Teamcenter Extension

1 Introduction

The Teamcenter Extension is a Mendix Extension built using the Mendix Extensibility Framework to provide you with an effortless means to harness the full capabilities of Teamcenter Connector for Mendix. The Teamcenter Extension is layered atop the Teamcenter Connector.It provides a low-code experience by making it easier to visualize and access Teamcenter data model and automate creation of Mendix domain models and microflows.

1.1 Typical Use Cases

The Teamcenter Extension offers a list of use cases for which domain models and microflows can be created. After you select a use case, it uses an import mapping approach similar to Mendix import mapping. Here, the Teamcenter Extension allows you to select data from the business model of your Teamcenter instance. Based on the selected use case, the import mapping and, for some use cases, additional configurations, the Teamcenter Extension generates and updates the domain model for your integration and generates one or more ready-to-use microflows that you can drag and drop into your application logic.

The extension offers the following integration options:

• Get item revisions
• Get workspace objects
• Create item and item revision
• Update item and item revision
• Revise item revisions
• Get structures

1.2 License

The Teamcenter Extension is free to download and use. You can, however, require a Teamcenter (Author or Consumer) license to connect to Teamcenter.

1.3 Pre-requisites

You must use Teamcenter Extension with a Studio Pro version between 10.6.5 to 10.8. Mendix recommends using Studio Pro version 10.6.7, as it is the medium-term support (MTS) version.

1.4 Dependencies

You must have these Marketplace modules installed:

• Teamcenter Connector

• Community Commons

1.5 Demo App

To see Teamcenter Extension in action, download and play with the Teamcenter Extension Sample App, which is available for free on the Mendix Marketplace.

2 Installation

Follow the instructions in Using Marketplace Content to import the Teamcenter Extension into your app.

3 Usage

3.1 Actions

3.1.1 Get Item Revisions from Teamcenter

The Get ItemRevision action allows you to generate a microflow to search for and retrieve ItemRevisions or its specialization from Teamcenter and the corresponding domain model. The resulting microflow implements the saved query Item Revision... from Teamcenter.

3.1.2 Get Workspace Objects

The Get Workspace Objects action allows you to configure and generate a microflow to search for and retrieve workspace objects or their specialization from Teamcenter and the corresponding domain model. This action implements the saved query General.. from Teamenter

3.1.3 Create Item and Item Revision

The Create Item and Item Revision action allows you to configure and generate a microflow to create an Item with ItemRevision or its specializations in Teamcenter and the corresponding domain model. The resulting microflow implements the Create Object and Update Properties actions from the Teamcenter Connector. With the Create Object action, the Item and ItemRevision get created in Teamcenter, setting the Teamcenter properties that need to be set upon creation. With the Update Properties action, the remaining properties are updated in Teamcenter.

3.1.4 Update Item and Item Revision

The Update Item and Item Revision action allows you to generate a microflow to update an Item with ItemRevision or their specializations in Teamcenter and the corresponding domain model. The resulting microflows implements the Update Properties action from the Teamcenter Connector.

3.1.5 Revise Item Revision

The Revise Item and Item Revision action allows you to generate a microflow to revise an ItemRevision or its specializations in Teamcenter and the corresponding domain model. The resulting microflow implements the Revise Object and Update Properties actions from the Teamcenter Connector. With the Revise Object action, a new ItemRevision is created, setting the Teamcenter properties that need to be set upon revising. With the Update Properties action, the remaining properties are updated in Teamcenter.

3.1.6 Get Structures

The Get Structures action allows you to generate microflows and corresponding domain model to configure a BOM window and retrieve structure data from Teamcenter. This feature supports the retrieval of structures with the following:

• RevisionRule (or default RevisionRule)
• VariantRule
• BOMWindow property flags

Depending on the configuration, microflows are generated to do the following:

• Create BOMWindow (implementing the Create BOM Windows2 action from the Teamcenter Connector)
• Retrieve RevisionRules (implementing the Get Revision Rules action from the Teamcenter Connector)
• Retrieve VariantRules (implementing the Get Variant Rule action from the Teamcenter Connector)
• Expand a single BOMLine (implementing the Expand One Level 2 action from the Teamcenter Connector)
• Expand all BOMLines (implementing the Expand All Levels action from the Teamcenter Connector)
• Close the BOMWindow (implementing the Close BIM Windows action from the Teamcenter Connector)
• Get the root BOMLine for a BOMWindow.

To work with structures, such as BOMs, you need to first create a BOM window in Teamcenter. One can retrieve the root BOM Line from the BOM window and from there start expanding the structure either line by line or with all BOM Lines at the same time. The BOM Lines define the structure (based on the configuration you passed when generating the BOM window). Each BOM Line is associated with a single ItemRevision.

This feature is designed specifically for generating microflows and domain models to retrieve and display simple BOM structures (unconfigured or configured). For other scenarios, consider alternative solutions. See the table below:

Scenario	Suggested Solution
Work with large or complex BOM structures	Use Active Workspace
Have performance concerns	Use Active Workspace
Transfer an entire BOM from Teamcenter to another system	Use Active Integration Gateway
Compare BOMs from different systems	Use Active Integration Gateway
Author BOMs	Use Active Workspace
Create BOM configurations	Use Active Workspace

3.2 Landing Page

To open the Teamcenter Extension in Studio Pro, go to View > Teamcenter. The landing page opens with two tabs: Menu and Settings.

The Menu tab displays use cases or actions you can create artifacts for using the extension.

The Settings tab allows you to provide details of your Teamcenter instance to connect to, while using the extension. The Settings tab displays the Teamcenter configuration page. Here you can provide your Teamcenter Instance details to connect to while building your app. Click Edit to open a panel to enter details. The certificate path should be relative to the app directly.

The extension supports both HTTP and HTTPS connections. Additionally, it supports certificates that have .crt and .pfx file extensions.

3.3 Import mapping

Clicking any one of the actions opens an empty import mapping page. Here you can define what data you want to retrieve from Teamcenter and how to handle this data in Mendix. Depending on the action, the import mapping page starts with one or multiple entities or objects to configure, one per business object that needs to be configured.

During configuration, the import mapping page will build up a preview of the Mendix domain model involved in the integration. In addition, the import mapping page shows the corresponding business objects on the Teamcenter side. For this, the Teamcenter Extension displays both the display names of the objects and their properties, references, relations, and the corresponding technical names, as they will end up in the Mendix domain model.

In the Teamcenter Extension, the import mapping consists of the following steps:

1. Object mapping: As Teamcenter works with many layers of specializations of its business objects, in the import mapping page, you need to configure which object type you want to retrieve from Teamcenter and what Mendix objects need to be created, when retrieving these business objects. This is called object mapping.
2. Selection of properties, references, and relations: Configure which properties, references, and relations you want to retrieve from Teamcenter and include in your Mendix model .

3.3.1 Object mapping

Clicking any one of the empty box in the import mapping page opens the object mapping dialog. On the left side of the dialog, a tree with all relevant business objects available from the configured Teamcenter instance is displayed. If you have created any custom business objects in Teamcenter BMIDE, those objects will be shown as well. The right side shows a tree of all relevant entities in your Mendix app.

The relevant objects and entities are dependent on the actions you are configuring. For example, for the action to get ItemRevisions from Teamcenter, the Teamcenter tree has an ItemRevision as its root object. That means that, for this action, you can only select ItemRevisions or its specializations. Similarly, in this example, the Mendix tree has the TcConnector.ItemRevision entity as its root entity.

When retrieving a tree of objects, relevance can also be based on the type of the relation or reference. When working with typed relations o references, the type of Teamcenter business object is dictated by the relation or reference. By limiting the list of Teamcenter objects and Mendix entities to those that are relevant, the Teamcenter Extension guides you to select Teamcenter business objects that make sense in the context of the action you want to perform.

To configure which type of Teamcenter business object you are interested in and what type of Mendix entities this should be mapped to, select a business object in the Teamcenter tree on the left side and an entity on the Mendix tree on the right side and click OK.

It is also possible to create new entities for your integrations. This new entity needs to be a specialization of the root entity in the Mendix tree or one of its specializations. When you want to use a new entity, click your generalization of choice, click the Create new specialization of selected entity check box and provide an entity name. Once finishing the configuration for the actions, the Teamcenter Extension will create a new entity with the given name and the selected entity as its generalization. You can also reuse or create the specialization of the generated entities in subsequent actions.

Once you click OK, you will return to the import mapping tab with a sidebar open for you to configure which Teamcenter properties, references, and relations to include when retrieving data for this business object.

3.3.2 Teamcenter properties, references, and relations

In the import mapping sidebar, you can configure which Teamcenter properties, references, and relations to include when retrieving data from Teamcenter. The import mapping sidebar is launched automatically after the completion of object mapping. When you are on the import mapping page and the sidebar is closed, you can double-click a previously configured entity to open the sidebar for that entity.

The sidebar shows all properties, references, and relations for the configured Teamcenter object. Depending on the use case, each one of them is accompanied with check boxes for reading () and writing () for you to configure what to include when retrieving data from or creating data in Teamcenter.

You often see that check boxes are selected by default or grayed out. In general, the following rules apply:

1. Properties that are already available on the Mendix entity or one of its generalizations are selected by default and cannot be unchecked.
2. Properties, references, and relations for Marketplace entities are disabled by default, as it is not good practice to change Mendix marketplace content.

As an example, if a check box for reading () is selected and grayed out, it means that property already exists as an attribute on the selected object or one of its generalizations. Similarly, if a check box for writing () is selected and grayed out, it means the property is required during creation or revision of the selected object.

You can select and deselect the properties, references, and relations depending on the data you need from Teamcenter. When you select a reference or relation, a new placeholder entity will be added to the object mapping tree. You will need to perform the import mapping for these referenced or related objects in a subsequent step (business object mapping and selection of Teamcenter properties, references, and relations).

3.4 Microflows and Domain Model

Once you finished import mapping, click Generate to create microflows for the selected use case and its corresponding domain model. These artifacts can be used in your app logic.