Back Forward RuleSet form
Completing the Security tab

About RuleSet rules

Complete this tab to specify whether you want this RuleSet to use the check out (rule management) facility. This facility requires developers to check out a rule before they can update it. This facility enhances security by controlling who can change rules in the RuleSet and prevents possible problems when two or more users attempt to change one rule at the same time.

When Use check-out? is in selected, the Check in (Check In) and Check out (Check out) buttons appear in the toolbar for most rules in the RuleSet. The Save button (Save) does not appear until a rule is checked out. (Rules of a few rule types cannot be checked out.)

You can also use the Security tab to lock this RuleSet by requiring developers to enter a password when they update the RuleSet, or add or update version instances for this RuleSet.

If the third password in the Define Passwords group contains asterisks, you must enter a matching password in the Enter Password Values group to save any updates to this rule.

CautionSet passwords carefully. If you set the third password in the Define Passwords group, no one can later update this RuleSet rule without first entering that same password in the Enter Password Values section.

Field

Description

Define Passwords  
To Add a Rule-RuleSet Version

Optional. Enter a password that a user must match before creating any additional RuleSet versions in this RuleSet. If this field is blank, no password is required.

To Update a Rule-RuleSet Version

Optional. Enter a password that a user must match before updating any RuleSet version in this RuleSet. If this field is blank, no password is required. When updating a RuleSet version, users must enter a value that matches this value in the To Add/Update this Version field on the Security tab of the Version form.

To Update this Rule-RuleSet Name

Optional. Enter a password that a user must match in the Enter Password Values area below when updating this RuleSet Name rule, including any of the passwords. If this field is blank, no password is required.

Enter Password Values  
To Update this Rule-RuleSet Name

To update this RuleSet Name rule, a user enters the same password in this field as the one you specify in the field of the same name in the Define Passwords section above.

Users only enter the password in this field when they want to update an existing RuleSet Name rule. Therefore, don't enter a value in this field when first creating the RuleSet Name rule.

Rule Management  
Local customization?

Select to record your intent that this RuleSet contains rules that tailor, override, and extend an application, rather than define an application. A local customization RuleSet is one not intended to be moved to other Process Commander systems. This is advisory only, this field has no functional effects.

If you select this box, do not select Use check-out?.

NoteDon't confuse local customization RuleSets, defined by this box, with localization or language-specific RuleSets, which support language-specific text.

Use check-out?

Select to enable rule management facilities for this RuleSet. The Check in (Check In) and Check out (Check out) buttons appear on the toolbar for rules in a RuleSet that is subject to rules management. The Save button does not appear until the rule is checked out.

To save a rule, users who have the Allow rule check out? box selected in the Advanced tab of their Operator ID data instances) can check the rule out, make changes, save the rule, and, when finished with the rule, check it in. Checking the rule in saves the rule, but you can also use Save independently before you check in the rule.

Clear this box if this RuleSet is not to use the rule management facility. For such RuleSets, if developers modify a rule, the Save button appears on the toolbar. See How to use the developer toolbar.

NoteWhen check-out is enabled, the system saves the entire previous rule each time you check in a new one, supporting the Restore (Restore) operation. See How to restore the earlier state of a rule.

NoteYou can't clear (deselect) this check box if anyone has one or more rules checked out from any version. Select View > Rules > Checkouts by RuleSet Version to see which rules are checked out.

TipAs a best practice — even for a RuleSet to be used only by yourself or by a small development team — select this check box. When a team of developers together work on a RuleSet that does not use checkout, rules are not locked as they are updated, so a risk of simultaneous updates exists; one user's changes may be overwritten. In addition, when checkout is not used, updated rules take effect immediately after a Save operation, which can be disruptive to other developers on a team, However, leave this box cleared for a RuleSet for Local customization, or one that is to contain only rules delegated to application users.

NoteRules in an override RuleSet can't be checked out. Leave this box unselected.
Work class used for approval process

SmartPromptOptional. Leave these two fields blank if the Use check-out? box is not selected. They support advanced rule management features, useful when a large development team is involved or when a development leader wants to review each change made by others on the development team before the changed rule is checked in.

To use a flow rule to manage development and check-in on this RuleSet, enter the work type to which the flow rule that controls check-ins applies. The standard work type named Work-RuleCheckIn is designed to support this process. See Using the Rule Check-in approval process.

Work flow to use for approvals

SmartPromptOptional. Enter the name of the flow rule that is to control rule check-in for this RuleSet. A standard flow rule named ApproveRuleChanges is the default. See Using the Rule Check-in approval process. Click the pencil icon (Pencil ) to review or edit the flow.

zzz About RuleSets