Import the Extension
Import Permissions Settings
Beginning with the 8.3.5 release, in order to import the
Analytics Extension into
ThingWorx, a set of Extension import permissions must be enabled in the
platform-settings.json file. These permissions might already have been enabled during
ThingWorx installation and configuration. However, if you are unable to perform the steps in the
Import section below, ensure that the following minimum parameters have been set in the
platform-settings.json file:
{
"PlatformSettingsConfig": {
...
"ExtensionPackageImportPolicy": {
"importEnabled": true,
"allowEntities": true,
"allowExtensibleEntities": true,
"allowJarResources": true,
"allowJavascriptResources": true,
"allowCSSResources": true
}
...
}
For information about importing extensions into
ThingWorx, see
Importing Extensions in the
ThingWorx Help Center. For detailed information about the
platform-settings.json file, see
platform-settings.json Configuration Details.
Before Importing
Before importing
Analytics Extension into
ThingWorx, complete the following tasks and then continue with the
Import section below.
• Locate the extension zip file in the downloaded
Analytics Extension software package files. You will need the following zip file for the import:
ThingWorx-Analytics-<n-n>-Extensions.zip
• If
Analytics Extension is currently deployed and you are re-importing the files, delete the previously imported extension files. For more information, see
Remove the Extension.
Import
To import the Analytics Extension into ThingWorx, complete the steps below.
1. Log into ThingWorx Composer as an administrator.
2. In the navigation bar on the left, click the
Import/Export icon (
) and select
Import.
The Import dialog box opens.
3. In the Import Option field, select the Extension.
4. Click Browse and navigate to the extension zip file, ThingWorx-Analytics-<n-n>-Extensions.zip, which was downloaded as part of the Analytics Extension software download. Click Open.
5. When the Import dialog box is redisplayed, click Validate.
The Validation Results are displayed.
6. Click Import.
The extension file is imported and the Installation Results are displayed.
| If any import failure messages are displayed, use the information provided in the message to resolve the error before proceeding. |
7. Click Close to close the import window. You will be prompted to refresh Composer.
8. Click Yes.
The extension import is complete.
9. If applicable, use one of the following procedures to re-import certain files into ThingWorx Composer:
| This step is only necessary for Analytics Builder 9.2.x and earlier. In 9.3 and later, the filter definitions are stored in the database and no importing or re-importing is necessary. |
This step is only necessary when you are re-importing
Analytics Extension and you have both, deleted a previous set of extension files, and exported an Analytics Builder filter definitions file or Analytics Manager data files before deleting the previous extension files (see
Remove the Extension).
10. To verify that the import was successful, click the
Manage icon (
) on the left and select
Installed Extensions from the bottom of the
Manage menu. Ensure that the imported components appear in the
Installed Extension Packages table on the right.
Check the appropriate section below as per your component:
Analytics Builder
File Name* | Description |
ThingWorx_Analytics_Console_Extension | This extension contains the ThingWorx Analytics console mashup and related artifacts to provide a single launch point for all ThingWorx Analytics applications. |
ThingWorx_Analytics_Builder_Extension | This extension contains the mashup and related artifacts for the Analytics Builder application. |
ROCChart_ExtensionPackage | This extension contains the ROC Chart widget that allows the Analytics Builder to display ROC charts on the Models Results page. |
Distributionbar_ExtensionPackage | This extension contains the Distribution Bar widget that allows the Analytics Builder to visualize the strength of a each signal on the Signals page. |
Rangeslider_ExtensionPackage | This extension contains the Rangeslider widget that allows the Analytics Builder to provide controls for limiting the list of signals displayed on the Signals page. |
LogoutButton | This extension contains the Logout Button widget that allows the Analytics Builder to provide a Sign Out button in the tool bar at the top of each page. |
FileUploadExt_ExtensionPackage | This extension contains the File Upload Extended widget that allows the Analytics Builder to handle uploaded data and metadata files. |
AnalyticsSmartGrid_ExtensionPackage | This extension contains a grid widget that provides more flexible table grid functionality. |
Analytics Manager
File Name | Description |
ThingWorx_Analytics_Console_Extension | This extension contains the ThingWorx Analytics console mashup and related artifacts to provide a single launch point for all ThingWorx Analytics applications. |
analysisprovider-extension | This extension contains the Analytics Manager framework and the artifacts associated with out-of-the-box packaged and directly instantiable connectors. This extension also contains all user interface elements for administering the Analytics Manager framework. |
analysisdeps-extension | This extension contains all third-party dependencies that the Analytics Manager framework uses. |
analyticsserverconnector-extension | This extension contains the TW.AnalysisServices.AnalyticsServer.AnalyticsServerConnector connector and artifacts that are used to connect with the prediction microservice in the Analytics Server to perform predictive scoring. |
clusterbase-extension | This extension is used for elastic resource management in the Analytics Manager framework. |
twxarchiver-extension | This extension is used to achieve the archiving feature in Analytics Manager. |
mathcadconnector-extension | This extension is used only if you want to execute Mathcad-based computations. |
capacitymgmt-extension | This extension is used to achieve the flexible scaling capabilities in the Analytics Manager framework. |
11. Continue with one of the following: