diff --git a/content/en/docs/appstore/platform-supported-content/modules/teamcenter-extension.md b/content/en/docs/appstore/platform-supported-content/modules/teamcenter-extension.md index 5aa6a43b1c8..4859ed1a385 100644 --- a/content/en/docs/appstore/platform-supported-content/modules/teamcenter-extension.md +++ b/content/en/docs/appstore/platform-supported-content/modules/teamcenter-extension.md @@ -8,17 +8,21 @@ description: "Describes Teamcenter Extension from the Mendix Marketplace. Teamce The [Teamcenter Extension](https://marketplace.mendix.com/link/component/225544) is a Mendix Extension built using the Mendix Extensibility Framework to provide you with an effortless means to harness the capabilities of [Teamcenter Connector](https://marketplace.mendix.com/link/component/111627) for Mendix. Teamcenter Extension is layered atop the Teamcenter Connector. It provides a low-code experience by making it easier to visualize and access Teamcenter data models and automate creation of Mendix domain models and microflows. +{{% alert color="info" %}}Teamcenter Extension V 3.0.0 and above is also supported on macOS.{{% /alert %}} + ### Typical Use Cases {#usecases} 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](/refguide/import-mappings/). Here, 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, 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. Teamcenter Extension offers the following integration options: -* Get item revisions -* Get workspace objects +* Search item revisions * Create item and item revision * Update item and item revision -* Revise item revisions +* Revise Item revison +* Search datasets +* Get datasets for item revision +* Search workspace objects * Get structures ### License {#license} @@ -31,7 +35,9 @@ The compatibility between Teamcenter Extension and Studio Pro is as follows: * Teamcenter Extension V 1.0.0 is compatible with Studio Pro versions between 10.6.5 and 10.7. -* Teamcenter Extension V 2.0.0 is compatible with Studio Pro version 10.12.1 or higher. +* Teamcenter Extension V 2.0.0 is compatible with Studio Pro version 10.12.1 and above. + +* Teamcenter Extension V 3.0.0 is compatible with Studio Pro version 10.12.6 and above. {{% alert color="info" %}}Teamcenter Extension is not compatible with Studio Pro versions between 10.8 to 10.11.

If you use one of these Studio Pro versions, a possible workaround is to use Teamcenter Extension in one of the compatible versions of Studio Pro first, create necessary artifacts and then import them into your version. However, Mendix always recommends using the latest MTS or LTS Studio Pro version.{{% /alert %}} @@ -49,8 +55,9 @@ You must have these Marketplace modules installed: | ------------- | ------------- | ------------- | | 1.0.0 | 3.6.1, V 3.6.0, V 3.5.0 | 10.6.5 thru 10.7 | | 2.0.0 | 2406.0.0 | 10.12.1 and above | +| 3.0.0 | 2406.3.0 | 10.12.6, 10.12.7, 10.16.0, and above | -{{% alert color="info" %}}If you use Teamcenter Extension V 1.0.0 with Teamcenter Connector V 3.6.1 or below, and want to upgrade to Teamcenter Extension V 2.0.0 and Teamcenter Connector V 2406.0.0, see the [Upgrading Teamcenter Extension V 1.0.0 to V 2.0.0](#upgrade) section.{{% /alert %}} +{{% alert color="info" %}}If you use Teamcenter Extension V 1.0.0 with Teamcenter Connector V 3.6.1 or below, and want to upgrade to Teamcenter Extension V 3.0.0 and Teamcenter Connector V 2406.3.0, see the [Upgrading Teamcenter Extension V 1.0.0 to V 3.0.0](#upgrade) section.{{% /alert %}} ### Demo App {#demoapp} @@ -64,13 +71,9 @@ Follow the instructions in [Using Marketplace Content](/appstore/use-content/) t ### Actions -#### Get Item Revisions from Teamcenter {#getitemrevision} - -The `Get ItemRevision` action allows you to generate the domain model and microflow to search for and retrieve `ItemRevisions` or its specialization. The resulting microflow implements the saved query `Item Revision...` from Teamcenter. - -#### Get Workspace Objects {#getworkspaceobjects} +#### Search Item Revisions from Teamcenter {#getitemrevision} -The `Get Workspace Objects` action allows you to configure and generate the domain model and microflow to search for and retrieve Workspace Objects or their specialization from Teamcenter. This action implements the saved query `General..` from Teamcenter +The `Search Item Revisions` action allows you to generate the domain model and microflow to search for and retrieve `ItemRevisions` or its specialization. The resulting microflow implements the saved query `Item Revision...` from Teamcenter. #### Create Item and Item Revision {#createitem-and-itemrevision} @@ -82,11 +85,23 @@ The `Update Item and Item Revision` action allows you to generate the domain mod #### Revise Item Revision {#reviseitem-and-itemrevision} -The `Revise Item and Item Revision` action allows you to generate the domain model and microflow to revise an `ItemRevision` or its specializations in Teamcenter. 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. +The `Revise Item and Item Revision` allows you to generate the domain model and microflow to revise an `ItemRevision` or its specializations in Teamcenter. 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. + +#### Search Datasets {#getdatasets} + +The `Search Datasets` allows you to generate the domain model and microflow to search for and retrieve `Datasets` or its specialization. The resulting microflow implements the saved query `Datasets` from Teamcenter. + +#### Get Datasets from Item Revision {#getdatasetsfromitemrevision} + +The `Get Datasets from Item Revision` action allows you to generate the domain model and microflow to retrieve datasets for an Item Revision and subsequently download files inside the dataset. + +#### Get Workspace Objects {#getworkspaceobjects} + +The `Get Workspace Objects` action allows you to configure and generate the domain model and microflow to search for and retrieve Workspace Objects or their specialization from Teamcenter. This action implements the saved query `General..` from Teamcenter. #### Get Structures -The `Get Structures` action allows you to generate the domain model and microflows to configure a BOM window and retrieve structure data from Teamcenter. This feature supports the retrieval of structures with the following: +The `Get Structures` allows you to generate the domain model and microflows 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` @@ -106,14 +121,14 @@ To work with structures, such as BOMs, you need to first create a BOM window in 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 | +| Scenario                                                 | Suggested Solution             | | -------------------------------------------------------- | ------------------------------ | -| Work with large or complex BOM structures | Use Active Workspace | -| Have performance concerns | Use Active Workspace | +| 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 | +| Compare BOMs from different systems                      | Use Active Integration Gateway | +| Author BOMs                                              | Use Active Workspace           | +| Create BOM configurations                                | Use Active Workspace           | ### Landing Page {#homepage} @@ -224,30 +239,30 @@ Once you finished import mapping, click **Generate** to create microflows for th {{< figure src="/attachments/appstore/platform-supported-content/modules/teamcenter-extension/microflow.png" >}} -## Upgrading Teamcenter Extension V 1.0.0 to V 2.0.0 {#upgrade} +## Upgrading Teamcenter Extension V 1.0.0 to V 3.0.0 {#upgrade} -If you use Teamcenter Extension V 1.0.0 with Teamcenter Connector V 3.6.1 or below, and want to upgrade to Teamcenter Extension V 2.0.0 and Teamcenter Connector V 2406.0.0, perform the following procedure: +If you use Teamcenter Extension V 1.0.0 with Teamcenter Connector V 3.6.1 or below, and want to upgrade to Teamcenter Extension V 3.0.0 and Teamcenter Connector V 2406.3.0, perform the following procedure: -1. Open your app in Studio Pro version 10.12.1 or higher. -2. Follow the instructions in [How to Use Marketplace Content in Studio Pro](/appstore/general/app-store-content/) to download [Teamcenter Extension V 2.0.0](https://marketplace.mendix.com/link/component/225544) from the Marketplace and install it. +1. Open your app in Studio Pro version 10.12.6 or higher. +2. Follow the instructions in [How to Use Marketplace Content in Studio Pro](/appstore/general/app-store-content/) to download [Teamcenter Extension V 3.0.0](https://marketplace.mendix.com/link/component/225544) from the Marketplace and install it. 3. When a warning dialog box opens, click **Trust module and enable extension**. Otherwise, Teamcenter Extension will not be installed. 4. Follow the instructions in [How to Upgrade the Module to a Newer Version](/appstore/use-content/#update-module) to upgrade Teamcenter Connector to V 2406.0.0. Teamcenter Connector V 2406.0.0 has updated domain model that made certain entities and associations in Teamcenter Extension V 1.0.0 redundant. As a result, you get errors after the upgrade. 5. To resolve the errors, use one of the solutions described the sections below: - * [Solution 1](#solution-1) +    * [Solution 1](#solution-1) - * [Solution 2](#solution-2) – Using Solution 2 has an advantage: after completing the procedure, the integrations will appear on the **History** tab. +    * [Solution 2](#solution-2) – Using Solution 2 has an advantage: after completing the procedure, the integrations will appear on the **History** tab. ### Resolving the Errors – Solution 1 {#solution-1} Follow the instructions in the table below: -| Error message | How to Solve the Error | +| Error message                                           | How to Solve the Error                                       | | ------------------------------------------------------- | ------------------------------------------------------------ | -| `TeamcenterToolkit.BOMWindow` no longer exists |
  1. Update all references to
    `TcConnector.BOMWindow`.
  2. Search for `TeamcenterToolkit.BOMWindow` to find `BOMapping` parameters where the entity is used, and change it to `TcConnector.BOMWindow`.
| -| `TeamcenterToolkit.top_line` no longer exists | Update all associations to `TcConnector.top_line`. | -| The selected Java action parameter […] no longer exists | Set all the Java action parameters again. | +| `TeamcenterToolkit.BOMWindow` no longer exists          |
  1. Update all references to
    `TcConnector.BOMWindow`.
  2. Search for `TeamcenterToolkit.BOMWindow` to find `BOMapping` parameters where the entity is used, and change it to `TcConnector.BOMWindow`.
| +| `TeamcenterToolkit.top_line` no longer exists           | Update all associations to `TcConnector.top_line`.           | +| The selected Java action parameter […] no longer exists | Set all the Java action parameters again.                    | ### Resolving the Errors – Solution 2 {#solution-2} @@ -258,5 +273,5 @@ Using Solution 2 has an advantage: after completing the procedure, the integrati As an alternative to solution 1, you can perform the following steps: 1. Delete the microflows generated with Teamcenter Extension V 1.0.0. This will cause errors in the locations where these microflows were used. Keep these errors so that you can identify where the microflows need to be implemented again. -2. Go to Teamcenter Extension V 2.0.0 and repeat the steps you did before in Teamcenter Extension V 1.0.0. Simply select the same entities and associations, as they already exist in your domain model. -3. Go over the errors caused by the missing microflows and implement the newly-generated microflows. +2. Go to Teamcenter Extension V 3.0.0 and repeat the steps you did before in Teamcenter Extension V 1.0.0. Simply select the same entities and associations, as they already exist in your domain model. +3. Go over the errors caused by the missing microflows and implement the newly-generated microflows.  diff --git a/static/attachments/appstore/platform-supported-content/modules/teamcenter-extension/history-tab.png b/static/attachments/appstore/platform-supported-content/modules/teamcenter-extension/history-tab.png index 5e86055d1f5..24ee4211ab1 100644 Binary files a/static/attachments/appstore/platform-supported-content/modules/teamcenter-extension/history-tab.png and b/static/attachments/appstore/platform-supported-content/modules/teamcenter-extension/history-tab.png differ diff --git a/static/attachments/appstore/platform-supported-content/modules/teamcenter-extension/menu-tab.png b/static/attachments/appstore/platform-supported-content/modules/teamcenter-extension/menu-tab.png index 66a594768a4..9d299c31bdd 100644 Binary files a/static/attachments/appstore/platform-supported-content/modules/teamcenter-extension/menu-tab.png and b/static/attachments/appstore/platform-supported-content/modules/teamcenter-extension/menu-tab.png differ