既存のアプリケーションをカスタマイズする

既存のオーダーハブアプリケーションから始めて、アプリケーション内のモジュールをカスタマイズすることができます。例えば、 IBM Sterling® Order Management System API からより多くのデータを取得し、既存のテーブルにデータを表示するために、Order 検索結果ページをカスタマイズすることができます。

既存モジュールのカスタマイズ

オーダーハブのコードを抽出したことを確認してください。詳細については、次世代オーダーハブのカスタマイズを始めるをご覧ください
ターミナルを開き、オーダー・ハブコード・ディレクトリに移動する。コンテナの場合、デフォルトの場所は devtoolkit_docker/orderhub-code です。

カスタマイズしたいモジュールに移動します。例えば、注文モジュールを更新したい場合、buc-app-orderフォルダに移動します：

cd devtoolkit_docker/orderhub-code/buc-app-order

表 1. Order Hub メニュー項目とツールキット内のフォルダ名のマッピング
オーダーハブのメニュー	モジュール/フォルダ名	ポート
ホームワークスペースアラート設定 > アラートルール	buc-app-workspace	8900
ノードと容量	buc-app-node	8200
オーダー出荷	buc-app-order	8300
在庫	buc-app-inventory	8600
フルフィルメント約束と出荷	buc-app-fulfillment	9000
例外	buc-app-exception	9100
設定 > ディスプレイ設定設定 > ユーザーの役割設定 > カスタマイズ設定 > バージョン情報設定 > 配信グループ	buc-app-settings	8400
コンフィギュレーション > ノードコンフィギュレーション > キャリアコンフィギュレーション > カスタム属性コンフィギュレーション > テナント	buc-app-configurations	9200
セキュリティ > ユーザー	buc-app-user	9600

次のコマンドを実行して、strict-sslをfalseに設定する。
```
yarn config set "strict-ssl" false
```
開発者ツールキット環境を新しいバージョンに更新した場合は、以下のコマンドを実行して、すべてのオープンソースとライブラリの依存関係の最新バージョンを取得するようにしてください。
```
yarn cache clean
```
以下のコマンドを実行して、モジュールの依存関係をすべてインストールする。
```
yarn install --update-checksums
```
以下のメッセージのようなエラーが発生した場合、そのエラーは無視して差し支えない。これらのエラーは、オーダーハブで使用されるアイコンには影響しません。
```
Error: Failed to compile entry-point @carbon/icons-angular/
```
モジュール/フォルダのルートにあるoverrides.jsonファイルを開く。例えば、devtoolkit_docker/buc-app-order/overrides.jsonのように。
runAsCustomization をtrueに設定して、カスタマイズするページのルートを更新します。例えば、注文検索ページを編集したい場合は、注文検索をtrueに設定します。
```
    "order-search": {
      "runAsCustomization": true
    },
```
サーバーを始動します。
```
yarn start-app
```
コンパイルとアプリケーションの起動に数分かかることもある。
注意：次のようなメッセージが表示されます。
```
"** Angular Live Development Serverはbucgenerichost:<port>でリッスンしています、 
https://localhost:<port>/<module>/<route> **でブラウザを開く。"
```
このメッセージは無視してください。
注意: 以下のメッセージのようなエラーが発生した場合は、新しいアプリケーションを起動する前にヒープサイズを増やしてください。
```
エラーコード 134 でコマンドに失敗しました。
lerna ERR！ yarn run start .... 終了した134
```
以下のコマンドを実行し、新しいアプリケーションを起動する。
- WindowsのCMDプロンプト：
```
SET NODE_OPTIONS=--max_old_space_size=8048
```
- Bash/Git Bash：
```
export NODE_OPTIONS=--max_old_space_size=8048
```
- Powershell：
```
$Env:NODE_OPTIONS=--max_old_space_size=8048
```
注意:サーバーを停止する必要がある場合は、サーバーのジョブを停止してyarn stop-appコマンドを実行し、すべてが正しく停止していることを確認してください。

注意: カスタマイズするモジュールのサーバーだけを起動してください。モジュールをカスタマイズするときはいつでも、モジュール内のカスタマイズされたページを表示するために、それぞれのモジュールディレクトリでyarn start-appを実行する必要があります。
これでカスタマイズの準備は整った。
IBMが提供する既存のページをカスタマイズします。オーダーハブは、既存のページに機能を追加する場合、以下のレベルのカスタマイズをサポートしています：
- コンフィギュレーションによるカスタマイズ
- コードによるカスタマイズ
  - 差別化されたカスタマイズ
  - オーバーライドによるカスタマイズ
詳しくは、次世代オーダーハブのカスタマイズをご覧ください。
あるいは、チュートリアルを見てください：
- チュートリアル：スケジュール注文アクションのカスタマイズ - 差分カスタマイズとオーバーライドによるカスタマイズのアプローチを使用します。
- チュートリアル：Create order flowのカスタマイズ - 設定によるカスタマイズとオーバーライドによるカスタマイズのアプローチを使用します。
- チュートリアル：インベントリ検索結果ページのカスタマイズ - コンフィギュレーションによるカスタマイズとオーバーライドによるカスタマイズのアプローチを使用します。
モジュールをカスタマイズした後、カスタマイズをオーダーハブでテストすることができます。