The new learning objective of this exercise is 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
- Cameo System Modeler 18.5 (or MagicDraw 18.5 with SysML plug-in) installed correctly on his or her machine with a valid license for use, and
- Syndeia 3.2 installed as a plugin for Cameo/MagicDraw with a valid license for use.
The specific instructions call for creating a network connection to a Teamcenter PLM repository, but the user can carry out the same process to any external repository (including Windchill, Jira, Jama, Doors NG, GitHub or MySQL), assuming that the appropriate interface has been properly installed and the user has access credentials (url, username and password, typically) to that repository.
Exercise
- Start MagicDraw and open a SysML model. In this example, we use the Exercise 1.2 Starter Model_Alpha sample model provided as part of the Syndeia training materials, but any model with a block structure should work.
- Right-click on the Starter_Model package in the containment browser and select Syndeia → If Syndeia is set for Cloud mode (see Exercise 1.1), select a project and proceed. If Syndeia is set for local mode, the Syndeia Dashboard will open directly with the Repository Manager tab showing, as shown in Figure 1.
- Depending on your set-up, there may be one or more existing repository connections already showing. These can be ignored for the purposes of this exercise.
- To add a new Teamcenter repository to the list on the left, right-click on Teamcenter under Repositories and select Add. The window shown in Figure 2 will appear.
- Under Repository Name, enter a short title (e.g. TC-User) that will represent the repository on the Syndeia dashboard.
- Under URL, enter the link to the Teamcenter repository. Your PLM administrator should be able to provide this.
- Enter your User name and password. In order to make connections to elements in a repository with Syndeia, you must have access to the repository listed in the URL. Your PLM administrator should be able to provide this.
- Click OK. If Syndeia is able to establish and verify the connection, the window will close and the Repository Name will appear under Teamcenter in the left column of the Repository Manager tab. If there is an error in the process, the message “Connection failed!” will appear at the bottom of the window. Check the Notification Window at the bottom of the dashboard or the syndeia.md.log file for more information.
- To add a new Local File System repository to the list on the left, right-click on Local File System and select Add. The window shown in Figure 3 will appear.
- Under Repository Name, enter a short title (e.g. My Hard Drive) that will represent the repository on the Syndeia dashboard.
- Under Root, enter or browse to the top-level folder in your local or shared drive that contains all the files you wish to connect to.
- Click OK. The window will close and the Repository Name will appear under Local File System in the left column of the Repository Manager tab.
- Select one of the new repository connections. The right panel of the dashboard will now show all the contents of that repository to which the user has access, e.g. the contents of the home folder as shown in Figure 4 for Teamcenter.
Note: If the Syndeia user is connected to Syndeia Cloud, the Repository Network connections are shared with other Syndeia users (although user name and passwords are stored locally in encrypted form). Creation, modification and deletion of the common connections may be reserved for the Syndeia Cloud administrator. A standard naming convention, especially for local drive connections, e.g. My Hard Drive – JohnSmith, helps avoid confusion.
Some repository connection types may support additional authentication methods. For example, JIRA and Jama repository connections support OAuth, if needed. If your repository connections require special methods, contact Intercax Technical support at www.intercax.com/help.