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
User Input Variables
Process Variables		*

* 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.
%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.