Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The JS7 - Workflow Editor offers the Image Removed icon with the property editor to declare order variables:

Image Removed 

A popup window opens that offers to declare order to declare variable. Clicking into the workflow editor panel with display the workflow properties that offer to add variables:

Explanations:

  • Order variables are declared by specifying a name and data type.
    • If no default value is added then the order variable is mandatory, i.e. any orders have to specify a value for the variable.
    • If a default value is added then the order variable is optional, i.e. orders can specify a value and otherwise the default value is used.
    • Default values accept constant values and to not accept expressionsand JS7 - Expressions for Variables.
  • Any number of order variables can be declared.

...

  • to populate environment variables that are used in job scripts,
  • to populate node arguments,
  • to be evaluated by an expression in a JS7 - If Instruction.

Using Order Variables in Shell Jobs

...

Node Arguments are typically used in a situation when the same job occurs more than once in a Workflowworkflow. The basic assumption is that the job will make use of the same variables that should carry different values per node in which the job is used.

...

  • $js7WorkflowPath
    • The unique name of a workflow. Consider that the name does not include the folder location of a workflow.
  • $js7WorkflowPosition
    • The position of an order in the workflow.
  • $js7Label
    • The label of the current instruction for which an order is executed.
  • $js7OrderId
    • The order identifier.
  • $js7ControllerId
    • The Controller's identifier as specified on during installation.

Job

  • $js7JobName
    • The name of the current job for which an order is executed.
  • $js7JobExecutionCount
    • A counter for the number of times that the same job node is executed within a workflow, e.g. if used with the JS7 - Retry Instruction.
  • $epochMilli
    • The number of milliseconds since January 1st 1970 UTC.
  • $returnCode
    • The numeric exit code of the current job for which an order is executed.

...