Page History
...
env( string: <environment-variable>, string: <default> )
- The function reads the value of an existing OS environment variable. The name has to be specified in correct uppercase/lowercase spelling.
- If the environment variable does not exist then an error is raised and the Order fails. Alternatively an optional default value can be specified.
Examples:
Expression env( ('JS7_AGENT_CONFIG_DIR')
JSON "env( 'JS7_AGENT_CONFIG_DIR' )"
Sample Value /var/sos-berlin.com/js7/agent/var_4445/config
Expression env( 'JAVA_HOME', '/usr/lib/jvm/java-1.8-openjdk' )
JSON "env( 'JAVA_HOME', '/usr/lib/jvm/java-1.8-openjdk' )"
Sample Value /usr/lib/jvm/java-1.8-openjdk
Expression env( 'HOSTNAME', env( 'COMPUTERNAME' ) )
JSON "env( 'HOSTNAME', env( 'COMPUTERNAME' ) )"
Sample Value 2021-05-03 07:30:42
This example assumes the
$HOSTNAME
environment variable to be available for Agents running on Unix or the%COMPUTERNAME%
environment variable to be available for Agents with Windows.
now( format='yyyy-MM-dd hh:mm:ss', timezone='Europe/Berlin' )
- The job start date. This date can be formatted using Java date qualifiers. Optionally a time zone can be specified, by default the UTC time zone is used.
Examples:
Expression now( format='yyyy-MM-dd' )
JSON "now( format='yyyy-MM-dd' )"
Sample Value 2021-05-03
Expression now( format='yyyy-MM-dd hh:mm:ss' )
JSON "now( format='yyyy-MM-dd hh:mm:ss' )"
Sample Value 2021-05-03 07:30:42
Expression now( format='yyyy-MM-dd hh:mm:ssZ', timezone="Europe/Berlin" )
JSON "now( format='yyyy-MM-dd hh:mm:ssZ', timezone=\"Europe/Berlin\" )"
Sample Value 2021-05-03 09:30:42+02:00
scheduledOrEmpty( format='yyyy-MM-dd hh:mm:ss', timezone='Europe/Berlin' )
- The date for which an order is scheduled.
- The date formatting options are the same as explained with the
now()
function.
...
replaceAll( string: String, regex: String, replacement: String)
- Similar to the Java replaceAll method.
- Use of on
$
und\
inreplacement
: If capturing groups from theregex
are used inreplacement
e.g.$1
, then$1
is not a variable but an identifier ofreplaceAll
similar to the Java methodreplace($myString, 'x', '-->$1<--')
.replacement
. Examples:
Expression replaceAll( $js7OrderId, '^#([0-9]{4}-[0-9]{2}-[0-9]{2})#.*$', '$1' )
JSON "replaceAll( $js7OrderId, '^#([0-9]{4}-[0-9]{2}-[0-9]{2})#.*$', '$1')"
Sample Value 2021-06-27
This example extracts the daily plan date from the build-in
$js7OrderId
variable, e.g. from an Order ID#2021-06-27#
P0000000412-jdScheduleBusinessDays
the date is extracted.
...
jobResourceVariable( string: <JobResource>, string: <Variable> )
- The function provides access to JS7 - Job Resources: it reads from the Job Resource specified with the first argument and returns the value of the Job Resource variable specified with the second argument. The function is evaluated by the Controller when adding an order. It is therefore not required to specify the requested Job Resource outside of the function. In fact the Controller reads the respective variable values from the indicated Job Resources and adds them to an Order Variable that is consider final and cannot be modified later on.
- This function can be used with the variable declaration of a workflow only. It cannot be used with later job arguments or environment variables.
Examples:
Expression jobResourceVariable( 'database', 'db_user' )
JSON "jobResourceVariable( 'database', 'db_user' )"
Sample Value scott
Expression jobResourceVariable( 'database_' ++ $country, 'db_user' )
JSON "jobResourceVariable( 'database_' ++ $country, 'db_user' )"
Sample Value tiger
This example dynamically specifies the name of the Job Resource by concatenating the fixed value
'database_'
and the value of the$country
order variable.
Further Resources
...