Editing an Existing Rule
On the default page of the Policy tab, click the name of
the rule that you want to edit.
The Rules page is re-displayed with blank editable text boxes.
- In the <rule name> text box, change the descriptive title as required. This is title displayed in the rule tree on the default page of the Policy tab.
In the <test> drop-down list, select a
different test if a change is wanted.
Depending on the test that you choose, additional text boxes may be displayed, which must be selected or filled, as appropriate. See "About Tests" for more information on these choices.NoteOptionally, you can add multiple tests by clicking add test, or remove unwanted tests by clicking the delete icon [x] immediately below the appropriate row. You can also change the order of multiple tests by clicking the up or down arrow icons immediately beneath the appropriate row.
In the actions drop-down list, select the action that
you want to use.
Depending on the action that you choose, additional text boxes may be displayed, which must be selected or filled, as appropriate. See "About Actions" for more information on these choices.NoteOptionally, you may add rules as part of the action taken, or add multiple actions by clicking add test or remove unwanted rules or tests by clicking the delete icon [x] immediately below the row for the rule or test that you want to delete.
Copy, Cut, or
Delete the modified rule or Add
Alternative rule as appropriate.
While the policy is being edited, the edits are stored in a temporary file (policy.siv.edit). The changes are not made active until you Commit them. The following buttons are available when a rule is selected for editing:
NoteThe Copy, Cut and Paste options are significant because of the importance of rule sequence. See "Policy Rules: Order of Processing" for more information.
- Save: Writes the changes to the temporary policy file, policy.siv.edit.
- Cancel: Removes the changes without writing to the temporary policy file.
- Copy: Copies the current rule (along with its associated tests and actions), so that it may be pasted elsewhere in the policy script.
- Cut: Removes a rule (along with its associated tests and actions) from its current position, so that it may be pasted elsewhere in the policy script.
- Delete: Deletes the entire rule, including the associated tests and actions.
- Paste: Inserts the most recently cut or copied rule immediately after the currently selected rule. The new rule is displayed at the same level of the hierarchy as the preceding rule. The rule is added as an "IF" rule or an "ELSEIF" rule, depending on the context. If you click the Paste button in a rule that is the last in a series of nested rules (an "ELSE" rule), or if it is a stand-alone "IF" rule, then a new "IF" rule is added. However, if you click the Paste button in a rule that is an "ELSEIF" or "IF" rule, followed by either an "ELSEIF" or "ELSE" rule, then a new "ELSEIF" rule is added.
- Add Alternative: Multiple rules can be specified at the same hierarchical level of the policy. When a second rule is specified using the Add Alternative button, it creates an "or" condition between the new rule and the rule above. Therefore, the second rule is only executed if the test in the first rule is not true. When rules are added using the add rule button, it creates an "and" condition between the new rule and the rule above. Regardless of whether the test in the first rule is true, subsequent rules will be processed.
Commit, Revert, or generate a
While the policy is being edited, the edits are stored in the temporary policy.siv.edit file. When you have finished making changes to the policy, you can perform any of these actions:
- Commit: Writes the temporary policy file
(policy.siv.edit) to the "live" policy file
(policy.siv). NoteIt is strongly advised that you test the modified policy before you commit it. See "Testing the Current Policy" for information on this procedure.
- Revert: Deletes the temporary policy file (policy.siv.edit) and returns to the display of the unaltered policy file (policy.siv).
- Source Diff: Displays a comparison of the source code of the temporary policy file that contains the changes with the current "live" policy file.
- see the source: Displays the source code of the temporary policy file that contains the changes. To edit the source code, click the filename. To return to the graphical policy editor, click go to constructor mode.
- Commit: Writes the temporary policy file (policy.siv.edit) to the "live" policy file (policy.siv).