Skip to main content

Actions

An action is a node that operates on the files or data it receives and passes the result to the next node. Every node after the trigger is either an action or a control. Actions copy, move, delete, convert, package, encrypt, or send files, write metadata, read text out of a file, or run a command on your own server. Controls route and reshape items, and they do not change files or send them anywhere.

An action processes every item it receives. What an action accepts and what it passes on determine where it can be placed in the graph.

ActionAcceptsPasses on
Create FolderFile or dataOne item for each folder it creates
Copy FileFile, or data written to a .json fileOne item for each destination written
Move FileFileOne item for each destination
Delete FileFileOne data item recording the deletion
Import FileFile or dataOne item for the imported file
Run SyncFile or dataThe same items, unchanged
Send via AS2File, or data written to a .json fileThe same items, unchanged
Send EmailFile or dataThe same items, unchanged
Agent ComputeFile, or data written to a .json fileOne data item with the command's result
Set MetadataFileThe same file, with its custom metadata replaced
ExtractFileThe same file, with the extracted text and metadata added to its attributes
Convert DocumentFileOne converted file
Convert ImageFileOne converted file
ZipFile, or data written to a .json fileOne archive for all incoming items
UnzipFileOne item for each extracted file
Encrypt With GPGFile, or data written to a .json fileOne encrypted file
Decrypt With GPGFileOne decrypted file

A data connection to a node that accepts only files fails at save, and the nodes that accept data by writing it to a file receive the JSON as a .json file.

Shared Settings

Every action has an Error Handling section, whose rules determine whether an item the action could not process is routed to the node's Error path, is not processed further, or fails the run. Every action also has a Return From Automation checkbox, which marks the action's output as what this Automation returns when another Automation runs it with Run Automation.

The actions that write files take a destination path, and Copy File, Move File, Convert Document, Convert Image, Zip, Unzip, Encrypt With GPG, and Decrypt With GPG take an overwrite setting that is off by default.

Copy File, Move File, and Delete File take an Exclude Pattern that removes matching files from the items the action processes, using the same syntax as the trigger's Exclude Pattern.