# ION Actions for Intent

## Helpful Tips:

To view what rules are currently deployed in your environment look at the documentation linked [here](https://manual.firstresonance.io/features/ion-actions). The documentation also outline how to enable or disable the rules if you desire to change them.

## Deployment:

### Step 1: General Integration Setup

* Follow the generic integrations and automations setup how-to page [here](https://manual.firstresonance.io/integrations/deploying-integrations-and-automations). This helps establish your API credentials.

### Step 2: Intent Specific Configuration

* Firstly, you must set up custom attributes in your ION organizational settings menu.
* Create new SELECT type Attributes in the **Part Inventory**, **Parts**, and **Run** objects attribute sections. The attribute must be named identically and IS case sensitive. The options for the select must also be identical for each object.
* When it's setup, the field will look something like below:

  <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FpMLCxo8bEAqb0tTmsxLI%2Fimage.png?alt=media&#x26;token=a13cf2eb-7088-4e60-8411-ead64a296ab4" alt=""><figcaption><p>Parts Inventory Object Attribute Setup</p></figcaption></figure>
* Common names for intent/pedigree tiers in different industries are show in the table below. You can use this as a baseline or populate your own options.

<table><thead><tr><th width="134">Industry</th><th width="192">Highest Intent</th><th>Second Intent</th><th>Lowest Intent</th></tr></thead><tbody><tr><td>Aerospace</td><td>Flight</td><td>Development</td><td>Engineering</td></tr><tr><td>Maritime</td><td>Float</td><td>Soak</td><td>Sink</td></tr><tr><td>Automotive</td><td>Drive</td><td>Qual</td><td>Dev</td></tr></tbody></table>

* Next, setup automation parameters. Descriptions of what are expected in the fields are shown in the image below.  The Pedigree Attribute Key is the Custom Attribute Name you have setup in your ION Organizational settings.

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FvQ6YxhHQ4NceYSpygnUM%2Fimage.png?alt=media&#x26;token=420fefc4-5ee3-4734-8405-cf71833c30ab" alt="" width="563"><figcaption><p>Intent Attributes to Match ION</p></figcaption></figure>

* You will notice one toggle available for this integration. This allows you to specify wether you want the rule enabled or not. If you're deploying for the first time you'll want this toggled on to Enabled/

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FcgUMvVdu4RUBBlW069m4%2Fimage.png?alt=media&#x26;token=3ae6feec-1317-49d4-86a3-491f64bbd248" alt="" width="281"><figcaption></figcaption></figure>

### Step 3: Configuration of Rollout Methodology

The last field you will find on deployment is the toggle below that defines the default intent of parts that haven't had their intent defined.

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FN6Hq4pAtFnEWYLbynFlG%2Fimage.png?alt=media&#x26;token=6e969ecc-bdfc-4080-981f-6a00a6dc9084" alt=""><figcaption><p>Option 1 Selected</p></figcaption></figure>

* Option 1: Halt Assembly of Product Without Intent Defined **ON**
  * Most safeguarded roll out.
  * On deployment, intent of the parent part in a run's mBOM is always assumed to be Tier 1 (FLIGHT in the case of aerospace).
  * The parts getting installed on the run to build the parent part are then assumed to be the lowest tier Tier 3 (ENGINEERING).
  * Thus, effectively blocking the assembly of anything that has not been assigned a tier 1 intent.
* Option 2: Halt Assrmbly of Porduct Without Intent Defined **OFF**
  * Least stringent roll out
  * On deployment, the intent of parent parts in a run's mBOM is always assumed to be Tier 3 (ENGINEERING).
  * The parts getting installed on the run to build the parent part are then assumed to be the lowest tier Tier 3 (ENGINEERING).
  * Thus, any part will be able to be installed on any assembly until intent Tiers are raised.

## Disabling Intent Rules

* To disable any of the intent rules you have deployed you can follow Step 5 on the [ION Actions](https://manual.firstresonance.io/features/ion-actions) page.
* The change you'll want to make in the mutation is converting the "enabled" field from true to false.
