Getting started with customizing Order Hub for traditional installations

Before you customize Order Hub, you must get the Order Hub source code. When you have the Order Hub source code, you either create new applications or customize existing applications to meet your business needs. After you customize Order Hub, you test your customizations to verify that they are working as intended in your environment.

Procedure

  1. Install a Node.js version that is compatible with Angular v15 or v18. For more information, see Version compatibility. If multiple node versions are needed, you can consider using nvm for Mac or Linux®) or nvm-windows (for Windows).
  2. Install Yarn.
  3. Install the Angular CLI globally by running one of the following commands in a console.
    For Angular v15, run the following command.
    npm install -g @angular/cli@15
    For Angular v18, run the following command.
    npm install -g @angular/cli@18
  4. Create a directory where you want to work on your customizations.
  5. Extract the source code to the directory you just created.The source code is located in the <runtime>/repository/orderhub/code/orderhub/on-prem-source.tar file.
    For example, extract the on-prem-source.tarsource code to the mkdir -p order hub-code/lib directory as follows:
    1. Create the directory:
      mkdir -p orderhub-code/lib
    2. Extract the on-prem-source.tar file:
      tar -xf <runtime>/repository/orderhub/code/orderhub/on-prem-source.tar --directory=orderhub-code
    3. Extract the lib.tar file:
      tar -xf <runtime>/repository/orderhub/code/orderhub/lib.tar --directory=orderhub-code/lib
  6. Customize Order Hub to suit your business needs. You can create an application that you access through a new menu item, or you can customize existing applications that are provided by IBM®.