You are here: Reference > Data classes > Access Group data instances > Access Group form - Completing the Layout tab

Access Group form
Completing the Definition tab

  1. About 
  2. New 
  3. Definition 
  4. Advanced 
  5. Operators 
  6. History 
  7. More... 

Complete this tab to identify the application this access group is associated with, and the portals and access roles available to operators that reference his access group.

Application

Field

Description

Name

Enter the first key part of an application rule (Rule-Application rule type) to be available to all users associated with this access group. When a user logs in, the RuleSets and Versions identified in this application rule are added to the user's RuleSet list.

(Leave blank in legacy configurations only.)

You can refer to an application rule that lists RuleSets and versions, or list them directly in the Production RuleSets array on the Definition tab.

As a best practice, leave the Production RuleSets array blank and refer to an application rule. This approach helps minimizes the number of distinct RuleSet lists that users in your system employ. Using fewer distinct RuleSet lists can improve system performance and help avoid unplanned differences in RuleSet lists among users.

Version

Identify the second key part of an application rule.

Portals

Field

Description

Name

Identify a portal rule to indicate which portal presentation supports those requestors who reference this access group. Click the open rule icon to open the portal rule.

Select a portal layout that works with the Roles array. Typical choices referencing standard portal rules are:

  • For a worker, select the Case Worker portal pyCaseWorker.
  • For a manager, select the Case Manager portal pyCaseManager.
  • For all developers and system administrators, select the Designer Studio portal Developer.

Use the radio button to select the portal that displays the current application when you open it.

You can use the launch portal menu on the Designer Studio header to open the current application in another portal on this list. Updates to the list are real-time on save.

The Developer portal is designed to support application developers who have the PegaRULES:SysAdm4 access role. Do not enter Developer unless PegaRULES:SysAdm4 appears in the Roles array and Allow rule check out is selected on the Security tab in the Operator ID form.

Roles

Field

Description

Roles

Identify one or more access roles (Rule-Access-Role-Name rule type) that members of this access group are to acquire at login, in addition to access roles they may acquire from other sources.

For a development system, commonly assigned access role names use these standards:

  • For a worker, use PegaRULES:User4
  • For a work manager, use PegaRULES:WorkMgr4
  • For a business analyst, use PegaRULES:SysArch4
  • For developers and designers, use PegaRULES:SysAdm4

Enter an access role that is consistent with the default value you entered in the Portals field.

Order is not significant; the access roles available to a user act as a collection of capabilities granted, not a hierarchy.

For non-developer workers and work managers using an application, a best practice is to create and use custom access roles that define the capabilities of the role through Access or Role to Object rules.

The PegaRULES:ProArch4 role is supported but deprecated. Do not use for new development.

About Access Group data instances