Importing Assets

Prepare CSV or TSV asset rows in the import format, import them to create or update assets, and verify and group the results.

Import creates or updates many assets at once. You paste comma-delimited (CSV) or tab-delimited (TSV) rows into the Import Assets dialog in the Assets portal.

The Import Assets dialog, with the format product id (required), sn (required), name, configuration, groups, and an example row in the text box.

The Import Assets dialog, showing the row format

Preparing the Data

Each row is one asset, with its values in this order:

ColumnRequiredValue
Product IDYesThe ID of the asset's copilot, or a name in the copilot's alias list. See Aliases.
SNYesThe asset's serial number.
NameNoThe asset's name.
ConfigurationNoData items from the copilot's data dictionary, as key=value pairs separated by commas, such as make=AZ Machine Works,model=AM-650. A key with a dot, such as fleet.unit, puts the value in a data object named fleet on the asset. See Asset Configuration.
GroupsNoThe asset groups the asset belongs to, separated by commas, such as AZ Copper Works,US Customers. A group that doesn't exist yet is created. See Groups.

Build the rows in a spreadsheet, one column per value, as in the example below. A heading row is skipped. Importing a serial number that already exists updates that asset instead of creating a new one. Copy the rows and paste them into the dialog: rows copied from a spreadsheet are tab-delimited (TSV), so the commas inside a Configuration or Groups cell stay in that cell.

🚧

Caution

An import runs in the account you are signed in to. Suppliers and customers use the same format, but a customer import, typically used to give assets their names and groups, should only be run in the customer's account.

Example

This example adds four AM-650 haul trucks to the Copilot (Truck) copilot, whose product ID is 88307. Each truck gets two data items from the copilot's data dictionary, make and model, and belongs to two asset groups: the customer group AZ Copper Works, and US Customers, a new group that the import creates.

PRODUCTSNNAMECONFIGURATIONGROUPS
88307B45102_V12Haul Truck - V12 (Pit 3)make=AZ Machine Works,model=AM-650AZ Copper Works,US Customers
88307B45117_V16Haul Truck - V16 (Pit 3)make=AZ Machine Works,model=AM-650AZ Copper Works,US Customers
88307B45240_V12Haul Truck - V12 (Pit 5)make=AZ Machine Works,model=AM-650AZ Copper Works,US Customers
88307B45311_V16Haul Truck - V16 (Pit 5)make=AZ Machine Works,model=AM-650AZ Copper Works,US Customers

Pasted into the dialog, with the heading row:

The Import Assets dialog with the heading row and four Copilot (Truck) asset rows pasted in.

Four haul trucks pasted into the Import Assets dialog

Import Results reports four assets created. US Customers is created with the first truck, and each truck is added to AZ Copper Works and US Customers:

Import Results showing 4 assets created and 1 group created, with a row for each truck and its messages.

Import Results: four assets and one group created

The four trucks then appear in the Assets list with both groups:

The Assets list with the four imported haul trucks, each in the AZ Copper Works and US Customers asset groups.

The imported trucks in the Assets list

Updating Assets

Importing the same serial numbers again updates those assets. This import adds a fleet object to each truck, with its unit number, site, and in-service date:

PRODUCTSNNAMECONFIGURATIONGROUPS
88307B45102_V12Haul Truck - V12 (Pit 3)make=AZ Machine Works,model=AM-650,fleet.unit=HT-301,fleet.site=Pit 3,fleet.in_service=2026-01-15AZ Copper Works,US Customers
88307B45117_V16Haul Truck - V16 (Pit 3)make=AZ Machine Works,model=AM-650,fleet.unit=HT-302,fleet.site=Pit 3,fleet.in_service=2026-02-02AZ Copper Works,US Customers
88307B45240_V12Haul Truck - V12 (Pit 5)make=AZ Machine Works,model=AM-650,fleet.unit=HT-501,fleet.site=Pit 5,fleet.in_service=2026-03-10AZ Copper Works,US Customers
88307B45311_V16Haul Truck - V16 (Pit 5)make=AZ Machine Works,model=AM-650,fleet.unit=HT-502,fleet.site=Pit 5,fleet.in_service=2026-04-21AZ Copper Works,US Customers
The Import Assets dialog with the four trucks again, now with fleet.unit, fleet.site, and fleet.in_service in their configuration.

The same trucks re-imported with fleet data

Import Results reports no assets created and four updated:

Import Results showing 0 assets created and 4 updated, with Updated asset as the message for each truck.

Import Results: four assets updated

On the asset's page, Configuration shows fleet as its own group, the same way it shows the values of the Component (Engine) component:

The Configuration section of Haul Truck - V12 (Pit 3), with make and model under Copilot (Truck), the Component (Engine) group collapsed, and the fleet group open with site Pit 3, unit HT-301, and in_service 2026-01-15.

The fleet values as their own group in Configuration

Importing the Data

  1. Sign in to the account the assets belong to and open the Assets portal.
  2. Click Import in the top-right corner of the page.
  3. Copy the rows from your spreadsheet, CSV, or TSV file.
  4. Paste them into the Import Assets box.
  5. Click Import.
  6. Review Import Results: the number of assets and groups created or updated, and a row for each asset with its messages. Messages shows the rows with messages, and All shows every row. Use Download or Copy to keep the results.
  7. Click OK.

The assets are added to InSkill and become available in the Assets portal.

Verifying Imported Assets

After importing, verify that the assets appear correctly. The search box finds assets by name or serial number; it is a plain text search on those two fields only.

To find assets by their data values or notes, click Filters. Under Search configuration, enter a key and value, such as fleet.site and Pit 3, and click Apply. Add Item adds another key and value, and Search notes searches the assets' notes. Clear Filters removes the filters.

The Filters panel in the Assets portal with the key fleet.site and the value Pit 3, and the two Pit 3 trucks in the list.

Filtering assets by a configuration value

Assigning Assets to Groups

📘

Note

Groups are created and assigned automatically if they are included in the import. The steps below are for assigning them manually.

You can assign an asset to a group from either side of the relationship.

From the asset:

  1. In the Assets portal, open Assets.
  2. Select the asset you want to add to a group and click Edit.
  3. Under Asset Groups, search for the group.
  4. Select the group and click Save.

From the group:

  1. In the Assets portal, open Groups.
  2. Select the group you want to add the asset to and click Edit.
  3. Under Assets, search for the asset.
  4. Select the asset and click Save.

Assigning Asset Groups to Teams

Follow these steps to give a team member access to an asset group:

  1. In the Admin portal, open Team.
  2. Select the team member and click Edit.
  3. Under Asset Groups, search for the group you want to assign.
  4. Select the group and click Save.

Common Errors and Troubleshooting

Error messageCauseSolution
Missing required columnsA row is missing the product ID or serial number.Make sure every row starts with the product ID and serial number.