Definitions and Calls

When you are creating a Workflow, there are different types of configuration overlays available. It's important to understand which overlays let you configure what.

Job Definitions and Job Calls

One key to understanding the Workflow Editor is knowing the difference between Job definitions and Job calls.

• A Job definition is an Object that defines what a Job is and how it works. It may include parameter definitions, but it does not include values for those parameters (other than their Default Expressions, if any). You can tell when you are editing a Job Definition because the configuration overlay is wide and contains multiple tabs across the top.

  

  Although you can edit some Job Definitions from within a Workflow, Job Definitions are not actually parts of a Workflow; Workflows simply refer to them. You can run a Job Definition separately or within the context of a Workflow.

• A Job call is a package of additional information that tells RunMyJobs how to run a specific Job definition in the context of a Workflow. You can tell when you are editing a Job call because the configuration overlay is narrow, has no tabs across the top, and does not let you change the Job Definition. A Job call is technically part of its parent Workflow.

  

  Note: Depending on the type of Job, you may be able to edit the Job Definition by scrolling to the bottom and clicking Edit Job Definition. Just keep in mind that if you do this, you are editing the definition of the Job, and any changes you make will affect all instances of that Job.

Workflow Definitions and Workflow Calls

It is equally important to understand the difference between Workflow Definitions and Workflow Configurations.

• A Workflow definition is technically a type of Job definition. It lets you define Workflow-level parameters, but it does not include values for those parameters (other than their Default Expressions, if any). You can tell when you are editing a Workflow definition because the configuration overlay is wide and contains multiple tabs across the top. To display the Workflow definition overlay, click the name of the Workflow in the Workflow Editor.

  

  You can run a Workflow definition separately, or within the context of another Workflow. A Workflow that is part of another Workflow is a sub-Workflow.

• A Workflow call is a package of additional information that tells RunMyJobs how to run a Workflow definition. It includes things such as default Status Handlers, which are not part of the Workflow Definition. You can tell when you are editing a Workflow call because the configuration overlay is narrow, has no tabs across the top, and does not let you change the Workflow definition. However, you can edit the associated Workflow definition by scrolling to the bottom and clicking Open Advanced Workflow Editor.

  To display the Workflow call overlay, click the START circle for the Workflow.