Testing existing module customizations in Order Hub

After customizing an existing module, you can test the changes by configuring Order Hub to connect to your toolkit environment.

  1. If you have a traditional on-premises Order Hub installation (not a next-generation Order Hub), edit the <html_directory>/orderhub/shell-ui/assets/app-bootstrap-config.json file and add the following as the second line in the file:
    "devMode" : true,
    Note: This should only be done in the local development environment. Do not deploy the app-bootstrap-config.json file with "devMode" : true to production systems.
  2. Log in to Order Hub.
  3. In the header, click Customize.
  4. Set the module that you customized to ON.
  5. Save your changes.
  6. If the local server is not running, start the server.
    yarn start-app
    Note: You see the following message.
    **Angular Live Development Server is listening on localhost:<port>,
    open your browser on https://localhost:<port>/<module>/<route>**
    You can ignore the message.
  7. Open a new tab and go to the following URL while replacing the <port> with the applicable port number for the module that you are customizing. For example, for the buc-app-order module, the default port number is 8300.
    https://localhost:<port>
    Accept the certificate so that the customized module can load in Order Hub.
  8. Refresh the browser tab that is logged in to Order Hub. The menu item that you enabled for customization should now show in parenthesis (DEV mode). These menu items will now render from your local server instead of from Order Hub.
    Order menu includes the words DEV mode in parenthesis to indicate that those pages are being served from local server