Version

    Chapter 34. Graph/Jobflow Parameters

    Parameters by Execution Type
    Adding Another Graph Parameters

    The CloverDX Server passes a set of parameters to each graph or jobflow execution.

    Keep in mind that ${paramName} placeholders (parameters) are resolved only during the initialization (loading of XML definition file), so if you need the parameters to be resolved for each job execution, you cannot set the job to be pooled. However, current parameter values are always accessible by an inline Java code: 

    String runId = getGraph().>getGraphProperties().getProperty("RUN_ID");

    Properties may be added or replaced:

    getGraph().getGraphProperties().setProperty("new_property", value);

    This is a set of parameters which are always set by CloverDX Server (for more information, see Execution Properties):

    Table 34.1. Defaults for graph execution configuration

    KeyDescription
    SANDBOX_CODE An identifier of a sandbox which contains the executed graph.
    JOB_FILEA path to the file (graph, subgraph, jobflow). The path relative to the sandbox root path.
    SANDBOX_ROOT An absolute path to sandbox root.
    RUN_IDAn ID of the graph execution. In a standalone mode or Cluster mode, it is always unique. It may be a value lower than 0, if the run record isn't persistent.
    PARENT_RUN_ID A run ID of the graph execution which is the parent to the current one. Useful when the execution is a subgraph, child-job of some jobflow or worker for distributed transformation in a Cluster. When the execution doesn't have a parent, the PARENT_RUN_ID is the same as RUN_ID.
    ROOT_RUN_ID A run ID of the graph execution which is the root execution to the current one (the one which doesn't have a parent). Useful when the execution is a subgraph, child-job of some jobflow or worker for distributed transformation in a Cluster. When the execution doesn't have a parent, the ROOT_RUN_ID is the same as RUN_ID.
    CLOVER_USERNAME The username of the user who launched the graph or jobflow.
    NODE_IDAn ID of the node running the graph or jobflow.