Support Article
Attachment Categories are not localized after upgrade
SA-16115
Summary
Issue with localizing attachment Categories drop-down values on Add Attachments modal dialog.
In PRPC 5.5, attachment category values were displayed correctly and only the drop-down values on Add Attachments modal dialog were translated. However, in Pega 7.1, the values are translated throughout the application and not limited to the drop-down.
Error Messages
Not Applicable
Steps to Reproduce
- Create a field value with pyLabel for localizing File Attachment Category on PRPC 5.5 with some text such as, XYZ
- The dynamic select displays localized value for File category
- Upgrade to Pega 7.1.7
- Change the dynamic select to drop-down in the OOTB AttachmentCategory section as the former is deprecated
- Create a field value with pyCaption for localizing File Attachment Category with some text such as, XYZ
- Notice that the text File is translated to XYZ throughout the application and not only on the Attachment Category modal pop-up.
Root Cause
The root cause of this problem is a user bug.
On PRPC 5.5 a field value was created using pyLabel for localizing the File attachment Category with localized label as XYZ. However, this is not the literal translation of File. One is required to create a new attachment category for this purpose. If this was performed, one would not have faced any issues, on either application. This is the root cause of the issue.
Use pyCaption and not pyLabel on Pega 7.1.7 because Pega 7 uses Dropdowns and not Dynamic Selects and all text or captions are translated using pyCaption (application is standardized).
A field value created using pyCaption will translate every occurrence of the text for which the field value was created, throughout the application (localization).
It is a coincidence that on PRPC 5.5, only the dynamic select values on the Attachment Category modal dialog was translated and not other parts of the application. If other parts of application used the text File as Labels, or if a field value using pyCaption was created then, the same behavior would be observed on PRPC 5.5 as well.
Resolution
Perform the following local-change:
1. Use Dropdown instead of Dynamic Select in the OOTB AttachmentCategory section.
2. Create a new Attachment Category for localizing the Category “Attachment with client sensitive data” instead of localizing the OOTB File Attachment Category with the same. (recommended)
3. If the application is already live in production with thousands of work objects incorrectly (logically wrong) placed under File category and since changing all the code references would take considerable effort and testing and would delay the delivery, user could continue using the same design (use field value using pyLabel to translate File to XYZ only for the drop-down values in the Attachment Category modal) by modifying the OOTB activity (available rule) GetListOfAttachmentCategoriesWrapper rule to pass the localized values to the drop-down.
4. It was recommended that the user must create a new Attachment Category for this purpose, post completion of the upgrade to prevent inconsistencies in the future.
Published January 31, 2016 - Updated October 8, 2020
Have a question? Get answers now.
Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.