parts and trace.md

Parts Library

Part objects in ION represent abstractions that carry information about a particular part, while the physical parts themselves are part inventory objects. The part objects dictate the mBOM, revision, supplier part number, tracking type, lead time, unit of measure, and other additional attributes about a part that get carried over to your factory. A part is a unique combination of Part Number and Revision.

What is a part, and when should I create a Part?

A part represents a unique combination of parts and processes that can exist as a standalone product in your inventory. We recommend creating a part if it meets the following criteria:

Here are example use cases:

When we DO NOT recommend creating a part:

Design Changes: When to Iterate on Part Numbers, Revisions, and mBOM Versions

There are many ways to iterate on your designs in ION; part number changes, new revisions, or iterating on mBOM versions. This guide is to help propose clarity so you know how to get the most out of the system.

Change you’re makingForm / Fit / FunctionWhat to updateTypical examplesDownstream impact
Major change: different form/ fit/functionChangesNew Part NumberNew connector type; new envelope size; performance class changeSeparate inventory & demand; new mBOM lineage
Controlled design tweak (interchangeable)SameNew RevisionTightened tolerance; material callout change; finish specOptionally allow kitting older revs if policy enabled; can auto-flow into mBOMs via automation
Build definition change onlySameNew mBOM VersionAdd/remove child, update qty/substitute, change refdesaBOM + Autoplan use latest Released version

Revisions and Revision Schemas

ION is intentionally flexible when it comes to part revisions, given that every customer has a different schema. In order to set your revision schema, navigate to the parts organization settings and set the format of the revision schema.

You can set the schema to allow overflow, which defines whether an error should be raised when the max iteration of a revision scheme is reached, or if it should overflow to the next available value. For example, you can determine if Z is the last revision in an alphabetical revision schema, or if it should overflow to AA.

The default boolean will automatically mark all newly created parts with this revision scheme unless overriden.

If no revision or revision schema is given, then the part defaults to Rev A. If a revision schema is given, then the part defaults to the first value of that revision schema.

Create a New Part Revision

A revision can be generated from any part, there are no restrictions requiring the revision to be generated from the current latest revision. For example if our part "ion-13" has existing revisions A and B, then a third revision C can be generated from either existing revision A or B. All information in the new revision is copied over from the old revision unless explicitly overridden in the mutation input. The new revision will be the next valid alphabetic character from the part's latest revision. If the part's latest revision is C, then the new revision will be D. If the part's latest revision is Z, then the new revision will be AA. Returns the newly created part object with the updated revision.

Archiving a Part

When archiving a part, ION will prevent any new inventory of that part from being created. Existing inventory will remain unaffected by archiving a part. This will also remove archived parts from dropdowns (i.e. part selection on a run or purchase order). You may unarchive a part by finding them using this filter on the parts library page.