...
3DEXPERIENCE 2019x or higher
Subscription & Access
All widget configurations are controlled by an access token tied to a subscription.
Subscriptions have an end date and a user count. To control usage the logged in user name is passed each time a widget definition is loaded from TECNNIA.cloud. This also applies to trial use. Fore more detail on the data stored see the privacy policy & data processing agreement.
To avoid unauthorized use of your subscription keep your access token a secret and renew it with a cadence.
Hosting / TECHNIA.cloud
All widget definitions are hosted on TECHNIA.cloud that is using a sub processor (e.g. AWS). For more detail on support etc see the agreement.
The following resources are hosted on TECHNIA.cloud
Framework resources (.html, .css, .js)
Widget definition
Configuration (e.g. columns, datasets etc .json)
Code (e.g. custom rendering, data calculations etc .js)
Widget definition - Administration
Customers sometimes control widget definitions themselves (depending on the agreement). Widget definition is currently managed over cURL using basic authentication (you can use git bash or similar terminal). To simplify administration and improve security further an admin UI with MFA is planned for later.
| Note |
|---|
Note that all modification to definitions is immediately reflected. Widget lifecycle management is not currently in place and it is recommended to use other specific widgets for dev and test purposes before updating the production definition. |
Listing configurations
The following cURL will list (id, name) of all configurations related to the admin user.
| Code Block |
|---|
export SERVER=https://waas.technia.cloud
export USER=
export PASSWORD=
curl ${SERVER}/api/v1/configs -u "${USER}:${PASSWORD}" -k |
Parameter Detail
Parameter | Description |
|---|---|
| An administration user with the proper access. |
| The password of the administration user. |
Updating a Configuration
The following cURL template will update the widget definition and/or its name (used referring from 3DX).
| Code Block |
|---|
export SERVER=https://waas.technia.cloud
export CONFIG_ID=
export CONFIG_NAME=
export CONFIG_FILE=
export USER=
export PASSWORD=
export CONTENT_TYPE='Content-Type: multipart/form-data'
curl -XPUT ${SERVER}/api/v1/configs/${CONFIG_ID} -H "${CONTENT_TYPE}" -F "name=${CONFIG_NAME}" -F "config=@${CONFIG_FILE}" -u "${USER}:${PASSWORD}" -k |
Parameter detail
Parameter | Description |
|---|---|
| A numeric identifier of the configuration. Can be found calling list configurations. |
| A string representation of the configuration. Could be changed, used when referring the widget from the “Create additional app” dialog. |
| The configuration file holding the new definition. |
| An administration user with the proper access. |
| The password of the administration user. |
Updating Code resources
To add a custom js resource to use in configurations (e.g. custom dataHandlers) you can push a js file to the server using the following cURL.
| Code Block |
|---|
export SERVER=https://waas.technia.cloud
export COMPANY_ID=
export FILE=
export USER=
export PASSWORD=
export CONTENT_TYPE='Content-Type: multipart/form-data'
curl -XPOST ${SERVER}/api/v1/companies/${COMPANY_ID}/resources -H "${CONTENT_TYPE}" -F "file=@${FILE}" -u "${USER}:${PASSWORD}" -k |
Parameter detail
Parameter | Description |
|---|---|
| A numeric identifier of your company. Where to get this? |
| The js file holding the new resource definition. |
| An administration user with the proper access. |
| The password of the administration user. |
Installation
found under “Platform management” → “Members”.
...
Updates
Lock version? Evergreen?
Components
Technical concept
ComponentsConfiguration