You are here: Reference > Tools, accelerators, and wizards > Application Programmer interfaces

 Processes landing page

The Processes landing page gives visibility into the business processes implemented by your application.

Access it by selecting the > Process & Rules > Processes menu item.

The following tabs are available on this landing page:

 

Using the Flow Errors tab

This report lists flow errors that are routed to your worklist or work group in your current application by a getProblemFlowOperator activity. Each row identifies one flow problem. Rows may reflect a common condition or unrelated conditions from multiple applications.

Using the View errors located in drop-down list, select Worklist or Workbaskets to see flow errors that are routed to one or the other in your current application.

Column

Description

Add

Select to designate one or more rows that you want to apply your problem resolution choice as defined by the button you select on this tab.

Error Message

Underlying problem that caused the flow error.

ID

Identifier of work item associated with this error.

Flow

Name of the flow in which the error occurred. To open the flow, click the displayed name.

Step

Name of the problem flow step in which the error occurred (pyFlowParameters.ProblemFlowStep).

Operator

ID of operator to whose worklist the problem flow assignment is routed by the getFlowProblemOperator activity. To open the Operator ID rule, click the displayed name.

After you have diagnosed and addressed a problem, check the Add box in one or more rows of this report and click a button to implement your disposition of the problem.

Button

Result

Select All

Selects the Add box for every row in the report.

Deselect All

Clears the Add box for every row in the report.

Resume Flow

Click to resume flow execution beginning at the step after the step that paused, without re-executing any rule in the step that paused.

This choice is common after many types of repairs to rules or data objects. For example, if a flow is stuck at a Decision shape, you can either:

  • Update the flow to add a missing connector and click Resume Flow.
  • Update the decision tree, decision table, or map value to return a value that the flow already accepts, and click Retry Last Step.
Retry Last Step

Click to resume flow execution but begin by re-executing the step that paused. This choice is typically appropriate for connector failures or timeouts.

Restart Flow

Click to start flow at the initial step.

Delete Orphan Assignments

Deletes an assignment for which the work item cannot be found. Such orphans may arise through design or implementation errors, access issues, RuleSet issues, or database integrity issues.

About flow errors

When it detects a flow error, Pega 7 normally starts the standard flow Work-.FlowProblems (using the same work item ID). It creates an assignment and places the assignment on a worklist, typically named administrator@zzz.com, where zzz.com is the organization of the operator who last worked on the work item. You can customize the standard activity Work-.getFlowProblemOperator in each application to send these to a different worklist or to a workbasket.

For example, these conditions cause a flow error execution to start:

In a production setting, review and diagnose every flow problem or problem assignment to insure data integrity.

 

Using the SLAs (Service-level agreements) tab

Service-level agreements (SLAs) are time constraints placed upon a case as it moves through the system. Use the SLA tab to display the overall case process, stage, flow, and assignment service levels agreements that are defined in the current application, and identify the flows or case type records that reference the service-level agreements.

Column

Description

Name Name key for this service-level agreement. Click the name to open its form for review or updates.
Applies To Class key for this service-level agreement. Click the class name to open the class form for review or updates.
Goal The Goal value defined on the General tab of the Service-level agreement form.
Deadline The Deadline value defined on the General tab of the Service-level agreement form..
References The count of case type records or flows that reference this service-level agreement. Click the reference count to open a list of flows (for assignment or flow service levels) or case types (for overall case or stage service levels).

 

Using the Status Values tab

Work status values are the primary indicator of the progress of a case towards resolution. The Status Values tab provides a single place to view all of the work item status values currently defined and available in the system. The values, such as New, Open, and Resolved, indicate the progress of a case as it moves through its business cycle.

The columns are described below.

Column

Description

Status Name The name of the work status (for example, Resolved-Withdrawn). To view or modify it, click the name to open its Field Value rule form.
Class Applies To class of the work status.
Description Description of the work status. The description is set in the rule form that defines the name and value of the corresponding work status.

 

Using the APIs (Application Programmer Interfaces) tab

This tab shows the standard activities, flows, and flow actions that comprise the Process API. Use the Process API to start and advance flows without implementing user forms. These rules can support BPM processing through Service Oriented Architecture (SOA) facilities including agents and service activities.

Business process management applications can use an external portal or external system and call Pega 7 services that in turn call Process API rules to create work items, advance the work items through a flow, perform assignments, and so on. You can also use these in certain places within browser-based, interactive applications, or without user forms in headless applications or straight-thru-processing.

For more information about API activities, see Atlas — Process API.

Click the expand icon in a header row to show the full description, usage, and parameters for the rule. The value in the References column indicates the number of rules that reference the API rule. Click the value to open the Referencing Rules display.

Column

Description

Click the expand icon in the row header to learn more about each activity, flow, or flow action. Information includes the rule's parameters (except flow actions).
Rule Name The Activity, Flow Name, or Action Name key part of the activity, flow, or flow action, respectively. Click the name to open the rule form.
Category The name of the rule type (activity, flow, or flow action).
Description A short summary of the rule's purpose.
Applies To The Applies To class of the rule.
References The number of rules in the system that reference this API rule. Click the value to open the Referencing Rules display.
Definitions landing page, service-level agreement, flow errors
Related topics About flows
About flow actions
Service-level agreement form

UpTools — Process and Rules

UpDesigner Studio — About Landing Pages