統合コンポーネント・ライブラリー内のコンポーネントの処理

WebSphere Business Integration Server Express インテグレーション・システムを実装する場合、大半の時間が統合コンポーネントの処理に費やされます。本書では個々のコンポーネントの開発に関する詳細については説明しません。このセクションでは、Designer ツールの起動方法、新規コンポーネントの作成方法、既存のコンポーネントの変更方法、および System Manager で開発する一部のコンポーネントの処理方法について説明します。

統合コンポーネントの開発方法について詳しくは、次のガイドを参照してください。

開発して InterChange Server Express インスタンスに配置したコンポーネントの処理の詳細については、InterChange Server Express リポジトリー内のコンポーネントの処理を参照してください。

コンポーネント命名ガイドライン

コンポーネントを作成するときは、以下の一般的なガイドラインと要件に注意してください。

後方互換性のため、IBM では、数少ない命名要件しか強制しておりません。ただし、命名は、基底のシステム・コンポーネントからの制限に従うため、このガイドの規則を守ってください。例えば、Java は、Java クラス名に制限を課しており、ユーザーのオペレーティング・システムおよびデータベースも同様に、ファイル名に使用される文字および文字長に対しても制限をしています。

Designer ツールの起動

このセクションでは、各 Designer ツールの起動方法について説明します。Designer ツールを使用すると、新規コンポーネントの作成や、既存のコンポーネントのオープンおよび変更を行うことができます。

注:
Designer ツールのいずれかを起動中に、クラスが見つからないというエラーが発生した場合、System Manager を起動して、その Designer ツールをもう一度起動する必要があります。ただし、ツールが起動した後は、System Manager を稼働したままにする必要はありません。

Business Object Designer Express

Business Object Designer Express を起動するには、次のいずれかの方法を使用します。

Business Object Designer Express の詳細については、「ビジネス・オブジェクト開発ガイド」を参照してください。

Connector Configurator

Connector Configurator を起動するには、以下のいずれかの操作を実行します。

Connector Configurator の詳細については、コネクターの構成を参照してください。

Map Designer Express

Map Designer Express を起動するには、次のいずれかの方法を使用します。

Map Designer Express の詳細については、「マップ開発ガイド」を参照してください。

Relationship Designer Express

Relationship Designer Express を起動するには、以下のいずれかの操作を実行します。

Relationship Designer Express の詳細については、「マップ開発ガイド」を参照してください。

Process Designer Express

Process Designer Express を起動するには、以下のいずれかの操作を実行します。

Process Designer Express の詳細については、「コラボレーション開発ガイド」を参照してください。

新規コンポーネントの作成

以下のコンポーネントの場合、Designer ツールの起動の説明に従って、各コンポーネントの Designer ツールを起動すると、そのタイプの新規コンポーネントを作成できます。

コンポーネントによっては専用の Designer ツールがないものもあります。この場合は、System Manager によって表示されるインターフェースで作成します。新しいコラボレーション・オブジェクト、データベース接続プール、およびスケジュールを作成するには、表 4 を参照してください。

表 4. Designer ツールを使用しない新規統合コンポーネントの作成方法
コンポーネント 方法 詳細情報の参照先
コラボレーション・オブジェクト 「WebSphere Business Integration」システム表示で「コラボレーション・オブジェクト」フォルダーを右マウス・ボタンでクリックし、コンテキスト・メニューから「新規コラボレーション・オブジェクトの作成」を選択します。 コラボレーション・オブジェクトの構成
データベース接続プール 「WebSphere Business Integration」システム表示で「データベース接続プール」フォルダーを右マウス・ボタンでクリックし、コンテキスト・メニューから「新規データベース接続の作成」を選択します。 データベース接続プールの構成
スケジュール
  • 「WebSphere Business Integration」システム表示で「スケジュール」フォルダーを右マウス・ボタンでクリックし、コンテキスト・メニューから「コンポーネントのスケジュールを編集」を選択します。
  • ライブラリーでスケジュール可能な任意のコンポーネント、またはユーザー・プロジェクトでスケジュール可能な任意のコンポーネントへのショートカットを右マウス・ボタンでクリックし、コンテキスト・メニューから「コンポーネントのスケジュールを編集」を選択します。
システム管理ガイド
Web サービス 統合コンポーネントとして Web サービスを指定するには、WebSphere Business Integration System ビューの「WebServices」フォルダーを右マウス・ボタンでクリックし、コンテキスト・メニューから「Register New Web Service」を選択します。 統合コンポーネントとしての Web サービスの指定

統合コンポーネントとしての Web サービスの指定

このセクションでは、System Manager で Web サービスを統合コンポーネントとして登録、起動する方法について説明します。以下のセクションから構成されています。

概説

Web サービスは、必要なものを完備したモジュラー式の動的分散アプリケーションであり、ネットワーク上で記述、パブリッシュ、配置、および起動し、製品、プロセス、およびサプライ・チェーンを作成することができます。Web サービスは、ローカル、分散的、または Web ベースの場合もあります。Web サービスは、TCP/IP、HTTP、Java、HTML、および XML などのオープン・スタンダードの上部に構築されます。Web サービスは、メッセージング用の SOAP (Simple Object Access Protocol)、およびパブリッシングとディスカバリー用の UDDI (Universal Description, Discovery and Integration) と WSDL (Web Services Description Language) などの新規の標準テクノロジーを使用します。

System Manager を使用すると、統合コンポーネント・ライブラリー (ICL) のコンポーネントとして、Web サービスを登録することができます。登録プロセスは、統合コンポーネント・ライブラリーの下のコンポーネントとして Web サービスを登録し、InterChange Server Express が Web サービスとの通信に使用するビジネス・オブジェクトを自動的に生成します。また、System Manager を使用して、登録されている Web サービスをテストしてから、サーバーに配置することもできます。

Web サービスの登録

System Manager では、「新規 Web サービスを登録」ウィザードを使用して、Web サービスを登録します。

  1. このウィザードを開始するには、WebSphere Business Integration System ビューの「統合コンポーネント・ライブラリー」を展開し、「WebServices」フォルダーを右マウス・ボタンでクリックしてから、「Register New Web Service」を選択します。「Web サービスを登録する方法の選択」ページが表示されます。
  2. 以下のオプションのいずれかをクリックします。
    オプション 説明
    WSDL ファイルの URL の入力 登録する Web サービスを正確に指定することができます。
    Web サービスの UDDI レジストリーの検索 Web サービスを見つけるため、検索する対象の UDDI レジストリーをさらに詳しく指定することができます。
  3. 「次へ」をクリックします。
  4. ステップ 2 で、「WSDL ファイルの URL の入力」をクリックした場合、「WSDL URL を入力してください」ページが表示されます。「WSDL URL」フィールドに、登録する Web サービスの URL を指定し、「次へ」をクリックしてから、ステップ 8 に進みます。
  5. ステップ 2 で、「Web サービスの UDDI レジストリーの検索」をクリックした場合は、「Web サービスを検索中」ページが表示されます。以下の手順を実行します。
    1. 「検索項目」フィールドで、検索する Web サービスに対する検索条件を入力します。
    2. 以下のサポートされている UDDI レジストリーから 1 つ以上選択します。
      • IBM UDDI レジストリー
      • Microsoft UDDI レジストリー
      • XMethods UDDI レジストリー
    3. 「検索」をクリックします。「検索結果」タブに、結果が検出されたレジストリーの名前が表示されます。選択したレジストリーが使用不可の場合は、そのページにエラー・メッセージが表示されます。
  6. リスト上の各レジストリー名に対して、以下を実行します。
  7. 登録する Web サービスの名前を選択して、「次へ」をクリックし、ウィザードの次のページに進みます。「新規 Web サービスが見つかりました」ページが表示されます。
  8. 新規 Web サービスが見つかりました」ページでは、以下を実行できます。
  9. 「使用可能なメソッド」をクリックすると、詳細情報が、(有効であれば) 右方のペインに表示されます。Fault(s) パラメーターが、サービスの呼び出し時に発生した可能性のあるエラーや例外を格納するために使用されていることに注意してください。
  10. 「完了」をクリックして、Web サービスを登録します。

登録されている Web サービスの表示

Web サービスの登録を終了すると、System Manager で表示することができます。

  1. 「統合コンポーネント・ライブラリー」>「WebServices」のもとで、Web サービス名をダブルクリックします。「概要」タブが表示されます。
  2. 「概要」タブをクリックして、「使用可能な操作」ページを表示します。このページには、その名前をダブルクリックした Web サービスに対するサービスまたはメソッドのリストが表示されます。「使用可能な操作」ページの右側に表示される「Web サービス・メソッド」パネルも、メソッドのリストを表示します。

    Web サービスのすべてのメソッドは、それらを使用するかどうかに関係なく、「使用可能な操作」ページの「操作」列に登録されて表示されます。

    Web サービスを登録するとき (Web サービスの登録を参照) に各メソッドに対して作成されたビジネス・オブジェクトが、「入力 BO」列と「出力 BO」列の下にリストされます。

  3. リストを最新表示にするには、「BO 定義の作成」ボタンをクリックします。
  4. 「Web サービス・メソッド」パネルで、メソッドを選択して、そのパラメーターを「メソッド・パラメーター」パネルに表示します。パラメーターが、「入力」「出力」、および「障害」の各カテゴリーの下にリストされます。

Web サービス・ビジネス・オブジェクトの使用

Web サービスで使用するカスタマイズ・ビジネス・オブジェクトを手動で作成する場合は、プロジェクトを配置するときに、その Web サービスの登録時に自動的に生成される特定のビジネス・オブジェクトを組み込む必要があります。

登録する各 Web サービスには、正しく機能するために一部のカスタマイズ・ビジネス・オブジェクトが必要です。新規の Web サービスを登録する場合、これらのビジネス・オブジェクトのデフォルトのセットが自動的に生成されて、ビジネス・オブジェクト・フォルダーに配置されます。これらのビジネス・オブジェクトは、名前の WS プレフィックスで認識できます。

WS_<name of webservice>
 

これらの自動生成されたビジネス・オブジェクトは、他のすべてのビジネス・オブジェクトと同様にマップやコラボレーションで使用できます。これらを使用すると、手作業で独自のビジネス・オブジェクトを作成する手間を省くことができます。代わりに独自のビジネス・オブジェクトを作成して使用することができますが、オブジェクト間の特定の依存関係のために、独自のカスタマイズ・ビジネス・オブジェクトを Web サービスで使用することを選択する場合は、ユーザーの System Manager プロジェクトから次のビジネス・オブジェクトをサーバーに手動で配置する必要があります。

これを行わないと、プロジェクトを配置してサーバーを始動した後に、次のエラー・メッセージが表示されることがあります。

BusOBj definition xxx not found
 

登録されている Web サービスのテスト

登録されている Web サービスは、テストしてから、統合サーバーに配置することができます。

  1. 「統合コンポーネント・ライブラリー」>「WebServices」のもとで、Web サービス名をダブルクリックします。「Web サービス・メソッド」パネルと「メソッド・パラメーター」パネルとともに、「概要」タブが表示されます。
  2. 「Web サービス・メソッド」パネルで、メソッドを選択します。
  3. 「概要」ページで、メソッド名をダブルクリックするか、右マウス・ボタンでクリックして「テスト」を選択して、メソッドをテストします。ビジネス・オブジェクト編集ページが、メソッドの入力ビジネス・オブジェクトと出力ビジネス・オブジェクトの名前とともに表示されます。このページは、入力ビジネス・オブジェクトをテストするために使用されます。
  4. ビジネス・オブジェクトをテストするには、以下の手順を実行します。
  5. Web サービスの登録時に作成されたビジネス・オブジェクトをテストするために使用する各 Web サービス・メソッドのパネルをクリックします。

既存のコンポーネントの変更

ビジネス・オブジェクト、マップ、関係、およびコラボレーション・テンプレートを変更するには、以下の操作を実行します。

コラボレーション・オブジェクト、データベース接続プール、およびスケジュールの変更方法については、表 5 を参照してください。

表 5. Designer ツールを使用しない統合コンポーネントの変更方法
コンポーネント 方法 詳細情報の参照先
コラボレーション・オブジェクト WebSphere Business Integration System ビューで、「コラボレーション・オブジェクト」フォルダー内のコラボレーション・オブジェクトをダブルクリックします。 コラボレーション・オブジェクトの構成
データベース接続プール データベース接続プールは変更できません。プール・コンポーネントの一部のプロパティーは変更できますが、プールが接続するデータベースなどの定義エレメントは変更できません。 データベース接続プールの構成
スケジュール
  • 「WebSphere Business Integration」システム表示で「スケジュール」フォルダーを右マウス・ボタンでクリックし、コンテキスト・メニューから「コンポーネントのスケジュールを編集」を選択します。
  • ライブラリーでスケジュール可能な任意のコンポーネント、またはユーザー・プロジェクトでスケジュール可能な任意のコンポーネントへのショートカットを右マウス・ボタンでクリックし、コンテキスト・メニューから「コンポーネントのスケジュールを編集」を選択します。

「スケジュール」インターフェースが表示され、定義済みのスケジュールを変更できるようになります。

システム管理ガイド

インポート・ウィザードを使用するサーバーからライブラリーへのコンポーネントのインポート

InterChange Server Express リポジトリーからライブラリーに統合コンポーネントをインポートできます。

InterChange Server Express リポジトリーから統合コンポーネント・ライブラリーにコンポーネントをインポートするには、以下の手順を実行します。

注:
InterChange Server Express インスタンスからライブラリーにコンポーネントをインポートするには、サーバーが実行されている必要があります。「コンポーネントをインポート」ウィザードを始動したときに System Manager がサーバーに接続されていない場合は、インポートできるコンポーネントは表示されません。
  1. System Manager を InterChange Server Express に接続します。詳細については、InterChange Server Express への接続を参照してください。
  2. WebSphere Business Integration System Manager ビューで、コンポーネントのインポート先ライブラリーを右マウス・ボタンでクリックし、コンテキスト・メニューから「サーバーからコンポーネントをインポート」を選択し、以下のいずれかの操作を実行して「コンポーネントをインポート」ウィザードを始動します。

    System Manager によって、図 13 に示すような「サーバーから追加のコンポーネントをインポート」ウィザードが表示されます。

    図 13. サーバーからのコンポーネントのインポート


  3. サーバー、コンポーネント・グループ、またはサーバーからインポートする個々のコンポーネントの横にあるチェック・ボックスを有効にします。
  4. コンポーネントの依存関係もインポートする場合は、「ディープ」チェック・ボックスを有効にします。依存関係については、依存関係および参照を参照してください。
  5. サーバーからインポートするために選択したコンポーネントと同じ名前のコンポーネントが現在ライブラリーに存在するときに、そのコンポーネントを上書きする場合は、「警告せずに既存のコンポーネントを上書きします」チェック・ボックスを有効にします。既存のコンポーネントを上書きするかどうか不明の場合は、チェック・ボックスを無効にします。
  6. 「完了」をクリックします。
  7. 「警告せずに既存のコンポーネントを上書きします」チェック・ボックスを有効にすると、同じ名前の既存のコンポーネントは警告なしに上書きされます。このチェック・ボックスを無効にすると、確認ダイアログで同じ名前の各コンポーネントを置換するかどうかのプロンプトが出されます。コンポーネントを置換しない場合は、「キャンセル」を選択します。コンポーネントは上書きされず、確認ダイアログが閉じます。

ドラッグ・アンド・ドロップを使用するサーバーからライブラリーへのコンポーネントのインポート

System Manager ビューで、ドラッグ・アンド・ドロップ操作を使用して、統合コンポーネント・ライブラリーにコンポーネントをインポートするには、以下の手順を実行します。

  1. InterChange Server Express コンポーネント管理ビューで、以下の操作を行って、展開するコンポーネントを選択します。
  2. WebSphere Business Integration System Manager ビューで、コンポーネントをインポートする先の統合コンポーネント・ライブラリー上に選択したリソースをドラッグ・アンド・ドロップします。

    System Manager が、指定した統合コンポーネント・ライブラリーにコンポーネントをインポートしようとします。メッセージとエラーは、コンソール・ビューに表示されます。

パッケージからライブラリーへのコンポーネントのインポート

System Manager を使用したパッケージへのコンポーネントのエクスポートの説明に従って、統合コンポーネントを .jar パッケージ・ファイルにエクスポートします。これにより、コンポーネントの環境間での移行、他の開発者との共用、およびテクニカル・サポートへのサブミットが容易になります。

パッケージから統合コンポーネント・ライブラリーにコンポーネントをインポートするには、以下の手順を実行します。

要確認:
インポートするパッケージのコンポーネントと同じ名前のコンポーネントが存在する場合、System Manager は警告を出さずに既存のコンポーネントを上書きします。
  1. 統合コンポーネント・ライブラリーを右マウス・ボタンでクリックし、コンテキスト・メニューから「リポジトリー・ファイルのインポート」を選択します。

    System Manager によって、図 14 に示すような「リポジトリー・ファイルのインポート」ウィザードが表示されます。

    図 14. パッケージのインポート


  2. 「リポジトリー・ファイルのインポート」画面で、「統合コンポーネント・ライブラリー名」ドロップダウン・メニューに、コンポーネントをインポートする先ライブラリーの名前が含まれていることを確認します。

    コンポーネントをインポートする先とは異なるライブラリーから「リポジトリー・ファイルからインポート」ウィザードを起動した場合、ウィザードを終了してから、再起動することなく、以下の方法でインポート先を変更できます。

  3. インポートするコンポーネントを指定するには、以下のいずれかを実行します。
  4. 「完了」をクリックします。
注:
ワークベンチで「ファイル」>「インポート」メニュー項目を使用してパッケージ・ファイルをインポートしないでください。「Zip ファイル」ウィザードは、.jar 拡張子を持つアーカイブを処理するもので、InterChange Server Express パッケージ・ファイルには .jar 拡張子が付いていますが、「Zip ファイル」ウィザードは、パッケージ・ファイルに対しては正常に機能しません。

統合コンポーネント・ライブラリーにおけるマップとコラボレーション・オブジェクト・プロパティーの変更

マップおよびコラボレーション・オブジェクトには変更可能なプロパティーがあります。これらのプロパティーを変更すると、コンポーネントの振る舞いを変更できます。コンポーネントのプロパティーを変更するには、統合コンポーネント・ライブラリーのコンポーネントまたはユーザー・プロジェクトのショートカットを右マウス・ボタンでクリックし、コンテキスト・メニューから「プロパティー」を選択します。System Manager に、コンポーネントのプロパティーを構成するためのダイアログが表示されます。

コラボレーション・オブジェクト・プロパティーについては、コラボレーション・オブジェクトの構成を参照してください。

マップ・プロパティーの詳細については、「マップ開発ガイド」を参照してください。

マップ自動化の同義語 の作成

Map Designer Express ツールには、ユーザーが使用して、同じような属性のソース属性と宛先属性を持つビジネス・オブジェクト間のマップおよび逆マップを自動的に作成できる機能があります。これを行うため、Map Designer Express は、ソース・ビジネス・オブジェクトと宛先ビジネス・オブジェクト間で、一致する名前を持つ属性を検索します。

System Manager により、ビジネス・オブジェクトの属性名に対して複数の同義語を作成して、この基本的なマッチング・プロセスを機能強化することができます。

これは、System Manager の ICL プロジェクト・レベルで実行されます。作成された同義語は、ICL に付加され、Map Designer によって起動されたときに、マップ自動化アルゴリズムによって使用されます。作成された同義語は、ICL プロジェクトに付加され、Map Designer によって起動されたときに、マップ自動化アルゴリズムによって使用されます。作成された同義語は、ICL プロジェクトに付加され、Map Designer によって起動されたときに、マップ自動化アルゴリズムによって使用されます。作成された同義語は、ICL プロジェクトに付加され、Map Designer によって起動されたときに、マップ自動化アルゴリズムによって使用されます。作成された同義語は、ICL プロジェクトに付加され、Map Designer によって起動されたときに、マップ自動化アルゴリズムによって使用されます。作成された同義語は、ICL プロジェクトに付加され、Map Designer によって起動されたときに、マップ自動化アルゴリズムによって使用されます。

同義語の作成が終了した後、1 つの ICL からの同義語をファイル (*.syn) にエクスポートすると、そのファイルは別の ICL にインポートすることが可能になります。同義語ファイルをエクスポートまたはインポートするには、ICL を右マウス・ボタンでクリックし、「同義語」>「エクスポート」または「同義語」>「インポート」をクリックします。

同義語を作成する手順は以下のとおりです。

マップ自動化の詳細な検討内容については、「マップ開発ガイド」を参照してください。

同義語作成の手順

ビジネス・オブジェクトに存在する属性の同義語を追加するには、以下の手順を実行します。

  1. System Manager で、ICL を右マウス・ボタンでクリックし、「コンテキスト」メニューを開きます。「同義語」>「編集」をクリックします。

    図 1 は、「コンテキスト」メニューの「同義語」オプションを示しています。

    図 15. 「コンテキスト」メニューの「同義語」オプション

    結果: 「編集」をクリックすると、「同義語」ウィンドウが開きます。

    図 2 は、「同義語」ウィンドウを示しています。

    図 16. 「同義語」ウィンドウ

  2. 左側には、ビジネス・オブジェクトがあります。右側には、属性の同義語を構成する「固有のビジネス・オブジェクト」ウィンドウと「グローバル」ウィンドウがあります。
    1. 左側のビジネス・オブジェクトから、使用する属性を選択し、「固有のビジネス・オブジェクト」ウィンドウの「属性」列の下の右側にドラッグ・アンド・ドロップします。
    2. 左側のビジネス・オブジェクトから、同義語として使用する属性を選択し、「固有のビジネス・オブジェクト」ウィンドウの「同義語」列の下の右側にドラッグ・アンド・ドロップします。
    3. ステップ 2a2b を繰り返して、プロジェクト内のすべてのビジネス・オブジェクトに適用される同義語を構成します。選択した属性をそれぞれ「グローバル」ウィンドウの「属性」列と「同義語」列の下にドラッグ・アンド・ドロップします。

結果: Map Designer Express は、ある属性のすべての同義語を検索し、一致するものを検出すると、自動マッピングを実行します。

ヒント: 同じ手順を使用して、属性と同義語の記入項目を編集するか、「同義語」列の下にコンマ・ストリングを追加します。

例: 図 2 に示されている同義語構成では、以下の結果になります。

このトピックでは、System Manager での同義語のセットアップ手順について説明しました。Map Designer Express による作業時にマップ自動化機能を使用する方法については、「マップ開発ガイド」を参照してください。

データベース接続プールの検証

データベース接続プール・コンポーネントには 「接続を検証」というコンテキスト・メニュー項目があります。このメニュー項目については、データベース接続プールの検証を参照してください。

マップおよびコラボレーション・テンプレートのコンパイル

マップおよびコラボレーション・テンプレートは System Manager でコンパイルできます。コンポーネントを展開したりパッケージにエクスポートしたりするにはコンパイルする必要があるため、この機能は非常に便利です。

コンパイルするコンポーネントが、IBM で提供していないライブラリー (ユーザー自身が複数のコンポーネントを作成したライブラリー) を使用する場合は、System Manager がそのライブラリーを参照するように構成する必要があります。「コンパイラー」設定インターフェースについて詳しくは、4 を参照してください。

マップまたはコラボレーション・テンプレートをコンパイルするには、以下のいずれかの操作を実行します。

統合コンポーネント・ライブラリーのマップまたはコラボレーション・テンプレートをすべてコンパイルするには、以下のいずれかの操作を実行します。

マップをサブマップとともにコンパイルするには、統合コンポーネント・ライブラリーのマップ、またはユーザー・プロジェクトのマップへのショートカットを右マウス・ボタンでクリックし、コンテキスト・メニューから「サブマップでコンパイル」を選択します。

Copyright IBM Corp. 2004