Admin Job Chains - Revision history

Carfey: Carfey moved page Admin Job Chains 4.0 to Admin Job Chains without leaving a redirect

2016-07-01T17:10:26Z

Carfey moved page Admin Job Chains 4.0 to Admin Job Chains without leaving a redirect

← Older revision	Revision as of 17:10, 1 July 2016
(No difference)

Carfey: /* Chain Tree View */

2016-06-29T23:06:22Z

Chain Tree View

← Older revision		Revision as of 23:06, 29 June 2016
Line 13:		Line 13:
	== Chain Tree View ==		== Chain Tree View ==

	Complex chain setups can be difficult to understand at times. To facilitate understanding how the chains relate to each other, Obsidian provides a tree view of chains. Click on the ''View Tree'' link at the top right of the table to view the tree diagram.		Complex chain setups can be difficult to understand at times. To facilitate understanding how the chains relate to each other, Obsidian provides a tree view of chains. Click on the ''View Tree'' link at the top right of the chain listing table to view the tree diagram.

	Enabled jobs are always shown as a root job in addition to any chain source jobs not found in another tree. If a job is not Enabled and is found in another chain tree, it will not be shown as a root job.		Enabled jobs are always shown as a root job in addition to any chain source jobs not found in another tree. If a job is not Enabled and is found in another chain tree, it will not be shown as a root job.

Carfey: /* Adding or Updating a Job Chain */

2016-06-29T22:59:37Z

Adding or Updating a Job Chain

← Older revision		Revision as of 22:59, 29 June 2016
Line 39:		Line 39:
	'''Note:''' The question mark icon that appears next to the form title indicates inline help. Click on the icon to see help related to the current page.		'''Note:''' The question mark icon that appears next to the form title indicates inline help. Click on the icon to see help related to the current page.

	[[Image:~~ChainSave_4~~.0.png]]		[[Image:ChainEdit_4.0.png]]

	== Conditional Chaining Configuration ==		== Conditional Chaining Configuration ==

Carfey: /* Confirming Changes */

2016-06-29T22:58:42Z

Confirming Changes

← Older revision		Revision as of 22:58, 29 June 2016
Line 61:		Line 61:
	Once you've completed your desired changes, click the Save button at the bottom of the form. You will either receive a save confirmation message as below, or a validation error message.		Once you've completed your desired changes, click the Save button at the bottom of the form. You will either receive a save confirmation message as below, or a validation error message.

	[[Image:~~NewChain_4~~.0.~~PNG~~]]		[[Image:ChainSave_4.0.png]]

	== Deleting ==		== Deleting ==

Carfey: /* Adding or Updating a Job Chain */

2016-06-29T22:57:47Z

Adding or Updating a Job Chain

← Older revision		Revision as of 22:57, 29 June 2016
Line 39:		Line 39:
	'''Note:''' The question mark icon that appears next to the form title indicates inline help. Click on the icon to see help related to the current page.		'''Note:''' The question mark icon that appears next to the form title indicates inline help. Click on the icon to see help related to the current page.

	[[Image:~~ConditionalChain_4~~.0.png]]		[[Image:ChainSave_4.0.png]]

	== Conditional Chaining Configuration ==		== Conditional Chaining Configuration ==

Carfey: /* Conditional Chaining Configuration */

2016-06-29T22:52:28Z

Conditional Chaining Configuration

← Older revision		Revision as of 22:52, 29 June 2016
Line 45:		Line 45:
	Conditional triggers are similar to Completed triggers, in that they only fire when a job successfully completes. The Conditional state, however, lets you indicate various output conditions which determine if the chain is triggered.		Conditional triggers are similar to Completed triggers, in that they only fire when a job successfully completes. The Conditional state, however, lets you indicate various output conditions which determine if the chain is triggered.

	If you select the Conditional trigger state, the ''Result Conditions'' area will be revealed below the state selector. In this section, you must specify at least one condition which is used to determine if the chain will fire. Each condition must be matched for the chain to be triggered. See [[Chaining~~\|Job chains~~]] for complete details on how conditional chaining works.		If you select the Conditional trigger state, the ''Result Conditions'' area will be revealed below the state selector. In this section, you must specify at least one condition which is used to determine if the chain will fire. Each condition must be matched for the chain to be triggered. See [[Chaining]] for complete details on how conditional chaining works.

	Each condition has the following fields, all of which are mandatory when presented: Variable Name, Operator, and Value. Note that the Value field is not shown for the ''Exists/Not Exists'' operators, and supports multiple values for the ''In/Not In'' operators.		Each condition has the following fields, all of which are mandatory when presented: Variable Name, Operator, and Value. Note that the Value field is not shown for the ''Exists/Not Exists'' operators, and supports multiple values for the ''In/Not In'' operators.

Carfey: /* Chain Tree View */

2016-06-29T22:52:08Z

Chain Tree View

← Older revision		Revision as of 22:52, 29 June 2016
Line 13:		Line 13:
	== Chain Tree View ==		== Chain Tree View ==

	Complex chain setups can be difficult to understand at times. To facilitate understanding how the chains relate to each other, Obsidian provides a tree view of chains . Click on the ''View Tree'' link at the top ~~left~~ of the table to view the tree diagram.		Complex chain setups can be difficult to understand at times. To facilitate understanding how the chains relate to each other, Obsidian provides a tree view of chains. Click on the ''View Tree'' link at the top right of the table to view the tree diagram.

	Enabled jobs are always shown as a root job in addition to any chain source jobs not found in another tree. If a job is not Enabled and is found in another chain tree, it will not be shown as a root job.		Enabled jobs are always shown as a root job in addition to any chain source jobs not found in another tree. If a job is not Enabled and is found in another chain tree, it will not be shown as a root job.

Carfey: Created page with "Job chains allow you to trigger job execution when another job completes or transitions to a terminal state. This screen can be accessed by all users from the pri..."

2016-06-29T22:51:34Z

Created page with "Job chains allow you to trigger job execution when another job completes or transitions to a terminal state. This screen can be accessed by all users from the pri..."

New page

[[Chaining|Job chains]] allow you to trigger job execution when another job completes or transitions to a terminal state. This screen can be accessed by all users from the primary navigation sidebar, underneath the Configuration parent menu item.

== Job Chain Listing ==

The initial job chain screen shows a listing of configured chains. You may optionally filter by selecting one or more source jobs to see which jobs are chained from those selected jobs. Selecting no jobs is equivalent to choosing all of them. Selected options may be cleared by clicking the (X) next to the dropdown arrow. Click ''Search'' to refresh the results table.

Clicking the description in the table will bring you to the edit screen.

To create a new chain, click the (+) button in the table header.

[[Image:ViewChains_4.0.png]]

== Chain Tree View ==

Complex chain setups can be difficult to understand at times. To facilitate understanding how the chains relate to each other, Obsidian provides a tree view of chains . Click on the ''View Tree'' link at the top left of the table to view the tree diagram.

Enabled jobs are always shown as a root job in addition to any chain source jobs not found in another tree. If a job is not Enabled and is found in another chain tree, it will not be shown as a root job.

'''Asterisks (*)''' mark jobs that will not be executed due to their current job state (e.g. Disabled or Ad Hoc Active).

'''Hash signs (#)''' mark the target job of a chain that is not currently active.

[[Image:.ViewChainTree_4.0.png]]

== Adding or Updating a Job Chain ==

When adding or updating a job chain, a source and target job must be selected, along with at least one trigger state.

The source job indicates the job whose completion will trigger the target job to be run.

The trigger states indicate which source job termination states will trigger the target job run. Default trigger states are selected when creating a new chain since they are the commonly used options, but they may be changed to whatever is required.

A description is optional for use in the chain listing. A description is generated if none is provided.

A schedule is optional and can be specified to restrict which times the target job may be spawned - if the source job terminates at a time that doesn't match the schedule, the target job will not be created.

When ''Conditional'' is selected as a trigger state, you must specify one or more conditions. In addition, only one of the ''Completed'' and ''Conditional'' state may be selected. See the ''Conditional Chaining Configuration'' below for more details on saving ''Conditional'' triggers.

'''Note:''' The question mark icon that appears next to the form title indicates inline help. Click on the icon to see help related to the current page.

[[Image:ConditionalChain_4.0.png]]

== Conditional Chaining Configuration ==

Conditional triggers are similar to Completed triggers, in that they only fire when a job successfully completes. The Conditional state, however, lets you indicate various output conditions which determine if the chain is triggered.

If you select the Conditional trigger state, the ''Result Conditions'' area will be revealed below the state selector. In this section, you must specify at least one condition which is used to determine if the chain will fire. Each condition must be matched for the chain to be triggered. See [[Chaining|Job chains]] for complete details on how conditional chaining works.

Each condition has the following fields, all of which are mandatory when presented: Variable Name, Operator, and Value. Note that the Value field is not shown for the ''Exists/Not Exists'' operators, and supports multiple values for the ''In/Not In'' operators.

To add an extra condition, click the ''Add Condition'' button. To remove an unwanted condition, click the ''Remove'' button at the bottom of that condition.

When using ''In/Not In'' operators, you may specify one or more values. To add a value, click the (+) button to the right of the value field. To remove an unwanted value, click the trash button on the right.

Always ensure you click the ''Save'' button to confirm your changes and validate your conditions.

[[Image:ChainConditions_4.0.png]]

== Confirming Changes ==

Once you've completed your desired changes, click the Save button at the bottom of the form. You will either receive a save confirmation message as below, or a validation error message.

[[Image:NewChain_4.0.PNG]]

== Deleting ==

We recommend you use the delete feature sparingly. It is typically most useful on long-obsolete chains. When you attempt to delete a job chain, Obsidian will ask for your confirmation.

Deleting a job chain in Obsidian assumes you are fine with losing the chaining evaluation results. Jobs will continue to show as either Chained or Chain Skipped, but the evaluation details will no longer be available.

[[Image:ChainDelete_4.0.png]]