JS7 - Variables are used to parameterize the execution of jobs in a workflow. Variables are declared for the workflow by specifying a name and data type and optionally a default value. Variables can be used in a number of places:
- As an Environment Variable: the environment variable is available for all shell jobs in a workflow.
- As a Job Resource: You can assign a set of variables to a job resource and attach the job resource to an individual job. If the job resources are attached to the workflow, the variables will be available for all the jobs in the workflow.
- As an Order Variable: You can declare variables with a workflow and assign or modify values when adding an order to the workflow.
The 03_VariablesPassing folder contains workflows used for passing variables. You can add an order from the action menu of the workflow.
In this example, variables are updated from job node properties. The two variables are declared in a workflow BOOKING_CODE and FLIGHT_DESTINATION. The value for the BOOKING CODE does not change during the whole workflow. We can change the value of the FLIGHT_DESTINATION variable at the time of adding the order and while executing the order in a workflow. Here, the value would be updated from the node properties of the jobs.
To execute the workflow from the 03_VariablesPassing folder follow the below steps:
- Click the 03_VariablesPassing folder and expand the jdVariablesNodes workflow.
- To add an order in the workflow, click the action menu of the workflow and select Add Order from the drop-down menu.
- When clicking Add Order a popup window will appear.
- You can add an Order ID or leave the Order ID value empty, it will then use a default Order ID.
- With the Modify Variable link you can edit the value of the variable assigned to the order.
- Click Modify Variable, and select the name of the variable that you want to modify from the drop-down menu. The screenshot shows the flight_destination variable with the default value Japan. The variable and default value are declared in the workflow definition. Click the Submit button to add the order to the workflow.
- To check the status of the order click on the name of the workflow. This will make the Order History panel appear.
- In the Order History panel you can verify if the order is successful and has finished. Click on the Order ID to see log output created by jobs executed for this order.
- A log window will open and the order log will be displayed. The order log contains log output from all jobs executed by the order.
- You can download the log file by clicking the Download button in the upper right-hand corner of the log window. Also, you can expand and collapse the individual job output using the arrow button in the left-hand corner of the log window.