Localizing PCF Controls

Microsoft Power Apps component framework (PCF) enables developers and app makers to create reusable code components for model-driven and canvas apps. For more information about Microsoft PCF, see Microsoft Documentation.

The following steps enable an administrator of Anthology Reach to override the translation of an existing language or install the translation for a new language in a PCF control.

  1. Create a copy of the web resource (.RESX) file associated with the PCF control with the required language code (LCID). For example, to translate the addressautocomplete PCF control to spanish, create a copy of the addressautocomplete.1033.resx file and change the LCID (1033) to 3082 in the RESX file name as addressautocomplete.3082.resx.

    To create a copy of the .RESX file, perform the following steps:

    1. In the Anthology Reach environment, navigate to Settings > Customizations > Customize the System.

    2. In the Solution: Default Solution page, click Components > Web Resources.

    3. Locate the RESX file of the PCF control that needs to be translated, and click to view the resource file details.

    4. From the Web Resource page, copy the path of the RESX file from the URL field and paste it in a browser.

    5. Copy the content of the RESX file displayed in the browser to an editor, translate the <value> of each <name> record, and rename the RESX file with the required language ID.

  2. In the Solution: Default Solution page, click Components > Web Resources, click New.

  3. In the Web Resource: New page, specify the following details:

    1. In the Name field, specify a name for the RESX file.

    2. In the Type field, select String (RESX).

    3. In the Upload File, upload the new RESX file created in step 1 above.

    4. Click Save.

    The new RESX file for the PCF control is created in the Reach environment.

  4. Copy the resource path of the newly created RESX file from the URL field.

  5. Open the entity form where the PCF control is added.

  6. Select and click the field for which the PCF control configured.

  7. In the Field Properties dialog box, click the Controls tab.

  8. In the Control area, select the PCF control name.

  9. Locate the Localization Resource File Path and click the edit icon.

  10. In the Configure Property "Localization Resource File Path" dialog:

    • Select the Bind to a static value option

    • Select SingleLineText and specify the path of the new RESX file copied in Step 4.

  11. Click OK to save and close the Field Properties dialog.

  12. In the Form page, click the Form Properties icon from the ribbon.

  13. In the Form Properties dialog box, click the Events tab.

  14. In the Event List area, select a javascript (.js) file such as Localization.js to add the dependency of the newly created resource.