Skip to main content

 –

Step 13: Internationalization of Addresses and Phone Numbers for Practitioner, Provider and Business entities

Suggest edit Updated on September 18, 2020

Practitioner, Provider and Business entities have been enhanced to support country and format selection for addresses along with country specific phone number formats. Universal Postal Union is be used as source of truth for address formats. Out of the box support is provided for USA, France and Brazil address formats.

Examples from Business entity locations:

  • Example 1:

    Country: United States of America

    Address type: Delivery to PO Box

  • Example 2:

    Country: United States of America

    Address type: Rural route

  • Example 3:

    Country: Brazil

    Address type: Community mail box

As shown in the above examples, labels and fields of the address change based on the selected Country and Address type. Below are some important rules used in implementation:

  • AddressMain section in Embed-PegaHC-Address class is the container for the full address.
  • Country dropdown is populated with instances of PegaHC-Data-Country class.
  • Address type dropdown is populated from PegaHC-Data-AddressType filtered by country selected.
  • SelectAddressFormat decision table returns the section to be displayed based on the Country and Address type as shown below:

  • This section name is stored in SelectedAddressFormat property and the section is embedded in the AddressMain by property reference.

If you are looking to add support for address formats of a new country that is separate from the OOTB supported list of countries, please follow below steps.

Mandatory steps to add address support for new country in Practitioner, Provider and Business entities:

  • Add country information to PegaHC-Data-Country class records.
  • Add country specific address types to PegaHC-Data-AddressType class records.
  • Add section rules to support each address type of the new country and create any new properties not present in data model.
  • Make sure to use AddressLine1/POBoxNumber and Zipcode properties and make them mandatory in newly created sections as these attributes are used in populating display name of the address.

    (or)

    Extend DisplayName declare expression to change default address display name behavior in case of business entity creation. Extend SetDisplayName_Ext data transform to change default address display name behavior in case of solo practitioner/provider as contract entity creation.
  • Extend decision table SelectAddressFormat to include section to be used for each combination of country code and address type.

Additional customizations (Optional):

  • Add logic to format phone number for new country in data transform FormatPhoneNmbrByCountry_Ext.
  • Add logic to format fax number for new country in data transform FormatFaxNmbrBycountry_Ext.
  • Default country is United States of America. This can be changed by changing the country code in DefaultAddressCountry application setting.
  • To disable country selection dropdown, set EditAddressCountry DSS value to false.
  • To hide country selection dropdown on UI, set DisplayAddressCountry DSS value to false.
  • To disable validation and formatting of phone numbers, set ValidateAndFormatPhone value to false. To disable validation and formatting of fax numbers, set ValidateAndFormatFax value to false.
Did you find this content helpful? YesNo

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us