Order Hub のカスタマイズ入門

オンライン編集

Order Hubをカスタマイズする前に、 Order Hub ソース・コードを入手して、ビジネス・ニーズに合わせて新規アプリケーションを作成するか、既存のアプリケーションをカスタマイズするかを決定する必要があります。 Order Hubをカスタマイズした後、カスタマイズ内容をテストして、ご使用の環境で意図したとおりに動作することを確認します。

このタスクについて

このタスクでは、Order Hub をカスタマイズするために、以下の大まかなステップを実行します。
  1. Order Hub ソース・コードを取得します。
  2. 新規アプリケーションを作成するか、既存のアプリケーションをカスタマイズすることにより、ビジネス・ニーズに合わせて Order Hub をカスタマイズします。
  3. カスタマイズをテストして、ご使用の環境で意図したとおりに動作することを確認します。

手順

Order Hub ソース・コードを取得します。

  1. Dockerをインストールします。
    Docker は、 Order Hub コンテナーのみをセットアップするために必要なコンポーネントおよび依存関係をインストールするために使用されます。 コンテナー内で Order Hub のカスタマイズを開発することはありません。 ローカル・ワークステーションで開発します。
  2. Node.js バージョン 16 をインストールします。 複数のノード・バージョンが必要な場合は、 nvm (Mac または Linuxの場合) または nvm-windows (Windows の場合) を使用することを検討してください。
  3. Yarnをインストールします。
  4. 端末で以下のコマンドを実行して、Angular CLI をグローバルにインストールします。
    npm install -g @angular/cli@13.3.9
  5. bucgenerichost を localhostにマップするように hosts ファイルを構成します。 Order Hub がローカル開発環境に接続できるようにするには、マッピングが必要です。
    例:
    1. hosts ファイルを開きます。
      • Windows 10 の場合: C:\Windows\System32\drivers\etc\hosts
      • Linux/Mac OS の場合: sudo vim /etc/hosts
    2. bucgenerichost を localhostに追加します。 例:
      127.0.0.1 localhost bucgenerichost
  6. 最適なパフォーマンスを得るために、ローカル・ワークステーションにデベロッパーズ・ツールキット環境をダウンロードしてセットアップします。 別の Docker コンテナー内または仮想マシン内にツールキットをセットアップしないことをお勧めします。 以下のステップでは、 Order Hubをカスタマイズするためのツールキットのセットアップ方法を素早く要約します。 デベロッパーズ・ツールキットのセットアップ方法の完全なガイドについては、 デベロッパーズ・ツールキット環境のセットアップを参照してください。
    1. Order Hubのカスタマイズを開発するローカル・ワークステーションにデベロッパーズ・ツールキットをダウンロード します。
      ヒント: Microsoft Windowsの場合、 devtoolkit_docker.tar ファイルをドライブのルート・ディレクトリーに保存します。 例えば、 C:/devtoolkit_docker.tarなどです。 インストール後、ファイルはローカル・ワークステーションに抽出され、ファイル・パスが長いと問題が発生します。
    2. ローカル・ワークステーションで端末を開きます。
    3. tar ファイルをダウンロードした場所を参照し、以下のコマンドを実行します。
      tar -xf devtoolkit_docker.tar && chmod +x devtoolkit_docker/compose/*.sh
      その結果、 devtoolkit_docker フォルダーがローカル・ワークステーションに作成されます。
    4. devtoolkit_docker/compose ディレクトリーに移動します。
    5. devtoolkit_docker/compose/om-compose.properties.sample ファイルのコピーを作成し、 om-compose.propertiesという名前を付けます。
      例:
      cp om-compose.properties.sample om-compose.properties
    6. om-compose.properties ファイルに以下の値が含まれていることを確認します。
      
ORDERHUB_MODE=omoc
      プロパティーの完全なリストについては、 デフォルトの Docker Compose プロパティーのオーバーライドを参照してください。
    7. Dockerを開始します。
      Docker Desktop をインストールした場合は、 Docker Desktop を開始します。 Docker Engineをインストールした場合は、コマンド・ラインから Docker を開始します。
      sudo service docker start
    8. 以下のコマンドを実行して、デベロッパーズ・ツールキットをセットアップします。
      • デベロッパーズ・ツールキットで Order Hub のみをセットアップする場合は、以下のコマンドを実行します。
        ./om-compose.sh setup-orderhub
      • 完全なデベロッパーズ・ツールキットをセットアップして、他の Sterling Order Management関連コンテナー (Sterling Business Center など) も含める場合は、以下のコマンドを実行します。
        • 新規ツールキットをセットアップするには、以下のようにします。
          ./om-compose.sh setup
        • 既存のツールキットをアップグレードする場合:
          ./om-compose.sh setup-upg
    9. 以下のコマンドを実行して、ソース・コードをローカル・ワークステーションに抽出します。 ソース・コードを使用して、 Order Hubをカスタマイズします。
      ./om-compose.sh extract-orderhub-code <version>
      < version>: 有効な値は oms または omocです。
      • oms: Order Hub のオンプレミス・バージョンの場合
      • omoc: Order Hub の SaaS バージョンの場合
      ソース・コードは、ローカル・ワークステーションの devtoolkit_docker/orderhub-codeにあります。
      注: Windows Subsystem for Linux バージョン 2 (WSL 2) を使用してツールキットをインストールした場合は、ローカル・ワークステーションでもファイルを使用できます。 例えば、 /mnt/c/devtoolkit_docker の WSL でコマンドを実行した場合、ファイルは C:/devtoolkit_dockerでも入手できます。 ローカル・ワークステーション (C:/devtoolkit_docker) ですべてのカスタマイズを完了します。

ビジネス・ニーズに合わせて Order Hub をカスタマイズします。

  1. Order Hub内の新しいメニュー項目からアクセスできるアプリケーションを作成するか、 IBMが提供する既存のアプリケーションをカスタマイズするかを決定します。
    詳細情報の参照先
  2. オプション: UI コンポーネントの作成に役立つストーリーブックを参照できます。
    以下の URL でストーリーブックにアクセスします。
    https://localhost:8443
    注: om-compose.properties ファイルで OH_EXT_HTTPS_PORT を変更した場合は、ポートを 8443 から指定したポートに更新します。
    ストーリーブックにアクセスするには、 orderhub 拡張 Docker コンテナーが実行されている必要があります。 コンテナーが実行されていない場合は、 devtoolkit_docker/compose に移動し、以下のコマンドを実行します。
    ./om-compose.sh start orderhubext

試してみる:

  1. カスタマイズをテストして、ご使用の環境で意図したとおりに動作することを確認します。