Versions Compared

Key

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

...

The user can use any Teamcenter repository they have available with the ability to create and edit model elements within a Teamcenter Bill of Materials. It is generally advisable to carry out these exercises in a non-production repository, a "sandbox", set up for training and practice purposes.
Using mapping in Syndeia requires two new elements which are provided with these tutorials

  1. A mappings file, syndeia33Tutorial.mappings, which contains the specific starting mappings used in this and the following exercises. To install this,

    1. Close MagicDraw, if it is open

    2. Rename the existing syndeia.mappings file in the .syndeia folder to something like syndeiaOld.mappings

    3. Copy syndeia33Tutorial.mappings into the .syndeia folder

    4. Rename syndeiaTutorial.mappings as syndeia.mappings

    5. When you have completed the mapping tutorial exercises, you may want to reverse this process to restore the original mappings file.

  2. A mappings profile, Syndeia_Mapping_Tutorials_Profile.mdzip, which is loaded automatically with the SysML project Syndeia_Teamcenter_Mapping_Tutorial.mdzip and can be used with other projects.

Exercise

  1. Open the SysML project Syndeia_Teamcenter_Mapping_Tutorial.mdzip, right-click the Teamcenter_Mapping package, and launch the Syndeia dashboard. Select a Syndeia Cloud project for the exercise, if necessary.

  2. Go to the Settings tab (Figure 1) and check the Use mapping element under the General heading, if not already checked. Click Apply.

    Image RemovedImage Added

    Figure 1 Syndeia dashboard, Settings tab, Use mapping checked

  3. Go to the Mappings tab. The contents of the main area on the right will depend on the element selected on the left. Expand Mapping Groups and select SysML-Teamcenter on the left to see the existing mappings in this area (Figure 2).

    Image RemovedImage Added

    Figure 2 Syndeia dashboard, Mappings tab, Mapping Groups/SysML-Teamcenter expanded on left

  4. The first task is to drag a hierarchy of SysML blocks into Teamcenter to create multiple Teamcenter items.

    1. Select the Connection Manager tab. Expand the SysML model in the left column and your Teamcenter repository in the left. Set Connection Type to Model Transform in the central column.

    2. Drag the Block_A block onto an empty target Teamcenter folder.

    3. Select Block-Item (no attributes) and click OK (Figure 3).

      Image RemovedImage Added

      Figure 3  Syndeia Dashboard, Connection Manager tab

  5. We can view the new Teamcenter items created by expanding the right side of the Connection Manager (see Figure 4). Teamcenter has assigned new id's to these items, but the structure from the SysML block structure is preserved.

    Image RemovedImage Added

    Figure 4  New Teamcenter items viewed in Syndeia dashboard

  6. In the second example, we will use a different mapping when we drag the Teamcenter items back into SysML.

    1. Return to the Mappings tab in the Syndeia dashboard and select the SysML-Teamcenter mapping Block – Item (attributes) in the left column (Figure 5). At the right, we see that this mapping is associated with a new SysML stereotype, <<Intercax_Artifact>>, which contains a set of tag values corresponding to some of the attributes of an Item in Teamcenter. Beside Attribute Definition Mappings, there is a table showing the desired mappings between the SysML (Source) element tag values and the Teamcenter (Target) attributes.

      Figure 5  Syndeia mapping for Block-Item (attributes)

    2. In the Syndeia dashboard, Connection Manager tab, select the Model Transform connection type, drag the Teamcenter 004392-Block_A item (your Teamcenter ID numbers will be different) into an empty SysML package (T3 in this example), and select the Block -Item (attributes) mapping.

    3. You can view the new blocks created in MagicDraw. It should appear similar to Figure 6. The <<Intercax_Artifact>> stereotype has been applied and the associated tag values have been added. Some of those tags (id, rev, and type) have been populated with default values by Teamcenter when the blocks were created earlier.

      Figure 6  New SysML blocks created by second mapping

  7. Use Syndeia's Compare and Sync capabilities to change the SysML model and push the changes to Teamcenter.

    1. Create the tag value "USA" in govClass in Block_A in SysML. Do not use HTML formatting or extraneous formatting characters will be displayed..

    2. Delete part property a2:Block_A2 in SysML.

    3. In the Syndeia dashboard, Connection Browser tab, find the connection from T3::Block_A to Teamcenter (Figure 7). Right-click this row and select Compare Source & Target.

      Image RemovedImage Added

      Figure 7 Syndeia dashboard, Connection Browser tab, T3::Block_A connection to Teamcenter

    4. The Comparison Result tab will show the differences between the SysML and Teamcenter models (Figure 8). The difference table shows that the SysML model is missing the child part of type Block_A2 and has a value for the "govClass" attribute.

      Image RemovedImage Added

      Figure 8 Syndeia dashboard, Comparison Result tab, T3::Block_A connection to Teamcenter

  8. Return to the Syndeia dashboard, Connection Browser tab, and the connection from T3::Block_A to Teamcenter (Figure 7). Right-click this row and select Sync Source to Target.

  9. Repeat the comparison and see that GovClass and Block_A2 differences have been resolved by updating the Teamcenter model. However, the update has created a new Item Revision in Teamcenter. The new item_revision_id in Teamcenter is B, which is different than the "rev" tag value in SysML for Block A. This difference may be resolved by syncing Target to Source for this connection, which will update the SysML "rev" tag value.

...