Locale Contract

Bring your company brand to the Consumer Goods offline mobile app and make the app easier to use for your global workforce.

Manage the translation of labels and localized images by using locale contracts in VS Code based Modeler. Locale contracts are located in $workspace/src/Locale. Out of the box, the Locale folder contains these files:

• en.locale.xml
• Global Labels.globallabel.xml

The default MCP zip also contains the <language>.locale.xml files, bundled as zips, for the Salesforce supported languages. For example - MCP_de.signed.zip, MCP_ja.signed.zip. An admin can extract the <language>.locale.xml files required by the business and add those files to $workspace$/src/Locale. For a custom language, you can create a clone of en.locale or create a custom locale contract. To sync your language locale contracts to include the updated and custom labels and images from Global Labels.globallabel.xml, refresh the locale contracts.

• Locale Contract Definition
  The locale contract in the src/Locale folder consists of simple label id-to-text mappings. The label definitions and translations in the locale contract are segregated into multiple label sections.
• Global Label and Framework Label
  Add new and custom labels in the Global Labels contract.
• Framework Label
  The framework labels are compiled in an XML file on each customizer branch, but customizers should not modify the framework labels. The Consumer Goods Cloud design team maintains and modifies the framework labels.
• Create a Locale Contract
  In Visual Studio Code based Modeler, the Locale contract structure is generated by fetching the default labels and images implemented in the customizer’s snapshot. Use these instructions to create a locale contract for a custom locale other than the available in the default MCP zip.
• Refresh Locale Contracts
  Refresh a locale contract to synchronize and add new, modified, and missing labels and images to the locale contract.
• Localize Date, Time, and Numbers
  Configure locale contracts to show date, time, dateTime, suffix for day and year values, and decimal formats in the language set up in the Consumer Goods mobile app.