Edit Workflow - Workflow variables

Variables are used to further customize workflows. Access the following types of variables:

  • capture variables – Available during the entire workflow lifecycle, e.g. information about the logged user, terminal, etc.

  • user input variables – Defined on the MFD by the user

  • process variables – Available during the workflow processing and delivery, e.g., a selected billing code


Workflow User Input Fields

Workflow Processing

Workflow Destination

Capture Variables

images/s/-t6brkm/8803/3fowtp/_/images/icons/emoticons/check.svg

images/s/-t6brkm/8803/3fowtp/_/images/icons/emoticons/check.svg

images/s/-t6brkm/8803/3fowtp/_/images/icons/emoticons/check.svg

User Input Variables

images/s/-t6brkm/8803/3fowtp/_/images/icons/emoticons/error.svg

images/s/-t6brkm/8803/3fowtp/_/images/icons/emoticons/check.svg

images/s/-t6brkm/8803/3fowtp/_/images/icons/emoticons/check.svg

Process Variables

images/s/-t6brkm/8803/3fowtp/_/images/icons/emoticons/error.svg

images/s/-t6brkm/8803/3fowtp/_/images/icons/emoticons/warning.svg *

images/s/-t6brkm/8803/3fowtp/_/images/icons/emoticons/check.svg

* Please note, it depends on the order in which processing is done.

Variables start with the '%' character followed by a variable name (no spaces allowed) and end with the '%' character, e.g. %userEmail%, %barcode%, etc.

Name

Workflow Destination

Variable Type

Usage

%barcode%

all

process

Contains the value extracted from the upper-left most barcode. For more details, see section Barcode.

%barcode<X>%

all

process

Contains each barcode value with X starting from 1. For more details, see section Barcode.

%barcodeInsecure<X>%

all

process

Contains each unmodified barcode value with X starting from 1. The value may contain unsafe user input that should not be directly used in a workflow. For more details, see section Barcode.

%barcode_<JSON key path>%

all

process

Contains barcode JSON values with key path using dot notation replaced by underscore character. For more details, see section Barcode.

%separationBarcode%

all

process

Contains the value extracted from a barcode that triggered a separation of scan jobs. For more details, see section Scan Job Separation.

%billingCode%

all

process

The code of billing code used for this scan job (can be null if none is assigned).

%fileLocations%

all

process

The comma-separated file paths of all scanned files in the destination.

%highlightedText%

all

process

Contains the text from highlighted text extraction. For more details, see section Highlighter Extraction.

%deviceID%

all

capture

The ID of the device where a scan was made.

%deviceName%

all

capture

The name of the device where a scan was made.

%deviceDescription%

all

capture

A description of the device where a scan was made.

%deviceGroupID%

all

capture

The ID of a group to which the device where a scan was made belongs.

%deviceGroupName%

all

capture

The name of a group to which the device where a scan was made belongs.

%deviceGroupIP%

all

capture

The IP address of a group to which the device where a scan was made belongs.

%deviceLocation%

all

capture

The location of the device where a scan was made.

%deviceIP%

all

capture

The IP address of the device where a scan was made.

%deviceActivationDate%

all

capture

The activate date of the device where a scan was made (in the 'YYYY-MM-DD HH:MM:SS.MS' format).

%deviceEquipmentID%

all

capture

The equipment ID of the device where a scan was made.

%deviceServiceAgreementID%

all

capture

The device service agreement ID of the device where a scan was made.

%deviceContactPerson%

all

capture

The contact person for the device where a scan was made.

%deviceCostCenterID%

all

capture

The cost center number of the device where a scan was made.

%deviceCostCenterName%

all

capture

The cost center name of the device where a scan was made.

%invitationLink%

OneDrive for Business (OAuth 2.0)

capture

The invitation link where users authorize access to their OneDrive storage.

%safeqHome%

all

capture

The full path to the folder where YSoft SafeQ is installed on the server where the Workflow Processing System is running (typically C:\SafeQ6).

%scanDate%

all

capture

The local date on Terminal Server at the time of a scan in the format yyyy-MM-dd, e.g., ' 2012-12-21' for December 21, 2012.

%scanTime%

all

capture

The local time on Terminal Server at the time of a scan in format HH-mm-ss-fff, e.g., '12-15-00-000' for a quarter past twelve.

%userCostCenterID%

all

capture

The cost center number of the terminal user who made a scan.

%userCostCenterName%

all

capture

The cost center name of the terminal user who made a scan.

%userEmail%

all

capture

The email of the terminal user who made a scan.

%userFirstName%

all

capture

The first name of the terminal user who made a scan.

%userHome%

all

capture

The home folder of the terminal user who made a scan.

%userSurname%

all

capture

The surname of the terminal user who made a scan.

%userUsername%

all

capture

The YSoft SafeQ username of the terminal user who made a scan.

%pdfPassword%

all

capture

The Password being used to encrypt a PDF document. For more details, see section Highlighter Extraction.

%fileLocations%

except script

capture

The final comma-separated list of processed files, including the path to file. This variable is only accessible in notifications.

%filePath%

script

process

The full path of the currently executed file if script execution mode is "Per file", or the path of the last file processed by the Workflow Processing System if script execution mode is "One time". For more details, see section Scan to Script.

%fileList%

script and external processing step

process

Full path to the file-list file containing the list of all scanned files. Relevant for the External Processing Step and for the "One time" execution mode of the Scan to script destination. For more details, see the sections Scan to Script and External Processing Step.

%metadata%

script and external processing step

process

Full path to the metadata file containing the list of all workflow variables. Relevant for the External Processing Step and for the "One time" execution mode of the Scan to script destination. For more details, see the sections Scan to Script and External Processing Step.

%externalStepExitCode%

all

process

After executing the External Processing Step, this variable will contain the numeric exit code from the external process. If the exit code is not zero, the workflow is aborted and the failure notification is delivered, which is where this variable may be useful.

%externalStepStdOut%

all

process

After executing the External Processing Step, this variable will contain the captured standard output from the external process (but not the standard error output).

%targetDir%

script

process

Specifies the location where scanned files (and optionally, metadata and file list files) are stored. For more details, see section Scan to Script.

%scanJobID%

all

process

The unique ID of the scan job instance. This identifier of the scan job is also visible in the log files.

%scanJobSize%

all

process

A summary of the scan job files sizes. The variable is available only when there is a restriction set on the connector.

%scanJobFileCount%

all

process

The scan job files count. The variable is available only when there is a restriction set on the connector.

%connectorFileCountLimit%

all

process

The max file count restriction limit. The variable is available only when there is a file count restriction set on the connector.

%connectorFileSizeLimit%

all

process

The file size restriction limit. The variable is available only when there is a file size restriction set on the connector.

%connectorRestrictionsDirectory%

all

process

The path to the folder where the scan jobs are stored when a restriction is applied. The variable is available only when there is a restriction set on the connector.

%workflowID%

all

capture

The ID of the workflow used to make the scan.

%workflowName%

all

capture

The name of the workflow used to make the scan.