Order Hub のカスタマイズ
カスタマイズ・オプションについて
Order Hub は、2 つの方法でカスタマイズおよび構成できます。 それぞれの方法には利点があるため、選択はカスタマイズ要件と、更新の処理および処理方法によって異なります。
- 新規アプリケーションおよびページの作成
- 既存の Order Hub アプリケーションおよびページの変更
新しいアプリケーションおよびページの作成: この方法では、新しい別個のカスタム・アプリケーションまたはページを設計してコーディングすることにより、機能を追加します。 まったく新しいアプリケーションまたはページを作成すると、コードは IBM コードから分離され、 IBMが提供するモジュールやページには影響しません。 したがって、 IBMから月次フィーチャーの更新が行われても、その更新はカスタマイズに影響しません。
既存の Order Hub アプリケーションおよびページの変更: この方法では、 IBMが提供する既存のアプリケーションおよびページをカスタマイズして機能を追加します。 この方法にはさまざまなアプローチがあります。 実行する方法に応じて、新しいコードを作成することも、単純なカスタマイズの場合は単に構成変更を行うこともできます。 どちらの場合も、更新の処理方法とロールアウト方法、および更新の影響について柔軟性があります。 どちらの方法を使用するかは、カスタマイズ要件と、コードを保守および更新する方法によって異なります。 詳しくは、 既存アプリケーションのカスタマイズを参照してください。
新規アプリケーションの作成によるカスタマイズ
まったく新しいアプリケーションとページを追加して Order Hub をカスタマイズすると、コードを制御し、「所有する」ことになります。 このタイプのカスタマイズを開始するには、新しいコード・モジュール・リポジトリーを生成するオプションを指定して、 Order Hub 開発環境のセットアップ手順に従ってください。 詳しくは、 新規アプリケーションの作成を参照してください。
既存のアプリケーションの変更によるカスタマイズ
- 構成によるカスタマイズ
- コードによるカスタマイズ
構成によるカスタマイズのアプローチ
構成によるカスタマイズ 方式を使用すると、コードを作成せずに既存のページをカスタマイズできます。 Order Hub には、JSON ファイルを使用して定義された構成変更を実行することにより、単純なカスタマイズを可能にする特定のページ/パターンがあります。 この機能をサポートするパターンは、設定アイコン (
) を持つ検索フォーム、テーブル、およびフィールド属性です。 以下のチュートリアルを参照して、構成アプローチによるカスタマイズの実際の動作を確認してください。
構成によるカスタマイズについて詳しくは、 構成によるカスタマイズ可能エレメントを参照してください。
コード・アプローチによるカスタマイズ
コードによるカスタマイズ 方式では、以下の 2 つの方法のいずれかでコードを作成することにより、既存のページをカスタマイズします。
- 差分カスタマイズ
- オーバーライドによるカスタマイズ
- カスタム・ページを追加します。
新規ページをナビゲーションに追加すると、共通シェル内で iFrame として機能します。 詳しくは、 新規アプリケーションの作成を参照してください。
- 拡張ポイントを使用して既存のページにコンテンツを追加します。
ページを構成する各コンポーネントには、既存のページにカスタム・コードを挿入するための 2 つの拡張ポイント (上と下) が含まれています。 IBM によって導入されたフィックスおよび新機能は、コード分離がクリーンであるため、簡単に取得できます。 詳しくは、 拡張ポイントを使用した既存ページへのコンテンツの追加を参照してください。
- カスタム・タブおよびページ・アクションを追加します。
選択した順序でカスタム・タブとページ・アクションを追加します。 詳しくは、 既存のページへのカスタム・タブの追加 および 既存のページへのカスタム・アクションの追加を参照してください。
「 チュートリアル: オーダーのスケジュール・アクションのカスタマイズ 」チュートリアルを参照して、差分カスタマイズの手法の実際の動作を確認してください。
オーバーライドによるカスタマイズ: オーバーライドによるカスタマイズでは、完全な柔軟性を備えた Order Hub の既存のページで任意のカスタマイズを実行できます。 ただし、コードを変更した後は、その経路またはページと、そのページに付属する対応するすべてのコード資産の所有権を取得します。 したがって、 IBM が新しい更新をリリースしても、そのページの更新は自動的には取得されません。 新しい更新を取得するには、カスタマイズ変更を最新のコード・リリースに再同期する必要があります。 以下のチュートリアルを参照して、オーバーライドによるカスタマイズのアプローチの実際の動作を確認してください。
ヒント: 必要なカスタマイズが Order Hub内の既存のパターンであるかどうかを確認してから、 Order Hub ソース・コード内のコンポーネントを見つけ、必要に応じて複製します。
カスタマイズ・アプローチのクイック比較
| アプローチ | コーディングが必要ですか? | IBM フィックスの更新の場合: コードのマージが必要ですか? |
|---|---|---|
| 構成によるカスタマイズ | いいえ | いいえ |
| コードによるカスタマイズ | はい | 「はい」と「いいえ」。どちらの方法を採用するかによって異なります。
|
開発環境のベスト・プラクティス
- 2 つの環境をカスタマイズ作業専用にします。 ソフトウェアをカスタマイズする場合は、1 つの環境をカスタマイズの開発専用にし、もう 1 つの環境をカスタマイズのデプロイ専用にすることを計画する必要があります。 カスタム・メニューからの構成は、デプロイメントよりも優先されます。 2 つの環境を専用にすることにより、カスタマイズ UI に変更を加えた場合に、異なるバージョンをデプロイすると、デプロイされた変更よりも UI のバージョンが優先されるようになります。 1 つの環境のみを使用するビジネス・ニーズがあり、UI に変更を加える場合は、メニューを削除してデプロイ済みバージョンと同期することで、この問題を回避できます。
- カスタマイズ作業用の Order Hub ソース・コードを抽出するには、常にセルフサービス・ツールから最新の DTK ダウンロードを使用してください。 Order Hub UI は、 IBM によってフィックスと機能を使用して毎月自動更新されるマルチテナント環境であるため、一致する Order Hub UI ソース・コードは常に最新の DTK の一部として使用できます。 代わりに環境リンクから DTK をダウンロードすると、最新のフィックスとフィーチャーが欠落している可能性がある古いバージョンの Order Hub ソース・コードを取得することがあります。
参照
- Order Hub は、Angular フレームワークを使用して構築されています。 詳しくは、「 https://angular.io」を参照してください。
- Order Hub では、Carbon コンポーネントを使用します。 詳しくは、「 https://angular.carbondesignsystem.com」を参照してください。
- IBM Carbon UI Builder を使用して、 Order Hub ページの UI フラグメントのプロトタイピングを素早く開始します。 詳しくは、「 https://builder.carbondesignsystem.com」を参照してください。
- Storybook にアクセスして、 Order Hubのカスタム・コンポーネントを表示します。 詳しくは、ツールキットのインストール後の ステップ 8 を参照してください。