# Using Workflows

## Transferring the BOM of a Vault Item to Fusion 360 Manage

With powerPLM (powerFLC) you can automate different scenarios when working within Vault Client and exchanging data with Fusion 360 Manage, for instance transferring the metadata of a Vault Item and its Bill Of Material information to Fusion 360 Manage.\
This is very simple because powerPLM (powerFLC) offers the [](</workflows/transfer_item_boms>) workflow example. So all you have to do is:

## Guarantee existence of prerequisite workspace *Items*

Autodesk's default workspace *"Items"* is already configured to align with the [](</workflows/transfer_item_boms>) workflow.\
This workspace is available in all current Fusion Manage tenants.

If you don't find this workspace in your tenant, simply install it throught *"Administration -> Template Library"*:
```{image} /img/getting_started/appstore_items_workspace.png
:width: 700px
```

> In this case, you also need to manually perform the following configuration steps:
>
> 1. In the [Security tab: Assign the "Items [R/W]" role to your user's group](<getting_started:security settings>).\
>    This makes the new "Items" workspace visible in your menu.
> 2. In the [Workspace Manager tab: Add the "Items" workspace as a new "Managed Items Tab" relationship to the "Change Orders" workspace](<getting_started:linked items / affected items>)\
>    (required for the [](</workflows/change_management>) workflow)
> 3. Usually there is already a "Product Development" category in Fusion Manage menus.\
>   The new "Items" workspace can then be found under *"Product Development_1"*. Optionally, you can move it via *Administration -> System Settings -> Main Menu Designer*.

## Connect Vault with Fusion 360 Manage

Please ensure that your [tenant is properly configured](<getting_started:configuration in fusion 360 manage>) to allow connections from the Vault Client and your Job Processor.

Then open the Vault Client and [enter the required Fusion 360 Manage Credentials](<workflows:configuration>) for authentication.

:::{note}
The system user configured here is not used for the item transfer on the Job Processor.\
Instead, Items and BOMs are created or updated in Fusion Manage under the name of the user who released the Item in Vault and queued the workflow job.

Therefore, an [email address must be configured](<workflows:configuration>) for all **Vault users that corresponds to accounts in your Fusion Manage** tenant.\
Assign the user accounts to the **Engineering** group!
:::

```{image} /img/getting_started/vlt_tools_settings.png
:width: 430px
```

```{image} /img/getting_started/vlt_tenant_settings.png
:width: 300px
```

[Import](<configuration_manager:import / export workflows>) the configuration using following file: *%ProgramData%\\coolOrange\\powerJobs\\Jobs\\Sample.TransferItemBOMs.json*.\
If required adapt the [workflow settings](<workflows:configuration>) or create the properties in Vault and/or FLC that are missing.\
Finally press *Save*.

```{image} /img/getting_started/import_workflow.png
:width: 460px
```

```{image} /img/getting_started/powerflc_configuration_manager.png
:width: 400px
```

## Trigger Job for Workflow

Configure a [Vault lifecycle state transition](<https://support.coolorange.com/kb/how-to-add-a-job-on-lifecycle-transition>) for items to trigger the Job Type: **Sample.TransferItemBOMs** on a lifecycle change.\
Afterwards select an Item in Vault and change its lifecycle state to the respective state.

```{image} /img/workflows/vault_lifecycle_customjob_transfer_item_bom.png
:width: 450px
```

```{image} /img/getting_started/vault_item_change_state.png
:width: 420px
```

## Job Processor

In order to execute the job you have to start the Job Processor.\
We recommend using the **powerJobs Processor** which can be started using the shortcut on the Desktop or in the StartMenu.

```{image} /img/powerjobsprocessor_executing_job.png
:width: 500px
```

## Result

After the Job Processor has finished processing the Job, the item and its [mapped Vault Properties](<workflows/transfer_item_boms:item details>), [Attachments](<workflows/transfer_item_boms:attachments>) and [Bill of Materials](<getting_started:bill of materials>) should habe been successfully transferred to your "Items" workspace in Fusion Manage:

```{image} /img/getting_started/transferred_flc_item.png
:width: 900px
```

:::{note}
To make the **Vault Thick** and **Thin Client buttons** work, you have to customize the calculated *"Actions"* field in Fusion Manage under **Administration -> WorkspaceManager -> Items -> Item Details Tab**.\
Replace the text `your-server-name` in the *"Computed Field Formula"* with the correct **name of your ADMS host**.
:::