WebSphere® Message Broker Toolkit の「新規メッセージ定義ファイル」ウィザードを使用して、WSDL から新規メッセージ定義を作成できます。
WSDL からインポートするには、次の 2 つの方法があります。
- メッセージ・セットを作成して、「新規メッセージ定義ファイル」ウィザードを使用します。
この方法については、以下に説明されています。
- 「WSDL または XSD ファイル (あるいはその両方) から開始」クイック・スタート・ウィザードを使用します。
これらのオプションの最初のものを選択した場合、開始前に以下のタスクを完了している必要があります。
以下のステップは、完全に新規のメッセージ定義ファイルを作成したり、既存ファイルの内容を上書きしたりする場合に必要です。
WSDL ファイル (複数可) からメッセージ定義を作成するには、以下のようにします。
- 「ブローカー・アプリケーション開発」パースペクティブに切り替えます。
- WebSphere Message Broker Toolkit メニューから、「ファイル」>「新規」>「メッセージ定義ファイルの作成元...」をクリックして、「新規メッセージ定義ファイル」ウィザードを開きます。
- 表示されるオプションのリストで、「WSDL ファイル」を選択して、「次へ」をクリックします。 あるいは、以前にWebSphere Message Broker Toolkitにインポートされた .wsdl ファイルを右クリックし、メニューで「新規」>「メッセージ定義ファイルの作成元...」をクリックして、ウィザードを開きます。
- 必要に応じて詳細を完了しながら、ウィザードの残りに従って進みます。
インポートする WSDL ファイル (複数の場合あり) が、WebSphere Message Broker Toolkitの現在のワークスペースにあるか、あるいはワークスペースの外部にあるかを選択する必要があります。
チェック・ボックスにより、以下のオプションが提供されています。
- ソース・ファイル (複数の場合あり) をメッセージ・セット・プロジェクトのディレクトリーにコピーします。
デフォルトでは、このチェック・ボックスはクリアされています。
- SOAP ノードを使用できるように、SOAP および XMLNSC ドメインをメッセージ・セットに追加します。
デフォルトでは、このチェック・ボックスが選択されています。
注: - ウィザードで使用できるパネルとオプションは、選択した設定に応じたものになります。
- ウィザード内のいくつかのフィールドは使用できない場合があります。これは、フィールドが必須設定であるか、フィールドに可能な値が 1 つしかないか、または他の値が設定されているためそのフィールドは使用されないことが原因です。
ウィザードを使用して、WSDL ファイル (複数の場合あり) のインポートが終了したら、以下のようにします。
- ファイルがインポートされた時に作成されたレポートにエラーがないかを注意深く調べます。このレポートは、作成しようとしたメッセージ定義を含むプロジェクト内の log ディレクトリーで見つけることができます。
レポートには <wsdl-file-name>.wsdl.report.txt ファイル記述子があります。ここで、<wsdl-file-name> はインポートする WSDL 定義の名前です。
- WebSphere Message Broker Toolkit タスク・リストに示されているメッセージを検討して、新規警告またはエラーが表示されているかどうかを調べます。
注: 必要な SOAP エンベロープおよび SOAP エンコード・メッセージ定義があれば、インポート時に自動的にメッセージ・セットに追加されます。
必要な場合は、新規オプションの「IBM 提供メッセージ」を選択し、「新規メッセージ定義ファイル」ウィザードを使用して、これらを手動でインポートすることもできます。