Exercise 1.2 - Using the Repository Manager
Objectives
The new learning objectives of this exercise are to familiarize the user with setting up a network link to an external repository using the Syndeia dashboard.
Preparation
This exercise assumes the student has
Syndeia 3.2 installed as a stand-alone Desktop App with a valid license for use, and
Syndeia Cloud installed on an accessible server (see Syndeia Cloud installation instructions) and user has a valid account. The user will need to contact the Syndeia Cloud administrator for their organization to get access credentials.
A Syndeia Cloud project from the first exercise.
The specific instructions call for using an existing repository connection to DOORS NG and creating a new repository connection to JIRA, which requires these additional interfaces beyond the Syndeia base module. Other external repositories (e.g. Teamcenter, Windchill, MySQL, and Jama) could be used instead. Step 6, connecting to a local file system, can be done with just the base module.
The Syndeia Desktop App stores inter-model connections only in a Syndeia Cloud project. If you need to transfer connections from an earlier version to Syndeia Cloud, contact Intercax for assistance (www.intercax.com/help).
Exercise
If the Syndeia Desktop App is not currently running, double-click the file SyndeiaDashboard.bat to launch the Syndeia Desktop App. The Select or Create Syndeia Project window appears as in Figure 1.
Select the project created in Exercise 1.1, PROJ_001 (My First Test Project) and click OK.
Figure 1 Select or Create Syndeia Project window, initial.
This will open the Syndeia Dashboard with the Repository Manager tab showing, as shown in Figure 2. The categories shown in the left column correspond to Syndeia tool interfaces for which you have a valid license. There may be several repository connections already shown, which were created by other users and have been downloaded from Syndeia Cloud. In order to use them, you will need to enter your own user name and password, which you will need to obtain from the appropriate repository administrator.
Figure 2 Syndeia Dashboard, Repository Manager tab
To register your credentials for the DOORS NG 6.0.4 repository connection, double-click that item in the left column.
In the Specify credential window (Figure 3), enter your user name and password and click OK
Figure 3 Specify credentials
In the settings tab, there is an entry under the General heading to Save repository passwords (encrypted). If this is checked, your name and password will be stored on your local machine and will not need to be re-entered. If this is unchecked, you will need to re-enter your credentials each time your relaunch the dashboard and use this repository connection.
In order to create a new repository connection, right-click on the appropriate category in the left column and select Add. For example, to add a new JIRA repository, for example, right-click JIRA and click add. The window shown in Figure 4 will appear.
Figure 4 Add Repository
Under Repository Name, enter a short title that will represent the repository on the Syndeia dashboard. This repository connection will be available to all Syndeia users on the same Cloud server, so choose a unique name. Your organization may choose to adopt a standard repository naming convention.
Under URL, enter the link to this JIRA repository. Then enter your user name and password. Your JIRA administrator should be able to provide these, as well as the authentication protocol necessary for that repository.
Click OK. The window in Figure 4 will confirm a successful connection and close, or report that it could not connect and remain open for modification.
In order to create a new local repository connection, right-click on Local File System in the left column and select Add. The window shown in Figure 5 will appear.
Figure 5 Add Local File System
Under Repository Name, enter a short title that will represent the connection on the Syndeia dashboard. This repository connection name will be visible to all Syndeia users on the same Cloud server, but they will not be able to access the contents unless they are on a shared or networked drive.
Under Root, enter the path to a folder on the local file system, or use Browse. Click OK.
The left-hand panel under the Repository Manager tab should show all repository connections that are available, including any new ones that have been added. Select a repository and its contents will appear on the right-hand side of the dashboard, as in Figure 6 for GitHub.
Figure 6 Syndeia Dashboard, Repository Manager tab, showing GitHub contents on right
