AMTrigger - SharePoint

Description

When a task is triggered, a pre-named (or fixed field) dataset called AMTrigger is created and populated with a collection of data related to the event or condition that initially triggered execution. AMTrigger is a standard Automate dataset which can be used within a task to examine particular characteristics about the initiated trigger, such as the type of event that activated the trigger, when it occurred and  what computer it occurred on.

Parameters

The total number of fields that AMTrigger creates during runtime and what they are named depends largely on the trigger that launched the task. Each trigger contains its own set of unique AMTrigger values. The table below lists the AMTrigger values that relate to the SharePoint trigger. For more details about an individual AMtrigger value, click the associated link.

Name

Data Type

Return Value

AMTrigger.Action

Text

Returns the action that was fired off the trigger.

AMTrigger.AfterURL

Text

Returns the AfterURL path. When moving or renaming an item, BeforeURL referes to the original path/file name and AfterURL refers to the new path/file name. For example, if moving /share/reports/log.txt to /share/reports/log_results/log.txt, BeforeURL refers to: /share/reports/log.txt and AfterURL refers to /share/reports/log_results/log.txt.

AMTrigger.BeforeURL

Text

Returns the BeforeURL path. When moving or renaming an item, BeforeURL referes to the original path/file name and AfterURL refers to the new path/file name. For example, if moving /share/reports/log.txt to /share/reports/log_results/log.txt, BeforeURL refers to: /share/reports/log.txt and AfterURL refers to /share/reports/log_results/log.txt.

AMTrigger.FieldName

Text

Returns the field name (column name) of a column in a SharPoint list.

AMTrigger.FieldXML

Text

Returns the XML representation of a list field (column).

AMTrigger.File

Text

Returns the name of the file in a SharPoint list.

AMTrigger.GroupID

Text

Returns the globally unique identifier (GUID) of the group.

AMTrigger.GroupName

Text

Returns the name of the group.

AMTrigger.ItemID

Text

Returns the globally unique identifier (GUID) of the list item. This ID identifies the item as unique from anything else in the system.

AMTrigger.ItemTitle

Text

Returns the title of the list item.

AMTrigger.List

Text

Returns the name of the list.

AMTrigger.RoleDefinitionID

Text

Returns the globally unique identifier (GUID) of the role definition.

AMTrigger.RoleDefinitionName

Text

Returns the name of the role definition.

AMTrigger.RoleDefinitionPermissions

Text

Returns the permissions level of the role definition.

AMTrigger.Site

Text

Returns the SharePoint site.

AMTrigger.WorkflowID

Text

Returns the globally unique identifier (GUID) of the SharePoint workflow.

AMTrigger.WorkflowName

Text

Returns the name of the SharePoint workflow.

AMTrigger.WorkflowInstanceID

Text

Returns the globally unique identifier (GUID) of the current SharePoint workflow instance.