スケジュール・オーダー・カスタマイズのデプロイ

スケジュール・オーダー・カスタマイズを Order Hub SaaS 環境にデプロイする方法について説明します。デプロイメント・プロセスについて詳しくは、既存のアプリケーションのカスタマイズのデプロイを参照してください。

手順

Order Hubにログインします。
カスタマイズの公開先のテナントに切り替えます。
「設定」 > 「構成」 > 「アドオン」 > 「カスタマイズ構成」に移動します。
以下の値を記録します。

カスタマイズ・フォルダー

この値は、カスタマイズをパッケージ化するために package-customization.json で定義する必要がある customizatonContextRoot として使用します。

カスタマイズ・クライアント ID

カスタマイズをデプロイするコマンドを実行するときに、この値を client-id として使用します。

カスタマイズ認証鍵

カスタマイズをデプロイするコマンドを実行するときに、この値を client-secret として使用します。認証キーは、テナントを最初にセットアップしたときにのみ表示されます。認証鍵が分からない場合は、「鍵の再生成」をクリックします。
カスタマイズしたモジュールのルート・レベルにある package-customization.json ファイルを編集します。
1. buc-app-order モジュールをカスタマイズしたため、 devtoolkit_docker/orderhub-code/buc-app-order/package-customization.json ファイルを開きます。
2. 手順4で取得したカスタマイズフォルダの値を customizationContextRootに設定します。
3. 「routes」セクションに、カスタマイズした order-search-result 経路を含めます。
  例:
```
{
    "repositoryName": "buc-app-order",
    "customizationContextRoot": "/buc-app-customization/balohTK4anG5GmXsRwOSeSidbQOKEw6N",
    // replace this with the value you retrieved for customization folder
    "routes": {
        "order-search-result": {
            "type": "code"
        }
    }
}
```
buc-app-order/packages/order-search-result/package.json ファイルを開きます。
ビルドマージされたスクリプトに次のプロパティを追加 --deploy-url=<customizationContextRoot>/buc-app-order/order-search-result
例:
```
"build-merged": "ng build order-search-result --configuration=merged-prod --deploy-url=/buc-app-customization/balohTK4anG5GmXsRwOSeSidbQOKEw6N/buc-app-order/order-search-result/"
```
注: 既存のモジュールをカスタマイズしたため、ビルド・マージ・スクリプトを更新する必要があります。
devtoolkit_docker/packages/buc-app-orderの下に features.json ファイルを作成します。
新規経路を追加しなかった (既存の 'order-search-result' 経路のみをカスタマイズした) ため、空の配列を追加します。
```
[]
```
端末を開き、モジュールのルート・フォルダー devtoolkit_docker/orderhub-code/buc-app-orderに移動します。
以下のコマンドを実行して、デプロイメント用のパッケージをビルドします。このコマンドの完了には時間がかかる場合があります。
```
yarn package-customization
```
以下のコマンドを実行して、カスタマイズをテナントにデプロイします。
```
yarn orderhub-cli publish-customization --client-id=<clientId> --client-secret=<clientSecret> --package-name=buc-app-order
```
注：publish-customizationコマンドが失敗した場合（例えば、クライアントシークレットが間違っている場合など）、 --publish-only=true /dist/buc-app-order.zipメータを指定してコマンドを再実行できます。
```
yarn orderhub-cli publish-customization --client-id=<clientId> --client-secret=<clientSecret> --publish-only=true --package-name=./dist/buc-app-order.zip
```
publish-customization コマンドの使用について詳しくは、既存のアプリケーションのカスタマイズのデプロイを参照してください。
DEV テナントにカスタマイズをデプロイした場合は、以下のステップを実行して、デベロッパーズ・ツールキットへの接続を切断します。別のテナントにデプロイした場合は、単にそのテナントにログインして、カスタマイズが使用可能であることを確認します。
1. Order Hubにログインします。
2. 「設定」 > 「カスタマイズ」に移動します。
3. 「OOB モジュールのカスタマイズを有効にする」をクリックします。
4. カスタマイズしたモジュールを OFFに設定します。
5. 変更を保存し、フレームを再ロードします。
  メニューは、「(DEV MODE)」なしで元のラベルに戻ります。これで、デベロッパーズ・ツールキットではなく、 Order Hub からカスタマイズが使用可能であり、レンダリングされていることを確認できるようになりました。

結果

カスタマイズがテナントに正常にデプロイされ、チュートリアルが完了しました。