Objectives

The new learning objective of this exercise is to:

Preparation

This exercise assumes the student has:

Cameo System Modeler 2022x (or MagicDraw with SysML plug-in) or later installed correctly on his or her machine with a valid license for use,
Syndeia 3.7.1 or later installed as a plugin for Cameo/MagicDraw with a valid license for use
Windchill interface, correctly configured with a valid license for use,
A Windchill repository network connection in the Syndeia Repository Manager.

This exercise assumes the user has access to the SysML model Syndeia_Windchill_Mapping_Tutorial.mdzip (get it here - SysML Models, Profiles and Mappings). Open the model in Cameo.
Right-click on package Windchill_Mapping, launch the Syndeia dashboard, select a Syndeia Cloud project if required, and click on the Connection Manager tab. Click on Repository at the top of the left panel and select SysML Repository. Click on Repository at the top of the right panel and select the 'Windchill' repository. The dashboard should appear as in Figure 1.

Figure 1 - Set the SysML repository and Windchill repository in the Connection Manager

In the Syndeia client dashboard, go to the Settings tab (Figure 2) and check the Use mapping element under the General heading, if not already checked. Click Apply.

Figure 2 - Confirm Mapping setting is applied in settings

Go to the Mappings tab in the Syndeia dashboard. If there is not a Windchill model type added already, we will go ahead and create one. Right click Model Types and select Add Model Type shown in Figure 3. Select the Windchill repository in the screen shown in Figure 4 and click OK to finish.

Figure 3 - Add model type

Figure 4 - Select Windchill model type

Right-click the Windchill model type and select Add Artifact Type a shown in Figure 5 below. Note: if a previous Windchill Part artifact type exists underneath Windchill artifact types, please delete it before adding the new 'Part' artifact type.

Figure 5 - Add a new Windchill artifact type from Mappings tab

A new window appears, ‘Add Windchill Artifact Type' as shown in Figure 6. Select your repository in the first dropdown menu and then select a Project (in our example ‘Sandbox’). Select 'Part’ from the Type dropdown. Lastly, input the Number/Template item of the artifact type from your Windchill repository and click Retrieve Windchill Artifact Type Properties.

Figure 6 - Add Windchill artifact and retrieve its properties

You should see a list of all possible attributes as shown in Figure 7 below. Click ‘Select all’ to bring in the entire list and then click OK to finish. Note the isModifiable column is no longer shown checked for all values, and some values may already have BOOLEAN type selected. For any that cannot be modified by a user in Windchill, uncheck the isModifiable box. Note the type column has different options other than STRING. IF your attribute in Windchill has a different type, such as the boolean type, configure it accordingly. In this example, we have selected AssemblyMode, GatheringPart, Name, and Source to be used in the mapping.

Figure 7 - Select the Windchill part properties and configure types

Figure 8 - Add new relation types for Windchill

If there is no Windchill Mapping group existing, right click Mapping Groups and Add Mapping Group shown below in Figure 9.

Figure 9 - Add Windchill mapping group

In the window ‘Create Mapping Group’, give the Windchill mapping group a name/description and select Windchill as the target model type as shown in Figure 10.

Figure 10 - Create Windchill Mapping Group

We will now create the first custom mapping that uses the 'Part Usage' relation. Underneath Mapping Groups you will see SysML - Windchill. Right-click the ‘SysML - Windchill’ group and select ‘Add mapping’ from the menu option.

In the window shown below in Figure 11, set a name and description reflecting the SysML and Windchill artifact type you are using along with any other information about the mapping you wish to preserve.
Set the Source Artifact Type to the Block and set the Target Artifact type to the Part.
Set the Structure level to CHILDREN_RECURSIVE and set Include Attributes to Include Attributes
For stereotypes, click the + button and add the Intercax Artifact stereotype from the Syndeia Mapping Tutorial profile

Further down in the mapping screen as shown in Figure 11, click the Retrieve Available Attribute Definitions button. Next, click the + button to the left and start mapping the attributes between SysML and Windchill. In this example:

Figure 11 - Configure the attributes and stereotypes for the Block - Part usage mapping

Set Include Relations to Include relations in the dropdown. Use the + icon to map Part Property to UsageLink as shown in Figure 12. Click Save mapping to finish.

Figure 12 - Include relations to map the Usagelink/Occurrence from Windchill

Right click the newly created ‘Block-Part Usage’ mapping and select Clone Mapping as shown in Figure 13.

Figure 13 - Clone the newly created mapping

Give this cloned mapping an updated name and description. Then repeat step 13 to create a relation mapping that uses the relation of type ‘OccurrenceLink’. Save mapping when finished.

Figure 14 - Updated clone mapping for relation type ‘OccurenceLink’