AMTrigger - SharePoint
Description
When a task is triggered, a prenamed (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 Desktop dataset within a task that examines 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 their names depends on the trigger launching 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.
| Name | Data Type | Return Value |
|---|---|---|
| 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 SharePoint list. |
| AMTrigger.FieldXML | Text | Returns the XML representation of a list field (column). |
| AMTrigger.File | Text | Returns the name of the file in a SharePoint 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 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 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 GUID of the SharePoint workflow. |
| AMTrigger.WorkflowName | Text | Returns the name of the SharePoint workflow. |
| AMTrigger.WorkflowInstanceID | Text | Returns the GUID of the current SharePoint workflow instance. |