From 7b16b66d5f9e994ac7c28adc1b22560ef0e75fd1 Mon Sep 17 00:00:00 2001 From: rohanwanchoo123 <157635704+rohanwanchoo123@users.noreply.github.com> Date: Fri, 11 Oct 2024 16:29:04 -0400 Subject: [PATCH 01/11] Update teamcenter-extension.md (Version 3.0.0) --- .../modules/teamcenter-extension.md | 85 +++++++++++-------- 1 file changed, 49 insertions(+), 36 deletions(-) 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 463824de934..2f9baa45d7b 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 @@ -14,11 +14,13 @@ Teamcenter Extension offers a list of use cases for which domain models and micr Teamcenter 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 +* Search Item Revisions +* Create Item and Item Revision +* Update Item and Item Revision +* Revise Item Revision +* Search Datasets +* Get Datasets for Item Revision +* Search workspace objects * Get structures ### License {#license} @@ -32,6 +34,8 @@ 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 3.0.0 is compatible with Studio Pro version 10.12.6 or higher. {{% 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 +53,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 and above (except 10.15.0) | -{{% 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,29 +69,37 @@ Follow the instructions in [Using Marketplace Content](/appstore/use-content/) t ### Actions -#### Get Item Revisions from Teamcenter {#getitemrevision} +#### Search 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} - -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 +This 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} -The `Create Item and Item Revision` action allows you to configure and generate the domain model and microflow to create an Item with `ItemRevision` or its specializations in Teamcenter. 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. +This action allows you to configure and generate the domain model and microflow to create an Item with `ItemRevision` or its specializations in Teamcenter. 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. #### Update Item and Item Revision {#updateitem-and-itemrevision} -The `Update Item and Item Revision` action allows you to generate the domain model and microflow to update an `Item` with `ItemRevision` or their specializations in Teamcenter. The resulting microflows implements the `Update Properties` action from the Teamcenter Connector. +This action allows you to generate the domain model and microflow to update an `Item` with `ItemRevision` or their specializations in Teamcenter. The resulting microflows implements the `Update Properties` action from the Teamcenter Connector. #### 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. +This 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. + +#### Search Datasets {#getdatasets} + +This action 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} + +This 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} + +This 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: +This 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: * `RevisionRule` (or default `RevisionRule`) * `VariantRule` @@ -106,14 +119,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} @@ -129,13 +142,13 @@ The landing page has with three tabs: **Menu**, **History**, and **Settings**. The **Menu** tab displays use cases or actions you can create artifacts for using Teamcenter Extension. -{{< figure src="/attachments/appstore/use-content/modules/teamcenter-extension/menu-tab.png" >}} + #### History Tab The **History** tab displays the history of all actions (also referred as integrations) carried out in Teamcenter Extension. -{{< figure src="/attachments/appstore/use-content/modules/teamcenter-extension/history-tab.png" >}} + On the **History** tab, you can view details of each action, such as entities and microflows created, Teamcenter URL used to connect with, the preview of the import mapping, and much more. @@ -224,30 +237,30 @@ Once you finished import mapping, click **Generate** to create microflows for th {{< figure src="/attachments/appstore/use-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 |
b4#64Z=9wEsG$L(`Y0;mLV(xF*sm
zDJgx)-i!C*9=Y>EA5R+i{3d{cB+H}v%l>L>#=ZAtwZpa0OjUWd=FkHqc|QL*$70*F
z>Os5FU0|uslHxGF ++!&mpJQ)cP|6GAY;bSy*#Ln5N|FFw|`^peDkzS(Db-s%1{VNUg*mp37TD`Y(#e7
zskog~Hea>ox*xvVe%vVgt$Td2+(UZ^6H$+SdPPf<7pyp;q;ZeTf1Ys(|H)408^_xy
z%yupaVfMjRzlqhnWQ8$S%ItYd;V`g@nb*Za$W$C&+VL0L+a4=4i&EYYdd5d1#xXry!*$!tL5QK_!p&`RJ1X!ciHZ`N=*0ObsH7
zb#hGHEHOs0)R4<_h5cQZN2y3IctLhxyU&tX$N`sqdJLwm1*u@(4kj#auM>2&e7^he
zBDJ}3(ZKo{FQ&XFtO1SI@B@ByRy+BUjci3eU!Av5ajkyotWRn?(P;OS0T1BRCWvsX
zx7xs^b|pqK=2J6kc)+r7mS|6qyw-(m+qwF&ZXS4uOFB4fhqY5R)*eZv-}a|7fK?vC
zj+DU?JJ1}9SpAhfkcEM;ZSv6UY3#b+I0LfRkTwyu=n)$Fe5KY^>`&jq8`WPU``P1#
z1K>f-J(H{q2CI5G3=NOm12v4Oq%XZC4y}!^&%1D{f<=fcW;B2;V@lsHugr?N1~>g4
zU<`u$Ucz5(&N+`w^{tP@L4VNTrH0VKd~
zGP~s$w6DE5J8Un|<3~AQ9yf7DvHC5D+$_~1dQ9Wxo9KEaB*YXu@4_u!{`m||;7t~f
zlY~ZJU{&WIK9nQq!J|z*C0I^lB|ZMFaT@rP0A26OiATBfBVK
%6rIm+RFTWgr}wyGd)oeMv;i^>9J#sfH5+
zsCi7m#*_KS6?5E-&HbA&D~dvp4|n{ZFkMCm@5KhOfP6$t;ZXr#>tgOBr;5SWnWsy~
zC(OQfUJMnC4E*Vy3ukjoXBgB{_I*y#9nmFsn{t+1
z{p?`y3yeEEt^@{uP*Ep|#;H+j(hl8EcFW6XkBQ!%AMCUnd8&8x_Pb1x-&QXT3gd3{
zCgkKt8VC>TP;7{+bYGhy>$EplB-yp``ojQzLO(i=ZbF4hPWfn60ujdsz;CaA#U4O8
z79E}?)(Z%on+|@2Xx+pIYk6qW>UN<7Os~LF#%EaR@P*Hsb2U9w`nRmX7aFu`wZEX{
z)?bKzsbRo}Ppn1SByYVOkah2ZwH7rs!?r;?dEm9Y2;}ZKv^6n4XWX`T-Ds?X)SLZd
zFeO^hDjI8|9BVMRjQCD4%FPGU0S8;RIDDtWiBCz-cb$Rb%-{aehh%y7L+7_xbG6