Skip to main content

​
Overview

The Tools importer bulk-creates or revises tools. In ION, a tool is a part with the tool part type, so this importer follows the same revision flow as the Parts importer but exposes a narrower, tool-relevant column set. Two things are set automatically on every row:
  • Part type is always tool.
  • Tracking type is always serial, because tools are serial-tracked. Including a tracking_type column in the CSV is rejected.

​
Columns

​
Duration format

The maintenance_interval column accepts a duration written in days, hours, and minutes. Use the units d, h, and m, in that order, with optional spaces between terms. Each unit is optional. The value is rounded down to the nearest minute. A plain number with no unit is read as a number of seconds. Valid values include: The Review step flags a value that uses any other unit (such as weeks or seconds), lists the units out of order, or is otherwise unparseable.

​
Revisions

Revision behavior mirrors the Parts importer: rows with an explicit revision create or update that exact (part_number, revision), while rows that omit revision either initialize a new tool at the scheme’s first value or auto-revise an existing tool from its latest revision.

​
Subtypes

The subtypes column attaches one or more subtypes to the tool. Subtype names are matched case-insensitively; names that don’t exist yet are created automatically, so you can bootstrap your subtype list from the same CSV. Associations that already exist are skipped, keeping re-imports idempotent.

​
Custom attributes

Any column not in the standard list above is treated as a custom attribute on the tool. Custom attribute columns must match a configured attribute key for your organization; unknown columns cause a validation error.