Press "Enter" to skip to content

How to configure flows in Pega?



  • Usually all applications have at least a single business process.
  • The business process use some sequence of events to complete the process.

Take Amazon as an example.

This is what happens, when we order a product in Amazon.

  • You can see a work flow here. Not only this organization, every organization business process can be represented in flows.

Now, Amazon needs a Pega sales application to manage this business process.

  • The ideal and best way to achieve this scenario is to use a case type.
  • In Pega 7, there are some beautiful changes in case designer. Introduction of stages, steps greatly reduce the developer works. Let’s discuss more aboutΒ cases in separate lesson.

This business process can also be achieved using flows.

In this post, I am going to explain how to configure a new flow.

I will explain all the available shapes and different scenarios in the upcoming posts πŸ™‚

“One may wonder, we just configure the flow shapes, then how the business process is handled?”

Pega Handles it with ease πŸ™‚

  • All the available rules to support the flow shapes, routing, assignment are hidden within PegaRules application.
  • Pega builts everything and all we need to do is apply our business logic using shapes.
  • Pega does the rest by invoking the appropriate rules.

What is a Flow rule?

  • A flow rule models the business process using shapes and connectors.
  • Flow rule helps in achieving the sequence of events, every work item cross in their life cycle.

How do we configure a flow rule?

  • Flow rule is of process category.

Create a new flow rule.

You can specify the additional configuration options:

  1. Screen flow
  2. Process flow

What is a Screen flow?

  • Imagine you are filling an application form which contain n number of fields, you can represent these fields in series of screens (pages) for effective user experience.
  • To achieve this we can use a screen flow to present series of assignments to a single user. User can go back and forth in the screens.

What is a Process flow?

This can be a starter flow or a simple flow to support business process. Here users are able to route the tasks to other users, worklist, workbasket and all other functionalities.

What are the differences between Process flow and Screen flow?

Let us compare two scenarios:

Amazon sales process vs. filling online application form.

  • Who can work on the above two process?

Many people are involved in sales process – Amazon service, Seller, Courier while only a single person should be involved to fill out the online application form.

From this, you can differentiate process and screen flows in 2 ways:

1. Process flows can be routed to many people to work on. In Screen flows, only a single people can work.

2. In process flows, routing can be configured in assignment shapes, while in screen flows, routing is configured only in the start shape. (Yes, we need to decide before start filling an application form).

  • How the form should look for the two flows?

Harness determines the presentation of the form. In Amazon sales process, the forms provided to people will be different from one another, but online application form will be uniform in all the pages.

From this, you can differentiate process and screen flows in 2 ways:

3. You can have different harness for different forms in process flow, while you have a uniform harness for screen flow.

4. You can specify the harness (tab or tree) in the screen flow start shape, but you can’t do the same in process flow.

You can check the start shape configurations for screen flow.

We will see about ‘screen flow’ with example in the upcoming posts.

Other differences are,

5. In process flow, you can specify the flow actions in the connector shape, while in screen flow, you can specify the flow action in assignment shape.

6. You have the option to go back and forth in screen flow, but you can’t do the same with process flow.

7. Advanced shapes are not supported by Screen flows except split for each.

And the main difference is,

8. Screen flow cannot be a starter flow. They cannot create new work item.

Let us jump to the normal process flow we created before.

As soon as you create a flow 3 shapes are available – a start shape, an assignment shape and an end shape. You can extend and include new shape to support your business process.

In this post, I am going to explain only the configurations.

There are 4 main tabs:

  1. Diagram tab
  2. Design tab
  3. Process tab

Diagram tab

  • In this tab, you will specify the flow diagram.
  • You got a tool bar to add or modify the shapes and layout.

  • Draft button is provided to On/Off the draft functionality. If draft is On, then you can test the flow by adding shapes alone. No need to add the complete rules.
  • Once rules are ready, remember to draft Off to validate all the shapes.
  • + icon is used to add shapes within the flow rules. There are many shapes available in ‘flow rule’. It is a lengthy topic, I will take care of it in separate post.

Design tab

Category – Read only. This will be based on what template you selected at the time of creation.

Flow-wide local actions –

Imagine you have a requirement, where you associate the interested people with the case. You can take this action throughout the case life cycle.

You can use the Flow-wide local actions.

Now, let us check the user portal.

Let me say about how this works. πŸ™‚

Step 1: Use live UI for the other action button. Open the section and button properties.

Step 2: You will an On click action set – opening a menu.

Step 3: Open the navigation rule – pyWorkActionsPerform

What do you see here?

Pre-Activity – pyWorkActionsPopulatePerform, opens the flow rule and append all the flow actions to the PageList property – pyFlowActionsList.

This is how the Other actions button load the local and flow actions in the menu.

Let’s go back to flow rule.

You can modify the order in which these local actions should be present in the user form.

Display actions in alphabetical order? – sorts the local actions and displays in alphabetical order in other actions button.

Display these actions first? – You can also display the same order we provide in this field. The same order will be reflected in User portal.


  • You have few tools to publish this flow or to invoke this flow from external services.

Generate services – This is mainly used to invoke this flow from any Pega service rule.

Let’s test it.

  • Click on generate services. It will open up the Service wizard.

  • Complete the wizard. Each step will be explained in Integration posts.
  • After you complete the steps. Check the Service-SOAP rule.

You will see the Service using OOTB service activity – svcAddWorkObject to invoke the flow rule we created.

Process tab

Start settings

For a change, let’s see the section Pega used in Designer studio.

Process Commander internal flow – you can open the property form and check why it is used.

  • Yes, if checked this flow will not write history. Also note that this checkbox is visible for all flows.

β€˜pySystemFlow’ property contains the data for this checkbox.

This value is set, when you create a new flow & default will be false. You can check view xml from the Actions button and check this property value in the rule form.

Similarly, you can check for all the fields in the flow rule form. πŸ™‚

Can be added to a work object – On checking this, the flow can be invoked on another work item through other actions button.

Note: This checkbox will not be visible, if there is already a case available in the flow applies to work class.

Create a new work object – On selecting this checkbox, this flow will create a new work item.

Then this flow can be called as starter flow.

pyCanCreateWorkObject – Note this property. We will see its usage later in this lesson.

This checkbox will not be visible, if there is already a case available in the Applies to class.

Document as Starting process – This checkbox is not that much important. When checked, this flow can be added in the application documentation as starting process.

Case creation settings

This block is visible only when you select, β€˜Create a new case’ from the start settings.

Temporary Object –Β 

  • On selecting this checkbox, work item is created but with no ID. This work item will not be saved to Database.

I know, what you are thinking πŸ™‚ Then, “why do we need this?”

Imagine, you are applying for an interview. A case is initially created for you as I-1, but sorry, unfortunately your profile is screened now. They have to resolve the case as cancelled.

If the organization don’t want to keep record of these, then they can create a temporary object initially.

Once you are qualified from the screening, they can create a new case ID and work on the Interview process.

Remember, you can persist any temporary object, anytime in the flow using it as an advanced shape β€˜Persist a case’.

Skip create harnessΒ 

Imagine the same example above, the organization needs you to fill in a form before starting the interview process. Case ID will be created only after submitting the form.

If you check this checkbox, then no create harness will be shown. A case ID will be created.

Let’s uncheck this and test.

Run the flow.

You will see that the new harness and the case ID are not created yet. You can try checking and testing from your end.

The Harness field, I marked in the picture is responsible to determine which harness should be displayed in the case creation.

Look for an assignment to perform –Β Make sure you check this checkbox. Default selected.

On checking this, Pega invokes a search to identify any open assignments for the same case in the work list. If yes, then the assignment will be presented to the User.

Also consider an assignment is workbasket – This is visible only when look for an assignment to perform is checked.

Here, Pega extends the search to the user available workbaskets.

If an assignment is not being performed? –

You can either show the harness or close the case.

If you select show harness, then specify a harness – Usually Confirm harness.

Let us test by closing the case when no assignment is being performed.

Still you will get the confirmation screen πŸ˜›

The reason is, this field applies only when flow started from create button and no assignment is found.

This same field is available in the flow action rule form.

Always this file takes precedence.

So, if you want to close the case/show harness after a last assignment screen, then use this setting.

Data Transform – You can specify a default data transform here.

If you leave blank, then default pyDefault will be called.

Work parties – Specify the work party to associate with the case.

For more details on ‘workparties’, kindly look at this post (

Supporting Process Settings

What is a supporting process?

  • Supporting process is specified in case type.
  • Supporting process appears in the Add work – Other actions menu. You can start a support case while working on the main case.

Look for an assignment to performΒ – Same as explained above.

Also consider an assignment is workbasket – Same as explained above.

  • This field holds the flow level SLA.
  • You can either set here or add in pyDefault Data Transform.

For more details on ‘SLA’, please see the post (

Start Conditions

You can specify a when rule to authorize creating a new flow.

Let’s test. I used never condition. Now, run the flow.

On clicking create button, you will get the error shown below.


You can also restrict creating the flow using authorization rule – Privilege.

The users should contain the above privilege to start the flow. If many used, then he/she should contain at least one privilege to start the flow.

For more information on ‘privilege’ visit my post (

No more… End of a long innings. See you soon in Flows part -2 πŸ™‚



  1. Hey Prem,

    First of all, this is great work. Amazing collection of tutorials. While going through the post I stumbled across a fact saying that screen flows cannot used to create new work items. Has that been tried and tested?

    • Premkumar G Premkumar G

      Thanks for your reply. Yes Screen flows stand alone cannot create a work item. You will never see an option to create a work item. But Screen flows can used in any starter flows

  2. Saleem Saleem

    Thanks for sharing.. Great work

    • Premkumar G Premkumar G

      Thank you so much for your appreciation, Saleem. Please subscribe and stay tuned for more posts.

  3. Saleem Saleem

    One more difference is usage of Ticket and SLA on assignment in screen flow is not there..!!

    • Premkumar G Premkumar G

      Tickts – We can raise a ticket inside a screen flow, but we cannot catch the ticket. ( Cannot be assigned to a shape)
      SLA – We can still assign a flow level SLA.

      Imagine a scenario,
      you have open the screen flow and without completing to left for that day. I can have a flow level SLA with 12 hours time period.
      I can use escalation activity to raise a ticket, that is tagged in parent flow. I can end this screen flow using over-all SLA and ticket

  4. sandeep mahajan sandeep mahajan

    This is very informative , I know lot of people will find it very useful. You are doing great job.

    • Premkumar G Premkumar G

      Thank you so much for your appreciation, Sandeep. Please subscribe and stay tuned for more posts.

  5. Ashok Ashok

    What’s the setting for a screen flow to get back to where they last were ?? Any idea or is that by default ??

    • Premkumar G Premkumar G

      Yes. Whenever you add a screenflow, default you will get Back & Next button.
      Please look into ‘pyCaseActionAreabuttons’ oOTB section which contain all the standard button configuration in perform harness mode.
      You can also control in the assignment shape as whether only going back is allowed. Please explore the same too πŸ™‚

  6. Let’s say, I run a starter flow explicitly for testing purpose. Will that create a new work object?

    • Premkumar G Premkumar G

      Yes, Datum it will 😊. We do it in development environment, so no issues. Go on creating as many as you can 😁

  7. Harsha Harsha

    Hi Prem,
    Great work. I have a request, Can I have video format of this class, so that it be more useful.

    • Premkumar G Premkumar G

      Thanks Harsha. I will plan it soon

  8. kiran kiran

    Hi Prem,

    Great Read.

    Why don’t you write a blog where you can share your experience on how you started learning Pega. Most importantly i want to know how one can master in writing activities. I know experience brings the best in you but just a basic thought of yours which can help in mastering activities. If you think you can answer by just replying even that would be great.

    • Premkumar G Premkumar G

      Hi Kiran, I will find a day to share my experience as a blog post πŸ™‚

      All the business process involves data. Activity helps in processing data. It involves several methods to achieve that.
      You can break any business logic to activity steps.

      Don’t think writing activity is a complex one. It is very simple. We just make use of those activity methods and build our logic.

      Don’t worry, I have planned to make a post on activity methods soon πŸ™‚

  9. sai sai

    when Creating Flow why we are using Standrad template option ?

    • Premkumar G Premkumar G

      Hi Sai,

      As we know there are two types of flow
      A) standard process flow
      B) screen flow

      When standard process flow is selected, we can create a simple flow or a starter flow ( creates work item )

  10. Sowmya Sowmya

    Hi Prem,

    Great Work. I have a request can you please share some useful stuff on “Circumstance” Concept.??

    • Premkumar G Premkumar G

      Thank you Sowmya πŸ™‚ I will try to make a post on circumstance soon. I added it in my backlog πŸ™‚

  11. Upendra Upendra

    can u explain straight throw flow? How it works without human input? Explain internal mechnisam?

    • Premkumar G Premkumar G

      Hi Upendra,
      Whenever you start a flow, it stops whenever it come across any assignment (needs human input). Say for example, your flow have only 3 shapes – start, end & a send email utility shape.
      Now this flow can be considered as straight throw flow. It can work without human input. πŸ™‚

  12. Thejaswi Thejaswi


    The document was very helpful.can you tell about entry point in screen flow

    • Premkumar G Premkumar G

      Hi Thejaswi,

      Entry point in screen flow refers to enable navigation link. You can configure that in assignment shapes.
      When enabled you can see a breadcrumb at the top. Usually we use it to jump between screens.

      You need to enable and disable the link and check the difference πŸ™‚

  13. Ramachandra Ramachandra

    Hi Prem,
    Can you make a topic on HARNESS…

    • Premkumar G Premkumar G

      Hi Ramachandra,
      Yes, I will try to post it soon. Stay tuned. πŸ™‚

  14. suma suma

    Hi Prem,

    Really great work sir..

    Im also waiting to see your post on your experience on Pega..
    It would be great if you can share any videos as well for each topic anyway images also helpful.

    Please share a post on Parameters in activities and DT..
    also on Harness topic


    • Premkumar G Premkumar G

      Hi Suma,

      Thank you so much.

      Oh. I’ll try to post about my experience soon. Yeah, some people also have suggested me to use videos. Since it has been some weeks only, I’m thinking about posting videos after sometime. But definitely, I’ll post some videos.

      Since many of you have requested a post on Harness, Activities and all, you expect those topics soon. πŸ™‚

      You are most welcome, Suma. πŸ™‚

  15. ravi ravi

    Great work Prem. Wonderful tutorial for beginners.Can you please explain more on “Create a New Work Object check box will not be visible, if there is already a case available in the applies to class

    • Premkumar G Premkumar G

      Hi ravi,
      It means, Pega wants to have a single starter flow per concrete class.
      In the Flow rule – process tab the checkbox is read only based on the condition when rule – ‘pzCasetypeHasStartingFlows’

      If you have create a starter flow before, then the checkbox will always be ready only:)

  16. Santosh Kumar Mohapatra Santosh Kumar Mohapatra

    Thanks a lot for these many information.

    • Premkumar G Premkumar G

      You are most welcome, Santosh. πŸ™‚

  17. Pradeep Pradeep

    Hi Prem,

    Before creating case, Can we apply Data Transform or execute Activity. If yes, where we can do this?

    • Premkumar G Premkumar G

      Yes. You can use both data transform and activity before executing the case.

      data transform – pyDefault. You can use this data transform, specialize in your work class and update any properties or call your data transform.
      Activity – NewDefaults. You can extend this actvity in your work class and do your business logic. You can also try ‘ValidateNew’ activity.
      Just open the tracer and create a sample case. You find these rule instances.

      I have used all the above rules in my previous projects πŸ™‚

  18. Pradeep Pradeep

    Thanks for the info Prem, Great work.!!

    • Premkumar G Premkumar G

      You are most welcome, Pradeep. πŸ™‚
      Thank you for your appreciation. πŸ™‚

  19. Sairam Sairam

    Hi Prem,
    Excellent work, Great job

    • Premkumar G Premkumar G

      Hi Sairam,

      Thank you so much for your appreciation. πŸ™‚

      Premkumar G

  20. ramesh ramesh

    Hi,This is rameshKoduri from Hyderabad

  21. Ravi Ravi

    Many thanks for sharing. Really awesome….

    • Premkumar G Premkumar G

      You are most welcome, Ravi. πŸ™‚
      Thank you. πŸ™‚

  22. Haribabu Avula Haribabu Avula

    Hi Prem,

    Very useful information for the beginners.Please add the post regarding issues or problems while creating Service-Rest and Connect-Rest.

    • Premkumar G Premkumar G

      Hello Haribabu Avula,

      Thank you so much. Yeah I’ll post about those issues and problems as a separate post soon. Stay tuned. πŸ™‚

  23. Ganapathy Ganapathy

    Hi Prem,

    First of all, my heartfelt appreciations for your great work in sharing knowledge of Pega. The blogs are really informative and helps to understand concepts easily.
    And I have a doubt. I have a flow rule A in class TVS-FW-Auto-Work and enabled “Create a New work Object”. I have created another flow rule B in the same class which I am calling from A as subflow. But in this flow rule B, I can able to select “Create a New work Object” and not as read only. I am using Pega 7.2. Please clarify my doubt.

    • Premkumar G Premkumar G

      Hi Ganapthy,
      It is a valid question. pega is using ‘pzCasetypeHasStartingFlows’ when rule to decide if the casetype has a starting flows. If this when rule satisfies, then your ‘Create a new work object’ will become read only.

      I believe in your case, you dont use case types πŸ™‚

Leave a Reply

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

error: Content is protected !!