Start a Graph
Start a Graph starts a specified graph from specified sandbox.
Table 20.8. Attributes of "Graph execution" task
| Task type | "Start a graph" |
| Start on | Node(s) to process the task. |
| Sandbox | This select box contains sandboxes which are readable for logger user. Select sandbox which contains graph to execute. |
| Graph | The graph to be executed.
This select box is filled with all graphs files accessible in selected sandbox. Type a graph name or path to filter available items. |
| Save run record | Saves run record to database.
If the task runs too often (once in several seconds), you can increase the database performance by disabling this. |
| Parameters |
List of parameters passed to the graph.
Event parameters like "EVENT_RUN_RESULT", "EVENT_RUN_ID" etc. are passed to the executed job without limitations. Parameters EVENT_RUN_RESULT and EVENT_RUN_ID are used in context of event listeners. They are not used in context of scheduling. |
Figure 20.3. Web GUI - Graph execution task
Please note that behaviour of this task type is almost the same as Start a Jobflow.
Parameters
You can start a graph with parameters.
To start a graph with parameter choose an existing parameter from a list, set its value, and click the plus sign button at the end of line.
Figure 20.4. Web GUI - Graph execution task
If the graph is started by event listener, it receives some additional parameters from the triggering job.
Parameters passed to graph by Event Listeners
Table 20.9. Additional parameters available in Event Listeners
| EVENT_USERNAME | Username of the user who caused the event |
| EVENT_USER_ID | Numeric ID of the user who caused the event. |
| EVENT_RUN_SANDBOX | Code of the sandbox containing the graph/jobflow |
| EVENT_RUN_JOB_FILE | Sandbox-relative path to the graph/jobflow file. |
| EVENT_RUN_RESULT | Current status of the graph/jobflow execution (N_A, READY, RUNNING, WAITING, FINISHED_OK, ERROR, ABORTED, TIMEOUT or UNKNOWN). |
| EVENT_RUN_ID | Numeric ID of the run record representing graph/jobflow execution. |
| EVENT_JOB_EVENT_TYPE | Graph/Jobflow event type that triggered the task. |
| EVENT_TIMEOUT | Specified timeout (in milliseconds) for the TIMEOUT event to occur |