Azure DevOps integration
Integration between ScopeMaster and Azure DevOps Services is easy. From within ScopeMaster, select the project in ADO with which to synchronise user stories. Thereafter you can control the synchronisation down to a requirement level.
This help article refers only to synchronising ScopeMaster with the cloud version of ADO known as Azure DevOps Services. (If you are using the on-prem server version, know as as Azure DevOps Server, you must create your own integration via the ScopeMaster REST API and your local instance). See https://help.scopemaster.com/article/50-introduction-to-the-api
How it works
This integration allows you to establish a 1:1 relationship between the user stories in a single project in ADO to a corresponding project in ScopeMaster. The synchronisation is controlled from within ScopeMaster and it performs both a "push" and "pull" of user story content. The user stories (and only the user stories) can be synchronised between the two repositories. This is a bi-directional exchange. The "last edited" timestamp is used to determine the latest version from either repository. The most recent version in either repository will be identified as a candidate to overwrite the other. You always have the opportunity to defer or block synchronisation down to the story level.
The synchronisation involves just three fields:System.Title
|System.Description||body||this is the field that contains the user story and is synchronised|
|System.Id||external-id||ADO ID field is sent to ScopeMaster and thereafter never changes|
Setting up Synchronisation
1. In ADO, create a personal access token (you will need to add this to your ScopeMaster Project Integration Settings.)
2. Ensure that a project exists within ADO ready to synchronise with ScopeMaster, make a not of the project ID.
Setting up Synchronisation in ScopeMaster
3. Now log into ScopeMaster and create a new project. Select synchronise with repository.
4. Visit the "Settings page"5. Enter the repository url, project id, and personal access token name and value created, click save.
Performing the Synchronisation
6. Now navigate to the Synchronise Stories page.
7. Click on the list stories button to display the current state of user stories in the two repositories.
From here you can click on the orange buttons to push or pull an individual user story or push or pull all changes.
When you click "synchronise": if a user story exists in ScopeMaster and not in ADO, it will create one in ADO. If a user story exists in ADO but not in ScopeMaster, it will create it in ScopeMaster.
Ensure that all user stories should have a unique title.