カスタム拡張を新規または既存のデベロッパーズ・ツールキット環境にインポートして、別のデベロッパーズ・ツールキット環境またはソース・コントロール・リポジトリーからカスタム拡張を追加することで、環境を素早くセットアップまたは更新できます。
拡張機能をインポートするために実行する必要があるプロセスは、セットアップする予定の新しいデベロッパーズ・ツールキット環境に拡張機能をインポートするか、既にセットアップされている環境に拡張機能をインポートするかによって異なります。
- 開発者ツールキット環境をセットアップしている場合、環境をセットアップするために使用している開発 ツールキットをダウンロードしたIBM Sterling Order ManagementSystemから、または外部のカスタマイズパッケージから、インポートするエクステンションを取得できます。
- IBM Sterling Order Management システム 環境からエクステンションをインクルードするには、 IBM® Sterling™ Order Management システム開発者ツールキット を環境からダウンロードするプロセスを実行する際に、 カスタマイズを含む オプションを選択します。
- 外部カスタマイズ・パッケージから拡張機能を組み込むには、デベロッパーズ・ツールキット環境のセットアップの一環として devtoolkit_setup.properties ファイルを構成するときに、 extensions.jar パッケージへの絶対パスを追加します。 詳しくは、 デベロッパーズ・ツールキット環境のセットアップを参照してください。
- セットアップされているデベロッパーズ・ツールキット環境にインポートする場合は、以下の手順のいずれかまたは両方のプロセスを実行します。
手順
- オプション: 拡張 Java アーカイブ (JAR) 内にパッケージされた拡張機能 (別のデベロッパーズ・ツールキット環境からエクスポートされた extensions.jar や、 SaaS 拡張機能サポート・プロバイダーによって提供されたなど) をインポートします。
アーカイブは任意のソースから取得できますが、必要なパッケージ構造に準拠している必要があります。 アーカイブがこの構造に準拠することを保証するために、パッケージがIBM Sterling Order Managementムの開発者ツールキット環境のエクスポート機能で作成されることを保証する。 拡張のエクスポートについて詳しくは、 デベロッパーズ・ツールキット環境からのカスタム拡張のエクスポートを参照してください。
- コマンド・ライン・ユーティリティーで、デベロッパーズ・ツールキット環境の runtime/bin ディレクトリーに移動します。
注意: コンテナー化されたデベロッパーズ・ツールキットの場合、 runtime ディレクトリーは抽出されたランタイム・ディレクトリーです。
- 次のコマンドを実行してください。
- ./sci_ant.sh -f ../devtoolkit/devtoolkit_extensions.xml import
-Dpackage=extension_archive_path
ここで、
extension_archive_path は、インポートする必要がある
extensions.jar アーカイブの絶対パスです。
- オプション: 拡張ファイル用にセットアップされ、ソース管理リポジトリーからチェックアウトされているプロジェクトからカスタム拡張をインポートします。
プロジェクトからインポートする場合は、必要とされるプロジェクト構造に一致するように、ソース・コード・リポジトリー・プロジェクトを手動で構造化する必要があります。 プロジェクトを正常にインポートするには、プロジェクトが以下の構造に従っている必要があります。
<project root directory>
|-- files
| |-- extensions
| | |-- global
| | |-- <custom extension files>
| | |-- resources
| | |-- <custom resource files, such as any custom log4jconfig xml>
| |-- properties
| | |-- customer_overrides.properties
| | |-- <any other allowed overridable property file(s)>
| |-- repository
| |-- eardata
| |-- <relative path to any extension directory>
|--src
| |-- <custom source java files in proper package structure>
|--lib
|--<additional jar files for compiling custom source files>
- カスタム拡張ファイルは、files/extensions/global ディレクトリー内に組み込みます。
- カスタム Java ソース・ファイルは、src ディレクトリー内の正しいパッケージ内に組み込みます。
- カスタム・ソース・ファイルのコンパイルに必要なカスタム JAR ファイルを、サブディレクトリー内ではなく lib ディレクトリー内に直接組み込みます。
- コマンド行ユーティリティーで、ターゲットのデベロッパーズ・ツールキット環境の bin ディレクトリーに移動します。
- 以下のコマンドを実行して、プロジェクトから開発者ツールキット環境に直接エクステンションをデプロイします。 ここで、 project_path はプロジェクト・ルート・ディレクトリへのフルパスである。
./sci_ant.sh -f ../devtoolkit/devtoolkit_extensions.xml importfromproject -Dprojectdir=project_path
コマンドが実行されると、カスタム・ソース・ファイルは custom_impl.jar アーカイブにコンパイルされ、lib 内にあるその他の従属 Java アーカイブと一緒に <runtime>/jar/custom_jars/1_0 ディレクトリーにコピーされます。 コピーされたこれらのアーカイブは、ランタイム・コンポーネント内のすべてのクラスパスに追加されます。
importfromproject ターゲットは、エクスポート処理中に実行される一連のバリデーションも実行する。 これらの検証は、コンパイルされデプロイされる前に、カスタマイズファイルの完全性と正しさを保証します。 詳細はバリデーション・チェックを参照。
コンパイル・エラー、指定された構造に従っていないプロジェクト・ディレクトリー、またはその他のエラーなどが原因でこのコマンドが失敗した場合は、拡張を手動でランタイム・コンポーネントにデプロイしてください。