Provisioning

Creating an Single Asset

Note

Only administrators and authorized users can create assets in the ThingWorx Asset Manager.

To create an asset, complete the following steps.

In the ThingWorx Asset Manager, click Create Asset under Provisioning.

Enter a unique name for the asset in the Name field.

Note

Once the asset has been saved, this field cannot be edited.

(Optional) Enter a description.

Select an asset type from the Asset Type (ThingTemplate) drop-down.

Note

Once the asset has been saved, this field cannot be edited.

Select a resource provider thing shape from the Resource Provider Thing Shape drop-down. For more information on resource providers, see Resource Providers.

(Optional) Select a thing shape.

Note

Use this field if want to add an extra thing shape. If you want to add more than one thing shape, it must be done in Composer.

(Optional) Assign the asset model tags.
Click Save. The Editable Property Values page appears. Update the desired properties and click Save.

Loading Assets in Bulk

Two new services, Validate and Import, are now available to validate and bulk load assets in the PTC.Asset.BulkImporter resource.

Note

The Import service only supports the creation of assets.

The services are available from within Composer. Both services have the same signature, and return a summary information info table.

Note

Detailed warnings and errors are only output to the application log.

The following is a list of Inputs for the service.

file repository
file path
asset type (thing template)
resource provider thing shape (associates the asset to the resource provider)
thing shape (additional, optional thing shape)
model tags

The following file types are supported.

CSV—comma separated values
TSV—tab separated values
XLS and XLSX—Microsoft Excel spreadsheets

The import type is determined by the file extension (csv, tsv, xls, xlsx). CSV files are assumed to be UTF-8 encoded and use ',' as the record separator and '"' for quote character. TSV files are assumed to be UTF-8 encoded as well and use tab as the record separator.

The following column headings are supported.

name (required thing name for the new asset)
description (optional description of the new asset)
Zero or more property fields based on the flattened list of properties defined on the asset type and optional thing shape

Property columns are optional. The column headings must match the property names exactly. For the property values, the ThingWorx default String conversions are used for the default basetypes. This means that values such as datetime must be in the format that ThingWorx expects. If a value is empty, it is treated as null.