Professional Documents
Culture Documents
Exercise Guide
PRPC v.7.1
Copyright 2014
Pegasystems Inc., Cambridge, MA
All rights reserved.
This document describes products and services of Pegasystems Inc. It may contain trade secrets and proprietary information.
The document and product are protected by copyright and distributed under licenses restricting their use, copying,
distribution, or transmittal in any form without prior written authorization of Pegasystems Inc.
This document is current as of the date of publication only. Changes in the document may be made from time to time at the
discretion of Pegasystems. This document remains the property of Pegasystems and must be returned to it upon request.
This document does not imply any commitment to offer or deliver the products or services provided.
This document may include references to Pegasystems product features that have not been licensed by your company. If you
have questions about whether a particular capability is included in your installation, please consult your Pegasystems service
consultant.
PegaRULES, Process Commander, SmartBPM and the Pegasystems logo are trademarks or registered trademarks of
Pegasystems Inc. All other product names, logos and symbols may be registered trademarks of their respective owners.
Although Pegasystems Inc. strives for accuracy in its publications, any publication may contain inaccuracies or typographical
errors. This document or Help System could contain technical inaccuracies or typographical errors. Changes are periodically
added to the information herein. Pegasystems Inc. may make improvements and/or changes in the information described
herein at any time.
This document is the property of:
Pegasystems Inc.
1 Rogers Street
Cambridge, MA 02142
Phone: (617) 374-9600
Fax: (617) 374-9620
www.pega.com
DocumentName:BAE7_71ML4_ExerciseGuide_20141001
PVS:BAE_71ML4_pvs_20140602.exe
Date: 20141001
Table of Contents
Course Introduction....................................................................................
Pega Overview..............................................................................................
Application Planning...................................................................................
11
Document an Application...................................................................................................
17
03 Application Planning..............................................................................
Case Design..................................................................................................
19
20
Process Design.............................................................................................
24
25
28
32
34
38
44
48
Data Modeling..............................................................................................
51
52
56
59
62
UI Modeling...................................................................................................
65
66
69
73
78
79
83
86
88
92
Route Assignments.............................................................................................................
94
97
100
102
Reporting......................................................................................................
107
108
Approach- specifies the high level steps you need to perform to solve the business problem
Solution/Procedure - shows the series of steps or instructions that are designed to help you
understand how to complete the exercise
It is our goal that you can complete the exercises using the scenario and approach and relying on
the hints as needed. Use the procedure to check your work or as a last resort to complete the
exercise.
While individual exercises are included for each lesson, you may find it useful to download and print
out the complete System Architect Essentials I Exercise Guide. This is available in the related content
pane on the right side of this lesson
Note: Screen images in the exercises were captured using a Chrome browser. Depending on the
browser you use, your experience may differ. For example, when finding and uploading files,
Chrome uses the prompt Choose File, where MS Internet Explorer uses the single word Browse.
User ID
Password
password
Manager / User
rules
Hilary.Redmond@SAE.com
Password: password
Approach
Create a Time Off case type to manage requests for vacation/holiday leave, paid time off (PTO),
family/medical leave, sabbaticals, and bereavement leave.
Add the following business objectives to the HR Services application version 02-02-01.
Reduce time needed for time-off approvals from three weeks to one
Hints
1. To create a case type, open the Manage case types menu in the Case Explorer and select
Add a new case.
2. To add a business objective to a case, open the Application Overview from the Application
menu.
Procedure
Follow the steps below:
1. Log in to the HR Services application, if necessary, using the user account and password
information provided in the scenario.
2. Click the Cases explorer to view existing case types.
3. Open the Manage case types menu by clicking on the
icon and from the list of options
select Add a case type. The Case Explorer: Add dialog appears.
4. In the Name field, enter Time Off. Leave the Parent field blank. In the Description field,
enter the following text.
The case type for time-off requests supports vacation/holiday leave, paid time off (PTO),
family/medical leave, sabbaticals, and bereavement leave.
5. Click OK.
6. Open the Application Overview by clicking the dropdown arrow next to the application name
HRServices. If the Time Off case appears in the Case Explorer as a top-level case, your
application is configured correctly.
7. Scroll down to the Business Objectives section, and click Edit to add the business objectives
provided. When you finish, click Save.
Password: password
Approach
Create a business rule requirement named Supported Leave Types that states, The application
must support all of the following types of leave requests: vacation/PTO, family/medical leave,
sabbatical, and bereavement. Assign the requirement to the Business Rule category, with an
importance of 1 Critical and an external ID of HRS-TO-0001.
Create the remaining application requirements by importing the Excel workbook
HRServices_Requirements.xlsx, provided in the Lab Files folder on your desktop.
Hints
1. To open the Application Profile landing page, open the DseginerStudio menu and select
Application > Profile > Requirements.
2. To import an Excel workbook that contains requirements, click Actions and select Import
from Excel from the drop-down menu.
Procedure
Follow the steps below:
1. Select Designer Studio > Application > Profile > Requirements to open the Application
Profile landing page.
2. Click Create Requirement to open the Add/Edit Requirement dialog.
3. In the Requirement Name field, enter Supported Leave Types. Accept the default values
for ruleset and ruleset version. Note, fields marked with asterisks are required.
4. From the Category drop-down list, select Business Rule.
5. From the Importance drop-down list, select 1 Critical.
6. In the External Req. ID field, enter HRS-TO-0001.
7. In the Short Description field, enter Supported Leave Types, then use the rich-text editor
to enter the following description of the requirement:
The application must support the following types of leave requests: vacation/PTO,
family/medical leave, sabbatical, and bereavement. as shown in the image below:
8. Click OK. The dialog disappears, and the requirement you created appears on the
Application Profile landing page.
9. Click Actions. From the drop-down menu, select Import from Excel.
10. Using the dialog provided by your browser, locate and select the file named
HRServices_Requirements_xlsx. Click Next (or OK), and Import. Instructor-led course
students will find the file in the Lab Files folder on the desktop. Students using Pega
Academy self-study online will find the file in the same zip file which contained this PDF.
Note: Screen images in this exercise guide were captured using a Chrome browser. Your
experience may differ depending upon the browser you are using. For example: Where
Chrome uses Choose File, MS Internet Explorer uses the term Browse to find files for
uploading.
11. Review the summary of the contents to be imported (12 requirements), and then click
Import. Once the import completes, click Close to return to the Application Profile landing
page. Verify that the Application Profile landing page now displays 13 requirements.
Note: You may need to click the Refresh button to view your changes.
10
Password: password
Approach
Search for, make a copy of, and edit the Application Profile document template, using the file
SAE_Logo.png provided for you.
The SAE_logo.png file is either in the zip file (self-study students) or in the Lab Files folder on the
desktop (instructor-led students).
Note: Internet Explorer is currently required to access the Word Template rule form to customize
the Application Profile document template.
Generate an application profile for the Time Off case, using your customized template.
Note: If you are using the PVS (Personal Virtual Server) on your own computer/laptop to access this
course, the first time you generate documentation with the Application Document wizard, you will
be prompted to install PRPC preferences for Microsoft Silverlight. The Application Document wizard
requires these prerequisites to generate documentation. Before you begin this exercise, run the
wizard and attempt to generate a document to install these prerequisites. Once installation finishes,
close all instances of your browser, re-open your browser, and attempt this exercise.
Note: When generating documentation, Microsoft Word may prompt you with a Convert File dialog.
If this happens, Open the File menu in Word, and select Options. In the Word Options dialog, click
Advanced, scroll down to the General Options section, and deselect Confirm file format conversion
on open.
11
Hints
1. Word templates are stored in PRPC as Word Template rules. Add a copy of the
pyApplicationProfile Word Template rule to the HRServices:02-02-01 ruleset.
2. To start the Document wizard, open Designer Studio and click Application > Tools >
Document.
Procedure
Follow the steps below:
1. Search for pyApplicationProfile and identify it as a WordTemplate. Open the template by
clicking on the rules name in the search results.
2. Open the template by clicking the rules name in the search results.
12
4. Click Edit Word Template (there is no need to click Download File and download the file
first). The template opens as a word document named pyApplicationProfile.doc:
5. Select Insert then choose Header | Edit Header. Replace the existing header image with
the SAE_Logo.png file.
13
6. Close the Header and Footer tools and save your changes. Close the
pyApplicationProfile.doc to return to the Edit Word Template window. Remember to click the
Save button.
7. Click Close. The Edit Word Template window closes.. Also close the first Edit Word Template
window which was opened.
Note: This warning is for your safety. Since you have just saved the Word Template rule
record, this warning may be safely disregarded. In future situations, you may wish to
abandon your rule form, so Close followed by Discard would be appropriate. In the case you
choose to Close, and do want to keep your record but cannot remember if you saved, it is
best to click Cancel, return to your form and Save your work. If you are positive you have
saved your work, you may click Discard.
14
11. In the Project Name field, enter Time Off. In the Organization Name field, enter SAE.com.
12. In the Project Led By field, keep the defaults for now. You can come back and experiment
with the other options later.
15. Click Document Now. Wait for the document to finish loading. Once the document loads,
review the Application Profile and save a copy to your desktop for future reference.
You should see that the document includes the header and other information entered in the
exercise:
15
Return to the Application Document tool form. To save the current document tool settings
for future use, click Save. Name your settings App Profile HR Services, and click OK.
16
Password: password
Approach
Run the Document wizard to generate an application document in Microsoft Word format, using the
following options:
Detail Level: Full Application Documentation
Hints
1. After you change the level of detail for your document, remember to refresh the contents.
2. To generate sample data for screenshots you must provide an ID number for a case, which
the wizard can use as a data source. If you dont know a valid case ID, create a new case,
note the case ID, and complete the case, then restart the Application Document wizard. (You
only need to worry about this when you have cases and case data.)
Procedure
Follow the steps below:
1. Hover over Designer Studio and click Application > Tools > Document to start the
Document wizard.
17
2. Confirm that the wizard will use the Application Document template.
3. Set the Detail Level to Full Application Documentation, suppress RuleSet and class
references, and refresh the table of contents. When you finish, click Next.
18
19
Password: password
Approach
Using the description provided, create a specification for the primary path and each alternate stage,
and qualifying conditions. Use the Case Designer to define the stages for the Time Off case type.
Well come back in a future exercise to define the steps for each stage.
20
Note: Remember that case design and process design is iterative process. It generally requires
multiple attempts to arrive at acceptable solution. In the next exercise well standardize our case
design and add the steps.
Hints
1. To add a primary stage to the case type, click the Add Primary Stage to Case (plus) icon that
appears after the last primary stage.
2. To create the first alternate stage, click Actions and select Configure Alternate Stages. To
create additional alternate stages, click the Add Alternate Stage to Case (plus) icon that
appears to the right of the first alternate stage.
Procedure
Follow the steps below:
1. Open the Time Off case type in the Case Designer by clicking on Time Off.
2. Click the Specifications tab, and create a specification to document the primary path for the
Time Off case. The Specification information can be found in the Scenerio above. Document
all four (4) primary stages.
a. Click Create Specification. A new specification dialog box appears. Enter the details
as shown in the screen shot below.
b. Click Save to save your work. Be sure to save your work often. You will not be
reminded to save your work in future exercises.
c.
21
3. Create three (3) specifications for each of the alternate stages just as you created the other
specification above. Below is an image showing how your Specifcations Tab should look once
you have completed adding all specifications.
6. Add each of the three (3) alternate stages for which you created a specification by doing the
following.
a. Click on the arrow beside actions and choose Configure Alternate Stages.
b. Change the name of Alternate Stage 1 by clicking into into the name Alternate Stage
1 to Update Request. Continue to add the additional alternate Stages (order does not
matter) by clicking the + icon.
22
Reference Information
23
24
Sabbaticals and family/medical leave requests advance to the Extended Leave Request
step
All requests advance to the Verify Accrued Time step, which displays the requestors
current time-off balance, accrual rate, and potential time-off balance as of the start date
of the leave. At any time during these steps, the requestor can opt to withdraw their
request.
The Approval stage should consist of three (3) steps, labelled Manager Approval, HR Approval, and
Notify Requestor of Approval. The Manager Approval step routes the request to the requestors
manager and, if necessary, the appropriate unit VP. The HR Approval step routes the request to the
HR department for review, and if necessary to the VP of HR. The request can proceed through both
approval processes simultaneously. Once the request has been approved by both their manager
and HR, the Notify Requestor of Approval step indicates that the requestor is informed of the
approval. If any party (manager, VP, HR, HR VP) rejects the request, the request immediately
advances to the Reject Request stage. At any point during the Approval stage, the requestor can
withdraw or update their request.
The Pending Request Usage stage consists of one step, labelled Wait for Occurrence. This step
collects and holds approved requests until the start date of the requestors leave, at which point
the request automatically advances to the Resolution stage. At any time before the start date, the
requestor can withdraw or update their request. Once the request reaches the Resolution stage, the
requestors available time-off balance is reduced by the amount requested and the request is closed
with a status of Resolved-Complete.
If a requestor decides to update their request, the request advances to the Update Request stage.
This stage consists of one step, labelled Change Request, which allows the requestor to change the
start date and duration of the request. Upon completion, the request returns to the Approval stage.
Any rejected request advances to the Reject Request stage, which contains two steps labelled Notify
Requestor of Rejection and Resolve as Rejected. The Notify Requestor of Rejection step notifies the
requestor of the rejection, and the Resolve as Rejected step closes the request with a status of
Resolved-Rejected.
25
If a requestor decides to withdraw their request, the request advances to the Withdraw Request
stage. This stage consists of one step, labelled Resolve as Withdrawn, which closes the request with
a status of Resolved-Withdrawn.
Password: password
Approach
Using the description provided in the scenario, update the Case Designer as necessary. When
finished, your case should match the following illustration.
Update the specifications for each step for the primary path and each alternate stage with the
information provided in the exercise scenario.
Note: Every time a step is defined, a process rule record called a flow rule is created. Well discuss
these rules more in a future lesson. As we update our case design, we may choose to rename steps
which will rename existing rules and potentially create new ones. This is intentional, to provide users
with the flexibility to redesign the case without deleting existing elements automatically. Once the
case design has been updated, a system architect can confirm any unused processes and delete
them to avoid confusion during the rest of the application development process.
26
Hints
1. To start an additional step when a case enters a stage, select upon stage entry in the Step
Configuration dialog.
Procedure
Follow the steps below:
1. Add steps to stages on the Stages & Processes tab as necessary using the scenario
illustration as a guide.
2. Hover over the HR Approval step and select Configure step behaviors from the drop-down
menu. In the Step Configuration dialog, select upon stage entry under Start Step. Click OK.
Click Save.
3. Hover over the Resolution stage, and using the drop down button choose Configure stage
behaviors. In the Stage Configure dialog select the Yes radio button for the question Is this
a resolution stage? Click OK. Click Save.
4. Repeat step 3 for the Withdraw Request and Reject Request alternate stages.
27
Password: password
Approach
Create an initial set of application specifications by importing the Excel workbook
HRServices_Specifications.xlsx, provided as part of this lesson.
Confirm that an appropriate specification has been associated with each step on the Stages &
Processes tab for the Time Off case. Where necessary, configure the step to reference the
appropriate specification.
Associate each specification with the appropriate requirement, using the following table.
Specification
ChangeRequest_EntireFlow
CreateRequest_EntireFlow
ExtendedLeaveRequest_EntireFlow
HRApproval_EntireFlow
ManagerApproval_EntireFlow
NotifyRequestorOfApproval_EntireFlow
NotifyRequestorOfRejection_EntireFlow
OtherLeaveRequest_EntireFlow
PTORequest_EntireFlow
ResolveAsCompleted_EntireFlow
ResolveAsRejected_EntireFlow
ResolveAsWithdrawn_EntireFlow
VerifyAccruedTime_EntireFlow
WaitForOccurrence_EntireFlow
Requirement(s)
Allow requestor to update request
Supported leave types
Supported leave types
Require HR VP approval for family leave
Require HR VP approval for sabbatical
Require unit VP approval for family leave
Require unit VP approval for PTO
Require unit VP approval for sabbaticals
Notify requestor of status
Notify requestor of status
Supported leave types
Supported leave types
Notify requestor of status
Notify requestor of status
Allow requestor to withdraw request
Calculate length of leave
Allow requestor to update request
Allow requestor to withdraw request
Update the specifications for the Change Request step, using the information provided.
Update the description to note that the status of the request should be set to Pending-Change
when the request enters the stage and to Open-Resubmitted when the request exits the stage to
be re-approved.
Note: Remember that writing specifications for a PRPC application is an iterative process. Any Pega
application, including this one, will include many more specifications than we use in this lesson. As
we proceed through this course, we will create additional specifications as needed and elaborate
existiing specifications as part of configuring our application. DCO (Direct Capture of Objectives
(specification and requirement detail) is not a single event. It continues iteratively throughout the
development process.
Hints
1. To update information about the specification such as its type, status, or related
requirements open the specification from the Specifications tab of the Case Designer.
Procedure
Follow the steps below:
1. Import the file HRServices_Specifications.xlsx. (Note: If you are attending an instructor led
course, your instructor will tell you where to locate the file.)
2. Configure each step's behavior so that it references a specification that you imported. Select
the appropriate specification by clicking Specification Actions and selecting Choose another
specification from the menu, delete existing text and begin typing in the name of the
specification you want. Click to select the desired specification which will be suffixed
_EntireFlow
Note: To avoid confusion, each imported specification defined for a case step has the text
_EntireFlow appended to the name of the step. This helps to differentiate the specification
for the step from the specification for the assignment, as the assignment carries the same
name as the step by default. These differences will be explained in a future lesson.
3. On the Change Request step, append the following text to the description:
The status of the request should be set to Pending-Change when the request enters the
stage and to Open-Resubmitted when the request exits the stage to be re-approved.
4. Click OK to close the Step Configuration dialog and Save your case design.
5. Click the Specifications tab of the case designer. Click Reload.
6. Open the Change Request_EntireFlow specification. Select Alternate path from the Type
drop-down list. Click OK.
7. Expand the Advanced section, then the Requirements section, and ensure the requirement
Allow requestor to update request is linked. Use AutoComplete to find the appropriate
requirement. Click to select the desired requirement and be patient. It can take a few
seconds for the link to finalize in the training system.
8. Click OK.
9. Repeat steps 6 and 7 to ensure the remaining specifications are associated with the
appropriate requirement(s), according to the following table.
Specification
ChangeRequest_EntireFlow
CreateRequest_EntireFlow
ExtendedLeaveRequest_EntireFlow
HRApproval_EntireFlow
ManagerApproval_EntireFlow
Requirement(s)
Allow requestor to update request
Supported leave types
Supported leave types
Require HR VP approval for family leave
Require HR VP approval for sabbatical
Require unit VP approval for family leave
Require unit VP approval for PTO
Require unit VP approval for sabbaticals
Specification
NotifyRequestorOfApproval_EntireFlow
NotifyRequestorOfRejection_EntireFlow
OtherLeaveRequest_EntireFlow
PTORequest_EntireFlow
ResolveAsCompleted_EntireFlow
ResolveAsRejected_EntireFlow
ResolveAsWithdrawn_EntireFlow
VerifyAccruedTime_EntireFlow
WaitForOccurrence_EntireFlow
Requirement(s)
Notify requestor of status
Notify requestor of status
Supported leave types
Supported leave types
Notify requestor of status
Notify requestor of status
Allow requestor to withdraw request
Calculate length of leave
Allow requestor to update request
Allow requestor to withdraw request
10. Click Save to save your changes then Reload to verify that each imported specification
associated in the above table is now associated with an implementation and at least one
requirement.
Exercise: Upd
date the
e Case Design
D
a
and Speccifications
Scenarrio
After reviewing the cu
urrent busine
ess process fo
or time-off re
equests with
h HR, we have
e identified th
he
following process imp
provements:
The decision to
t forward a request to th
he requestorrs unit VP and the decisio
on to forward
da
re
equest to the
e VP of HR sh
hould be auto
omated.
Passw
word: passw
word
Approa
ach
Update th
he Manager Approval
A
and
d HR Approva
al specificatio
ons to includ
de the following decision
condition
ns, and add a comment th
hat the evaluation of thesse decisions ccan be autom
mated.
Fa
amily/medica
al leave and sabbatical
s
re
equests requ ire additiona
al approval byy the VP of H
HR.
Fa
amily/medica
al leave, sabb
batical reque
ests, and PTO
O requests re
equire additio
onal approva
al by
th
he unit VP.
Increase the
t complexity for each specification
s
to Medium, a
and change tthe type to E
Entire flow.
Hints
1. To
o update the
e description of a specifica
ation for a sttep, open the
e step in the Step
Configuration dialog.
o update the
e details of a specification
n, open the sp
pecification b
by selecting V
View Full De
etails,
2. To
or open the sp
pecification from
f
the Spe
ecifications ttab of the Case Designer..
3. Frrom this poin
nt forward, you need to be
b diligent be
ecause comm
mon navigatio
on and user
acctions such as
a Click OK and Save may
m not be exxplicitly menttioned in pro
ocedure step
ps.
Proced
dure
Follow the steps below
w:
O
the Time Off case in the Case De
esigner, if neccessary.
1. Open
2. Se
elect the HR Approval step, and open
n the Step Co
onfiguration dialog. Upda
ate the
description to
o include the following tex
xt.
32
3. Repeat step 2 for the Manager Approval step to update the description with the following
text.
Any time-off request for family/medical leave, a sabbatical, or PTO request must be
approved by the appropriate unit VP as well. Requests that do not meet these
conditions can advance to the Notify Requestor of Approval step without review by the
unit VP. The evaluation of this decision should be automated.
4. Click the Specifications tab.
5. Open the HRApproval_EntireFlow specification. Update the complexity to Medium, and
change the type to Entire flow.
33
Exercise: Con
nfigure Single
S
Sttep Assiignments
Scenarrio
Now thatt our case design has been approved, we can begin
n to design tthe processess for each ste
ep.
Our first task
t
in designing each process is to co
onfigure the single-step a
assignments to include all of
the eleme
ents of an inttent-driven process
p
mode
el: intent drivven shape na
ames, instrucctions,
likelihood
ds, audit note
es, and work status chang
ges.
Passw
word: passw
word
Approa
ach
Configure
e each single-step assignm
ment listed in
n the followin
ng table to in
nclude a flow
w action of the
same nam
me, an instru
uction, and an
n audit note.
Assignmeent
Audit No
ote
Instructioons
Create Reequest
PTO request
Change Request
R
Update the
t dates of the time off
Hints
1. While
W
you can
n add a conne
ector flow action to an asssignment fro
om the proce
ess outline, yyou
must
m
open the
e flow rule to
o add a likelih
hood and au dit note to th
he connectorr.
2. To
o see a flow shape prope
erties panel, right-click
r
on the shape (in this case itt will be a
co
onnector sha
ape), and sele
ect View Pro
operties. Ano
other option is Double-cliicking the sha
ape.
34
Procedure
Follow the steps below:
1. Hover over the Submission stage, and click Configure process detail which appears below
the last step in the Stage. This opens the Process Outline where you can view all processes
within the stage in context. Stages at the top, steps for the identified stage on the left, and a
workspace frame on the right. In our Submission stage, all processes are single step
assignment processes, which is why the left frame shows only assignment shape icons. Click
on any assignment icon in the left frame and youll see the properties panel for that
assignment in the workspace.
2. In the properties panel for the Create Request assignment, enter Create Request in the
Action field.
35
3. Scroll down to the Instruction field, and enter Create the time-off request. Click Save.
4. Select the PTO Request step, enter PTO Request in the Action field, and add the instruction
Enter day or days of PTO leave, and hours requested each day.
5. Click the Status tab. In the Work Status field, enter Open. Click Save.
6. Repeat steps 4 and 5 for the Extended Leave Request and Other Leave Request steps,
using the information in the following table.
Assignment
Instructions
Extended Leave
Request
Other Leave
Request
36
Note: The flow action name does not contain a space. PRPC automatically removes the
spaces when it creates the rule, as rule names can only contain alphanumeric characters.
10. Repeat steps 8 and 9 for the PTO Request, Extended Leave Request, and Other Leave
Request steps. Save the case design.
11. Configure the Change Request flow to name the flow action, add the appropriate audit note
to the connector, and add the appropriate instructions to the assignment.
12. Run the process, and note the changes to the flow.
37
Password: password
Approach
Model the process flows for both HR and manager approvals, using the following diagrams.
Remove the assignments from the Resolve as Approved, Resolve as Withdrawn, and Resolve as
Rejected flow rules. Add the appropriate work status to the end shape in each flow.
38
Model the process flows for the Notify Requestor of Approval and Notify Requestor of Rejection to
remove the assignment and add a Send Email smart shape.
Ensure that each flow shape you add is configured with an audit note, each assignment is
configured with an instruction, and each connector is configured with the correct likelihood.
Hints
1. Audit notes can be added to any shape that calls a rule, including a connector.
1. Instructions are added to assignments only.
2. All connectors should have a likelihood assigned, even if the connector represents the only
option to advance from a flow shape. In this case, the likelihood is 100.
Procedure
Follow the steps below:
1. Select the Step Configuration dialog from the drop down arrow on each step, to configure
both the HR Approval and Manager Approval steps as a Multi Step Process. A warning
message appears stating that you are changing from a Single Step to a Multi Step process by
adding an additional step. This is expected; it is not an error.
2. Open the Approval Stage in the process outline by clicking Configure process detail.
3. In the Manager Approval process (not the Manager Approval assignment), change the
second assignment to VP Approval. Right-click the assignment shape and choose View
Properties to open the assignment properties panel and change the name in the Step Name
field. Note: Double-clicking a flow shape also opens that shapes properties panel.
4. Add the Approve flow action to the connector between the Manager Approval and VP
Approval assignments. Open the connectors properties panel (right-click or double-click to
do this). To reference an already existing flow action, place your cursor in the flow action
field and tap the down-arrow on your keyboard. This presents a list of flow actions. Doubleclick Approve to choose it from the list, then click OK.
Note: When you see a field in a rule record with a triangle in the bottom right corner this is
referred to as Smart Prompt and displays a list of choices. This helps us determine if there
is a rule of this type we may reuse, before we decide to create something new. A
39
SmartPrompt also helps us avoid typographical errors since referenced rules are case
sensitive.
5. Add the Reject flow action to the connector between the VP Approval assignment and the
end shape by following the same process.
6. Add a decision shape to the process by clicking on the drop down beside the + and drag the
decision shape onto the flow directly below the Manager Approval assignment shape. Name
the shape Requires VP Approval. Adjust the Approve connector so it leads from the
Manager Approval shape to the decision. The connectors are connected when you click
on the bullet at the end of the connector shape and drag that bullet into the CENTER of the
target shape. Allow the connector to choose the entry point for you. We can make esthetic
enhancements later, for now all we care about is the functionality.
7. Move the existing VP Approval assignment shape, the connector shape named reject and
the end shape, below the decision shape as illustrated in the image below. Add two
connectors to the decision shape. Name the connectors Yes and No. The HR department has
reported it expects approximately 20% of requests to require further approval, so set the
Yes connector to be 20, and the No connector to be 80, Now connect the Yes connector to
the VP Approval assignment shape, and the No connector to the End shape. Click on the dot
on the corner of the shape and drag the connector to the End shape to create the No
connector. Follow the same process for adding the Yes connector only connect it to the VP
Approval shape.
40
8. Add two Change Stage smart shapes. Configure each to change the case stage to Reject
Request. Open the Change Stage properties panel and on the Utility tab, select the Select a
stage radio button. In the Stage field select Reject Request from the list of choices in the
drop-down menu.
9. Add a connector from the Manager Approval assignment to one of the Change Stage smart
shapes. Add the Reject flow action to the connector.
10. Adjust the Reject connector from the VP Approval assignment so that it connects to the
other Change Stage smart shape, rather than the end shape.
41
11. Add a connector from the VP Approval assignment to the end shape. Add the Approve flow
action to the connector properties panel.
12. Add likelihoods, audit notes, and instructions to the appropriate shapes, including
connectors.
Note: During our DCO session, the business subject matter expert from HR reported that
they expect 80% of requests to be approved, and 20% to be rejected.
13. Repeat steps 3 12 for the HR Approval process. The decision shape should be labelled
Requires HR VP approval and its Yes connector should point to an assignment labelled HR VP
Approval. Click Save. Click Back to Stages.
14. Open the flow rule for the Resolve as Completed step using the steps drop-down menu..
Delete the assignment, and connect the start shape to the end shape. Open the properties
panel for the end shape, and set the work status to Resolved-Completed. Remember, you
can click the down arrow on your keyboard to look up Resolved-Completed and typing a
portion of the name into the Work Status cell also helps to narrow the search results. Save
the flow.
15. Repeat step 14 to configure the Resolve as Withdrawn and Resolve as Rejected steps.
16. Open the flow rule for the Notify Requestor of Approval step. Delete the assignment and
connector. Add the Send Email smart shape to the process, with the audit note Email
requestor with news of approval. Connect the shape to the start and end shapes, and save
the flow.
42
43
Password: password
Approach
Create three new field values for the pyStatusWork property:
Open-Resubmitted.
Pending-Update.
Pending-Usage.
Update the flow rules for the Change Request and Wait for Occurrence steps according to the
specifications for each step, and incorporate these three new work status values.
Hints
1. The configuration of the Change Request flow does not match the specification, and must be
updated with a Change Stage smart shape.
2. Work status is set on a flow shape, such as an assignment.
3. The Wait for Occurrence flows does not match the specification. The assignment should be
replaced with a Wait shape.
44
Procedure
Follow the steps below:
1. Click The Case Explorer.
2. Click the Manage case types icon
Field Value.
. From the resulting menu, select Create > Data Model >
3. In the Label field, enter Open-Resubmitted. In the Field Name field, select pyStatusWork
and click Create and Open. If prompted for a class, use SAE-HRServices-Work.
Note: When using SmartPrompt , double-click More to find rules you may inherit.
4. In the To field, enter Open-Resubmitted, and then save the rule.
5. Repeat steps 1-3 to create the Pending-Update and Pending-Usage field values.
Note: This is a great time to use Save As. Just be sure to change each new rules form
value(s) appropriately.
6. Hover over the Change Request step. From the Options menu, select Open to open the
Change Request flow rule in the Process Modeler.
7. Add a Change Stage smart shape to the flow. Configure the shape to change the case to the
Approval stage and add an audit note to the shape that states Resubmitted for approval.
8. Move the Change Request connector to lead to the smart shape, rather than the end shape,
and delete the end shape.
9. Right-click the Change Request assignment and open the properties panel. Click the Status
tab, and in the Work status field, select Pending-Update. Click OK. A red flag should now
appear on the connector leading to the assignment.
45
10. Right-click the Change Stage smart shape and open the properties panel. Click the Status
tab, and in the Work status field, select Open-Resubmitted. Click OK. A blue flag should
now appear on the Change Request connector.
11. Save and close the flow rule to return to the Case Designer.
12. Open the Wait for Occurrence flow in the Process Modeller, and replace the assignment with
a Wait shape which is found under the Advanced Shapes. Delete the connector leading to
the end shape and replace it with a new one. Open the properties panel for the Wait shape
and in the name field type Wait Until Employee Takes Leave. In the Wait Type options select
Case Dependency. In the Cases for type field, select SAE-HRServices-Work-TimeOff. In the To
reach status field, select Pending-Usage. Scroll down and ensure the Permit End User to
perform check box is selected. Click OK and Save. The images below may be used to confirm
your work.
46
13. Create a new Time Off request and note the Case ID. Process the case to the Pending
Request Usage Stage. When the assignment arrives at the Wait for Occurrence flow Wait
shape, by default it is assigned to a workbasket named deferred@pega.com. Click on the
Await Dependency to be fulfilled (Pending Request Usage) link. Click Stop waiting and
continue process to proceed to the Resolution stage.
47
Password: password
Approach
Create a process to allow the requestor to withdraw their time off request. This process should
consist of two steps: an assignment for the requestor to document the reason for the withdrawal,
and a change to the Withdraw Request alternate stage. The connector between these two shapes
should use the standard Withdraw flow action.
Add the standard pyChangeStage flow action to the Approval and Pending Usage stages.
Note: The pyChangeStage flow action provides us with the out-of-the-box capability to switch a case
to a different stage. While we may wish to customize the user interface later during the
development cycle, using the standard flow action allows us to quickly add this functionality to our
case while we create and review our process models.
Hints
1. Optional processes and flow actions are added to an entire case from the Details tab of the
Case Designer.
2. Optional processes and flow actions are added to an entire stage from the Stage
Configuration dialog. They are not typically configured as a step associated with a stage.
48
Procedure
Follow the steps below:
1. Create a new flow rule by clicking Actions > Create > Process > Flow as shown below.
a. Enter Withdraw Request in the Label field of the Create Dialog form. Click Create
and Open.
2. If necessary, change the assignment name to Withdraw Request. Open the assignment
properties panel and on the Local Actions tab, delete all local actions except AttachANote
and click OK. Open the properties panel for the connector located between the assignment
and the end shape and reference the standard Withdraw flow action. Add The request was
withdrawn to the audit note field. Delete the existing end shape and replace it with a
Change Stage smart shape. Configure the smart shape Utility tab to Select a stage and select
the Withdraw Request stage. Add an audit note Moved to Withdraw Request stage.
3. Return to the Case Designer, and click the Details tab. Locate the entry for case-wide
supporting processes, and click (Edit).
49
4. Select the Withdraw Request flow you created in step 1, and click OK.
50
51
Password: password
Approach
Use the following entity relationship diagram to create properties that model the Time Off and
Employee objects and their attributes.
Create specifications for the Create Request and Verify Accrued Time flow actions to indicate the
properties to include on each.
52
Hints
1. When you choose to configure process detail for a stage, you are opening the process
outline for that stage.
2. You can create properties from the properties panel of an assignment.
Procedure
Follow the steps below:
1. Open the Time Off case in the Case Designer, and open the process outline for the
Submission stage.
2. Open the properties panel for the Create Request assignment, and click View Action
Specification. Enter the following description and save the specification.
The requestor provides the following information regarding their time-off request:
Type of Request: Text
Create Date/Time: DateTime
Start Date: Date
Employee ID: Text
First Name: Text
Last Name: Text
Department: Text
3. Click Add Fields. Use the Edit Fields dialog to add the three properties listed for the Time Off
case: Two will be new properties, Type of Request (Text), and Start Date (Date), and one
inherited property Create Date/Time (choose the standard property that applies to Work,
not @baseclass). Your results should be similar to the image below:
4. In the Edit Fields dialog, add a fourth line and add the existing Employee page property. This
results in multiple fields for employee data to automatically populate the Employee page.
5. Click Add field to page to add the Department field to the Employee page as a text
property. Remove the following fields, which are not needed for this case type: Date of
53
Birth, Full Name, Full Time, Hire Date, Job Title, Marital Status, Salary, Taxing State. The
Edit Fields dialog should look similar to the image below.
54
9. Create a time-off case. Advance through all of the steps in the Submission stage to verify
that all properties were created correctly.
Note: As you run through the process for your time-off case, you may notice that some of
the properties already utilize specific UI controls such as radio buttons or calendar icons.
These controls were specified automatically by PRPC, to match the property types you
selected when creating the properties. In the exercises for the User Interface lessons, we will
configure the remaining properties to use specific controls for display.
55
Password: password
Approach
Use the following entity relationship diagram to create properties that model the Other Leave,
Extended Leave, and PTO Leave objects and their attributes.
Create specifications for the PTO Request, Extended Leave Request, and Other Leave Request flow
actions to indicate the properties to include on each.
Hints
1. You can create properties from the properties panel of an assignment.
56
Procedure
Follow the steps below:
1. Open the Time Off case in the Case Designer, and open the process outline for the
Submission stage.
2. Open the properties panel for the PTO Request assignment, and click View Action
Specification. Enter the following description and save the specification.
The requestor provides the following information regarding their PTO request:
Date: Date
Hours: Decimal
All Day?: TrueFalse
3. Click Add Fields. Use the Edit Fields dialog to create a page list named PTO Leave, and the
three properties Date, Hours, and All Day? to this page list.
57
6. Open the properties panel for the Other Leave Request assignment. Create a specification
for the flow action, listing the properties and property types from the relationship diagram.
Add a page property named Other Leave, and on it create a property of type Integer
named Number of Days, and a property of type Text named Type of Bereavement. Click
OK and save your changes.
7. Create a time-off case. Advance through all of the steps in the Create Request stage to
verify that all properties were created correctly.
Note: As you run through the process for your time-off case, you may notice that some of
the properties already utilize specific UI controls. These controls were specified
automatically by PRPC, to match the property types you selected when creating the
properties. In the exercises for the User Interface lessons, we will configure the remaining
properties to use specific controls for display.
58
Password: password
Approach
Create a property named Total PTO for the PTO Dates flow action, to store decimal values.
Create a declare expressions rule named Total PTO to sum the hours of PTO entered on the PTO
Dates flow action.
Hints
1. To create a declare expressions rule, first create the target property (the property for which
you want to set the value), and then create the declare expressions rule.
2. To total a set of values in a page list, select the Sum of function.
3. When summing properties in a page list, first specify the page list, then specify the property.
4. When you iterate over the elements of a page list such as to sum properties on the page
list do not specify an index value. Instead, leave the index blank. The property reference
should be of the form .PageList().Property.
59
Procedure
Follow the steps below:
1. Open the PTO Request step in the process outline.
2. Click the Add field link (bottom left of dialog) to add a field named Total PTO of type Decimal
to the PTO Request flow action do not add field to page list PTO Leave.
3. Enable the Calculated option for the Total PTO property, and click Define Calculation.
Note: This method automatically creates the Declare Expression rule for the property and
the Edit Declare Expression rule dialog is now opened for editing.
4. Select Sum of in the drop-down field to the right of the text Set Total PTO =. In the field to
the right of the drop-down list, delete the text .pyLabel and select .PTOLeave().Hours.
Save and close the declare expressions rule. Return to the process outline and click OK to
dismiss the Edit Fields dialog. Save the case design.
5. Create a new PTO request. On the PTO Dates form, enter values in the Hours column,
adding rows as needed. Each time you exit the Hours field, verify that the value for Total
PTO is calculating, similar to the image below.
60
61
Password: password
Hints
1. To withdraw a specification, open the specification and change the status to Withdrawn.
Approach
Update the case design to reflect the process improvements identified in the scenario:
Update the specification for the Create Request assignment (not the entire flow) to include the
details of the database query: based on the employee ID provided, the query should return the
corresponding first and last name, department, manager, current PTO balance, and current PTO
accrual rate.
Note: Remember that our focus as a BA is to gather information and incorporate it into the
application design. When documenting an integration need, we want to capture the intent of that
integration, and accurately reflect that intent in our requirements and specifications. The technical
details of the integration are generally elaborated upon by system architects and IT representatives.
62
Procedure
Follow the steps below:
1. Open the Time Off case in the Case Designer, if necessary, and click on the Specifications
tab.
2. Open the Verify Accrued Time specification. Change the status to Withdrawn. Click OK to
close the specification.
3. Return to the Stages & Processes tab.
4. Hover over the Verify Accrued Time step. Open the drop-down menu for the step and
select Delete this step. Save your case design.
Update the complexity of the Create Request assignment specification to Medium and
update the description to read:
Create the time-off request. The requestor should specify the starting date for their leave
request, the type of leave requested, and their employee ID. Upon entering the
employee ID, the system queries the employee database for the employees first and last
name, department, manager, current PTO balance, and current PTO accrual rate.
After completing this step, the case advances to the step that corresponds to the type of
leave selected:
5. Add the VerifyAllowedPTO requirement to the Create Request flow action specification,
and increase the complexity to Medium.
63
Note: Use the technique you learned in the exercise, Defining Specifications for Case Steps.
64
Principles of UI Modeling
65
Password: password
Approach
Create specifications to document the UI for the Change Request, PTO Request, Extended Leave
Request, Other Leave Request, and Verify Accrued Time flow actions, using the following UI
mockups.
66
Hints
1. Specifications that describe the UI presented to the user at an assignment should be
associated with a specific action (flow action).
Procedure
Follow the steps below:
1. Update the specification for the Change Request flow action (not the entire flow) with the
following changes to reflect the use of controls to guide user input, then save the
specification.
The requestor provides the following information for their time-off request:
Type of Request: Text, drop-down list (allowed values: Vacation/PTO, Family/Medical
Leave, Sabbatical, Bereavement)
Date of Request: Date, read-only, automatically calculated
Start Date: Date, calendar
Employee ID: Text
First Name: Text, read-only
Last Name: Text, read-only
Department: Text, read-only
Accrual Rate: Decimal, read-only
Allowed Time Off: Decimal, read-only
Available Time Off: Decimal, read-only
2. Update the specification for the PTO Request flow action following changes to reflect the
use of controls to guide user input, then save the specification.
The requestor provides the following information for their PTO request:
Date: Date, calendar
Hours: Decimal, read-only and automatically calculated (8) if All Day? check box is
selected
All Day?: TrueFalse, check box
The requestor can add as many days as needed to document their leave.
3. Update the specification for the Extended Leave Request flow action following changes to
reflect the use of controls to guide user input, then save the specification.
The requestor provides the following information for their extended leave request:
End Date: Date, calendar
Extended Leave Type: Text, drop-down list (allowed values: Family/Medical Leave,
Sabbatical)
67
4. Update the specification for the Other Leave Request flow action following changes to
reflect the use of controls to guide user input, then save the specification.
The requestor provides the following information for their bereavement request:
Number of Days: Integer, radio buttons (allowed choices: 1, 2, 3, 4)
Type of Bereavement: Text, drop-down list (allowed choices: Extended Family,
Immediate Family)
68
Create Request
The fields in the Employee layout should eventually be read-only, and automatically populate once
the employee provides their ID. The information about the employee their first and last name,
department, and manager, should be laid out in two columns. The employees time-off balances
should be laid out in three columns.
Change Request
The Change Request form should consist of four reused layouts: the top layout from the Create
Request step, followed by the PTO Request, Extended Leave Request, and Other Leave Request
sections.
Password: password
Approach
Using the information provided in the scenario, update the specification for the Create Request
assignment and create a specification for the Change Request assignment.
Configure the user interface for the Create Request assignment:
Move the Accrual Rate, Allowed Time Off, and Available Time Off fields to a three-column layout.
Reuse the PTO Request, Extended Leave Request, and Other Leave Request sections.
Note: Once you edit a section rule directly, you can no longer use the Add fields or View/Edit fields
feature of the properties panel to add additional properties. That feature will disappear from the
panel. Instead you must add them to the section rule.
69
Hints
1. Each layout can only incorporate one layout type.
2. To reuse a layout, click the Save as Section icon on the section header.
Procedure
Follow the steps below:
1. Open the Create Request and Change Request assignment specifications, and update the
description for each with information from the Scenario and Approach.
2. Open the Create Request section by clicking Open Section in the Edit Case Type form. Note
two layouts exist.
3. Add the Employee ID property to the top layout, and export the top layout to a new section
rule named Request Details.
a. Click App Explorer
b. Expand SAE-HRServices-Work
c.
d. Expand Employee
e.
Using the property icon, click and drag the property into the dynamic layout below
the Start Date field.
f.
Confirm the .Employee page by selecting the radio button and click OK
g. To save the layout as a section, click the layout header and then click the Save as
Section icon (looks like a check within a circle)
h. Name the new section by placing RequestDetails (one word) in Purpose.
70
7. Drag the Accrual Rate, Allowed Time Off, and Available Time Off fields from Employee to
the new layout. Using the layouts property panel
change the layout type to Inline Grid
Triple, and change the layout type of the first layout to Inline Grid Double. Add a label to
identify each layout.
71
of the following layouts: Request Details, PTO Request, Extended Leave Request, and
Other Leave Request. The easiest way is to drag and drop each section from the
application explorer into the Change Request section.Save the section.
10. Create a new time off case, and verify your UI changes. Check to make sure all sections are
included.
72
Password: password
Approach
Configure the Create Request form with the following changes:
Mark the Type of Request, Start Date, and Employee ID fields as required.
Present the Type of Request field as a drop-down list with the following choices:
Vacation/PTO, Family/Medical Leave, Sabbatical, and Bereavement.
Present the Type of Bereavement field as a drop-down list with two choices: Immediate
Family and Extended Family.
Add a Validate rule to limit requests to two days when the deceased is a member of the
employees extended family. Configure the condition to display the message Bereavement
leave for a member of your extended family is limited to two days.
Update the description of each specification as appropriate. In addition, update the status of the
Other Request specification to Complete afterward.
73
Hints
1. To set a field as required, either open the section rule containing the field and use the
properties panel for the field to enable the Required option, or use the View/Edit Fields
dialog from the Case Designer and enable the Required option.
2. To configure a set of radio buttons, use the pxRadioButtons control on the property form, or
configure the cell in the section rule.
Procedure
Follow the steps below:
1. Open the Create Request specification (not the CreateRequest_EntireFlow specification),
and update the description to include the required fields.
2. Mark the Type of Request, Start Date, and Employee ID fields as required. In the Stage
Designer click Configure process detail and open section Create Request. Open the cell
properties form by clicking the view properties icon
. Check required.
74
3. Open the Type of Request property form by clicking on the magnifying glass that can be
seen when you are in the Cell Properties form. Change the UI Control found by expanding
Display and Validation to pxDropdown, and select Local List from the Table Type dropdown list. Ensure that the first entry in the list is blank, and then add the four choices
requested by HR.
5. Use search to find the Number of Days (no spaces) and open the property form. Configure
the property to display as a set of radio buttons numbered 1-4.
75
6. Open the Type of Bereavement property form. Configure the property to display as a dropdown list with the two choices specified by HR.
7. Open the Other Leave Request flow action. Click the Validation tab. In the Validate Rule
field, enter VerifyAllowedBereavement and create the validate rule by clicking the Open icon
(it looks like a magnifying glass).
Note: The Open icon will attempt to open the referenced rule. When it does not exist, the
architect is presented with the create rule dialog.
8. In the Property field, select .OtherLeave.NumberOfDays, and then click Add to add a
condition.
9. In the Validation Conditions dialog, select the [first String] [relation] [Second String]
function. Configure the condition to verify that the Type of Bereavement property
.OtherLeave.TypeofBereavement equals Extended Family. Be sure that Extended
Family is in double quotes as it is a literal value.
10. Create a second condition and configure the condition to test if the Number of Days
property .OtherLeave.NumberOfDays is greater than 2. Verify that the conditions are
combined with a boolean AND as illustrated in the following image:
76
11. In the Message field, enter BereavementTooLong and create the message rule. In the
Message field, enter Bereavement leave for a member of your extended family is
limited to two days.
12. Save the Bereavement Too Long message rule, the Verify Allowed Bereavement validate
rule, and the Other Request flow action.
13. Create a new Time Off case, and request bereavement leave. Advance to the Other Request
form, and verify your changes.
14. Return to the Other Request specification, and update its status to Complete.
77
78
PTO Request run only when the requestor elects to use PTO or vacation time.
Extended Leave Request run only when the requestor requests family/medical leave or a
sabbatical.
Other Leave Request run only when the requestor needs to request bereavement leave.
Notify Requestor of Approval occurs only after the request is approved by both the
manager and HR.
For the Time Off case to work properly, we must identify conditions that determine when these
steps should be incorporated into the overall case process for each request. In addition, we also
need to configure each step to evaluate the appropriate condition, and only perform each step
when appropriate.
Password: password
Approach
Create two single-value properties of type TrueFalse, named HR Approved and Manager Approved.
Configure the HR Approval and Manager Approval flow rules to set the appropriate property to true
when the request has been approved.
Using the following table, create each of the listed When rules using the conditions provided and
add each When rule to the corresponding case step.
When rule
IsPTO
IsOtherLeave
IsExtendedLeave
Step
PTO Request
Other Leave Request
Extended Leave Request
IsApproved
Condition
Type Of Request = "Vacation/PTO"
Type Of Request = "Bereavement"
Type Of Request = "Family/Medical Leave" OR
Type Of Request = Sabbatical
Manager Approved = true AND
HR Approved = true
Add the IsPTO, IsOtherLeave, and IsExtendedLeave conditions to the corresponding section includes
in the Change Request section.
79
Hints
1. You can set a property to a specific value using the Set Properties tab of the properties panel
for a connector.
2. As a best practice, when string values are used in decision processing (input conditions or
output results) literal values should be placed between double quotation marks. Example:
Vacation/PTO.
Procedure
Follow the steps below:
1. Open the Step Configuration dialog for the PTO Request step. In the and when field, enter
IsPTO and click the magnifying glass icon to create the When rule.
2. In the Label field, enter Is PTO and click Create and open.
3. Double-click the text [Double click to add condition]. In the Condition dialog, select
TypeOfRequest in the left field, and enter Vacation/PTO in the right field.
80
6. Open the Change Request section. Open the properties panel for each of the PTO Request,
Extended Leave Request, and Other Leave Request section includes, and add the
corresponding condition to the layout as a Visibility condition.
7. Create two properties of type TrueFalse, named Manager Approved and HR Approved.
8. Open the Manager Approval flow.
9. Open the Connector Properties dialog for the No connector on the Requires VP Approval
decision, and click the Set Properties tab.
10. In the Name field, select ManagerApproved, and in the Value field, enter true. When you
finish, click OK.
11. Repeat steps 9 and 10 to set the value of the .ManagerApproved property to true on the
Approve connector leading from the VP Approval assignment. Save and close the flow.
81
12. Open the HR Approval flow and repeat steps 8-11 to set the .HRApproved property on the
Approved and No connectors, as shown in the following screenshot.
13. Open the Step Configuration dialog for the Notify Requestor of Approval step. In the and
when field, enter IsApproved, and create the When rule.
14. Configure the default condition to read .ManagerApproved = true.
15. Open the Actions menu and select Insert Condition. Create the second condition,
.HRApproved = true, and click OK. Verify that the two conditions are related with a Boolean
AND operator.
16. Return to the Case Designer, click OK to dismiss the Stage Configuration dialog, and save the
case.
82
Password: password
Approach
Create a specification for the Requires HR VP Approval decision, using the information provided in
the Scenario.
Configure a decision table named Requires HR VP Approval, to return a Yes result for any of the
following types of time-off requests.
Sabbatical
Family leave
Medical leave
Hints
1. When creating a decision rule from the properties panel of a decision shape, the type of the
rule created (decision table, decision tree, etc.) depends upon the Type selection.
2. The otherwise row should always be used to return the safest result generally, the mostconservative result. When determining whether approval by the VP of HR is required, the
more-conservative result is to require extra approval.
3. Place all literal values within double-quotes (best practice). Examples: Sabbatical and
Family/Medical Leave.
83
4. The Open icon (looks like a magnifying glass) when clicked will search for the identified rule
and if not found you are presented with the option to create that rule.
Procedure
Follow the steps below:
1. Create a specification named Requires HR VP Approval. Change the Type to Decision, and
set the Complexity to Low. Associate the specification with the appropriate requirement
and business objective, and enter a description based upon the scenario provided.
2. Open the HR Approval flow. And open the properties panel for the Requires HR VP
Approval decision. Select the specification you just created, and set the Type to Decision
Table.
3. Enter RequiresHRVPApproval in the Rule field. Create the Requires HR VP Approval
decision table by clicking the Open icon. Click the Conditions column header and select the
Type Of Request property (.TypeofRequest) and click Save to close. Click in the empty cell
and using the Insert Row After icon, add 3 rows for a total of 4 rows. Complete steps 4 and 5
using the image in step 6 as a guide. Be sure all entries are literal values (in double quotes).
4. Add conditions to return a Yes result for Sabbatical and Family/Medical Leave requests.
5. Add conditions to return a No result for Bereavement and Vacation/PTO requests.
6. Configure the otherwise result to return Yes. Save the decision table.
7. Save the HR Approval flow. Create a Time Off case, and select the type of the request.
Advance the case to the HR Approval step and verify that the HR VP Approval assignment
is skipped according to the decision logic.
84
8. Re-open the Requires HR VP Approval specification and update its status to Completed.
85
Password: password
Approach
Create a specification for the Requires VP Approval decision, using the information provided in the
Scenario.
Configure a decision tree named Requires VP Approval, to return a Yes result for any of the following
types of time-off requests.
Sabbatical
Family leave
Medical leave
Vacation
PTO
Hints
1. When creating a decision rule from the properties panel of a decision shape, the type of the
rule created (decision table, decision tree, etc.) depends upon the Type selection.
2. The otherwise row should always be used to return the safest result generally, the mostconservative result. When determining whether approval by the requestors VP is required,
the more-conservative result is to require extra approval.
86
Procedure
Follow the steps below:
1. Create a specification named Requires VP Approval. Change the Type to Decision, and set
the Complexity to Low. Associate the specification with the appropriate requirement and
business objective, and enter a description based upon the scenario provided.
2. Find and Open the Manager Approval flow. Open the properties panel for the Requires VP
Approval decision. Using the Specification Actions link, locate the specification you just
created and link it. Set the Type field to Decision Tree.
3. Create the Requires VP Approval decision tree. Name the Decision Tree RequiresVPApproval
and click the Open icon to create.
4. Add conditions to return a Yes result for Sabbatical, Family/Medical Leave, and
Vacation/PTO requests. Be sure all literal entries are placed in double-quotes.
5. Add a condition to return a No result for Bereavement requests.
6. Configure the otherwise result to return Yes. Save the decision tree.
7. Save the Manager Approval flow. Create a Time Off case, and select the type of the request.
Advance the case to the Manager Approval step and verify that the VP Approval
assignment is skipped according to the decision logic.
8. Reopen the Requires VP Approval specification and update its status to Complete.
87
Password: password
Approach
Create a When rule named IsAllDay to test if the All Day property has been set to true.
Update the Hours field on the PTO Leave section to display as read-only when the When rule returns
a true result.
Create a data transform named AllDay to set the value of the Hours property to 8 when the When
rule returns a true result.
Create an On change event for the All Day? checkbox on the PTO Leave section. This event should
refresh the section and run the AllDay data transform.
Note: While data transforms are typically a system architect responsibility, they are a valuable tool
for reinforcing the concept of page context when referring to properties in PRPC applications. For
this exercise, you will create a simple data transform
Hints
1. To set a field to display as read-only, select the appropriate editing options on the
Presentation tab of the properties panel for the field.
2. To configure an event for a UI control, open the Actions tab of the properties panel for the
control.
88
3. To run a data transform in response to an event, select Refresh this section in the Action
drop-down, then select the Run data transform option and enter the data transform to run.
4. When creating a data transform to set a property value only when a When rule returns a
true result, first select the When action and specify the When rule to evaluate. Then, use the
child action row that appears to set the property value accordingly.
Procedure
Follow the steps below:
1. Open the PTO Leave section.
2. Select the Hours field. Open the properties panel, and click the Presentation tab. From the
Edit Options drop-down list, select Read only (when rule). In the field that appears to the
right of the drop-down list, enter IsAllDay and click the magnifying glass icon to create the
when rule.
3. Enter Is All Day in the Label field and click Create and open.
89
4. Double-click the text [Double click to add condition] to create the when condition. In the
first field, select the All Day? property. In the second field, enter true. Verify that the
operator used to compare the two values is the equals sign. Click OK to create the condition,
and save the rule.
5. Select the All Day? check box. Open the properties panel and click the Actions tab. From the
Event drop-down list, select On change. From the Action drop-down list that appears,
select Refresh this section. Enable the Run data transform option and enter AllDay, then
click the magnifying glass icon to create the data transform.
6. Enter All Day in the Label field and click Create and open.
7. From the Action drop-down list, select When. In the Target field to the right of the dropdown list, select the IsAllDay when rule.
8. In the child row, select the Hours property in the Target field, and enter 8 in the source field.
Save the data transform.
9. Return to the PTO Leave section. Click OK to dismiss the properties panel, and save the
section.
90
10. Create a new PTO request. On the PTO Leave form, verify that clicking the All Day? check
box for a row automatically enters an 8 into the corresponding Hours field, and displays the
field as read-only.
91
Exercise: Con
nfigure a Service Level
Scenarrio
One of th
he business objectives
o
forr the Time Offf case is to re
educe the tim
me required to approve ttimeoff reque
ests from thre
ee weeks to one.
o
The app
provals proce
ess consists o
of up to four manual step
ps
and three
e automated steps. The HR
H department has issued
d guidelines for the manu
ual steps in the
approvalss process. Th
he HR department and ind
dividual man
nagers should
d approve tim
me-off reque
ests
within on
ne business day,
d
with a go
oal of approv
ving requestss within four hours. VPs should approve
any reque
ests sent to them
t
within two
t
businesss days, with a goal of app
proving reque
ests within on
ne
business day.
Passw
word: passw
word
Hints
1. Remember that the goal and deadline intervals botth begin whe
en the assignment is read
dy for
a user to perfo
orm it.
Approa
ach
Update th
he specificatiions for the Manager
M
App
proval and H R Approval p
processes witth the respon
nse
time guid
delines established by HR.
Configure
e service leve
el rules for th
he Manager Approval,
A
HR
R Approval, VP
P Approval, a
and HR VP
Approval assignmentss, using the information provided
p
in t he scenario.
Proced
dure
Follow the steps below
w:
O
the speccification for each of the following
f
asssignments: M
ManagerApp
proval,
1. Open
HRApproval,
H
VP Approva
al, and HR VP
P Approval. U
Update the d
description fo
or each
sp
pecification with
w the resp
ponse time gu
uidelines esta
ablished by H
HR.
2. Open
O
the Man
nager Appro
oval flow, and
d open the p
properties pa
anel for the M
Manager
Approval
A
assignment. In the
t Service Level
L
field, en
nter Manage
erApproves and create the
se
ervice level rule.
92
3. In the Goal section, enter 4 into the HH field, and select Business Days. In the Deadline
section, enter 1 into the Days field, and select Business Days.
4. Create an identical service level rule named HR Approves. Hint: Save As.
5. Create a service level rule named VP Approves, with a goal of one business day and a
deadline of two business days. Add the service level to the VP Approval assignment in the
Manager Approval flow and HR VP Approval assignment in the HR Approval flow.
6. Create a Time Off case and advance it to the Approval stage. Verify that each of the open
approval assignments now displays a deadline interval. (The screenshot below is sample.
Your results may be slightly different.
93
Each end user is assigned to a workgroup, which identifies the manager for the group.
HR also wants us to implement an automated router that allows the requestor to update request.
Password: password
Approach
Configure the Update Request flow to automatically route the Change Request assignment back to
the requestor, using the ToCreateOperator router.
Configure the HR Approval flow to automatically route the HR Approval assignment to the HR@SAE
workbasket, using the ToWorkbasket router.
Configure the HR Approval flow to automatically route the HR VP Approval assignment to the VP of
HR, using the ToCostCenterManager router.
Configure the Manager Approval flow to automatically route the Manager Approval assignment to
the requestors manager, using the ToWorkgroupManager router.
Configure a decision table named VP Routing Table to return an operator ID for each department,
using the information in the following table. Configure the Manager Approval flow to automatically
route the VP Approval assignment to the appropriate unit VP, using the ToDecisionTable router and
the VP Routing Table decision table you create.
Department
Engineering
Facilities
Sales
All other departments
Unit VP
Richard.Marx@SAE.com
Byran.Adams@SAE.com
Belinda.Carlisle@SAE.com
George.Michael@SAE.com
94
Note: We are using out-of-the-box routing rules and hard coding the names which is not a best
practice. We are doing this to test routing without adding the complexity of lookups. When hard
coding the names, they must be surrounded by quotes because they are literal values.
Hints
1. To route an assignment to a workbasket, you must configure the assignment type as
Workbasket.
2. To route an assignment using a decision table, select the ToDecisionTable router, and enter
the name of the decision table in the DecisionTable field.
Procedure
Follow the steps below:
1. Open the Change Request flow, and open the properties panel for the Change Request
assignment. In the Router field, select ToCreateOperator.
2. Open the HR Approval flow, and open the properties panel for the HR Approval
assignment. Select Workbasket from the Assignment type drop-down list. In the Router
field, To WorkBasket for the router and select HR@SAE for the workbasket. .
3. In the HR Approval flow, open the properties panel for the (HR) VP Approval assignment. In
the Router field, select ToCostCenterManager.
4. Open the Manager Approval flow, and open the properties panel for the Manager
Approval assignment. In the Router field, select ToWorkgroupManager.
5. In the Manager Approval flow, open the properties panel for the VP Approval assignment.
In the Router field, select ToDecisionTable. The DecisionTable field should automatically
appear below the Router field.
6. In the DecisionTable field, enter VPRoutingTable and create the decision table.
95
7. Create a new time off request, and verify that the request is routed to the correct parties,
using the following table as a guide.
Assignment
Manager Approval
VP Approval
HR Approval
HR VP Approval
Change Request
Recipient
Manager@SAE (operator)
Determined from the table in the approach
HR@SAE (workbasket)
George.Michael@SAE.com
BAEArchitect
Important Note: Do not forget to enter a value for the department field when testing. This field is
case sensitive, so if you are typing it in make sure the case is correct.
96
Exercise: Sen
nd an Au
utomate
ed Email to a Work Partty
Scenarrio
To ensure
e that requesstors are nottified of the status
s
of thei r time-off req
quests, HR has requested
d that
we config
gure our case
e to send an email to the requestor w
when their req
quest has been approved
d or
rejected.
Passw
word: passw
word
Approa
ach
Create a corresponde
c
ence rule nam
med RequestApproved, w
which contain
ns the following text.
Your request <<py
yID>> for <<T
TypeOfReque
est>> has be en approved
d.
c
ence rule nam
med RequestDenied.
Create a corresponde
Your request <<py
yID>> for <<T
TypeOfReque
est>> has be en rejected.
e the Notify Requestor
R
off Approval sm
mart shape to
o send the Re
equestAppro
oved
Configure
correspondence rule to the Owner party. Create a specifica
ation for thiss shape to de
escribe the
notificatio
on.
Configure
e the Notify Requestor
R
off Rejection sm
mart shape to
o send the Re
equestRejectted
correspondence rule to the Owner party. Create a specifica
ation for thiss shape to de
escribe the
notificatio
on.
Note: The
e Correspondence rule fo
orm is suppo
orted by Interrnet Explorerr only.
Hints
1. The Owner wo
ork party corrresponds to the user wh o created the
e case.
e is set when creating a co
orresponden
nce rule.
2. The Correspondence Type
97
3. Click the Add Property toolbar button to add a reference to a PRPC property.
4. Once you implement the correspondence rule, verify that all relevant information has been
added to the specification, then mark the specification as completed.
5. Reminder: Correspondence templates must be configured using Internet Explorer.
Procedure
Follow the steps below:
1. Open the Notify Requestor of Approval flow rule.
2. Open the properties panel for the Notify Requestor of Approval smart shape. Enter a
description of the email to send and relate this to the appropriate specification.
3. Select Party, then select the Owner party and enter a subject for the email.
5. In the Label field, enter Request Approved. In the Correspondence Type field, select
Email. Click Create and open.
98
6. Click the Corr tab. In the rich-text editor, enter the text Your request pyID for
TypeOfRequest has been approved. Select the text pyID and click the Add Property button
on the toolbar to add a reference to the .pyID property, which stores the ID number for
a case. Repeat this process to add a reference to the .TypeOfRequest property. Add spaces
to the message as needed.
7. Save and close the rule form. Return to the flow, click OK to dismiss the properties panel,
and save the flow.
8. Repeat steps 1-7 to add a message to the Notify Requestor of Rejection flow.
9. Create a new Time Off request and run through the process to verify that emails are sent
when a request is either approved or rejected.
10. Open the Notify Requestor of Approval specification. Change the Type to
Correspondence and set the Complexity to Low. Make sure the business objective Reduce
time needed for time-off approvals from three weeks to one and the requirement
Notify Requestor of Status are there. Change the Status to Complete, then click OK.
99
Exercise: Sen
nd a Nottification
n from a
an Assig
gnment
Scenarrio
To ensure
e that time-o
off requests are
a processed
d as quickly a
as possible, H
HR has reque
ested that ou
ur
applicatio
on automaticcally notify managers
m
and
d other appro
overs when a request awa
aits their revview.
Passw
word: passw
word
Approa
ach
Create a corresponde
c
ence rule nam
med AwaitsRe
eview, which
h contains the
e following te
ext.
Time Off request <<pyID>> has been assigned to you fo
or review.
Configure
e the Manage
er Approval, HR Approvall, VP Approva
al, and HR VP
P Approval asssignments to
send the AwaitsReview
w correspondence rule to
o the assigne
ed party. Upd
date the speccifications for
these asssignments to describe the
e notification that should be sent.
Note: The
e Correspondence rule fo
orm is suppo
orted by Interrnet Explorerr only.
Hints
1. The NotifyAssignee correspondence acctivity autom
matically send
ds an assignm
ment notificattion
to
o the user to whom the assignment has been routted.
2. The Correspondence Type
e is set when creating a co
orresponden
nce rule.
olbar button to
t add a refe
erence to a PRPC propertyy.
3. Click the Add Property too
nfigured usin
ng Internet Ex
xplorer.
4. Reminder: Correspondencce templates must be con
100
Procedure
Follow the steps below:
1. Open the Manager Approval flow rule.
2. Open the properties panel for the Manager Approval assignment. Update the specification
for the assignment with a description of the email to send, then click the Notification tab.
3. In the Notify field, select the NotifyAssignee notification activity.
4. In the Subject field, enter A time-off request awaits your review. In the CorrName field,
enter AwaitsReview, and create the correspondence rule.
5. Use the rich-text editor to enter the notification text Time Off request <<pyID>> has been
assigned to you for review. Use the Add Property button on the toolbar to add the
reference to the .pyID property.
6. Save and close the correspondence rule. Return to the Manager Approval flow, and click OK
to dismiss the properties panel.
7. Open the properties panel for the VP Approval assignment. Update the specification for the
assignment, and configure the assignment to send the AwaitsReview notification to the
assigned user. Save the flow.
8. Open the HR Approval flow, and use the properties panel for the HR Approval and HR VP
Approval assignments to configure each to send the AwaitsReview notification to the
assigned user. Save the flow.
9. Create a new Time Off request and run through the process to verify that emails are sent
when a request is either approved or rejected.
101
Passw
word: passw
word
Approa
ach
Delegate the VP Routiing Table deccision table to
o Hilary Redm
mond (Hilaryy.Redmond@
@SAE.com).
Log in as Hilary Redmond and upd
date the VP Routing
R
Table
e to add the M
Marketing de
epartment, w
with
the appro
oval authority
y assigned to
o Tina.Turnerr@SAE.com.
Note: Forr this exercise, the ruleset Delegation:02-02-01 ha s been set up for the DelegationArchitect
operator.. The VP Routting Table de
ecision table should be co
opied to this production rruleset, and tthen
delegated
d.
Note: Remember, the
e proper implementation of a delegat ion strategy requires the assistance o
of a
system ad
dministrator and system architect to create
c
the ne
ecessary rule
esets and acccess control
mechanissms. You wou
uld generally
y be documenting the info
ormation so the delegatio
on can be bu
uilt.
102
Hints
1. The appropriate delegation strategy must be configured in the system by a senior system
architect or an administrator prior to delegation of rules.
2. Copy the VPRoutingTable decision table to the Delegation:02-02-01 ruleset. To do so, select
the Production Rulesets app layer when creating the new decision table.
4. To add a favorite for a specific user, select Other User Personal in the Add To drop-down list,
then select the desired user.
5. To create a favorite for a rule, use the Actions menu on the rule form.
6. To access a favorite as a user, select My Rules from the Operator menu.
7. To ensure that the results of the decision table are read correctly, enclose each one in
quotes.
103
Procedure
Before you begin this exercise, the system must be set up to use the ruleset that will contain the
delegated rule. Again, this is something that is usually done by a Senior System Architect (SSA) or an
administrator. For this exercise, edit the Time-Off class definition, by following the steps below:
1. Using the App Explorer, right-click Time Off and choose Definition. The Edit Class: Time Off
definition appears.
2. Click on the Advanced tab of the class form, scroll down and add Delegation to the RULESET
list. Be sure to Save. We can now add copies of this rule to the Delegation RuleSet
2. Copy the VPRoutingTable decision table to the Delegation:02-02-01 ruleset by finding the
rule and clicking Save As. In the CONTEXT area be sure to select the radio button for
Production Rulesets.
104
3. Open the new version of VPRoutingTable. Confirm you have the correct instance from the
Delegation ruleset using the image below:
105
9. Add a row to the table for the Marketing department, and assign responsibility for time-off
approvals to Tina.Turner@SAE.com.
Tip:Toensurethataliteraltextorstringentryisreadcorrectly,encapsulateitinquotes.Entrieswith
specialcharacters,suchasaperiod,mustbeencapsulatedinquotestobeprocessedcorrectly.
106
Reporting Overview
107
Reduce time needed for time-off approvals from three weeks to one
They have asked us to identify or create any reports to verify that our objectives are satisfied, and
add them to a dedicated report category.
Password: password
Approach
Create a new public report category called HR Reports.
Customize the Timeliness of Resolved Items By Operator report so that the report does not filter on
a specific workgroup, and save the modified report to the HR Reports category.
Hints
1. The Timeliness of Resolved Items By Operator is found in the Monitor Assignments category.
2. To edit a filter condition, click on the filter in the Report Viewer.
3. To avoid filtering on a specific workgroup, set the filter to Is Not Null.
4. To save an edited report to a new category, click Save As in the report header and specify
the category to which you want to save the report.
108
Procedure
Follow the steps below:
1. Open the Report Browser from Designer Studio by clicking Reporting > Access > Report
Browser.
2. Create a new public report category called HR Reports. To do so, click on Create Category in
the upper right hand corner of the Report Browser. Use the name HR Reports and ensure
the Category Type selected is Public.
Note: After typing HR Reports into the category name field, HRReports will automatically be
concatenated when you tab out of the field. This is expected as rule names must be oneword names.
3. Open the Monitor Assignments category by clicking on Monitor Assignments, and click on
Timeliness of Resolved Items By Operator to open the report.
4. Open the Monitor Assignments category by clicking on Monitor Assignments in the
PUBLIC CATEGORIES section, and click on Timeliness of Resolved Items By Operator to
open the report.
109
5. Click the Workgroup filter condition (the current condition is set to default@SAE). From the
drop-down list, select Is Not Null. Click Apply Changes.
6. Click the Save As link in the Report Viewer header to save the Report.
110