Skip to main content

Supply - Related Asset

Updated today

This template manages the relationships between supply items and company assets. It lets you define which parts and materials each asset uses and in what quantities.

What Is It For

Use this template to:

  • Associate supply items with specific assets, defining how many units of each item the asset uses

  • Remove existing associations between items and assets

  • Replace the asset in an existing association with a different asset

  • Keep existing associations unchanged (useful for validation or review)

Each row in the file represents a single operation on one item-asset relationship.


Import and Export

This template supports both import and export.

  • Export downloads all current associations between supply items and assets, showing which items are linked to which assets and the quantities involved.

  • Import processes operations (add, remove, replace, keep) on item-asset relationships. Each row must reference an existing item and an existing asset.

  • Export from import is available after a successful import and downloads the imported data in spreadsheet format.


Column Reference Table

Column

Required

Type

Allowed Values

Item ID

Yes

Text

Existing supply item ID

Asset ID

Yes

Text

Existing asset ID

New Asset ID

Conditional

Text

Existing asset ID (required only for replace operation)

Amount

Conditional

Number

Quantity (required for add and replace operations)

Operation

Yes

Dropdown

add, remove, replace, keep


Columns in Detail

Item ID The unique identifier of the supply item. The item must already exist in the system. Required for every row.

Asset ID The unique identifier of the asset. The asset must already exist in the asset tree. Required for every row.

New Asset ID The unique identifier of the replacement asset. Only used and required for the replace operation. The new asset must also exist in the system. Leave empty for all other operations.

Amount The quantity of the item associated with the asset. Required for add and replace operations. For remove and keep operations, this field is ignored and can be left empty.

Operation The type of action to perform on the item-asset relationship. Required for every row. Allowed values:

  • add -- Creates a new association between the item and the asset with the specified quantity

  • remove -- Removes the existing association between the item and the asset

  • replace -- Replaces the asset in the association with the asset specified in New Asset ID, keeping the item and updating the quantity

  • keep -- Leaves the existing association unchanged; useful for validating that the relationship exists without modifying it


Custom Fields

This template does not support custom fields.


Tips

  1. Make sure all Item IDs and Asset IDs exist in the system before importing.

  2. For replace operations, both Asset ID (the current asset) and New Asset ID (the replacement) must exist.

  3. The Amount field is required for add and replace but ignored for remove and keep.

  4. Use the keep operation to verify that existing relationships are correctly set up without making any changes.

  5. Group similar operations together in the file for easier review.

  6. Export the current associations first to review what already exists before making changes.

  7. Run validation before importing to catch missing IDs or invalid operations early.


Example Rows

Add new associations

Item ID

Asset ID

New Asset ID

Amount

Operation

ITEM-001

ASSET-123

4

add

ITEM-002

ASSET-123

2

add

ITEM-003

ASSET-456

10

add

Replace the asset in an association

Item ID

Asset ID

New Asset ID

Amount

Operation

ITEM-001

ASSET-123

ASSET-789

4

replace

This moves the association of ITEM-001 from ASSET-123 to ASSET-789 with a quantity of 4.

Remove associations

Item ID

Asset ID

New Asset ID

Amount

Operation

ITEM-002

ASSET-123

remove

ITEM-003

ASSET-456

remove

Keep existing associations for validation

Item ID

Asset ID

New Asset ID

Amount

Operation

ITEM-001

ASSET-789

keep


Frequently Asked Questions

What happens if the Item ID or Asset ID does not exist? The import will fail for that row. Make sure all IDs reference items and assets that are already registered in the system.

Can I add an association that already exists? Attempting to add a duplicate association will result in an error. Use replace or keep instead if the association already exists.

What does the keep operation do? It validates that the relationship exists without changing anything. This is useful when reviewing or auditing existing associations.

Is the Amount required for remove? No. For remove and keep operations, the Amount field is ignored. You can leave it empty.

Can I replace only the quantity without changing the asset? To change only the quantity, remove the existing association and add a new one with the updated amount.

What happens to the quantity when I use replace? The replace operation sets the quantity to the value in the Amount column for the new asset. The old association is removed.

If you have questions, contact support or refer to the platform documentation.

Did this answer your question?