オーダー・ハブ のカスタマイズの開始

Order Hubをカスタマイズする前に、デベロッパーズ・ツールキット (DTK) をセットアップし、作成したディレクトリーにソース・コードを抽出します。 あなたが注文ハブソース コードを使用すると、新しいアプリケーションを作成したり、既存のアプリケーションをビジネス ニーズに合わせてカスタマイズしたりできます。 Order Hubをカスタマイズした後、カスタマイズをテストして、それらがご使用の環境で意図したとおりに機能していることを確認します。

手順

  1. インストールする Node.js Angularと互換性のあるバージョンをインストールしてください。 v15 または v18。 詳しくは、 バージョンの互換性を参照してください。 複数のノードバージョンが必要な場合は、Mac 用のnvm （ Linux® ）または nvm-windows （Windows用）の使用を検討できます。
  2. Yarnをインストールします。
  3. コンソールで以下のコマンドのいずれかを実行して、Angular CLI をグローバルにインストールします。
    Angularの場合、 v15、次のコマンドを実行します。
    npm install -g @angular/cli@15
    Angularの場合、 v18、次のコマンドを実行します。
    npm install -g @angular/cli@18
  4. 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
  5. 最適なパフォーマンスを得るには、ローカル・ワークステーションにデベロッパーズ・ツールキット環境をダウンロードしてセットアップしてください。 ツールキットを別の Docker コンテナー内や仮想マシン上でセットアップしないでください。 詳細は、「開発者ツールキット環境の設定」 を参照してください。
    1. Order Hubのカスタマイズを開発するローカル・ワークステーションにデベロッパーズ・ツールキットをダウンロードします。
      ヒント: 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 ディレクトリーで、以下の例に示すように、 devtoolkit_docker/compose/om-compose.properties.sample ファイルのコピーを作成し、それに om-compose.properties という名前を付けます。
      cp om-compose.properties.sample om-compose.properties
    5. om-compose.properties ファイルに以下の値が含まれていることを確認します。
      ORDERHUB_MODE=omoc
    6. Dockerを開始します。
      Docker Desktop をインストールした場合は、 Docker Desktop を開始します。 インストールした場合Docker Engine、 始めるDockerコマンドラインインターフェースを使用してsudo service docker start指示。
    7. 以下のいずれかのコマンドを実行して、デベロッパーズ・ツールキットをセットアップします。
      • デベロッパーズ・ツールキットで Order Hub をセットアップするには、 ./om-compose.sh setup-orderhub コマンドを実行します。
      • 新規の完全な開発者ツールキットをセットアップして、 Sterling™ Business Center のような他の Order Management Softwareのコンテナも含めるには、 ./om-compose.sh setup コマンドを実行します。
      • 既存の完全なデベロッパーズ・ツールキットをアップグレードして、他の Order Management Software関連コンテナー ( Sterling Business Centerなど) も含めるには、 ./om-compose.sh setup-upg コマンドを実行します。
    8. ソース・コードをローカル・ワークステーションに抽出するには、次のコマンドを実行します。 ソース・コードを使用して、 Order Hubをカスタマイズします。
      ./om-compose.sh extract-orderhub-code omoc
      ソース・コードは、ローカル・ワークステーションの devtoolkit_docker/orderhub-codeで入手できます。
      注: Windows Subsystem for Linux バージョン 2 (WSL 2) を使用してツールキットをインストールした場合、ファイルはローカル・ワークステーションでも使用可能です。 例えば、 /mnt/c/devtoolkit_docker内の WSL でコマンドを実行した場合、ファイルは C:/devtoolkit_dockerでも使用可能です。 C:/devtoolkit_dockerにあるローカル・ワークステーションで、すべてのカスタマイズを実行します。
  6. ビジネス・ニーズに合わせて Order Hub をカスタマイズします。 新しいメニュー項目からアクセスするアプリケーションを作成したり、提供されている既存のアプリケーションをカスタマイズしたりすることができます。 IBM。
    詳細は、「新規アプリケーションの作成 」または 「既存アプリケーションのカスタマイズ 」を参照してください。
    注: UI コンポーネントの作成を支援するために、ストーリーブックを使用できます。 ブラウザで https://local host:8443 を入力し、開発者ツールキット環境からストーリーブックにアクセスしてください。 om-compose.properties ファイルの OH_EXT_HTTPS_PORT を変更した場合は、ポートを 8443 から指定したポートに更新してください。