Operations (ops) from the palette offers the needed mechanisms to create rules for automation.
They all have a context menu with the following fields:
Operation configuration is common to all operations used in a rule. After clicking this option menu, a new window is raised up with an action tab and six window tabs.
Action tabs are:
- Cancel - To cancel all actions performed since last save and close configuration window.
- Save - Save all configuration and metadata. Once configuration is saved, op may include some tags to indicate some attribute values.
Windows tabs are:
- Configurable parameters to run the op:
Name - Name of the the operation.
Depending on the op it displays a window with the necessary fields to implement its target. Full information about each field will be described at the time particular op is presented.
- Configurable parameters to run the op:
Enabled - To activate the operation. Its default value is checked.
Return Key - Key stash defined by the user where output data is stored after op execution. Its value can be accessed through the stash in the form of:
Needs Rollback? - Rollback flag that controls whether or not to rollback in case of failure in the same pass.
If an error is detected, the rollback starts.
Its default value is ‘No Rollback Necessary’.
User chooses when the flag is set according to 4 options:
- Rollback Needed After - Flag is set after op execution.
- Rollback Needed Before - Flag is set before op execution.
- Rollback Needed Always - Flag is set at the time DSL building.
- No Rollback Necessary - Flag is not set.
- Needs Rollback Key - Related to the option above, it is a text field that is displayed when the
needs_rollback?option is set to a different value other than ‘No Rollback Necessary’. It defines the op to be executed in case of error. Rollback is implemented for scripting and fileman service op.
- Run Forward - Run if the pass is forward.
- Run Rollback - Run if the pass is rollback.
- Timeout - Number of seconds for the rule to run, if timeout is reached, rule stops with a message to inform the user.
- Semaphore Key - Asks for a time slot to execute the rule. After the rule is finished the semaphore is release.
- Parallel Mode - Defines how to run rules, in terms of parallel or serially processing. Its default value is ‘No
Parallel’. There are three available option:
- No Parallel - All ops are performed as they are located in rule.
- Fork and Wait - Rule is running in parallel way and afterwards, wait for children to finish.
- Fork and Leave - Parallel way processing but it doesn’t wait for children results.
- Error Handling - Defines how to treat op errors when they occur. Its default value is
Throw Errors. There are three options:
- Throw Errors - Op errors are not handled in any way, they will throw and the rule will finish in error.
- Trap Errors - Trap an error and wait for an user action, it can be:
- Retrying - Retrying op.
- Skipping - Skipping op.
- Ignore Errors - Error is ignored.
3. Root-Cause Analysis¶
Everything related to Root-Cause Analysis:
- Root Cause - Resource for performing the analysis.
See also Root-Cause Analysis.
Window including op metadata, which defines op configuration and behavior. It displays three columns containing:
- Key - Op attribute.
- Type - Attribute value type, it can be:
- Value - Key value is a simple type.
- Array - Key value is an array.
- Hash - Key value is a hash.
- Value - Key value.
Contents of this window depend on the selected type of op and the configuration defined above by the user. Following it is described common attributes to all ops when op is dragged from the palette to the rule:
Key- Op registered.
ID- Op instance id, value is in the form of
Name- Op name, it is a short description of what op.
Text- Its default value is the op name. This field can be changed through the rename action from op context menu.
Icon- Op image, describes what op does in a graphic way.
Leaf- Set to 0, this key indicates op holds or cand hold nested ops.
When metadata is saved others attributes are set, they are:
Data- This attribute is a hash with the data from the configuration form entered by the user.
Data_key- Contains the value from the return key configuration filled out by the user.
Disabled- Set to true if the op configuration ‘enable’ is not checked.
Expanded- True if op holds other ops nested.
Run_forward- This attribute is showed if the user manipulate configuration run_forward. Set to true if the configuration is checked.
Run_rollback- Showed if the user clicks on run_rollback configuration. Set to true if the configuration is checked.
Parallel_mode- Attribute that indicates the running process mode. It can have three different values:
- None - Process running in serial mode.
- Nohup - Process running in fork and leave mode.
- Fork - Process running in fork and way mode.
Error_trap- Attribute that indicates how to trap errors. It can have three different values:
- None - No trap error.
- Ignored - Ignore error.
- Trap - Trap error waiting for an action.
Semaphore_key- Contains the semaphore name filled by the user in semaphore_key option window.
Timeout- Attribute with the number of seconds to wait.
Note- Contains note tab contents.
Qtip- Same as note. Attributes depending on the type ops selected are:
- Holds_children - Indicates if op can hold other op nested inside.
- Nested - If value is 0, this attribute indicates that op is the beginning of code function.
- Children - Hash holding the nested ops.
- Id_rule - The value of this key is the id rule number.
Window including notes written by the user.
It displays a window including op notes entered by the user or for the user to include.
Copy op from rule tree area to clipboard.
Drops op from rule tree area to clipboard.
Copy op from clipboard nested to the op selected, if possible.
Displays a window with title DSL:
<rule name>. An action tab and three different areas are showed in DSL window, the
action tab is composed of:
- Run - button to run DSL code from DSL area. Areas are:
- Stash area - Textarea with stash variables in yaml format, variables can be set by the user, it the rule to run is of type job chain, three stash variables are showed by default:
- changesets: 
- elements: 
- job_step: CHECK
- DSL area - Textarea with DSL code from op and its configuration, this code can be changed and executed.
- Output area - Textarea with two tab
- Ouput - Result of DSL code execution.
- Stash - Stash values from DSL code execution.
- Toggle - Switch op state from enable to disable and viceversa. If op is not active a line through op is displayed.
- Delete - Remove op selected.