Press "Enter" to skip to content

Field value rules in Pega



In this post we will see more in detail about field value rules.

What is a field value rule?

The name speaks, field value rule can be defined in 2 ways – Value for a field or  caption for a field.

Field values can be used in many ways!

  1. Restrict selection of items. In other words provides set of values to users for selection (sourcing dropdown control)
  2. Reusable labels (captions) or Reusable values.
  3. Supports localization.


1. Restrict selection of items

Let me explain this with some sample (standard) rules provided by Pega

Here is my favourite quote from Will Smith about reading books.

“There is no new problem that someone hasn’t  already had and written about it in a book”

It is all about how we find the right book :).

Why I am saying this is, Pega base product ‘PegaRules’ has lot of rules which are worth taking a look and learn how they  built it.

So, now I am going to show you an already existing field value rule

Step 1: go to records -> Data model -> property. Filter the property name based on ‘pyTypeOfWork’

Step 2: Open the property ‘pyTypeOfWork’  of class ‘Work-‘

  • You can see the Table type – Field value & you can see the field value description referring the field value name ‘pyTypeOfWork’

Let’s check the field value rule

Step 3: Go to Records -> Data model -> Field value.  Filter the field name based on ‘pyTypeOfWork’

  • You can see there were five field value rules created on the field name ‘pyTypeOfWork’.
  • It means the property ‘pyTypeOfWork’ can contain either of the 5 values (values can be restricted)

Every field value rule contains two key parts

  1. Field Name – It can be a valid name to define a subset of values (eg. pyTypeOfWork, pyStatusWork)
  2. Field Value – It defines the values for the field name (eg. All Unresolved Work)

A single field name can contain multiple field values.

Let’s test this.

Step 1: open any section and include the field ‘pyTypeOfWork’. Use dropdown control or ‘as defined on property’ option.

Step 2: Run the flow and check from the user portal.

Verified.  It means you can restrict the selection of items or provide right set of values.

Field values are reusable components and the same field value (pyTypeOfWork) can be used as Table type in different properties 🙂

2) Reusable labels  or values

Let’s see some of the standard field names before proceeding. (remember, I am talking about field names not field values)

a) pyCaption – This field name is used as labels for fields in user work form.

Open the same section we used before and open any cell properties. You can see a field ‘Label’ used to set the label for the field customer name.

Label can accept any hardcoded value or a Field value rule.

  • If we want to use field value rule, then we have a constraint like the eligible field value rules should come under the Field name pyCaption.
  • All the dropdown items (field value rules) belongs to field name =’pycaption’

Note: There are lot of out of the box field value rules that’s comes under field name ‘pyCaption’

Let’s verify.

Open the ‘GridNoResultsOnLoad’ field value.

b) pyButtonLabel – This field name is used as a label for buttons.

Step 1: I am just including a button in my section to show you the pyButtonLabel.

Step 2: Open the button properties and elect button caption as Text and click on the down arrow, you will see all the eligible field values with field name =’pyButtonLabel

Step 3: Open the field value =’<<Back’

Now you know the importance of field  name.

So whenever you want to use field value inside cell properties or anywhere in a form, first check the dropdown list and know what are the eligible field  names and then create a new field value rule accordingly.

Reusable VALUES

Till now you seen field value rule are used in the left hand side of the form as label or caption.

You can also use field value rule as right hand side values.

Assume you need to include some description in UI. (may be kind of one or more lines)

Step 1: Open any section rule form.

Step 2: Include label.

Step 3: Open the cell properties of the label and start entering the description ( actually you are hardcoding the description). Use more than 64 characters.

  • You can see Pega throws you a severe warning – length exceeds 64 characters.

So here you need to create a new field value rule J instead of hardcoding

Note: Obviously you can create a new field value even though size do not exceeds 64 chars. It’s all about keeping reusability in mind

Finally I am  going to create a new field value rule.

How to create a new field value rule?

Step 1: Records -> Data model -> Field Value -> New

What should be the field name?

The key to decide the field name

  1. If you are going to use it in cell properties in user form, identify the eligible standard field name. ( eg: pyCaption, pyButtonLabel etc)
  2. Else give some meaning field name, mostly the property name itself to which you will use this field value ( eg. pyStatusWork, pyTypeOfWork etc)

In our case, we are going to use it in cell properties, so identify the eligible standard field name 🙂

If you are confused in creating a new rule, remember will smith quotes :P.

Go the section  -> Label cell properties -> Keep your focus on the field and click down arrow to view the list.

  • Now open any field value name, Say GridNoResultsOnLoad. We knew already it is field name ‘pyCaption’
  • Now it’s evident that we need to create a new field value with field name ‘pyCaption’

Note: Field name in the create form also accept property name as shown below.

In our case, specify it as pyCaption and create.

Step 2: You will see the field value rule created with 2 keys

  • Field name
  • Field value (Rule name / Identifier)

You will also see Translate from and Translate To

This opens the way for localization or language pack.

What is localization?

For example: Lets’s  take Mercedes  Benz. They have different branches operating in different countries. They use Pega application to service the customer.

  • Assume three countries – India, China and Germany. India – English;  Germany – German; China – Chinese.
  • The employees or CSRs are mostly local people and are good in their local language.
  • The application functionality should be exactly the same for all 3 countries

Now how will you build an application that can be used by those different countries?

Use localization packs.

Note: The generic answer for the above question is to use Implementation layers for different regions J

What are the rule types that support localization?

  1. Field value
  2. Message

You can build your application in English language and use the language packs.

Language packs are nothing but an overriding ruleset where you can override the field value rules or message rules with localized (translated values). At run time,  this language ruleset will come in the top of ruleset hierarchy and gets picked by rule resolution.

I will create a separate post on localization later!!

In our example, we don’t use any translation or language pack, so I  just used  the English text in To field.

If you want to use an chinese version, save the rule in some dedicated language ruleset  (higher in ruleset hierarchy) and override the To value

Note: The translation pack rulesets  always ends with _<language code> For dutch it will be AmazonSa_NL

Credits: google translation

There are some other standard rules that support localization based on field values.

They can be used to get the translated version of field value rule.

a) Activity – GetLocalizedTextForString

b) Functions

getLocalizedValue() – in pegaRules string library.

getLocalizedText()  – in pegaRules utilities library.

c) Control rule – GetLocalizedValue

How to use parameters in Field value?

Field value rules support parameters.

You can specify more than one parameter.

Parameter values can be dynamically referenced in the Translated To field.

How to test parameters in field value rule?

Step 1: Add a new parameter – NoOfChar

Step 2: Place the parameter order (in our case 1) within the field value To message.

Step 3: Include the field value inside the section label and specify the parameter value.

Step 4: save and create a new case to check from user portal.

You can see the parameters are passed dynamically.

  • The field value message also supports dynamic property references.

For example, we can dynamically refer the case ID within the field value.

We know ‘pyID’ stores the case ID value.

Update the field value as shown below. Refer .pyID dynamically within the curly braces.

Now again go to user portal and create a new case.

You will see the case ID is passed dynamically.

We are at the end of field value post 🙂

Please drop your comments if something  is not clear!! I think this post requires one or two edits 😛

See ya soon in my next post!!!……………………..


  1. Rama krishna Abburi Rama krishna Abburi

    It is very good. Concept with real time examples

  2. Sai Sai

    Hi Prem,

    You made it simple and easy to understand. Good job 🙂


  3. Raghu K Raghu K

    Hi Prem,

    Awesome explanation of this rule. But i have a small doubt in which scenario we will use this field value rule. Could you please tell me 🙂 I am the silent follower of this blog.

  4. sathya sathya

    Great work … please post more posts…

  5. suresh suresh

    Very Nicely explained which is very easy to digest

  6. Mohan Poojary Mohan Poojary

    Good one Prem. Could you please post on Listner parts ex: file-Listner..

  7. Vasu Vasu


    Could you please write a post about Functions & Function Alias?


  8. Marthula srinu Marthula srinu

    please provide a post on decision rules

    • Premkumar G Premkumar G

      Yeah I’ll post about it soon, Marthula. Stay tuned!

  9. Mahitha Mahitha

    Hi Prem,
    I have tried to use Field Value while practicing, but was initially confused a lot. After reading your post I was thorough with this topic. Thank you so much …

  10. siva siva

    where do we specify language specific ruleset in rule set hierarchy? how rules in this will be picked during resolution?

  11. Venki Venki

    Thanks for this post. Very clear aricle on field values. Expecting more articles 🙂

    • Premkumar G Premkumar G

      You are welcome, Venki. 🙂
      I’ll post more. Stay tuned !!

  12. Prasanth Prasanth

    Hi Prem,

    Could you please suggest like the pyCaption we add under the Cell Properties in Label field, Where should we add/configure the “pyConfirmationNote” field value after creating a pyConformationNote rule ?


  13. fouzi fouzi

    Your explanation is really good , a goodjob

    • Premkumar G Premkumar G

      Thank you so much, Fouzi. 🙂

  14. Mohammed Warish Mohammed Warish

    It’s really useful with elaborate explanation.Great work.try to provide more pega concepts.thanks for spending ur valuable time to us.

    • Premkumar G Premkumar G

      Thank you so much for your appreciative words. Really motivates me. I’ll keep on posting more concepts, Mohammed. 😀
      You are most welcome !!

  15. Harsh Soni Harsh Soni

    Hi Prem,

    Great Post !

    When there will be a post for Localization?

    Harsh Soni

  16. Bharath Bharath


    In previous posts some where you said your next post on DSS and SS. Everyone is waiting, please post it soon.

  17. yaswanth reddy yaswanth reddy

    Best Explanation I have seen on the Field Value Concept.

  18. Kyle G Macarthur Kyle G Macarthur

    Very well written and complete discussion! Thank you!

  19. Shivakumaaran Shivakumaaran

    How do you restrict the field values options available in the drop down or radio buttons?

  20. Swe Swe

    Hi Prem
    Can you help me with How to Insert a LineBreak in Field Value. I am using pega 7.3. Tried \n everything. It didn’t work.

    • Premkumar G Premkumar G

      Hi Swe, To my knowledge, you cannot use a line break within a single field value. \n and will NOT work! Better you can create a separate field value rules.

      • aravind aravind

        can you please try

    • Ankit Kothari Ankit Kothari

      Hi Swe/Prem,

      You can use to insert linebreak in Field Value. This works in PEGA 7.2 not sure whether it will work for 7.3 as well.


      • Ankit Kothari Ankit Kothari

        Hi Swe/ Prem,

        You can use to insert linebreak in Field Value. This works in Pega 7.2 not sure whether it will work for 7.3 as well.


  21. Nobu Nobu

    Hi Prem,

    Thank you! I can learn a lot from your blog.
    Can you also explain about how to create a team application and branches?

  22. aravind aravind

    html break command directly in between text should work

  23. sravani sravani

    Hi Prem,

    good article !

    how can we get a dynamic property value in file value rule ?

Leave a Reply

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

error: Content is protected !!