Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
Table of Contents
maxlevel2

Anchor
Overview
Overview
Overview

Variables and functions can be used in free-text fields within tasks and workflows. When a variable or function is specified in a free-text field, the Controller inserts its value into the field when the task or workflow is run.

Also, triggers can pass variables and functions into the tasks and workflows they launch.

Universal Controller supports a number of functions that can be specified in free-text fields. They are resolved when a task instance runs or when a Set Variable action containing a function is executed.

Functions are entered using the following formats:
 

Panel

Anchor
Formatting Rules
Formatting Rules
Formatting Rules

Panel

Anchor
Function Categories
Function Categories
Function Categories

Functions are listed alphabetically within the following categories on this page:

Anchor
Conditional Functions
Conditional Functions
Conditional Functions

Return Conditional Value Depending on Equality of String Parameters

Description

Returns a conditional value depending on the equality of two string parameters.
 
(Returns if_value if string value1 is equal to string value2; otherwise, else_value is returned.)

Syntax

${_ifEqual('value1', 'value2', 'if_value', 'else_value'[, ignore_case])}

Parameters

  • value1
    Required; First string.
  • value2
    Required; Second string.
  • if_value
    Required; Return value if value1 equals value2.
  • else_value
    Required; Return value if value1 does not equal value2.
  • ignore_case
    Optional; Specification (true or false) whether or not to ignore case when comparing value1 and value2. Default is false.

Examples

Panel

Return Conditional Value Depending on Value of Boolean Parameter

Description

Returns a conditional value depending on the value of a boolean parameter.
 
Returns if_value if value is true; otherwise, else_value is returned.

Syntax

${_ifTrue(value, 'if_value', 'else_value')}

Parameters

  • value
    Required; Boolean value (true or false).
  • if_value
    Required; Return value if value is true.
  • else_value
    Required; Return value if value is false.

Example

Panel

Anchor
Credential Functions
Credential Functions
Credential Functions

Anchor
Return Key Location
Return Key Location
Return Key Location of a Credential

Description

Returns a token representing the Resolvable Credential Key Location that you want to embed.

Syntax

${_credentialKeyLoc('<credential_name>')}

Parameters

  • credential_name
    Required; Name of the Credential.
Example
Panel

${_credentialKeyLoc('RCredentialXYZ')} → $(ops_unv_cred_key_loc_c89e7b2caf4247909bc46041df8a2643)

Anchor
Return Passphrase
Return Passphrase
Return Passphrase of a Credential

Description

Returns a token representing the Resolvable Credential Passphrase that you want to embed.

Syntax

${_credentialPassphrase('<credential_name>')}

Parameters

  • credential_name
    Required; Name of the Credential.
Example
Panel
${_credentialPassphrase('RCredentialXYZ')} → $(ops_unv_cred_passphrase_c89e7b2caf4247909bc46041df8a2643)

Anchor
Return Token of a Credential
Return Token of a Credential
Return Token of a Credential

Description

Returns a token representing the Resolvable Credential Token that you want to embed.

Syntax

${_credentialToken('<credential_name>')}

Parameters

  • credential_name
    Required; Name of the Credential.
Example
Panel
${_credentialToken('RCredentialXYZ')} → $(ops_unv_cred_token_c89e7b2caf4247909bc46041df8a264


Return User Name of a Credential

Description

Returns a token representing the Resolvable Credential Runtime User that you want to embed.

Syntax

${_credentialUser('<credential_name>')}

Parameters

  • credential_name
    Required; Name of the Credential.
Example
Panel

${_credentialUser('RCredentialXYZ')} → $(ops_unv_cred_user_c89e7b2caf4247909bc46041df8a2643)

Return User Password of a Credential

Description

Returns a token representing the Resolvable Credential Runtime Password that you want to embed.

Syntax

${_credentialPwd('<credential_name>')}

Parameters

  • credential_name
    Required; Name of the Credential.
Example
Panel

${_credentialPwd('RCredentialXYZ')} → $(ops_unv_cred_pwd_c89e7b2caf4247909bc46041df8a2643)

Anchor
Date Functions
Date Functions
Date Functions

Checks if Date Argument Equals Today's Date

Description

Checks if a date argument is equal to today's date in the specified format.
 
Returns true if date is equal to today's date in the specified format; otherwise, false is returned.

Syntax

${_isToday('date'[, 'format', is_relative])}

Parameters

  • date
    Required; Date to compare to today's date.
  • format
    Optional; Format of today's date. Default is yyyy-MM-dd.
  • is_relative
    Optional; Specification (true or false) for whether today's date is relative to the trigger/launch time of the task instance. Default is false.

Examples

Panel

Anchor
_date
_date
Resolve to Current Date and Time

Description

Resolves to the current date and time.

Syntax

${_date(['format', day_offset, hour_offset, minute_offset])}

Parameters

Examples

Panel

Resolve to Current Date and Time (Advanced)

Description

Resolves to the current date and time.

Syntax

${_dateadv(['format', year_offset, month_offset, day_offset, hour_offset, minute_offset])}

Parameters

Examples

Panel

Resolve to Current Unix Epoch Time

Description

Resolves to the current time in milliseconds since Wed Dec 31 1969 19:00:00 GMT-0500 (EST) – the start of Unix epoch time.

Syntax

${_currentTimeMillis}

Parameters

n/a

Return Date with Offsets

Description

Returns the date after applying offsets. Optionally, can specify the output format.
 

Note

Whether a holiday is treated as a business day or a non-business day is specified by the Exclude Holidays for Business Days Universal Controller system property.

Syntax

${_formatDate(['date_time', 'format', day_offset, use_business_days, hour_offset, minute_offset, timezone])}

Parameters

Example

Panel

Return Date with Offsets (Advanced)

Description

Returns the date after applying offsets. Optionally, can specify the output format.
 

Note

Whether a holiday is treated as a business day or a non-business day is specified by the Exclude Holidays for Business Days Universal Controller system property.

Syntax

${_formatDateAdv(['date_time', 'format', year_offset, month_offset, day_offset, use_business_days, hour_offset, minute_offset, timezone])}

Parameters

Examples

Panel

Return Date with Time Zone

DescriptionReturns the Date and Time in another time zone.

Syntax

${_formatDateTz('date_time', 'target_time_zone'[, 'output_format'])}

Parameters

Examples

Panel

Return Day of Week

Description

Returns the day of week for the specified date as a number.

Syntax

${_dayOfWeek(['date', 'first_dow', first_dow_value])}

Parameters

Example

Panel

Return Days between Dates

Description

Returns the number of days between date1 and date2.

The start date is inclusive, but the end date is not.

Syntax

${_daysBetween('date1', 'date2')}

Parameters

Example

Panel

Return Non-Business Day of Month

Description

Returns the Nth non-business day of month for the month of the date specified. Optionally, can start from the end of the month.
 

Note

Whether a holiday is treated as a business day or a non-business day is specified by the Exclude Holidays for Business Days Universal Controller system property.

Syntax

${_nonBusinessDayOfMonth(index, ['date', 'format', reverse])}

Parameters

Examples

Panel

Return Nth Business Day of Month

Description

Returns the Nth business day of month for the month of the date specified. Optionally, can start from the end of the month.
 

Note

Whether a holiday is treated as a business day or a non-business day is specified by the Exclude Holidays for Business Days Universal Controller system property.

Syntax

${_businessDayOfMonth(index, ['date', 'format', reverse])}

Parameters

Examples

Panel

Return Nth Day of Month

Description

Returns the Nth day of month for the month of the date specified. Optionally, can start from the end of the month.

Syntax

${_dayOfMonth(index, ['date', 'format', reverse])}

Parameters

Examples

Panel

Return Number of Business Days between Dates

Description

Returns the number of business days between date1 and date2.

The start date is inclusive, but the end date is not.
 

Note

Whether a holiday is treated as a business day or a non-business day is specified by the Exclude Holidays for Business Days Universal Controller system property.

Syntax

${_businessDaysBetween('date1', 'date2')}

Parameters

Example

Panel

Anchor
Mathematical Functions
Mathematical Functions
Mathematical Functions

Add

Description

Return the sum of the augend added with the addend.

Syntax

${_add(augend, addend)}

Parameters

  • augend
    Integer to which the addend is being added.
  • addend
    Integer being added to the augend.

Example

Panel

 
Using Variables for augend and addend (${augend} = 17, ${addend} = 5):
 

Panel

Divide

Description

Return the quotient of the dividend divided by divisor.

Syntax

${_divide(dividend, divisor)}

Parameters

  • dividend
    Integer being divided by the divisor.
  • divisor
    Integer being used to divide the dividend.

Example

Panel

 
Using Variables for dividend and divisor (${dividend} = 100, ${divisor} = 5)
 

Panel

Multiply

Description

Return the product of the multiplicand multiplied with the multiplier.

Syntax

${_multiply(multiplicand, multiplier)}

Parameters

  • multiplicand
    Integer being multiplied by the multiplier.
  • multiplier
    Integer being used to multiply the multiplicand.

Example

Panel

 
Using Variables for multiplicand and multiplier (${multiplicand} = 100, ${multiplier} = 5):
 

Panel

Return Absolute Value

Description

Return the absolute value of the parameter.

Syntax

{_abs(parameter)}

Parameters

  • parameter
    Integer (positive or negative value).

Example

Panel

 
Using Variables for parameter (${parameter} = -100):
 

Panel

Return Modulo

Description

Return the modulo (remainder) of the dividend divided by divisor.

Syntax

${_mod(dividend, divisor)}

Parameters

  • dividend
    Integer being divided by the divisor.
  • divisor
    Integer being used to divide the dividend.

Example

Panel

 
Using Variables for dividend and divisor (${dividend} = 23, ${divisor} = 5):
 

Panel

Subtract

Description

Return the difference of the subtrahend subtracted from the minuend.

Syntax

${_subtract(minuend, subtrahend)}

Parameters

  • minuend
    Integer from which the subtrahend is being subtracted.
  • subtrahend
    Integer being subtracted from the minuend.

Example

Panel

 
Using Variables for minuend and subtrahend (${minuend} = 100, ${subtrahend} = 5):
 

Panel

Anchor
Other Task Functions
Other Task Functions
Other Task Functions

Anchor
Business Services List
Business Services List
Business Services Membership

Description

Resolves to a delimited list of business service names the task instance is a member of.

Syntax

${_businessServices(['resultDelimiter'])}

Parameters

  • resultDelimiter
    Optional; Delimiter to use when concatenating business service names. If not specified, ", " will be used.
Example

If a task instance is a member of business services A, B, and C.

Panel
borderStylesolid

${_businessServices()}
A, B, C

Panel
borderStylesolid

${_businessServices('\n')}
A
B
C

If a task instance is not a member of any business service, the function will evaluate to empty.

Anchor
Output Functions
Output Functions
Output Functions

(For Web Service output, see Web Service Functions.)
 

Note
titleNote

A prerequisite for the use of these functions is that Automatic Output Retrieval and Wait For Output are selected at task level, with the exception of the EXTENSION output type.

Anchor
Task Instance Output
Task Instance Output
Task Instance Output

Description

Resolves to the output data, of the specified outputType, of the task instance that is resolving the function.

  • If the output record of the specified ouptutType cannot be found, the function will remain unresolved.

Syntax

${_output('outputType'[, 'defaultValue'])}

Parameters

  • outputType
    Required; Type of output to resolve: STDOUT, STDERR, FILE, EXTENSION, or JOBLOG.
  • defaultValue
    Optional; Default value to return if the output data is not found. Default is empty ('').

Sibling Task Instance Output

Description

Resolves to the output data, of the specified outputType, of the task instance specified by the siblingName parameter.
 
The sibling task instance must be within the same workflow, and the Execution User of the task instance that is resolving the function must have Read permission for the sibling task instance.

  • If the output record of the specified outputType cannot be found, the function will remain unresolved.

Syntax

${_outputFromTask('siblingName', 'outputType'[, 'defaultValue'])}

Parameters

  • siblingName
    Required; Name of a sibling task instance.
  • outputType
    Required; Type of output to resolve: STDOUT, STDERR, FILE, EXTENSION, or JOBLOG.
  • defaultValue
    Optional; Default value to return if the output data is not found. Default is empty ('').

Anchor
Task Instance Output by Specific Line(s)
Task Instance Output by Specific Line(s)
Task Instance Output by Specific Line(s)

Description

Resolves to the specified line(s) of output data, of the specified outputType, of the task instance that is resolving the function.

  • If the output record of the specified ouptutType cannot be found, the function will remain unresolved.

Syntax

${_outputLines('outputType', startLine, numberOfLines[, 'defaultValue', 'resultDelimiter'])}

Parameters

  • outputType
    Required; Type of output to resolve: STDOUT, STDERR, FILE, EXTENSION, or JOBLOG.
  • startLine
    Required; Start line, where 1 is the first line and -1 is the last line.
  • numberOfLines
    Required; Number of lines to return starting from the startLine.
  • defaultValue
    Optional; Default value to return if no lines qualify. Default is empty ('')
  • resultDelimiter
    Optional; Delimiter to use when concatenating matching lines. If not specified, "\n" or "\r\n" depending on original output line endings.

Sibling Task Instance Output by Specific Line(s)

Description

Resolves to the specified line(s) of output data, of the specified outputType, of the task instance specified by the siblingName parameter.
 
The sibling task instance must be within the same workflow, and the Execution User of the task instance that is resolving the function must have Read permission for the sibling task instance.

  • If the output record of the specified outputType cannot be found, the function will remain unresolved.

Syntax

${_outputLinesFromTask('siblingName', 'outputType', startLine, numberOfLines[, 'defaultValue', 'resultDelimiter'])}

Parameters

  • siblingName
    Required; Name of a sibling task instance.
  • outputType
    Required; Type of output to resolve: STDOUT, STDERR, FILE, EXTENSION, or JOBLOG.
  • startLine
    Required; Start line, where 1 is the first line and -1 is the last line.
  • numberOfLines
    Required; Number of lines to return starting from the startLine.
  • defaultValue
    Optional; Default value to return if no lines qualify. Default is empty ('').
  • resultDelimiter
    Optional; Delimiter to use when concatenating matching lines. If not specified, "\n" or "\r\n" depending on original output line endings.

Anchor
Task Instance Output by Line(s) Matching Regular Expression
Task Instance Output by Line(s) Matching Regular Expression
Task Instance Output by Line(s) Matching Regular Expression

Description

Resolves to the line(s) of output data that match the specified regular expression, of the specified outputType, of the task instance that is resolving the function by specifying a regular expression.

  • The complete outpout line is returned.
  • If the output record of the specified ouptutType cannot be found, the function will remain unresolved.

Syntax

${_outputLinesByRegex('outputType', 'regexPattern'[, maxCount, numberOfLinesBefore, numberOfLinesAfter, 'defaultValue', 'resultDelimiter'])}

Parameters

  • outputType
    Required; Type of output to resolve: STDOUT, STDERR, FILE, EXTENSION, or JOBLOG.
  • regexPattern
    Required; Regular expression used for determining if a line matches. Regular expression must match the whole line (see Example, below).
  • maxCount
    Optional; Maximum number of matching lines to return. Default is 1.
  • numberOfLinesBefore
    Optional; Number of lines before each matching line to return along with the matching line. Default is 0.
  • numberOfLinesAfter
    Optional; Number of lines after each matching line to return along with the matching line. Default is 0.
  • defaultValue
    Optional; Default value to return if no lines match the regular expression. Default is empty ('').
  • resultDelimiter
    Optional; Delimiter to use when concatenating matching lines. If not specified, "\n" or "\r\n" depending on original output line endings.

Example

STDOUT contains:
Some_Text
ABC=Some_String
More_Text
 
${_outputLinesByRegex('STDOUT', '^ABC=')} Returns empty (the whole Line was not matched)
${_outputLinesByRegex('STDOUT', '^ABC=.*')} Returns ABC=Some_String

Sibling Task Instance Output by Line(s) Matching Regular Expression

Description

Resolves to the line(s) of output data that match the specified regular expression, of the specified outputType, of the task instance specified by the siblingName parameter.
 
The sibling task instance must be within the same workflow, and the Execution User of the task instance that is resolving the function must have Read permission for the sibling task instance.

  • If the output record of the specified outputType cannot be found, the function will remain unresolved.

Syntax

${_outputLinesByRegexFromTask('siblingName', 'outputType', 'regexPattern'[, maxCount, numberOfLinesBefore, numberOfLinesAfter, 'defaultValue', 'resultDelimiter'])}

Parameters

  • siblingName
    Required; Name of a sibling task instance.
  • outputType
    Required; Type of output to resolve: STDOUT, STDERR, FILE, EXTENSION, or JOBLOG.
  • regexPattern
    Required; Regular expression used for determining if a line matches.
  • maxCount
    Optional; Maximum number of matching lines to return. Default is 1.
  • numberOfLinesBefore
    Optional; Number of lines before each matching line to return along with the matching line. Default is 0.
  • numberOfLinesAfter
    Optional; Number of lines after each matching line to return along with the matching line. Default is 0.
  • defaultValue
    Optional; Default value to return if no lines match the regular expression. Default is empty ('').
  • resultDelimiter
    Optional; Delimiter to use when concatenating matching lines. If not specified, "\n" or "\r\n" depending on original output line endings.

Anchor
Task Instance Output By XPath
Task Instance Output By XPath
Task Instance Output By XPath

Description

Resolves to the XML output data of the task instance that is resolving the function, corresponding to the evaluated XPath expression.

  • If the output record cannot be found, the function will remain unresolved.

  • If the output record is found, but the path expression does not yield a result, the function will resolve to the default value.

Syntax

${_outputXPath('outputType', 'xPathExpression'[, 'defaultValue', 'delimiter', prettyPrint])}

Parameters

  • outputType
    Required; Type of output to resolve: STDOUT, STDERR, FILE, EXTENSION, or JOBLOG.
  • xPathExpression
    Required; XPath expression. https://www.w3schools.com/xml/xpath_intro.asp
  • defaultValue
    Optional; Default value to return if the result is not found. Default is empty ('').
  • delimiter
    Optional; If xPathExpression evaluates to multiple results, the delimiter to be used to separate those results. Default is new line character (\n).
  • prettyPrint
    Optional; Specification (true or false) for whether or not XML output will be pretty printed (indented). Default is false.

Example

XML

<message>
  <code>10</code>
</message>

Function

${_outputXPath('STDOUT', '//code/text()')}

Result

10

Sibling Task Instance Output By XPath

Description

Resolves to the XML output data of the task instance specified by the siblingName, corresponding to the evaluated XPath expression.

The sibling task instance must be within the same workflow and the Execution User of the task instance that is resolving the function must have Read permission for the sibling task instance.

  • If the output record cannot be found, the function will remain unresolved.

  • If the output record is found but the path expression does not yield a result, the function will resolve to the default value.

Syntax

${_outputXPathFromTask('siblingName', 'outputType', 'xPathExpression'[, 'defaultValue', 'delimiter', prettyPrint])}

Parameters

  • siblingName
    Required; Name of a sibling task instance.
  • outputType
    Required; Type of output to resolve: STDOUT, STDERR, FILE, EXTENSION, or JOBLOG.
  • xPathExpression
    Required; XPath expression. https://www.w3schools.com/xml/xpath_intro.asp
  • defaultValue
    Optional; Default value to return if the result is not found. Default is empty ('').
  • delimiter
    Optional; If xPathExpression evaluates to multiple results, the delimiter to be used to separate those results. Default is new line character (\n).
  • prettyPrint
    Optional; Specification (true or false) for whether or not XML output will be pretty printed (indented). Default is false.

Example

XML
<message>
  <code>10</code>
</message>

Function
${_outputXPathFromTask('Sibling_With_XML_Output', 'STDOUT', '//code/text()')}

Result
10

Anchor
Task Instance Output By JsonPath
Task Instance Output By JsonPath
Task Instance Output By JsonPath

Description

Resolves to the JSON output data of the task instance that is resolving the function, corresponding to the evaluated JsonPath expression.

  • If the output record cannot be found, the function will remain unresolved.

  • If the output record is found but the path expression does not yield a result, the function will resolve to the default value.

Syntax

${_outputJsonPath('outputType', 'pathExpression'[, 'defaultValue', 'delimiter', prettyPrint])}

Parameters

  • outputType
    Required; Type of output to resolve: STDOUT, STDERR, FILE, EXTENSION, or JOBLOG.
  • PathExpression
    Required; JsonPath expression. https://github.com/json-path/Jsonpath
  • defaultValue
    Optional; Default value to return if the result is not found. Default is empty ('').
  • delimiter
    Optional; If pathExpression evaluates to multiple results, the delimiter to be used to separate those results. Default is new line character (\n).
  • prettyPrint
    Optional; Specification (true or false) for whether or not JSON output will be pretty printed (indented). Default is false.

Example

JSON

{
  "code": 10
}


Function

${_outputJsonPath('STDOUT', '$.code')}


Result

10

Sibling Task Instance Output By JsonPath

Description

Resolves to the JSON output data of the task instance specified by the siblingName, corresponding to the evaluated JsonPath expression.

The sibling task instance must be within the same workflow and the Execution User of the task instance that is resolving the function must have Read permission for the sibling task instance.

  • If the output record cannot be found, the function will remain unresolved.

  • If the output record is found but the path expression does not yield a result, the function will resolve to the default value

Syntax

${_outputJsonPathFromTask('siblingName', 'outputType', 'pathExpression'[, 'defaultValue', 'delimiter', prettyPrint])}

Parameters

  • siblingName
    Required; Name of a sibling task instance.
  • outputType
    Required; Type of output to resolve: STDOUT, STDERR, FILE, EXTENSION, or JOBLOG.
  • PathExpression
    Required; JsonPath expression. https://github.com/json-path/Jsonpath
  • defaultValue
    Optional; Default value to return if the result is not found. Default is empty ('').
  • delimiter
    Optional; If pathExpression evaluates to multiple results, the delimiter to be used to separate those results. Default is new line character (\n).
  • prettyPrint
    Optional; Specification (true or false) for whether or not JSON output will be pretty printed (indented). Default is false.

Example

JSON

{
  "code": 10
}

Function

${_outputJsonPathFromTask('Sibling_With_JSON_Output', 'STDOUT', '$.code')}

Result

10

Anchor
Task Instance Output By JsonPath As Array
Task Instance Output By JsonPath As Array
Task Instance Output By JsonPath As Array

Description

Resolves to the JSON output data of the task instance that is resolving the function, corresponding to the evaluated JsonPath expression.

  • If the output record cannot be found, the function will remain unresolved.

  • If the output record is found but the path expression does not yield a result, the function will resolve to the default value.

Syntax

${_outputJsonPathAsArray('outputType', 'pathExpression'[, 'defaultValue', prettyPrint])}

Parameters

  • outputType
    Required; Type of output to resolve: STDOUT, STDERR, FILE, EXTENSION, or JOBLOG.
  • PathExpression
    Required; JsonPath expression. https://github.com/json-path/Jsonpath
  • defaultValue
    Optional; Default value to return if the result is not found. Default is empty ('').
  • prettyPrint
    Optional; Specification (true or false) for whether or not JSON output will be pretty printed (indented). Default is false.

Example

JSON

[
  
{
    "message" : "Hello",
    "code" : 10
  },
  {
    "message" : "World!",
    "code" : 20
  }
]


Function

${_outputJsonPathAsArray('STDOUT', '$[*].message', '', true)}

Result

[
    "Hello",
    "World!"
]

Sibling Task Instance Output By JsonPath As Array

Description

Resolves to the JSON output data of the task instance specified by the siblingName, corresponding to the evaluated JsonPath expression.

The sibling task instance must be within the same workflow and the Execution User of the task instance that is resolving the function must have Read permission for the sibling task instance.

  • If the output record cannot be found, the function will remain unresolved.

  • If the output record is found but the path expression does not yield a result, the function will resolve to the default value.

Syntax

${_outputJsonPathFromTask('siblingName', 'outputType', 'pathExpression'[, 'defaultValue', prettyPrint])}

Parameters

  • siblingName
    Required; Name of a sibling task instance.
  • outputType
    Required; Type of output to resolve: STDOUT, STDERR, FILE, EXTENSION, or JOBLOG.
  • PathExpression
    Required; JsonPath expression. https://github.com/json-path/Jsonpath
  • defaultValue
    Optional; Default value to return if the result is not found. Default is empty ('').
  • prettyPrint
    Optional; Specification (true or false) for whether or not JSON output will be pretty printed (indented). Default is false.

Example

JSON
[
  {
    "message" : "Hello",
    "code" : 10
  },
  {
    "message" : "World!",
    "code" : 20
  }
]

Function
${_outputJsonPathAsArrayFromTask('Sibling_With_JSON_Output', 'STDOUT', '$[*].message')}

Result
["Hello","World!"]


Anchor
Script Functions
Script Functions
Script Functions

Anchor
Returns Path to Data Script
Returns Path to Data Script
Returns Path to Data Script

Description

Returns a token representing the path to a Data Script that you want to embed.

Syntax

${_scriptPath('script_name')}

Parameters

  • script_name
    Required; Name of the Data Script.

Example

Script Name: MyDataScript

Script UUID: 507ffdbd0eba4b62b0e31e0fd22f6bec
Panel
borderStylesolid

${_scriptPath('MyDataScript')} --> $(ops_unv_script_path_507ffdbd0eba4b62b0e31e0fd22f6bec)

Note
titleNote

The Agent will replace the resolved token with a path to a temporary file containing the content of the Data Script.

For additional details, refer to Embedding a Data Script.

Note
titleNote

_scriptPath requires Agent 6.4.0.0 or later.

Anchor
SQL/Stored Procedure Functions
SQL/Stored Procedure Functions
SQL/Stored Procedure Functions

Return Column Names for SQL Results from Current Task

Description

Returns the column names for the SQL results from the current SQL or Stored Procedure task. Column names are separated by the specified separator.

Syntax

${_resultsColumnNames(['separator'])}

Parameters

  • separator
    Optional; Column name separator. Default is comma (,).

Return Column Names for SQL Results from Sibling Task

Description

Returns the column names for the SQL results from a sibling SQL or Stored Procedure task, within the same workflow. Column names are separated by the specified separator.

Syntax

${_resultsColumnNamesFromTask('name'[, 'separator'])}

Parameters

  • name
    Required; Name of the sibling task that the results should come from. The task must be within the same workflow.
  • separator
    Optional; Column name separator. Default is comma (,).

Return SQL Results from Current Task

Description

Returns all SQL results from the current SQL or Stored Procedure task. Columns are separated by the specified separator and rows are separated by a new line.

Syntax

${_resultsAll(['separator', 'rowSeparator'])}

Parameters

  • separator
    Optional; Column separator. Default is comma (,).
  • rowSeparator
    Optional; Overrides default New Line character.

Return SQL Results from Sibling Task

Description

Returns all SQL results from a sibling SQL or Stored Procedure task, within the same workflow. Columns are separated by the specified separator and rows are separated by a new line.

Syntax

${_resultsAllFromTask('name'[, 'separator', 'rowSeparator'])}

Parameters

  • name
    Required; Name of the task that the results should come from. The task must be within the same workflow.
  • separator
    Optional; Column separator. Default is comma (,).
  • rowSeparator
    Optional; Overrides default New Line character.

Return SQL Warnings from Current Task

Description

Returns all SQL warnings from the current SQL or Stored Procedure task. Columns are separated by the specified separator and rows are separated by a new line.

Syntax

${_SQLWarnings(['separator'])}

Parameters

  • separator
    Optional; Column separator. Default is comma (,).

Return SQL Warnings from Sibling Task

Description

Returns all SQL warnings from a sibling SQL or Stored Procedure task, within the same workflow. Columns are separated by the specified separator and rows are separated by a new line.

Syntax

${_SQLWarningsFromTask('name'[, 'separator'])}

Parameters

  • name
    Required; Name of the sibling task that the warnings should come from. The task must be within the same workflow.
  • separator
    Optional; Column separator. Default is comma (,).

Return String Value of Row/Column by Column Name

Description

Returns the string value of a row/column from a previously executed SQL task within the same workflow, or from the current SQL task.

Syntax

${_resultsColumn('name', 'colname'[, rownum, 'default_value'])}

Parameters

  • name
    Required; Name of a sibling SQL task within the same workflow from which you want the function to fetch results. If you want to execute the function against the current task, use an empty string for the name parameter.
  • colname
    Required; Name of column to retrieve.
  • rownum
    Optional; Numeric row number in result set to retrieve. Default is 1.
  • default_value
    Optional; Default value to return if result not found.

Return String Value of Row/Column by Column Number

Description

Returns the string value of a row/column from a previously executed SQL task within the same workflow, or from the current SQL task.

Syntax

${_resultsColumnByNo('name', colnum[, rownum, 'default_value'])}

Parameters

  • name
    Required; Name of a sibling SQL task within the same workflow from which you want the function to fetch results. If you want to execute the function against the current task, use an empty string for the name parameter.
  • colnum
    Required; Number of column to retrieve. First column in result is 1, second is 2, and so on.
  • rownum
    Optional; Numeric row number in result set to retrieve. Default is 1.
  • default_value
    Optional; Default value to return if result not found.

Return String Values of Columns

Description

Returns the string values of columns in a specific row in CSV (comma-separated values) format, from a previously executed SQL task within the same workflow, or from the current SQL task.

Syntax

${_resultsColumnsCSV('name'[, rownum])}

Parameters

  • name
    Required; Name of a sibling SQL task within the same workflow from which you want the function to fetch results. If you want to execute the function against the current task, use an empty string for the name parameter.
  • rownum
    Optional; Numeric row number in result set to retrieve. Default is 1.

Anchor
String Functions
String Functions
String Functions

String Functions can accept:

  • String content in a String parameter.
  • Variable name in a String parameter (prefixed with _var) from which string content can be obtained.
  • Integer and Boolean parameters.

For String functions that accept a String value parameter directly, the value parameter can be specified using hard-coded text, variables, functions, or any combination of the three.
 

Note
titleNote

When using String functions that accept a String value parameter directly, you should be aware of expectations with respect to escape characters and escape sequences (see Escape Sequences, below).


For String functions that accept a variable name parameter, the fully resolved value of the variable by the specified name will be used as the String value argument. The variable must be fully resolvable and must not contain an unresolved function.


Note
titleNote

Indexing functions use zero-based numbering; that is, the initial element is assigned the index 0.

Anchor
Escape Sequences
Escape Sequences
Escape Sequences

An escape character preceded by a backslash (\) is an escape sequence (see the following table for a list of escape sequences).

If you are using a String function to manipulate a String value that potentially may contain an escape sequence, you should use the String function that accepts a variable name parameter to allow for passing the value to the function without the escape sequence being interpreted.
 

Escape Sequences

Escape Sequence Description

\t

Insert a tab in the text at this point.

\b

Insert a backspace in the text at this point.

\n

Insert a newline in the text at this point.

\r

Insert a carriage return in the text at this point.

\f

Insert a formfeed in the text at this point.

\'

Insert a single quote character in the text at this point.

\'

Insert a double quote character in the text at this point.

\\

Insert a backslash character in the text at this point.

Anchor
_toLowerCase
_toLowerCase
Convert Characters in Value to Lower Case

Description

Converts all of the characters in the value to lower case using the rules of the default locale.

Syntax

${_toLowerCase('value')}

Parameters

  • value
    Required; String to convert to lower case.

Anchor
_varToLowerCase
_varToLowerCase
Convert Characters in Variable to Lower Case

Description

Converts all of the characters in the variable to lower case using the rules of the default locale.

Syntax

${_varToLowerCase('variableName')}

Parameters

  • variableName
    Required; Name of the variable being passed into the function.

Anchor
_toUpperCase
_toUpperCase
Convert Characters in Value to Upper Case

Description

Converts all of the characters in the value to upper case using the rules of the default locale.

Syntax

${_toUpperCase('value')}

Parameters

  • value
    Required; String to convert to upper case.

Anchor
_varToUpperCase
_varToUpperCase
Convert Characters in Variable to Upper Case

Description

Converts all of the characters in the variable to upper case using the rules of the default locale.

Syntax

${_varToUpperCase('variableName')}

Parameters

  • variableName
    Required; Name of the variable being passed into the function.

Anchor
_varEscapeXml
_varEscapeXml
Escape Characters in Variable Using XML Entities

Description

Escapes the characters in a variable value using XML entities.

Syntax

${_varEscapeXml('variableName')}

Parameters

  • variableName
    Required; Name of the variable being passed into the function. The variable value will be escaped for insertion into XML.

Example

Variable Name:
escape_me
 
Variable Value:
`1234567890\E-=[]\;',./ ~!@#$%^&*()_+{}|:"<>?
 

Panel

&apos

&amp

&quot

&lt

&gt

Anchor
_varEscapeJson
_varEscapeJson
Escape Characters in Variable Using JSON String Rules

Description

Escapes the characters in a variable value using JSON string values.

Syntax

${_varEscapeJson('variableName')}

Parameters

  • variableName
    Required; Name of the variable being passed into the function. The variable value will be escaped for insertion into JSON.

Example

Variable Name:
escape_me
 
Variable Value:
`1234567890\E-=[]\;',./ ~!@#$%^&*()_+{}|:"<>?
 

Panel

<>

Anchor
_varEscapeJavaScript
_varEscapeJavaScript
Escape Characters in Variable Using JavaScript String Rules

Description

Escapes the characters in a variable value using JavaScript String rules.

Syntax

${_varEscapeJavaScript('variableName')}

Parameters

  • variableName
    Required; Name of the variable being passed into the function. The variable value will be escaped for insertion into JavaScript.

Example

Variable Name:
escape_me
 
Variable Value:
`1234567890\E-=[]\;',./ ~!@#$%^&*()_+{}|:"<>?
 

Panel

<>

Anchor
_varEscapeHtml
_varEscapeHtml
Escape Characters in Variable Using HTML Entities

Description

Escapes the characters in a variable value using HTML entities. (Supports all known HTML 4.0 entities.)

Syntax

${_varEscapeHtml('variableName')}

Parameters

  • variableName
    Required; Name of the variable being passed into the function. The variable value will be escaped for insertion into HTML.

Example

Variable Name:
escape_me
 
Variable Value:
`1234567890\E-=[]\;',./ ~!@#$%^&*()_+{}|:"<>?
 

Panel

&amp

&quot

&lt

&gt

Anchor
_varLiteralPattern
_varLiteralPattern
Escape Characters in Variable as a Literal Pattern

Description

Returns a literal regular expression pattern String for the value of the specified variable.
 
This method produces a String that can be used to create a Pattern that would match the String as if it were a literal pattern.

Syntax

${_varLiteralPattern('variableName')}

Parameters

  • variableName
    Required; Name of the variable being passed into the function. The variable value will be escaped for insertion into a regular expression as a literal pattern.

Example

Variable Name:
escape_me
 
Variable Value:
`1234567890\E-=[]\;',./ ~!@#$%^&*()_+{}|:"<>?
 

Panel

<>

Anchor
_randomString
_randomString
Randomly Generate a String

Description

Randomly generates a String with a specified length.

Syntax

${_randomString(length[, 'excludeCharacters', 'defaultCharacters'])}

Parameters

Note
titleNote

The following characters are included in the default character set, in addition to the space character.

<>

Example

Panel

Anchor
_replaceAll
_replaceAll
Replace Substring of Value with Regular Expression

Description

Replaces each substring of value that matches the specified regular expression, regex, with the specified replacement.

Syntax

${_replaceAll('value', 'regex', 'replacement')}

Parameters

  • value
    Required; Input string.
  • regex
    Required; Regular expression.
  • replacement
    Required; Replacement string.

Anchor
_varReplaceAll
_varReplaceAll
Replace Substring of Variable with Regular Expression

Description

Replaces each substring of variableName that matches the specified regular expression, regex, with the specified replacement.

Syntax

${_varReplaceAll('variableName', 'regex', 'replacement')}

Parameters

  • variableName
    Required; Name of the variable being passed into the function.
  • regex
    Required; Regular expression.
  • replacement
    Required; Replacement string.

Anchor
_varEncodeBase64
_varEncodeBase64
Return Base64 Encoded String

Description

Returns the value of the specified variable encoded using the Base64 encoding scheme.

Syntax

${_varEncodeBase64('variableName'[, 'charset'])}

Parameters

  • variableName
    Required; Name of the variable whose value will be encoded using the Base64 encoding scheme.
  • charset
    Optional; Name of the charset; default UTF-8.
Example

Where Variable rawstring contains a value of "Test String":

Panel

${_varEncodeBase64('rawstring')} --> VGVzdCBTdHJpbmc=

Anchor
_trim
_trim
Return Copy of Value with Whitespace Omitted

Description

Returns a copy of value, with leading and trailing whitespace omitted.

Syntax

${_trim('value')}

Parameters

  • value
    Required; String to trim.

Anchor
_varTrim
_varTrim
Return Copy of Variable with Whitespace Omitted

Description

Returns a copy of variableName, with leading and trailing whitespace omitted.

Syntax

${_varTrim('variableName')}

Parameters

  • variableName
    Required; Name of the variable being passed into the function.

Anchor
_indexOf
_indexOf
Return Index of Substring in String Value

Description

Returns the index within the string value of the first occurrence of the specified substring, str.

Syntax

${_indexOf('value', 'str')}

Parameters

Anchor
_varIndexOf
_varIndexOf
Return Index of Substring in String Variable

Description

Returns the index within the string variable of the first occurrence of the specified substring, str.

Syntax

${_varIndexOf('variableName', 'str')}

Parameters

Anchor
_indexOfWithOffset
_indexOfWithOffset
Return Index of Substring Plus Offset in String Value

Description

Returns the index within this string of the first occurrence of the specified substring plus the specified offset. The integer returned is the smallest value.

Syntax

${_indexOfWithOffset('value', 'str', offset)}

Parameters

Anchor
_varIndexOfWithOffset
_varIndexOfWithOffset
Return Index of Substring Plus Offset in String Variable

Description

Returns the index within this string of the first occurrence of the specified substring plus the specified offset. The integer returned is the smallest variable.

Syntax

${_varIndexOfWithOffset('variableName', 'str', offset)}

Parameters

Anchor
_lastIndexOf
_lastIndexOf
Return Index of Rightmost Occurrence of Substring in String Value

Description

Returns the index within the string value of the rightmost occurrence of the specified substring, str.

Syntax

${_lastIndexOf('value', 'str')}

Parameters

Anchor
_varLastIndexOf
_varLastIndexOf
Return Index of Rightmost Occurrence of Substring in String Variable

Description

Returns the index within the string variable of the rightmost occurrence of the specified substring, str.

Syntax

${_varLastIndexOf('variableName', 'str')}

Parameters

Anchor
_lastIndexOfWithOffset
_lastIndexOfWithOffset
Return Index of Rightmost Occurrence of Substring Plus Offset in String Value

Description

Returns the index within this string of the rightmost occurrence of the specified substring, plus the specified offset. The returned index is the largest value.

Syntax

${_lastIndexOfWithOffset('value', 'str', offset)}

Parameters

Anchor
_varLastIndexOfWithOffset
_varLastIndexOfWithOffset
Return Index of Rightmost Occurrence of Substring Plus Offset in String Variable

Description

Returns the index within this string of the rightmost occurrence of the specified substring, plus the specified offset. The returned index is the largest variable.

Syntax

${_varLastIndexOfWithOffset('variableName', 'str', offset)}

Parameters

Anchor
_length
_length
Return Length of Value

Description

Returns the length of value.

Syntax

${_length('value')}

Parameters

  • value
    Required; Any string.

Anchor
_varLength
_varLength
Return Length of Variable

Description

Returns the length of variableName.

Syntax

${_varLength('variableName'[, useEmptyForUndefined])}

Parameters

Anchor
_substring
_substring
Return New String that is Substring of Value

Description

Returns a new string that is a substring of value. The substring begins at beginIndex and extends to the character at endIndex -1.

Syntax

${_substring('value', beginIndex[, endIndex])}

Parameters

Example

Panel

Anchor
_varSubstring
_varSubstring
Return New String that is Substring of Variable

Description

Returns a new string that is a substring of variableName. The substring begins at beginIndex and extends to the character at endIndex -1.

Syntax

${_varSubstring('variableName', beginIndex[, endIndex])}

Parameters

Examples

If the value of the food variable is hamburger, and the value of the face variable is smiles:
 

Panel

Anchor
varEncodeUrl
varEncodeUrl
Return URL-Encoded String

Description

Returns a URL-encoded string according to the ASCII Encoding Reference for UTF-8; all non-alphanumeric characters are replaced with their equivalent hexadecimal escape sequences.

Syntax

${_varEncodeUrl('variableName')}

Parameters

  • variableName
    Required; Name of the variable whose value will be converted to a URL encoded string.
Example

Where Variable rawstring contains a value of “ABC$%^----DEF":

Panel

${_varEncodeUrl(‘rawstring’)} --> ABC%24%25%5E----DEF


Anchor
System Functions
System Functions
System Functions

Display Variables

Description

Displays all the defined and built-in variables associated with the task instance.

Syntax

${_scope}

Parameters

(none)

Example

Panel

Generate Random Number

Description

Generates a random number between max (inclusive) and min (inclusive)

Syntax

${_random([max, min])}

Parameters

  • max
    Optional; Upper bound (inclusive) on the random number. Default is 9.
  • min
    Optional; Lower bound (inclusive) on the random number. Default is 0.

Resolve to GUID (Globally Unique ID)

Description

Resolves to a 32-byte GUID (Globally Unique ID).

Syntax

${_guid}

Parameters

(none)

Resolve to Host Name

Description

Resolves to the hostname of the machine running the Controller, if available.

Syntax

${_hostname}

Parameters

(none)

Resolve to IP Address

Description

Resolves to the IP address of the machine running the Controller.

Syntax

${_ipaddress}

Parameters

(none)

Resolve to SYS_ID

Description

Resolves to the sys_id of the first task instance found within the same workflow specified by the sibling name.

Syntax

${_siblingid('sibling_name')}

Parameters

  • sibling_name
    Required; Sibling name.

Example

Panel

Resolve to Variable Value

Description

Locates the specified variable in the specified sibling task instance within the same workflow and resolves to the variable value.

Syntax

${_varLookup('sibling_name', 'variable_name'[,'def'])}

Parameters

  • sibling_name
    Required; Name of the sibling task instance from which the function is collecting the variable value.
  • variable_name
    Required; Name of the variable being collected by the function.
  • def
    Optional; Default value to return if the variable is not defined in the sibling task instance.

Resolve Variable

Description

Resolves the variable specified by the variable_name parameter and substitutes the default_value if the variable cannot be resolved.

Syntax

${_resolve('variable_name', 'default_value')}

Parameters

  • variable_name
    Required; Variable name.
  • default_value
    Required; Default value to use if the variable cannot be resolved.

Resolve Variable (Advanced)

Description

Resolves the variable specified by the variable_name parameter and substitutes the default value if the variable cannot be resolved.

Syntax

${_resolveadv('variable_name', 'default_value', [use_default_if_blank])}

Parameters

  • variable_name
    Required; Variable name.
  • default_value
    Required; Default value to use if the variable cannot be resolved.
  • use_default_if_blank
    Optional; Specification (true or false) for whether or not to use the default value if the variable is empty or blank. (If use_default_if_blank is false, _resolveadv behaves like _resolve.)

Anchor
Universal Task Functions
Universal Task Functions
Universal Task Functions

Convert Array Field Variable

Description

Given the variable name representing the Array field, generate a String of delimited Array field entry data.

Note
titleNote

The function does not support resolving embedded functions found within the content of the Array field; it, only supports the resolution of embedded variables.

Syntax

${_convertArrayFieldVariable('arrayFieldVariableName'[,'delimiter', 'separator', 'keyQuote', 'valueQuote'])}

Parameters

  • arrayFieldVariableName
    Required; Name of the variable for the Array Field; for example, ops_af_p2.
  • delimeter
    Optional; Value to be used to delimit the Name from the Value. Default is =.
  • separator
    Optional; Value to be used to separate one entry/row from the next. Default is comma (,).
  • keyQuote
    Optional; Quoting to be used around the Name. Default is "no quoting."
  • valueQuote
    Optional; Quoting to be used around the Value. Default is "no quoting."

Example

Panel

Get Array Field Variable Value

Description

Given the variable name representing the Array field and the name of an entry in the Array field, return the value for the entry.

Note
titleNote

The function does not support resolving embedded functions found within the content of the Array field; it, only supports the resolution of embedded variables.

Syntax

${_getArrayFieldVariableValue('arrayFieldVariableName', 'name')}

Parameters

  • arrayFieldVariableName
    Required; Name of the variable for the Array Field; for example, ops_af_p1.
  • name
    Required; Name of the entry for which the value is to be returned.

Example

Panel

Anchor
Web Service Functions
Web Service Functions
Web Service Functions

All functions will remain unresolved if no Web Service output record can be found for the task instance, for the current attempt.

All functions will remain unresolved if a required parameter either is not specified or specified incorrectly.

Raw Output from Web Service Task

Description

Resolves to the raw output data of the Web Service task instance that is resolving the function.

  • If the output record cannot be found, the function will remain unresolved.
  • If the output record is found, but the path expression does not yield a result, the function will resolve to the default value.

Syntax

${_responseRaw(['default_value'])}

Parameters

  • default_value
    Optional; Default value to return if the result is not found. Default is empty ('').

Raw Output from Sibling Web Service Task

Description

Resolves to the raw output data of the Web Service task instance specified by the siblingName parameter.
 
The sibling task instance must be within the same workflow, and the Execution User of the task instance that is resolving the function must have Read permission for the sibling task instance.

  • If the output record cannot be found, the function will remain unresolved.
  • If the output record is found but the path expression does not yield a result, the function will resolve to the default value.

Syntax

${_responseRawFromTask('siblingName'[,'defaultValue'])}

Parameters

  • siblingName
    Required; Name of a sibling task instance.
  • default_value
    Optional; Default value to return if the result is not found. Default is empty ('').

XML Output Data from Web Service Task

Description

Resolves to the XML output data of the Web Service task instance that is resolving the function, corresponding to the evaluated xPath expression.

  • If the output record cannot be found, the function will remain unresolved.
  • If the output record is found, but the path expression does not yield a result, the function will resolve to the default value.

Syntax

${_responseXPath('xPathExpression'[,'defaultValue','delimiter',prettyPrint])}

Parameters

  • xPathExpression
    Required; xPath expression, https://www.w3schools.com/xml/xpath_intro.asp
  • defaultValue
    Optional; Default value to return if the result is not found. Default is empty ('').
  • delimiter
    Optional; If xPathExpression evaluates to multiple results, the delimiter to be used to separate those results. Default is new line character (\n).
  • prettyPrint
    Optional; Specification (true or false) for whether or not XML output will be pretty printed (indented). Default is false.

Examples

If you want to obtain the info element text from the following Web Service Task XML output, you could use either of two examples for this Function.
 

Panel

 
Example 1

Panel

Select the info node in the document no matter where it is.
 
Example 2

Panel

Select the info node from a specific path in the document, starting from the root node.
 
Using either of these examples will resolve to the following: No changes detected for variable variableName, ignoring Set Variable command.

XML Output Data From Sibling Web Service Task

Description

Resolves to the XML output data of the Web Service task instance specified by the siblingName, corresponding to the evaluated xPath expression.
 
The sibling task instance must be within the same workflow and the Execution User of the task instance that is resolving the function must have Read permission for the sibling task instance.

  • If the output record cannot be found, the function will remain unresolved.
  • If the output record is found but the path expression does not yield a result, the function will resolve to the default value.

Syntax

${_responseXPathFromTask('siblingName','xPathExpression'[,'defaultValue','delimiter',prettyPrint])}

Parameters

  • siblingName
    Required; Name of a sibling task instance.
  • xPathExpression
    Required; xPath expression, https://www.w3schools.com/xml/xpath_intro.asp
  • defaultValue
    Optional; Default value to return if the result is not found. Default is empty ('').
  • delimiter
    Optional; If xPathExpression evaluates to multiple results, the delimiter to be used to separate those results. Default is new line character (\n).
  • prettyPrint
    Optional; Specification (true or false) for whether or not XML output will be pretty printed (indented). Default is false.

JSON Output Data From Web Service Task

Description

Resolves to the JSON output data of the Web Service task instance that is resolving the function, corresponding to the evaluated JsonPath expression.

  • If the output record cannot be found, the function will remain unresolved.
  • If the output record is found but the path expression does not yield a result, the function will resolve to the default value.

Syntax

${_responseJsonPath('pathExpression'[,'defaultValue','delimiter',prettyPrint])}

Parameters

  • pathExpression
    Required; JsonPath expression.
  • defaultValue
    Optional; Default value to return if the result is not found. Default is empty ('').
  • delimiter
    Optional; If pathExpression evaluates to multiple results, the delimiter to be used to separate those results. Default is new line character (\n).
  • prettyPrint
    Optional; Specification (true or false) for whether or not JSON output will be pretty printed (indented). Default is false.

JSON Output Data From Sibling Web Service Task

Description

Resolves to the JSON output data of the Web Service task instance specified by the siblingName, corresponding to the evaluated JsonPath expression.
 
The sibling task instance must be within the same workflow and the Execution User of the task instance that is resolving the function must have Read permission for the sibling task instance.

  • If the output record cannot be found, the function will remain unresolved.
  • If the output record is found but the path expression does not yield a result, the function will resolve to the default value.

Syntax

${_responseJsonPathFromTask('siblingName','pathExpression'[,'defaultValue','delimiter',prettyPrint])}

Parameters

  • siblingName
    Required; Name of a sibling task instance.
  • pathExpression
    Required; JsonPath expression.
  • defaultValue
    Optional; Default value to return if the result is not found. Default is empty ('').
  • delimiter
    Optional; If pathExpression evaluates to multiple results, the delimiter to be used to separate those results. Default is new line character (\n).
  • prettyPrint
    Optional; Specification (true or false) for whether or not JSON output will be pretty printed (indented). Default is false.

JSON Output Data As Array From Web Service Task

Description

Resolves to the JSON output data of the Web Service task instance that is resolving the function, corresponding to the evaluated JsonPath expression.

  • If the output record cannot be found, the function will remain unresolved.
  • If the output record is found but the path expression does not yield a result, the function will resolve to the default value.

Syntax

${_responseJsonPathAsArray('pathExpression'[,'defaultValue',prettyPrint])}

Parameters

  • pathExpression
    Required; JsonPath expression.
  • defaultValue
    Optional; Default value to return if the result is not found. Default is empty ('').
  • prettyPrint
    Optional; Specification (true or false) for whether or not JSON output will be pretty printed (indented). Default is false.

JSON Output Data As Array From Sibling Web Service Task

Description

Resolves to the JSON output data of the Web Service task instance specified by the siblingName, corresponding to the evaluated JsonPath expression.
 
The sibling task instance must be within the same workflow and the Execution User of the task instance that is resolving the function must have Read permission for the sibling task instance.

  • If the output record cannot be found, the function will remain unresolved.
  • If the output record is found but the path expression doesn't yield a result, the function will resolve to the default value.

Syntax

${_responseJsonPathAsArrayFromTask('siblingName','pathExpression'[,'defaultValue',prettyPrint])}

Parameters

  • siblingName
    Required; Name of a sibling task instance.
  • pathExpression
    Required; JsonPath expression.
  • defaultValue
    Optional; Default value to return if the result is not found. Default is empty ('').
  • prettyPrint
    Optional; Specification (true or false) for whether or not JSON output will be pretty printed (indented). Default is false.