Press "Enter" to skip to content

Case management – Introduction



In this post, we will see some basics about case management.

What is Case?   – Case defines work!

  • Every organization have their own business processes.

Think of any Insurance company XYZ (no amazon this time J), they must have some claim process.

Claims – I will talk in terms of home insurance. Insurance policy provides coverage and compensation to the losses or damages occur to the insured house. You can sustain the compensation by requesting a Claim.

Below is my own visualization on the claim process.

Let me explain the flow

  1. It all starts with the Insured guy raising a claim request and the customer service representative (CSR) receives the request.
  2. CSR sends the request to Investigation department, where the claim is checked for its validity. If it is a valid claim, the process continues else the process ends.
  3. If the claim amount exceeds certain limit, then further claim investigations are needed. You may require onsite investigation and approval. If the claim amount is less than certain limit, then the extra investigation is not required.
  4. Then the claim moves to the Claim approver, when he can approve the claim request.
  5. Once the claim is approved, then it can move to payment department where the claim amount will be settled.

This is the complete claim process 🙂

What we have seen till now? – Claim life cycle from START to END.

  • I say this Claims business process is the idle candidate for Case management.
  • If you look at the process, you can see different tasks are performed by different people at different stages.

Let’s come to our Pega.

What is the case structure in Pega?

This is how a case can be broken down in Pega.

  • Whenever you design a case, I would request you to draw the rough design in a paper.  Do some paperwork 🙂

I am going to replicate the claims process as a Pega case.

Let’s create a new claims case.

Records -> Cases -> Add a new case type

Name – You can specify the Case name

Advanced Settings

Derives from (Directed) – You can specify the direct inheritance class. ( If you use any framework layer, the specify the framework work class)

Derives from (Pattern) – You can specify the Implementation work class.

Remote case type – This comes under federated case management.

What is remote case type?

Federated case management (FCM) enables you to access cases from different applications. Say for example, an Insurance company  have two Pega applications. Now using FCM, one application can access cases created from another application.

To enable this, you have to specify the case type as remote 🙂

After filling all the details, click submit. You will be presented with the case designer.

What are the rules created at the back end?

1. Case type –

This rule instance will hold all the case configuration settings.  When you add a new stage, steps or processes using Case designer, then the case type will get updated.

I will make a separate post on Case type and Case designer.

How to access case designer and case type?

Case designer – Click on the case link. You will land in the case designer page.

Case Type – You can use the menu link and open the case type.

2. Flow – pyStartCase

This flow uses ‘pxStartCaseType’ as a sub process and invoke the case stages

3. Data transform – pyDefault and pySetFieldDefaults

Used to initialize certain values for the case. Eg. pyWorkIDPrefix ( S-, W-)

4. Work party – pyCaseManagementDefault – This can be extended based on your business requirement

5. Class – PKS-KnowPega-Work-Claim

You have 5 tabs in case designer

Data model

You can specify the data model for the case. You can create new properties

You can also create declare expressions for the field you specify. You have an option to view the reusable fields too.

  • On specifying the calculation, system creates a declaration rule at the back end.

Workflow tab

Here you can model the stages, processes and steps

Before proceeding let’s define rough stages  – A blue print for our case

Based on the above Claims life cycle, I defined 4 stages.

How to define stages?


  • A case can be decomposed to stages. Take any case life cycle, you will see the case moves through different stages.
  • Normally certain tasks can be grouped to form a stage. For example, take the first stage – Request. Here the CSR can collect the claim request details and can also request some documents.

Click on Add life cycle

Let’s add the stages first. You can use +Stage to add new stages.

Note: As a best practice, try to use Noun or gerund for stage names.

What are the types of stages?

Primary stage – It defines the expected behavior of the case. Happy path

Alternate stage – It defines the exceptions in a case.

For example, if the claim process is rejected then we can jump to an alternate stage and end the case (Resolve cancel). We will see more in detail at the end of this post.

Next, we can define the process for stages.

How to define new processes?


  • Stages can be broken to processes. Based on your business requirement, you can define one or more processes in a single stage
  • In every stage, you get a menu icon, from where you can add new processes.

I defined 2 processes in Investigation stage.

Note: Process names can be same as stage name

You can also define a new process as parallel process, It means when the case enters the stage then both the process starts parallel.

Now processes are ready, let’s define steps in each process.

How to define new steps?


  • Steps represent an action that can be performed in a process( manual action or automated action)
  • Click on the +Step to add new steps.

Pega provides you some predefined configuration for steps

1. Collect Information – provides you with an assignment shape.

2. Approve / Reject – Uses OOTB approval process

3. More

Processes – Expand the icon and you can use any existing flows.

User actions

Utilities – Automated actions

  • Let’s define the steps for all processes.

Note: As soon as you add an Approval step,  Approval Rejection alternate stage is added by system.

I will tell you, how I added the Attach Claim Proof step later in this post!

Let’s see, how the rules were created at the back end.


  • For every process, Pega creates a flow rule at the backend.
  • Click on the Open process.

You can see a new flow created. You can always modify the flow rule.

I updated to flow rule to include the attachment step.

  • Click on the sub process. I added ‘pzAttachmentStep’ OOTB flow rule as a sub process.

Note: Updating the flow here, automatically reflects in the process steps and like the same if you update the steps in the case designer  the corresponding flow will be updated! It’s just vice versa

  • Applies to class of the newly created flow will be same as the Claim work class.
  • The flow created will be in Draft on mode. (This is because the flow is not completed fully). You have to create the flow actions to complete the flow.

Note: Remember to switch off draft mode, It may lead to issues in production.

Flow actions and Sections

  • In every collect information step, you can use ‘Configure view’ to design the data model. On using Configure view, Pega creates a new flow action and section for the defined data model.

I explained about this in my next post 🙂

How to add alternate stage?

  • As mentioned before, alternate stages are designed to all exception actions.
  • Alternate stages appear at the bottom of the Primary stages. They appear in golden color.

Click on the ‘+ Alternate Stage’ to add a new alternate stage.

  • Similar to primary stages, alternate stage can include processes and steps.

Alternate stages do not support automatic transitions, so how do you jump to alternate stage or come out of alternate stage?!

  • Use Change stage. You can use this action, to jump to any stage.
  • Change stage is available as a Utility in flows or case steps as well as available as a local action.

We are at the end of the Introduction post.

In my next post, we will see about the configuration settings available in the stages, processes and steps.


  1. Amir Amir

    Excellent post as always 👍⭐️

    • Premkumar G Premkumar G

      Thank you so much, Amir. 🙂

    • kaa kaa


  2. Parvez Parvez

    Hi Prem,

    Thank you very much. was eagerly waiting for post on case management.


    • Premkumar G Premkumar G

      Hi Parvez,

      You are most welcome. 🙂

      Premkumar G

  3. PrasuR PrasuR

    Hi Prem

    I’m eagerly waiting for your new posts. Thankyou for doing this post on case management.

    • Premkumar G Premkumar G

      Hi Prasu,

      You are most welcome. 🙂 Hope I’ve met your expectations in the new post. 🙂

  4. srikka srikka

    Hi Prem,

    Thanks a lot for publishing case management from many days I am waiting this topic.
    Finally, I got it from your end now almost my doubts has been cleared.


    • Premkumar G Premkumar G

      Hi Srikka,

      You are most welcome. Glad to hear that your doubts have been cleared. 🙂

      Premkumar G

  5. Rakesh Rakesh

    Nice Explanation Prem, keep it up……………

    • Premkumar G Premkumar G

      Thank you, Rakesh. 🙂

  6. Sanjukta Dash Sanjukta Dash

    Hi Prem,

    Thank you for posting Case management topic.

    • Premkumar G Premkumar G

      Hi Sanjukta,

      You are welcome. 🙂

  7. Shaik Shaik

    Have been waiting..Finally.. 🙂
    Thanks for the post on Case Management.

    • Premkumar G Premkumar G

      Hope I’ve satisfied your long-awaited expectation, Shaik. 🙂
      You are most welcome. 🙂

  8. Basant Soni Basant Soni

    Great Article Sir

    • Premkumar G Premkumar G

      Thank you so much, Basant. 🙂

  9. Somnath Panda Somnath Panda

    A great artical with in detail explanation. We need more articles on PEGA and please post your article a bit more quickly. Thank you.

    • Premkumar G Premkumar G

      Thank you, Somnath. 🙂
      I will try my best to post more articles soon. Since writing an article takes time, work and patience. But don’t worry, I’ll try to post more soon. Stay tuned. 🙂
      You are welcome. 🙂

  10. khan khan

    Hello sir! we seriously appreciate your enthusiasm, time, effort and commitment to this blog. This blog has been a huge help for Pega dev junior and senior. I have been a silent follower of your blog for a while and its really hard not to express my appreciation at this point.
    keep up the good work! God Bless you!

    • Premkumar G Premkumar G

      Hi Khan,

      Thank you so very much for your sincerest appreciation! I am feeling energetic and motivated to do more for this blog and I’ll definitely do more. Thank you so much. 🙂
      Stay tuned. 🙂

  11. Rajnish Kumar Mallick Rajnish Kumar Mallick

    Good one buddy.. 🙂

    • Premkumar G Premkumar G

      Thank you, Rajnish. 🙂

  12. Hi Prem,

    I am following all your tutorials. All of them are excellent. The one I love the most are integration ones. I just opened this post and had a laugh seeing this ‘no amazon this time’. I got motivation in preparing for interviews by your posts. I love how you dig into the topics by a simple example and later explain them clearly each and every tab. You are really a hero bro!!

    Thanks for all your efforts@

    • Premkumar G Premkumar G

      Hi Santhosh,

      No words can tell how much elated and motivated, I am feeling on reading your comment. Thank you so very much for your heartfelt appreciation. Appreciations like these motivate me to work hard more. Thank you so much once again.

      You are most welcome, Santhosh. 🙂
      Stay tuned. 🙂

  13. yashoda yashoda

    clear explanation. thank you…

    • Premkumar G Premkumar G

      Thank you and you are welcome, Yashoda. 🙂

  14. Santhosh Santhosh

    Finally a post on Case Management, was waiting for this particular post. Thanks a lot.

    • Premkumar G Premkumar G

      You are welcome, Santhosh. 🙂

  15. Surya Surya

    A big thank you to Prem seriously your Posts are awesome .Every one can understand the way you explain. Thanks for your efforts.
    Please keep going on .

    • Premkumar G Premkumar G

      You are most welcome, Surya. 🙂
      Thank you so much for your heartfelt appreciation. 🙂
      I’ll keep on posting new stuffs. Stay tuned. 🙂

  16. mahesh mahesh

    Hi prem,

    I am really thanking you such a valuable knowledge sharing to us . keep rock bro

    • Premkumar G Premkumar G

      Hi Mahesh,

      You are welcome, Mahesh. 🙂
      I’ll keep on posting new stuffs. Stay tuned. 🙂

  17. Prasad Prasad

    Thank You prem…

    Recently i Saw your posts on web ,really useful for begginers like me.The way your explained topic was very clear and perfect..Thanks for Sharing your knowledge to us

    • Premkumar G Premkumar G

      You are most welcome, Prasad. 🙂
      Thank you so much for your appreciation. Glad to hear that you are finding my blog useful. 🙂

  18. Vasu Vasu

    Information is very useful.

    • Premkumar G Premkumar G

      Thank you, Vasu. 🙂

  19. Venkat Venkat

    Hello Prem
    It’s really awesome !! Keep on update

    • Premkumar G Premkumar G

      Hi Venkat,

      Thank you so much. I’ll keep on updating. Stay tuned !

Leave a Reply

Your email address will not be published. Required fields are marked *

error: Content is protected !!