Study guide

3.3 Optional Actions, Approvals & Case Resolution

Pegasystems Certified Pega System Architect CSA

Track your progress as you read

Finished sections get a check mark.

1 Chapter 1: Exam Overview & Architecture Foundations

1.1 Certified Pega System Architect Exam Format, Blueprint & Strategy 1.2 Pega Architecture & Enterprise Class Structure (ECS) 1.3 Studio Environments: App Studio, Dev Studio, Admin Studio & Prediction Studio

2 Chapter 2: Case Lifecycle Design & Core Workflows

2.1 Case Types, Stages, Processes, and Steps 2.2 Routing Strategies: Worklists, Work Queues, and Teams 2.3 Service Level Agreements (SLAs) & Urgency Calculations

3 Chapter 3: Advanced Case Management Patterns

3.1 Multi-Step Processes, Parallel Processing & Sub-processes 3.2 Child Cases, Data Propagation & Wait Steps 3.3 Optional Actions, Approvals & Case Resolution 3.4 Duplicate Case Detection, Automation Shapes & Automated Correspondence

4 Chapter 4: Data Modeling & Data Page Architecture

4.1 Data Objects, Property Modes & Page Types 4.2 Data Pages: Scope, Types & Refresh Policies 4.3 Data Transforms & Object Mapping

5 Chapter 5: Business Logic, Calculations & Decisioning

5.1 Declare Expressions & Declarative Network Chaining 5.2 Decision Tables & Decision Trees 5.3 Integration Connectors, Systems of Record & Error Handling

6 Chapter 6: User Interface & User Experience Design

6.1 Traditional UI vs Constellation Architecture 6.2 Views, Dynamic Layouts, Design Templates & Action Sets 6.3 Form Validation, Edit Validate & WCAG Accessibility 6.4 Form Views: Default vs Hierarchical Forms, Field Groups & Primary Fields

7 Chapter 7: Rule Architecture & Rule Resolution

7.1 Rulesets, Versioning & Ruleset Stack Hierarchy 7.2 The Rule Resolution Algorithm 7.3 Circumstancing & Rule Specialization

8 Chapter 8: Security & Access Control

8.1 Authentication, Operator Records & Access Groups 8.2 Role-Based Access Control: Access Roles, ARO & Privileges 8.3 Attribute-Based Access Control (ABAC), Encryption & Audit Trails 8.4 The Security Checklist & Secure Deployment

9 Chapter 9: DevOps, Testing & Application Quality

9.1 Guardrail Compliance, Best Practices & Performance Profiling 9.2 Automated Testing: Pega Unit Test Cases & Scenario Testing 9.3 Packaging, Branching & Deployment Manager CI/CD

10 Chapter 10: Reporting & Operational Analytics

10.1 Report Definitions: Querying, Columns, Summaries & Joins 10.2 Filtering, Parameters & Column Exposure Optimization 10.3 Insights, Visual Dashboards & Business Metrics

11 Chapter 11: Mobility, Digital Channels & Portals

11.1 Mobile Channel Configuration & Offline Processing 11.2 Web Mashup, Digital Channels & Constellation Embed 11.3 Channels, Personas, Portals & Landing Pages

12 Chapter 12: Center-out Architecture, Enterprise Reuse & Agile Delivery

12.1 Center-out Business Architecture & the Case for Pega 12.2 The Situational Layer Cake, Modules & Enterprise Reuse 12.3 Agile Workbench, Workspaces, Branches, Delivery Roles & the Estimator

13 Chapter 13: Pega GenAI for System Architects

13.1 Pega Blueprint: Creating, Importing & Modifying an Application Design 13.2 Pega GenAI Autopilot & Pega GenAI Coach 13.3 Pega GenAI Connect Rules, Knowledge Buddy, Agents & Tool Rules

3.3 Optional Actions, Approvals & Case Resolution

Key Takeaways Explain This Topic AI

Optional actions provide out-of-sequence user actions or processes without disrupting the primary stage path, scoped either to a specific stage or across the entire case lifecycle.

Optional User Actions execute a single screen flow action to update data, while Optional Processes launch multi-step flow rules containing assignments and routing.

Cascading approvals enforce multi-tiered organizational governance using either a Reporting Manager hierarchy (traversing pyReportTo) or an Authority Matrix (evaluating Decision Tables into a Page List).

The Authority Matrix pattern is required when approvers do not follow the submitter's direct supervisory chain or depend on multi-attribute matrix criteria like cost center, risk rating, and department.

Case resolution requires updating pyStatusWork to a value prefixed with 'Resolved-', which automatically closes active assignments, releases locks, halts SLAs, and records completion timestamps.

Last updated: September 2026

3.3 Optional Actions, Approvals & Case Resolution

CSA Exam Focus: Enterprise business operations rarely follow a purely linear path. The Certified Pega System Architect exam heavily emphasizes non-linear patterns, including Optional Actions (User Actions vs. Processes, Stage-only vs. Case-wide), multi-tiered Cascading Approvals (Reporting Manager vs. Authority Matrix), and proper case resolution mechanics using standard status conventions.

Optional Actions: Enabling Non-Linear Workflows

While the primary stage lifecycle defines the expected, standard path of a case, users frequently need the ability to perform ad-hoc, discretionary activities outside the normal sequence of steps. Pega provides Optional Actions to support these requirements without cluttering the primary case progression.

Scoping Optional Actions: Stage-Only vs. Case-Wide

Optional actions can be scoped in two distinct ways within Case Designer:

Stage-Only Optional Actions : Configured under the Workflow tab of a specific stage. These actions are accessible to operators in the User Portal only while the case currently resides within that stage. For example, during an Underwriting stage, an underwriter might have a stage-only action to Request Supplemental Medical Records . Once the case advances to the Policy Issuance stage, that action disappears from the user's available actions menu.

Case-Wide Optional Actions : Configured under the Workflow > Case-wide optional actions section. These actions are globally available throughout the entire case lifecycle, across all primary and alternate stages, until the case reaches resolution. Examples include Update Contact Information , Add Case Note , Change Beneficiary , or Withdraw/Cancel Case .

Optional User Action vs. Optional Process

Within either scope, an optional action can be modeled as either a single-step action or a multi-step process:

  • Feature Optional User Action Optional Process
  • Underlying Rule Flow Action ( Rule-Obj-FlowAction ) Flow Rule ( Rule-Obj-Flow )

User Experience Opens a single modal dialog or screen view Launches a multi-step process with its own assignments

Routing Executed immediately by the current user Can route assignments to different users, work queues, or external parties

Impact on Primary Flow Updates case data and returns user to the current assignment; does not alter stage progression Can run in parallel with the main path or temporarily divert case progression until completed

Common Use Cases Update Phone Number, Add Attachment, Log Phone Call Initiate Fraud Investigation, Dispute Transaction, Cancel & Refund Order

In the Pega Constellation or Theme Cosmos user interface, optional actions are exposed to end users through the Actions menu on the case summary header or workspace panel.

Approval Workflows: Single vs. Cascading Approvals

Approval steps represent checkpoints where designated stakeholders evaluate case information and decide whether work should proceed, be rejected, or be routed back for rework.

Single Approval Step

Configured directly in Case Designer by adding an Approve/Reject step. Pega allows routing single approvals to:

Specific User : Routes to a designated operator's personal worklist.

Work Queue : Routes to a shared functional queue (e.g., FinanceApprovals@Finance ).

Reporting Manager : Routes dynamically to the submitter's direct manager based on the operator's organizational hierarchy.

When configuring an Approve/Reject step, the architect designates what occurs upon rejection: the case can advance to an Alternate Stage (e.g., Rejection ), resolve immediately with a status of Resolved-Rejected , or route back to a previous stage for correction.

Cascading Approvals

Many business processes require multi-tiered governance where a single sign-off is insufficient. For instance, high-value expenditures, sensitive security access requests, or complex insurance claims demand multiple successive approvals before execution. Pega supports this through Cascading Approvals .

  • Pega provides two distinct cascading approval models: +---------------------------------+
  • | Cascading Approval Model |
  • +----------------+----------------+
  • |
  • +-----------------------------+-----------------------------+
  • | |
  • v v
  • [Reporting Manager Hierarchy] [Authority Matrix]
  • Based on organizational chart (pyReportTo) - Based on business rules & decision tables
  • Follows direct supervisory chain - Routes to arbitrary, cross-functional approvers
  • Evaluates approval levels or thresholds - Populates an Approver Page List property
  • Best for: Internal expense reports, PTO - Best for: Capex, Legal, IT Security, Matrix orgs
  • Cascading Approval Pattern 1: Reporting Manager Hierarchy

The Reporting Manager model routes approvals sequentially up the submitter's management reporting chain. Pega navigates this hierarchy using the pyReportTo property stored on the operator record ( Data-Admin-Operator-ID ).

Configuration Options

In Case Designer, when selecting Cascading Approval based on Reporting Manager, the architect configures the stopping criteria:

All Managers in Hierarchy : Routes to the direct manager, then that manager's manager, continuing all the way to the top executive in the organization structure.

Custom Approval Threshold / Levels : Evaluates a business condition or threshold (e.g., purchase total). For example:

Purchases up to $1,000: Approved by Direct Manager ( pyReportTo ).

Purchases up to $10,000: Requires 2nd-level Director approval.

Purchases over $10,000: Requires 3rd-level Vice President approval.

Once an approver at or above the required approval level submits an approval, the cascading approval completes, and the case advances to the next step.

Cascading Approval Pattern 2: Authority Matrix

In modern matrix organizations, approval authorities rarely align strictly with an employee's direct line manager. Approvals often depend on multiple dynamic case attributes—such as product category, risk classification, geographic region, and total dollar exposure. Furthermore, required approvers may include cross-functional specialists (e.g., Legal Counsel, Compliance Officer, Chief Information Security Officer) who exist entirely outside the submitter's management chain.

For these scenarios, Pega provides the Authority Matrix cascading approval pattern.

Architectural Components of an Authority Matrix

An Authority Matrix relies on three coordinated components:

A Page List Property : A collection property on the case type (commonly named .ApproverList and typed to Embed-ApprovalList or a specialized data class). Each page in the list represents an approval step and contains properties such as .pyApprover (operator ID or work queue) and .pyApprovalLevel .

A Decision Table : Evaluates case attributes (e.g., .Department , .TotalExpense , .ContractRiskTier ) and returns the designated approver and required role.

A Data Transform or Activity : Queries the Decision Table, iterates across business rules, and appends the necessary approver records onto the Page List property before the approval step executes.

  • Step-by-Step Configuration of an Authority Matrix Approval Step 1: Define Data Model
  • Create Page List property on Case Type: .ApproverList (Class: Embed-ApprovalList)
  • Step 2: Build Decision Table (e.g., DetermineApprovers)
  • Condition Columns: .ExpenseType | .AmountThreshold | .Department
  • Action Column: Return Approver Operator ID (e.g., "cfo@company.com", "legal_lead@company.com")

Step 3: Populate Page List via Data Transform

Execute Data Transform during stage entry or pre-approval routing.

Data transform appends rows to .ApproverList with .pyApprover and .pyApprovalLevel.

  • Step 4: Configure Approval Step in Case Designer
  • Step Type: Cascading Approval
  • Approval Model: Authority Matrix
  • Approver List Property: .ApproverList
  • Approver Identifier: .pyApprover

When the case reaches the Cascading Approval step, Pega automatically iterates through .ApproverList , generating sequential approval assignments for each operator or work queue on the list. If any approver rejects, Pega halts the cascade and routes the case to the configured rejection path.

Case Resolution Best Practices

Case resolution marks the official conclusion of a case lifecycle. A case should only be resolved when all business goals have been achieved or when work is formally abandoned, rejected, or cancelled.

The Update Status Smart Shape and Stage Resolutions

In Case Designer, resolution is typically configured on the Resolution Stage (an alternate stage marked with the flag "Resolve the case"), or by inserting an Update Status automation step ( Rule-Obj-Flow ) in the final stage process.

The Mandatory "Resolved-" Prefix Convention

Critical CSA Rule: In Pega, a case is officially recognized as resolved by the platform engine only when its pyStatusWork property value begins with the standard prefix Resolved- (case-sensitive).

Standard Pega resolution statuses include:

Resolved-Completed : The case successfully completed all required business steps and objectives.

Resolved-Rejected : The case was reviewed and formally denied during an approval or evaluation step.

Resolved-Withdrawn : The customer or initiator withdrew their request before completion.

Resolved-Cancelled : The system or an administrative operator aborted processing.

Resolved-Duplicate : The case was identified as a duplicate of another existing case.

System Actions Triggered by "Resolved-"

When pyStatusWork is set to a status starting with Resolved- , Pega's internal case engine automatically executes critical system housekeeping:

Deletes Open Assignments : Searches the Assign-Worklist and Assign-WorkBasket tables and closes out all active assignments associated with the case, ensuring no work items remain lingering in queues.

Halts Service Level Agreements (SLAs) : Automatically terminates all active SLA timers ( System-Queue-ServiceLevel ), preventing false past-due escalations or notifications.

Releases Locks : Purges any held locks from System-Locks .

Records Resolution Metadata : Automatically stamps the resolution timestamp ( pyResolveTimestamp ), the resolving user's Operator ID ( pyResolvedBy ), and the resolving work group ( pyResolvedByWorkgroup ).

Excludes from Active Reporting : Excludes the case from standard operational "Work In Progress" (WIP) reports and dashboard metrics, archiving it for historical reporting.

Common Anti-Pattern : Setting pyStatusWork to custom non-prefixed values like Closed , Finished , or Archived . Doing so updates the string property on the clipboard but fails to trigger Pega's resolution automation, leaving orphan assignments active and SLA timers running indefinitely.

Loading diagram... Authority Matrix Cascading Approval Flow and Case Resolution