Installing TopBraid Composer, Cloning Git Repository, Installing Postman

Introduction

Installing TopBraid Composer SE

1. Obtain installation at https://www.topquadrant.com/downloads/topbraid-composer-install/
2. Select Standard Edition
3. For version 5.5, go to this SharePoint site: https://cdisc.sharepoint.com/sites/DataScienceTeam/Shared%20Documents/TopBraid%20SE
4. Unzip the file on a local machine folder. Note: TopBraid SE does not require typical Windows installation
5. Select TopBraid Composer.exe from the unzipped folder to launch the software
6. Follow TopBraid instructions for setting up a workspace
7. Follow TopBraid instructions for entering license to activate the software

Setting up SHARE 2.0 Git Repo

For fresh new clone

1. In TopBraid, switch to Git perspective: Window > Perspective > Other Perspective > Other... > Git
2. Select the Clone a Git repository option
3. In the Source Git Repository dialog box, 
4. In the same dialog box, select connection protocol & authentication method:
   1. For https as Protocol:
      1. Enter https://bitbucket.cdisc.org/scm/share/share-2-0.git as Location's URI. This will auto-populate Host, Repository Path, Protocol and Port
      2. Enter WIKI/JIRA credentials in the Authentication section.
      3. Enable Store in Secure Store, if this feature is desired.
   2. For ssh as Protocol (refer this page for details in setting up individual SSH key: https://confluence.atlassian.com/bitbucketserver0411/using-ssh-keys-to-secure-git-operations-861180645.html?utm_campaign=in-app-help&utm_medium=in-app-help&utm_source=stash):
      1. Ensure an SSH key is applied to the user account here: https://bitbucket.cdisc.org/plugins/servlet/ssh/account/keys
      2. Enter ssh://git@bitbucket.cdisc.org:7999/share/share-2-0.git as Location's URI. This will auto-populate Host, Repository Path, Protocol, Port, and User
      3. Leave blank in Authentication | Password.
      4. Enable Store in Secure Store, if this feature is desired.
      5. Click Next
      6. Enter passphrase that is attached to the encryption key, e.g, RSA
5. Click Next
6. In the Branch Selection dialog box, be sure master is selected
7. Click Next
8. In the Local Destination dialog box, select a desired Directory
9. Click Finish
10. The software will begin cloning the repo
11.  Open the Git Staging view and perform an Ignore to the .project file. Once completed, another .gitignore file will appear on the Git Staging view. Perform an Ignore to it as well.

For reusing cloned local repo

1. In TopBraid, switch to git perspective: Window > Perspective > Other Perspective > Other... > Git
2. Select the Add an existing local Git repository option
3. Select a local directory where a local Git repository resides
4. Click Finish

Creating a TopBraid Project

1. In the TopBraid, switch to TopBraid perspective: Window > Perspective > Other Perspective > Other... > TopBraid
2. Create a new project by importing from the Git repository: File > Import... > Git > Projects from Git
3. Click Next
4. Select Existing local repository
5. Select the share-2-0 local repository
6. Select Import as general project
7. Click Next
8. Click Finish

Installing Postman

1. Obtain a Postman account from CDISC IT (i.e., user license)
2. Obtain installation at https://www.getpostman.com/apps
3. Here is a couple of useful tips in case installation goes less than smoothly
   1. https://github.com/postmanlabs/postman-app-support/issues/4594
   2. https://support.getpostman.com/hc/en-us/articles/115005901149-My-Postman-app-won-t-start
4. Follow installation instruction and log into the software
5. Join the collection, i.e., ask Sam, current owner team workspace admin, for an invitation