Get a workspace from Git – PB Docs 2022

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

1. Right-click “No Workspace” in the System Tree and select
   Connect to Workspace from the pop-up menu

   or

   Select Connect to Workspace from the File menu.

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

2. Select Git from the
   Source Control System
   list.

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

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

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

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

7. 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.

8. 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.

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

10. 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.

    

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

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

    Note

    After you get a workspace 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 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 dialog
box.

1. In the Connect to Workspace
   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 box,
   type in the name of the workspace file to be downloaded from the
   repository. Note that the workspace 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 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 dialog box.

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