|
The Application Structure landing page helps you manage and understand the rulesets, rules, access groups and operators that make up your application. Additional options quickly show you referencing applications, allow you to invite collaborators to the development process, and (for those with permission) give you access to other applications on the system.
Access this landing page by selecting the 
> Application > Structure menu item.
The following tabs are available on this landing page:
This tab lists the RuleSets and RuleSet versions that make up your current application including those inherited from any built-on applications. It also allows you to lock versions and roll (increment) them to higher versions.
The display is organized by Current Application followed by the Built on Application(s) and is filtered by RuleSet and version, lock status, total number of rules, and number of checked out rules.
To open an application rule in the list, click its name.
Field | Description |
| RuleSet | The RuleSets and versions in the application. To open a RuleSet, click its name. |
| Lock | Contains an icon indicating the lock status of RuleSet versions for the application.
Click an icon to open a window that displays a list of versions, and for each version, the lock status and the number of total and checked out versioned and non-versioned rules such as RuleSet, class, organization instances, and so on. |
| Checked Out | The total number of checked-out versioned and non-versioned rules. |
| All Rules | The total number of versioned and non-versioned rules. Click a number to open a window listing the rule types and counts comprising the total. Click a row (including Total) in the list to drill down to a list of rule instances comprising a rule type. |
| Lock and Roll | Click to display the Application Lock and Roll window where you can review, lock current RuleSet versions, and roll (increment) versions in a single step. You can optionally update your current application rule to reflect the new versions, or create a new application rule that contains the new RuleSet versions. |
| Package and Export | (For the Current Application only.) Click to start the Application Package wizard, to create a product rule for this application. See About the Application Package wizard. |
In the window, select the application RuleSet versions you want to lock and roll to a higher version.
Field | Description |
| Lock | Check the checkbox to indicate you want to lock the RuleSet version and roll to a new version. Locking prevents a developer from saving new rule instances to this version, or updating or deleting existing instances. A A |
| RuleSet Version | The RuleSet and current version. Click When you lock a RuleSet version and select the Roll checkbox, you can modify the new prerequisites. By default, they are the same as the current ones. You can select different prerequisites, add additional ones, and delete ones from the New list. To add another RuleSet version to the list, click |
| Password | Appears when you select the Lock checkbox. Enter the password for the RuleSet Version. |
| Roll | Displays when Lock is checked. Check if you want to roll the RuleSet to a higher version. |
| Roll to Version | Displays the version that the RuleSet will be rolled to unless you indicate another version number. Defaults to the next logical number in the RuleSet numbering sequence. |
| Description | Current description of the RuleSet version. |
| Run | Select an option to run against the selected RuleSet versions.
|
This tab displays a tree view of RuleSets and versions and their prerequisites in the current application.
to expand the tree to show the prerequisite RuleSets and versions. A version in blue text indicates that it is listed as a top-level version in the application RuleSet list.This tab lists other applications that reference the current application.
Field | Description |
| Name and Version | This (referencing) application name and version. |
| Access Groups | The total number of access groups associated with this application. |
| Operators | The total number of operators associated with the access groups. |
| RuleSet | This application RuleSet. |
Use this tab to:
Field | Description |
Invite Collaborator | Click to invite people (via email) to collaborate in developing the application. For example, a Lead Business Analyst can invite other business analysts to edit and add specifications and requirements to the in-progress application. They might also invite subject matter experts to review the specifications. Upon clicking the link, the Invite Collaborator window opens for you to specify the information needed to send email invitations to the invitees. See Invite Collaborator window — Inviting collaborators. |
Access Group | The name of an access group referenced by the application. Select a name to see the list of users that reference that access group, and so have that level of access into the application. |
Operator Name | The names of operators who reference the access group. |
Operator ID | The IDs of operators who reference the access group. |
Administrators (operators with the PegaRULES:SysAdm4 role or a role based on that role) can use this tab to lock and roll applications in the PRPC system other than those in the RuleSet Stack of the current application. For example, when upgrading a PRPC it is considered best practice to lock all applications and create new RuleSet versions before resuming development.
This page displays all applications in the system that contain an unlocked RuleSet version and lists the RuleSets and RuleSet versions that make up each application including those inherited from any built-on applications.
To open an application rule in the list, click its name.
Field | Description |
| RuleSet | The RuleSets and versions in the application. |
| Lock | Contains an icon indicating the lock status of RuleSet versions for the application.
Click an icon to open a window that displays a list of versions, and for each version, the lock status and the number of total and checked out versioned and non-versioned rules such as RuleSet, class, organization instances, and so on. |
| Checked Out | The total number of checked-out versioned and non-versioned rules. |
| All Rules | The total number of versioned and non-versioned rules. Click a number to open a window listing the rule types and counts comprising the total. Click a row (including Total) in the list to drill down to a list of rule instances comprising a rule type. |
| Lock and Roll | Click to display the Application Lock and Roll window where you can review, lock current RuleSet versions, and roll (increment) versions in a single step. You can optionally update your current application rule to reflect the new versions, or create a new application rule that contains the new RuleSet versions. |
In the window, select the application RuleSet versions you want to lock and roll to a higher version.
Field | Description |
| Lock | Check the checkbox to indicate you want to lock the RuleSet version and roll to a new version. Locking prevents a developer from saving new rule instances to this version, or updating or deleting existing instances. A A |
| RuleSet Version | The RuleSet and current version. Click When you lock a RuleSet version and select the Roll checkbox, you can modify the new prerequisites. By default, they are the same as the current ones. You can select different prerequisites, add additional ones, and delete ones from the New list. To add another RuleSet version to the list, click |
| Password | Appears when you select the Lock checkbox. Enter the password for the RuleSet Version. |
| Roll | Displays when Lock is checked. Check if you want to roll the RuleSet to a higher version. |
| Roll to Version | Displays the version that the RuleSet will be rolled to unless you indicate another version number. Defaults to the next logical number in the RuleSet numbering sequence. |
| Description | Current description of the RuleSet version. |
| Run | Select an option to run against the selected RuleSet versions.
|
Application Structure landing page
— Indicates that the version for any given RuleSet is locked. Also indicates a locked application rule.
— Indicates that the version for any given RuleSet is unlocked. Also indicates an unlocked application rule.
— Warns you that a locked RuleSet version has lower unlocked versions. Click the icon to view a list that shows you which versions are unlocked. To lock an unlocked version, select it in the list, and its rule form opens where you can lock the version. As a best practice, leave only the highest version of a RuleSet unlocked. If the warning condition exists, you cannot roll (increment) a lower unlocked version using Lock and Roll functionality.
— Warns you that this RuleSet version does not exist but appears in your application rule. To correct, remove the version.
. To open the rule form for a RuleSet in the New list, click 
next to its name. To delete a RuleSet from the New list, click 
next to its name.
Tools — Application
Help Home