Skip to content

Commit 738131a

Browse files
committed
Merge branch 'development' into production
2 parents 9a0985f + 23e8776 commit 738131a

File tree

4 files changed

+46
-31
lines changed

4 files changed

+46
-31
lines changed

content/en/docs/appstore/platform-supported-content/modules/teamcenter-extension.md

Lines changed: 45 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -8,17 +8,21 @@ description: "Describes Teamcenter Extension from the Mendix Marketplace. Teamce
88

99
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.
1010

11+
{{% alert color="info" %}}Teamcenter Extension V 3.0.0 and above is also supported on macOS.{{% /alert %}}
12+
1113
### Typical Use Cases {#usecases}
1214

1315
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.
1416

1517
Teamcenter Extension offers the following integration options:
1618

17-
* Get item revisions
18-
* Get workspace objects
19+
* Search item revisions
1920
* Create item and item revision
2021
* Update item and item revision
21-
* Revise item revisions
22+
* Revise Item revison
23+
* Search datasets
24+
* Get datasets for item revision
25+
* Search workspace objects
2226
* Get structures
2327

2428
### License {#license}
@@ -31,7 +35,9 @@ The compatibility between Teamcenter Extension and Studio Pro is as follows:
3135

3236
* Teamcenter Extension V 1.0.0 is compatible with Studio Pro versions between 10.6.5 and 10.7.
3337

34-
* Teamcenter Extension V 2.0.0 is compatible with Studio Pro version 10.12.1 or higher.
38+
* Teamcenter Extension V 2.0.0 is compatible with Studio Pro version 10.12.1 and above.
39+
40+
* Teamcenter Extension V 3.0.0 is compatible with Studio Pro version 10.12.6 and above.
3541

3642
{{% alert color="info" %}}Teamcenter Extension is not compatible with Studio Pro versions between 10.8 to 10.11. </br></br>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 %}}
3743

@@ -49,8 +55,9 @@ You must have these Marketplace modules installed:
4955
| ------------- | ------------- | ------------- |
5056
| 1.0.0 | 3.6.1, V 3.6.0, V 3.5.0 | 10.6.5 thru 10.7 |
5157
| 2.0.0 | 2406.0.0 | 10.12.1 and above |
58+
| 3.0.0 | 2406.3.0 | 10.12.6, 10.12.7, 10.16.0, and above |
5259

53-
{{% 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 %}}
60+
{{% 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 %}}
5461

5562
### Demo App {#demoapp}
5663

@@ -70,11 +77,7 @@ The `Search Item Revisions` action allows you to generate the domain model and m
7077

7178
#### Get Item Revisions from Teamcenter {#getitemrevision}
7279

73-
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.
74-
75-
#### Get Workspace Objects {#getworkspaceobjects}
76-
77-
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
80+
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.
7881

7982
#### Create Item and Item Revision {#createitem-and-itemrevision}
8083

@@ -86,11 +89,23 @@ The `Update Item and Item Revision` action allows you to generate the domain mod
8689

8790
#### Revise Item Revision {#reviseitem-and-itemrevision}
8891

89-
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.
92+
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.
93+
94+
#### Search Datasets {#getdatasets}
95+
96+
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.
97+
98+
#### Get Datasets from Item Revision {#getdatasetsfromitemrevision}
99+
100+
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.
101+
102+
#### Get Workspace Objects {#getworkspaceobjects}
103+
104+
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.
90105

91106
#### Get Structures
92107

93-
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:
108+
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:
94109

95110
* `RevisionRule` (or default `RevisionRule`)
96111
* `VariantRule`
@@ -110,14 +125,14 @@ To work with structures, such as BOMs, you need to first create a BOM window in
110125

111126
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:
112127

113-
| Scenario | Suggested Solution |
128+
| Scenario                                                 | Suggested Solution             |
114129
| -------------------------------------------------------- | ------------------------------ |
115-
| Work with large or complex BOM structures | Use Active Workspace |
116-
| Have performance concerns | Use Active Workspace |
130+
| Work with large or complex BOM structures                | Use Active Workspace           |
131+
| Have performance concerns                                | Use Active Workspace           |
117132
| Transfer an entire BOM from Teamcenter to another system | Use Active Integration Gateway |
118-
| Compare BOMs from different systems | Use Active Integration Gateway |
119-
| Author BOMs | Use Active Workspace |
120-
| Create BOM configurations | Use Active Workspace |
133+
| Compare BOMs from different systems                      | Use Active Integration Gateway |
134+
| Author BOMs                                              | Use Active Workspace           |
135+
| Create BOM configurations                                | Use Active Workspace           |
121136

122137
### Landing Page {#homepage}
123138

@@ -228,30 +243,30 @@ Once you finished import mapping, click **Generate** to create microflows for th
228243

229244
{{< figure src="/attachments/appstore/platform-supported-content/modules/teamcenter-extension/microflow.png" >}}
230245

231-
## Upgrading Teamcenter Extension V 1.0.0 to V 2.0.0 {#upgrade}
246+
## Upgrading Teamcenter Extension V 1.0.0 to V 3.0.0 {#upgrade}
232247

233-
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:
248+
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:
234249

235-
1. Open your app in Studio Pro version 10.12.1 or higher.
236-
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.
250+
1. Open your app in Studio Pro version 10.12.6 or higher.
251+
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.
237252
3. When a warning dialog box opens, click **Trust module and enable extension**. Otherwise, Teamcenter Extension will not be installed.
238253
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.
239254

240255
5. To resolve the errors, use one of the solutions described the sections below:
241256

242-
* [Solution 1](#solution-1)
257+
    * [Solution 1](#solution-1)
243258

244-
* [Solution 2](#solution-2) – Using Solution 2 has an advantage: after completing the procedure, the integrations will appear on the **History** tab.
259+
    * [Solution 2](#solution-2) – Using Solution 2 has an advantage: after completing the procedure, the integrations will appear on the **History** tab.
245260

246261
### Resolving the Errors – Solution 1 {#solution-1}
247262

248263
Follow the instructions in the table below:
249264

250-
| Error message | How to Solve the Error |
265+
| Error message                                           | How to Solve the Error                                       |
251266
| ------------------------------------------------------- | ------------------------------------------------------------ |
252-
| `TeamcenterToolkit.BOMWindow` no longer exists | <ol><li>Update all references to <br/>`TcConnector.BOMWindow`.</li><li>Search for `TeamcenterToolkit.BOMWindow` to find `BOMapping` parameters where the entity is used, and change it to `TcConnector.BOMWindow`.</li></ol> |
253-
| `TeamcenterToolkit.top_line` no longer exists | Update all associations to `TcConnector.top_line`. |
254-
| The selected Java action parameter [] no longer exists | Set all the Java action parameters again. |
267+
| `TeamcenterToolkit.BOMWindow` no longer exists          | <ol><li>Update all references to <br/>`TcConnector.BOMWindow`.</li><li>Search for `TeamcenterToolkit.BOMWindow` to find `BOMapping` parameters where the entity is used, and change it to `TcConnector.BOMWindow`.</li></ol> |
268+
| `TeamcenterToolkit.top_line` no longer exists           | Update all associations to `TcConnector.top_line`.           |
269+
| The selected Java action parameter [] no longer exists | Set all the Java action parameters again.                    |
255270

256271
### Resolving the Errors – Solution 2 {#solution-2}
257272

@@ -262,5 +277,5 @@ Using Solution 2 has an advantage: after completing the procedure, the integrati
262277
As an alternative to solution 1, you can perform the following steps:
263278

264279
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.
265-
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.
266-
3. Go over the errors caused by the missing microflows and implement the newly-generated microflows.
280+
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.
281+
3. Go over the errors caused by the missing microflows and implement the newly-generated microflows. 

content/en/docs/deployment/private-cloud/private-cloud-deploy.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -492,7 +492,7 @@ If any of these garbage collection steps fail, you will no longer see the enviro
492492

493493
If you need to enter or change the subscription secret, then you can do that here.
494494

495-
Subscription secrets are obtained from [Mendix support](https://support.mendix.com/).
495+
Subscription secrets are obtained from [Mendix support](https://support.mendix.com/). You can use subscription secrets in [standalone mode](/developerportal/deploy/private-cloud-technical-appendix-02/).
496496

497497
We have also released an alternate way of licensing your apps in the Private Cloud by using PCLM. For more information, see [Private Cloud License Manager](/developerportal/deploy/private-cloud/private-cloud-license-manager/).
498498

-1.92 MB
Loading
-793 KB
Loading

0 commit comments

Comments
 (0)