Uploads or references a file as an attachment to to an SDI in the application.

sdcid

Identifier of the SDC for the SDI to which you are adding the Attachment.

Yes

keyid1

Identifier of the SDI in the specified SDC.

Yes

keyid2

Second part of the identifier of the SDI when the primary key is formed from multiple columns.

Only for multi-key SDCs.

keyid3

Third part of the identifier of the SDI when the primary key is formed from multiple columns.

Only for multi-key SDCs.

attachmentclass

The attachment class to apply to the new Attachment.

No.

filename

Name of (and path to) the file to be linked. Use this property or sourcefilename but do not use both.
When provided, this file will not be uploaded. A reference pointer to the file will be stored as an attachment to the SDI.
Example: \\fileshare\attachment.pdf.
In this example, 'attachment.pdf' must always be accessable by all servers in a cluster in the same way.
In some cases, unsafe characters such as backslash may need to be ascii-encoded when this action is called.

Yes - when a sourcefilename is not provided.

This path must be allowed through configuration of a node in the FileLocationPolicy. See also the property 'filelocationpolicynode'

sourcefilename

Name of (and path to) the file that will be uploaded to LabVantage as an attachment.

Yes - when a filename is not provided.

Use this property or filename but do not use both. This file will be uploaded to LabVantage and stored into a repository.
This path must be allowed through configuration of a node in the FileLocationPolicy. See also the property 'filelocationpolicynode'

type

Determines how the file containing the Attachment is saved. Possible values:
R = (meaning "Reference") saves only the File Name to the database. This is a reference to the attachement.
S = (meaning "Store") uploads a copy of the file and stores the copy to the appropriate attachment repository.

Yes

Use 'R' when supplying a 'filename'. Use 'S' when supplying a 'sourcefilename' See also the property 'filelocationpolicynode'

description

Textual description that will be shown to users as an explaination for or the purpose of this attachment.

Yes

applylock

Accepts Y or N.
This determines if the SID will be locked during Action processing. If an attempt is made to lock the SDI but a lock cannot be obtained, the action will fail.

No

index

Determines whether or not (Y/N) the attachment should be indexed.

No

uploadto

Assumes that a sourcefilename is provided. The file will be stored to this location.

No

In a clustered enviornment, make sure all nodes of the cluster can access this same location in the same way.
If no uploadto is provided, an attachment repository is used.

oleclass

OLE class name. This applies only to OLE links made in LVX Maintenance and Maintenance Grid Pages.

No

eventnotify

Determines whether or not (Y/N) an event is posted on the ToDo List when the Action executes.

As of LabVantage version 7, Event Notify actions are no longer generated.

documentfield

Reference to a document file field. This property is typically only used in the Graphical Action Processor for file field processing.

No

attachmentrespositoryid

The repository id for the storage of the attachment. If left blank then it will use the attachment policy rules to set the repository.

No

attachmentrespositorynodeid

The node of the attachment repository. Only required when providing an attachment repository. If left blank, then will default to Sapphire Custom.

No

filelocationpolicynode

The node of the FileLocationPolicy used to determine if the source file is in an allowed location and if the file type is allowed.

No

This Action inserts a new record in the SDIAttachment table.