Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Warning: In order to complete the tutorial exercises in this document, it is necessary to change Rhapsody settings so that it accepts spaces in names. See User Guide.

...

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

  • IBM Rational Rhapsody 8.2 installed correctly on his or her machine with a valid license for use, and
  • Syndeia 3.2 installed as a plugin for Rhapsody 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

  1. Start Rhapsody and open a SysML model. In this example, we use the
  2. Satellite
  3. Starter_Model_Alpha.rpy sample model provided as part of the
  4. Melody parametric solver plugin
  5. Syndeia training materials, but any model with a block structure should work.
  6. The Satellite model with BDD and Containment browser open are shown.
    Image Removed 
  7. Add Syndeia profile to model by selecting Add Profile to Model… from the Rhapsody File menu and adding the Syndeia profile as shown in Figure 2. Click Open to complete.
    Image RemovedSelect the Satellite block
  8. Right-click on the Starter_Model_Alpha package in the containment browser and launch the Syndeia Dashboard using the Syndeia Windows batch file in the Syndeia installation folder (see Syndeia User Guide). This will open the Syndeia Dashboard 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 3. (Launching the dashboard using the Rhapsody right-click menu is not recommended at this time)1.

    Image Added

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

  10. To add a new Windchill Teamcenter repository to the list on the left, right-click on Windchill Teamcenter under Repositories and select Add. The window shown in Figure 42 will appear.

    Image Added

    Click OK.
    Image Removed
    To add a new Teamcenter
    1. Under Repository Name, enter a short title (e.g. WCTC-User) that will represent the repository on the Syndeia dashboard.
    2. Under URL, enter the link to the Windchill Teamcenter repository. Your PLM administrator should be able to provide this.
    3. 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.
    4. Click OK.
      Image RemovedImage Removed
    To add a new Teamcenter repository to the list on the left, right-click on Teamcenter Repositories and select Add. The window shown below will appear.
  11. Under Repository Name, enter a short title (e.g. TC-User) that will represent the repository on the Syndeia dashboard.
  12. Under URL, enter the link to the Teamcenter repository. Your PLM administrator should be able to provide this.
  13. 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.
    1. 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.
  14. To add a new Local File System repository to the list on the left, right-click on Teamcenter Repositories Local File System and select Add. The window shown above in Figure 3 will appear.

    Image Added

    1. Under Repository Name, enter a short title (e.g. TC-UserMy Hard Drive) that will represent the repository on the Syndeia dashboard.
    2. Under URLRoot, 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 URLor browse to the top-level folder in your local or shared drive that contains all the files you wish to connect to.
    3. Click OK.

...

    1. The window will close and the Repository Name will appear under Local File System in the left column of the Repository Manager tab

...

    1. .
  1. Select one of the new repository

...

  1. connections. The right panel of the dashboard

...

  1. will now show all the

...

  1. contents of that repository to which the user has access

...

  1. , e.g. the contents of the home folder

...

  1. as shown in Figure 4 for Teamcenter.

    Image Added


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.