Add-FLCItem

Creates a new Item in the specified workspace in Fusion 360 Manage.

Syntax

Add-FLCItem -Workspace <String> [[-Properties] <Hashtable>] [<CommonParameters>]

Parameters

Type

Name

Description

Optional

String

Workspace

The name of the workspace where the item should be added to

no

Hashtable

Properties

The properties for the item being created, which will be set for the according fields in Fusion 360 Manage

yes

Return type

Item ← on success.
empty ← on failure. Exception/ErrorMessage can be accessed using $Error.

Remarks

The -Properties arguments allows passing the name and value for all the fields which should be set when creating the Item.
For those fields which are not present in the Hashtable the value is set to a default value configured in Fusion 360 Manage.

Only fields which where assigned either to a Section or to a Matrix in the Item Details Form in Fusion 360 Manage can be passed.
Addionally they must have one of the following Field types:

  • Integer

  • Float

  • Money

  • Date

  • Single Line Text

  • Paragraph

  • Paragraph w/o Line Breaks

  • Check Box

  • Image

  • Email

  • BOM UOM Pick List

  • Defined Pick List - Single Selection

  • Defined Pick List - Multiple Selection

Maximum number of characters

When the passed value for a Field exceeds the in Fusion 360 Manage configured maximum length, the value gets trimmed to its maximum length.

Examples

To use the examples below a Fusion 360 Manage demo Tenant is required:

Create a new Item

Connect-FLC -Tenant 'your_tenant_name' -ClientId 'your_client_id' -ClientSecret 'your_client_secret' -UserId '[email protected]'

Add-FLCItem -Workspace 'Training'

<#
Id                      : 9009
Workspace               : Training
RootId                  : 9009
Number                  : TRN000003
Document Number         :
Trainee Name            :
Job Title               :
Primary Trainer         :
Training Start          :
Training End            :
Qualification Completed :
Comments                :

Create an Item with properties

Connect-FLC -Tenant 'your_tenant_name' -ClientId 'your_client_id' -ClientSecret 'your_client_secret' -UserId '[email protected]'

$item = Add-FLCItem -Workspace 'Items' -Properties @{
    'Title' = 'powerPLM is fun!'              #Field Type: Single Line Text
    'PDM Last Modification Date' = (Get-Date) #Field Type: Date
    'Estimated Cost'  = 9000.5                #Field Type: Money
    #'My custom checkbox' = $true             #Field Type: Check Box
}

Create an Item with Pick List fields

Connect-FLC -Tenant 'your_tenant_name' -ClientId 'your_client_id' -ClientSecret 'your_client_secret' -UserId '[email protected]'

$item = Add-FLCItem -Workspace 'Audits' -Properties @{
    "Unit of Measure" = "Cubic Centimeter"                  #Field Type: BOM UOM Pick List
    "SPC Score" = "3 - Advanced"                            #Field Type: Defined Pick List - Single Selection
    "Audit Team" = @("Thomsen, Dane", "Bernat, Lauran")     #Field Type: Defined Pick List - Multiple Selection
}

Create an Item with Paragraph and Image fields

Connect-FLC -Tenant 'your_tenant_name' -ClientId 'your_client_id' -ClientSecret 'your_client_secret' -UserId '[email protected]'

$imageBytes = Get-Content -Path 'thumbnail.jpeg' -Encoding Byte -Raw

$item = Add-FLCItem -Workspace 'FMEA Analysis' -Properties @{
    "Type of FMEA required" = "System FMEA"               #Field Type: Defined Pick List - Single Selection
    "Request Date" = (Get-Date)                           #Field Type: Date
    "Request Notes" = "<p><b>Renewe next time!<b></p>"    #Field Type: Paragraph
    "Process or Product Image" = $imageBytes              #Field Type: Image
}

Error handling, analyze why Item could not be created using $Error

Connect-FLC -Tenant 'your_tenant_name' -ClientId 'your_client_id' -ClientSecret 'your_client_secret' -UserId '[email protected]'
$item = Add-FLCItem -Workspace 'Not existing Workspace'

if(-not $item){
   $Error[0].Exception #Returns "No Workspace found with the given name: Not existing Workspace"
}