AMTrigger - File System
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 Desktop 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 related to the File System trigger. For more details about an individual AMtrigger value, click the associated link.
| Name | Data Type | Return Value |
|---|---|---|
| AMTrigger.Action | String | Returns the file/folder related action that took place to cause the task to trigger. |
| AMTrigger.Count | Number | If the AMTrigger.Action field returns TOO MANY FOLDERS or TOO MANY FILES, this value is the total number of folders or files that activated the trigger. |
| AMTrigger.FileName | String | If the AMTrigger.Action field returns FILE ADDED, FILE MODIFIED or FILE DELETED, returns the path and file name of the file that was either added, modified or deleted (according to the file action that the user initially set for the trigger). |
| AMTrigger.FolderName | String | If the AMTrigger.Action field returns FOLDER ADDED, FOLDER MODIFIED or FOLDER DELETED returns the path and name of the folder that was either added, modified or deleted (according to the folder action that the user initially set for the trigger). |
| AMTrigger.NBFiles | Number | If the AMTrigger.Action field returns TOO MANY FILES, this value is the total number of files in the directory being monitored. |
| AMTrigger.OldFileName | String | If the AMTrigger.Action field returns FILE RENAMED, this value is the original file name. |
| AMTrigger.OldFolderName | String | If the AMTrigger.Action field returns FOLDER RENAMED, this value is the original name of the folder. |
| AMTrigger.Size | Number | If the AMTrigger.Action field returns ONE FILE TOO BIG, this value is the size (in KB) of the file or folder that activated the trigger. |