Testing custom locales

Testing custom locales for the developer toolkit

Test your custom locale locally for the developer toolkit.

  1. Copy files from the orderhub-code/shell-ui/assets folder into the om-orderhub-base Docker container.
    docker exec om-orderhub-base bash -c 'mkdir -p /opt/app-root/src/shell-ui/assets/custom'
docker cp orderhub-code/shell-ui/assets/. om-orderhub-base:/opt/app-root/src/shell-ui/assets/custom
  2. Place the new translation for each module of the application in its respective directory. For each module, navigate to orderhub-code/buc-app-<module>/packages/<module>-root-config/src/assets/custom/i18n/<new_language_code>.json.
  3. To log in to Order Hub, from the login page, select the custom language. Then, in Sterling™ Order Management System, create a locale and update your user role to use the locale code. For more information, see Creating a locale.
  4. Use the Customization modal to enable the customization for a module, then start the module by using the following command.
    yarn start-app

Testing custom locales for traditional installations

Test your custom locale locally for traditional installations.

  1. Copy the changes from the orderhub-code/shell-ui/assets folder in the $HTML_DIRECTORY/ext/orderhub/shell-ui/assets directory of the NGINX server. If the $HTML_DIRECTORY/ext/orderhub/shell-ui/assets directory is not empty, merge the changes and do not overwrite the directory.
  2. In the app-bootstrap-config.json file, set "devMode": true.
  3. Place the custom translation for each module of application in its respective directory. For each module, navigate to orderhub-code/buc-app-<module>/packages/<module>-root-config/src/assets/custom/i18n/<new_language_code>.json.
  4. To log in to Order Hub, from the login page, select the custom language. Then, in Sterling Order Management System, create a locale and update your user role to use the locale code. For more information, see Creating a locale.
  5. Use the Customization modal to enable the customization for a module, then start the module by using the following command.
    yarn start-app