Then click the New Procedure button to open the Creating / Editing Agent Procedures dialog.
To edit an existing procedure:
Select the procedure.
Then click the Edit Procedure button to open the Creating / Editing Agent Procedures dialog. You can also double-click a procedure to edit it.
Note: Access to creating or editing a procedure depends on your Folder Rights.
The Agent Procedure Editor
The Procedure Editor has 3 main sections: the Statements pane, the Procedure pane, and the Properties pane. All statements you can add to an agent procedure display in the left-hand pane. Agent procedures display in the middle pane of the editor on one more tabs. The parameters for each statement display in the right-hand pane.
Note: See IF-ELSE-STEP Statements for a detailed explanation of each statement's parameters.
The Statements pane
The Statements pane contains the available IFS and STEPS (statements) that can be used to create each procedure line.
The Procedure pane
The Procedure pane displays all of the lines that make up the procedure script.
Action Buttons
These buttons display in the middle pane of the procedure editor.
Procedure
New - Creates an empty tab for a new procedure.
Open - Edits an existing procedure.
Save - Saves the currently selected procedure.
Save As - Saves the procedure to a different name. A dialog enables you to select the folder used to save the procedure.
Publish - Publishes the procedure to a shared folder.
Upload File - Uploads file to the File Manager.
Edit - The following buttons are only enabled when one or more statements are selected.
Undo - Undoes the last edit.
Redo - Redoes the last edit.
Cut - Cuts selected lines.
Copy - Copies selected lines.
Paste - Pastes copied lines.
Remove - Removes selected lines.
Goto Line - Selects the line number you specify.
Search - Searches for matching text in commands, parameters and values.
Insert Lines - Inserts a blank line that you can then begin typing into. This displays a drop-down list of commands that you can select a command from and insert into the procedure.
Indent Lines - Indents selected lines
Outdent Lines - Outdents selected lines.
Help
Help Tips - Display tooltips on how to use the procedure editor.
Online Help - Displays online help.
Auto Save - Allows to save automatically the opened procedures.
Dark/Light Mode - Toggles the interface between dark or light mode.
Toolbar - Provides commonly used actions to initiate quickly through a single mouse click.
Drag and Drop
Drag and drop any statement above or below any other statement.
Drag and drop any comment above or below any statement.
A statement is automatically indented when dropped below an IF statement, except for an ELSE statement.
You can nest steps within multiple IF or ELSE statements. Just drag-and-drop an IF or ELSE statement below an IF statement to insert it as a child statement.
The Properties pane
The Properties pane displays procedure and statement properties.
Editing lines
One method of editing procedure lines is by using the Properties Pane. Only a single procedure line can be edited at a time. If there are no lines selected, this pane can be used to edit overall procedure properties (such as the procedure description).
Guidelines
Click any STEP, IF or ELSE statement in the middle pane to see its settings in the right-hand pane. You can edit these settings in the right hand pane or click any value in a statement directly to edit it.
Multiple lines can be selected and acted on at one time.
Right click selected lines to get additional options.
Enter a value in search box in Statement pane to filter the list of statements you can select.
Hovering the cursor over any statement in Procedure pane displays a tooltip description of that statement. The same description displays on Properties pane.
Hovering the cursor to the left of selected statements displays icons. Click these icons to remove, indent or outdent selected statements.
When entering a value for a variable into a parameter:
Enter a < to select from a list of system variables.
Open and work on multiple procedures simultaneously. Each procedure you open displays in a separate tab. Copy and paste selected statements between tabs.
You can set a STEP to Continue on Fail. This allows a procedure to continue running even if that particular STEP fails.
Click the blank line at the bottom of the procedure to edit the description for the entire procedure.
icons. Click these icons to remove, indent or outdent selected statements.