# Getting Started

```{toctree}
:hidden:

getting_started/using_the_powerflc_cmdlets
getting_started/using_the_powerflc_workflows
```

If you are new to powerPLM (powerFLC), topics in this section will help you quickly start getting the best of the product:

- [Using the Cmdlets](</getting_started/using_the_powerflc_cmdlets>)
- [Using Workflows](</getting_started/using_the_powerflc_workflows>)

Before you are able to use your Fusion 360 Manage tenant you have to make sure that the tenant is configured as described below.

## Configuration in Fusion 360 Manage

### Whitelisting the Forge App

Fusion 360 Manage has to be configured to allow communication with your Forge App.

:::{admonition} Create an App
:class: information

If you don't already have a Forge App, please [create an App](<https://forge.autodesk.com/en/docs/oauth/v2/tutorials/create-app/>) for *powerPLM* in your [Forge portal](<https://forge.autodesk.com/>).
:::

In order to allow connecting powerPLM (powerFLC) via your registered apps credentials, Fusion 360 Manage needs to know and allow them.\
This can be done with following steps:

> 1. Open the [My Apps](<https://forge.autodesk.com/myapps>) section of your Forge app and copy the *Client ID* of your app
>
>    > ```{image} /img/forgeapp_clientid.png
>    > :width: 600px
>    > ```
>
> 2. Go to your Fusion 360 Manage Site, click the burger menu on the top left -> *Administration* -> System *Configuration*
>
>    > ```{image} /img/forgeapp_nav.png
>    > :width: 600px
>    > ```
>
> 2. Navigate to your Fusion 360 Manage Site and click on *Administration* → System *Configuration* → *General Settings*
>
>    > ```{image} /img/flc_general_settings.png
>    > :width: 600px
>    > ```
>
> 3. Go to the section *Security Settings* and add the Client ID to the *Whitelist*
>
>    > ```{image} /img/flc_security_settings.png
>    > :width: 600px
>    > ```
>
> 4. Change the setting "*Allow multiple concurrent sessions with the same User ID*" to *Yes*.
>
> 5. Press *Save*

### Workspace Behaviors

It is recommended to disable scripts that are executed automatically on specific operations in the required Workspaces. Otherwise it might lead to errors when executing the configured workflows.\
This can be done with following steps:

> 1. Navigate to your Fusi on Lifecycle Site and click on *Administration* → *Workspace Manager*
> 2. Go to each required *Workspace* and click on *Behaviors*
> 3. Clear the setting "*Scripts to run at item creation*".
> 4. Press *Save*

### Security Settings

The *user* configured to perform the requests on Fusion 360 Manage has to be [active](<http://help.autodesk.com/view/PLM/ENU/?guid=GUID-FE8C2A42-A349-4CB2-9541-67879E2E591E>) in the system.\
In order to perform the required operations for the items in the given Workspaces, the user needs the according [Workspace permissions](<http://help.autodesk.com/view/PLM/ENU/?guid=GUID-F3C22AD5-FC88-4752-BA6B-54051A11E0C7>).\
Therefore grant the required read/write permissions for all the required Workspaces by adding your users to the according [Groups and Roles](<http://help.autodesk.com/view/PLM/ENU/?guid=GUID-C7F1FE63-3093-4B39-B155-0EC0EF0888A2>).

### Attachments

The Fusion 360 Manage workspaces must be configured to allow the user to work with items in the [Attachments Tab](<https://help.autodesk.com/view/PLM/ENU/?guid=UG-ATTTAB-DOWNLOAD>) by assigning the permissions *View Attachments*, *Download Attachments* , *Add Attachments* and *Edit Attachments* .

*Note:* Required by [](</code_reference/commandlets/Add-FLCAttachment>), [](</code_reference/commandlets/Save-FLCAttachment>) and [](</code_reference/commandlets/Get-FLCItemAssociations>) when using *-Attachments* parameter..

### Bill of Materials

[Relationships](<http://help.autodesk.com/view/PLM/ENU/?guid=GUID-3C1B81A3-B5F7-401F-A60A-69B49BB51B12>) to workspaces which contain the according BOM line items must be configured for the [Bill of Materials Tab](<https://help.autodesk.com/view/PLM/ENU/?guid=UG-BOMTAB-BOM>): *Administration→Workspace Manager→\[Workspace\]→Workspace Relationships*.

```{image} /img/vlt_connector_settings_boms_flc_relationship.png
:width: 600px
```

Additionally the required Fusion 360 Manage workspaces must be configured to allow the user to work with items in this Tab by assigning the permissions *View BOM*, *Add to BOM*, *Edit BOM* and *Delete from BOM*.

*Note:* Required for the [Transfer Item BOMs](</workflows/transfer_item_boms>) workflow and all [BOM cmdlets](<code_reference/commandlets:boms>)

### Linked Items / Affected Items

The workspaces must be configured to allow [relationships](<http://help.autodesk.com/view/PLM/ENU/?guid=GUID-3C1B81A3-B5F7-401F-A60A-69B49BB51B12>) to the [Affected Items Tab](<https://help.autodesk.com/view/PLM/ENU/?guid=FLC-APPSTORE-CHANGE-MGMT-AFFECTED-ITEMS-MGMT>) (In non-revisioning workspaces the tab serves as *Linked Items* tab).\
They can be configured via: *Administration→Workspace Manager→\[Workspace\]→Workspace Relationships*.

```{image} /img/flc_manageditems_relationship.png
:width: 600px
```

Additionally the user must have the permission to *View Managed Items* for the according workspaces.

*Note:* Required for the [Change-Management](</workflows/change_management>) workflow, by [Get-FLCItemAssociations](</code_reference/commandlets/Get-FLCItemAssociations>) and the [update-flcitem](</code_reference/commandlets/Update-FLCItem>) *-AffectedItems* parameter.