Add-FLCAttachment

Adds an Attachment to an existing Item in Fusion Lifecycle.

Add-FLCAttachment -Workspace <String> -ItemId <Long> -Path <FileInfo> [[-Title] <String>] [[-Description] <String>] [<CommonParameters>]

Add-FLCAttachment -InputObject <PSObject> -Path <FileInfo> [[-Title] <String>] [[-Description] <String>] [<CommonParameters>]

Type Name Description Optional
StringWorkspaceThe name of the workspace that contains the Itemno (optional when InputObject is used)
LongItemIdThe ID of the Item for which the attachment should be addedno (optional when InputObject is used)
ItemInputObjectThe Fusion Lifecycle Item for which the attachment should be added. The argument accepts pipeline inputno (optional when Workspace and ItemId are used)
FileInfoPathThe Path to the file which should be uploaded and attached to the item. no
StringTitleThe title to use for the attachment. If no title is provided, the filename without extension will be used.yes
StringDescriptionA description for the uploaded attachmentyes

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

The -Path arguments accepts all file types to be uploaded as attachment although only specific file types can be viewed with the Viewer in Fusion Lifecycle.
A list of the file types that can be viewed in Fusion Lifecycle can be found here.

When an attachment with the same Title already exists on the item a new version of the attachment is added.
Optionally with the -Title argument you can upload the same attachment using a different title.

Once the attachment is added to an Item the Title and Description can not be changed anymore.

To use the examples below a Fusion Lifecycle PLM demo Tenant is required:

Add an Attachment to an Item

Connect-FLC -Tenant 'your_tenant_name' -ClientId 'your_client_id' -ClientSecret 'your_client_secret' -UserId 'your_email@example.com'

$attachment = Add-FLCAttachment -Workspace 'Products' -ItemId 8684 -Path 'C:\Temp\Injection Molding Machine.dwf'

Add an Attachment using a specific title

Connect-FLC -Tenant 'your_tenant_name' -ClientId 'your_client_id' -ClientSecret 'your_client_secret' -UserId 'your_email@example.com'

$item = (Get-FLCItems -Workspace 'Documents' -Filter '"Final Assembly Installation"')[0]

$item | Add-FLCAttachment -Title 'Instructions' -Path '.\Documents\C300NO678S.pdf' -Description 'Documentation for Installation'

<#
Title       : Instructions
ItemId      : 8644
Workspace   : Documents
#>

Error handling, analyze why adding attachment failed using $Error

Connect-FLC -Tenant 'your_tenant_name' -ClientId 'your_client_id' -ClientSecret 'your_client_secret' -UserId 'your_email@example.com'

$attachment = Add-FLCAttachment -Workspace 'Suppliers' -ItemId 5839 -Path 'C:\Temp\Picture.png'

if(-not $attachment){
   $Error[0].Exception #Returns "FORBIDDEN: User Qpdb4: access ADD_ATTACHMENTS denied..."
}