Users Guide
Using Git source control system

To get a PowerBuilder workspace/solution from the Git source control system:

1. Right-click "None" in the System Tree and select Connect to Workspace/Solution from the pop-up menu

   or

   Select Connect to Workspace/Solution from the File menu.

   The Connect to Workspace/Solution dialog box displays. If the login information has been input before, they will be filled in automatically.

2. Select the Workspace or Solution tab.

3. Select Git from the Source Control System list.

4. In the Repository URL box, input the URL of the Git source control server and the name of an existing repository on the server.

5. In the Workspace File or Solution File box, type in the name of the workspace/solution file to be downloaded from the repository. Note that the workspace/solution file name is case-sensitive.

6. In the Branch box, specify the branch from which source code will be downloaded. If not specified, it will default to the "main" branch.

7. Select Basic or Token from the Authentication Type list.

8. In the User ID and Password (or Personal Access Token) boxes, type in your user name and password (or token) for the Git source control system.

9. In the Checkout Directory box, type or select a path for the local root directory. All the files that you add to or get from source control must reside in this path or in a subdirectory of this path.

10. In the Author Name and Author Email box, input the author name and author email.

11. In the Workspace tab, you can also select the "Regenerate all PBLs with the source code after download" option to regenerate all PBLs after downloading the source code from workspace if you are unsure whether the PBLs are updated with the latest source code.

    Note

    If using the proxy server, configure the proxy server IP address and port number in the PB.ini file. See Using proxy server for more information.

    
    
    

12. Click Test Connection, and click OK when connection is successful.

    PowerBuilder starts downloading the workspace/solution from the Git source control system, and after the workspace/solution is successfully downloaded, it will be loaded in the PowerBuilder IDE automatically.

    Note

    After you get a workspace/solution which was added to Git using a third-party tool such as TortoiseGit (not by PowerBuilder IDE), the objects will be marked with this icon which means the objects are not yet under source control in PowerBuilder IDE, so you should commit the entire workspace/solution from the PowerBuilder IDE to Git to add it under source control.

To authenticate your user credentials with the Git server:

You can directly get your username/password (or personal access token) from the GitHub, GitLab, BitBucket etc. in the Connect to Workspace/Solution dialog box.

1. In the Connect to Workspace/Solution dialog box, select Git from the Source Control System list.

2. In the Repository URL box, input the URL of the Git source control server and the name of an existing repository on the server.

3. In the Workspace File or Solution File box, type in the name of the workspace/solution file to be downloaded from the repository. Note that the workspace/solution file name is case-sensitive.

4. Leave the Branch box empty if downloading from the "main" branch, or specify a branch.

5. Select Basic or Token from the Authentication Type list and leave the User ID and Password (or Personal Access Token) boxes empty.

6. Click Connect.

   
   
   

7. In the Windows Credentials window or the sign-in window for GitHub, GitLab, BitBucket etc., sign in with your user name and password.

   You will need to install the Git for Windows tool first in order to display the Windows Credentials window or the sign-in window for GitHub, GitLab, BitBucket etc..

   Take GitHub for example. In the Connect to GitHub window, click Sign in with your browser, and then sign in to GitHub with your user name and password in the browser window. When authentication succeeds, your user name and password or personal access token will be automatically filled into the Connect to Workspace/Solution dialog box.

   
   
   

8. Make sure the authentication is successful and your user name and password or personal access token are automatically filled in the Connect to Workspace/Solution dialog box.

9. Click Connect again in the Connect to Workspace/Solution dialog box to verify that the connection is successful.