パートナーリンク

パートナーリンク要素およびパートナーリンクの型の定義

パートナーリンクの型は、WSDL の BPEL 拡張です。このため、これは BPEL ファイルではなく WSDL ファイルで定義されます。パートナーリンクの型は、1つまたは 2 つの任意のロール間の関連を作成し、各ロールが単一のポート型を実行する必要があることを示します。パートナーリンクは、ロールをポート型に関連付けてパートナー間の相互の規則を定義します。

パートナーリンク要素とパートナーリンクの型の定義は次のとおりです。混同しないようにしてください。

パートナーリンクの型およびロールは BPEL 拡張であり、WSDL ファイルで定義されます。
パートナーリンク要素は BPEL 2.0 要素です。これらは、BPEL プロセスファイルで定義されます。パートナーリンク要素は、パートナーリンクの型属性への参照を作成します。

パートナーリンクの型を定義することは、パートナーリンク要素の必要条件です。パートナーリンク要素を定義する唯一の方法は、特定のパートナーリンクの型および WSDL ファイルで定義される必要があるロールを参照することです。

パートナーリンクを追加する方法

次に示すいずれかの方法で、ビジネスプロセスにパートナーリンクを追加できます。

パレットから、図にパートナーリンク要素をドラッグします。
「プロジェクト」ウィンドウの同じプロジェクトから、図に WSDL ファイルをドラッグします。
「プロジェクト」ウィンドウの別のプロジェクトから、図に WSDL ファイルをドラッグします。IDE が、自動的に別のプロジェクトから WSDL ファイルを取得し、プロジェクト構造内の Partner ディレクトリに、関連するファイルをコピーします。
「プロジェクト」ウィンドウの EJB プロジェクトから、図に Web サービスノードをドラッグします。

Web サービスノードをドラッグすると、BPEL デザイナーは、Application Server から WSDL ファイルを取得します。WSDL ファイルを正常に取得するには、Application Server が実行されていて、かつ Web サービスプロジェクトが配備されていなければなりません。

パートナーリンク要素の使用

パートナーリンク要素を使用するには、次の手順に従います。

デザインビューで、前述の方法のいずれかを使用して、図にパートナーリンク要素を追加します。
パートナーリンクの「プロパティーエディタ」ダイアログが表示されます。
「プロパティーエディタ」ダイアログで、次の項目を指定します。

名前。デフォルトの名前を受け入れるか、任意の名前を入力します。名前は、そのプロセスで一意でなければなりません。
WSDL ファイル。パートナーリンクに関連する外部サービスの WSDL ファイルを選択します。
図に WSDL ファイルをドラッグしてパートナーリンク要素を追加した場合は、WSDL ファイルは選択された状態になっています。

パートナーリンクの型を指定するには、次のいずれかの方法を選択します。

既存のパートナーリンクの型を使用。指定した WSDL ファイルにすでに存在するパートナーリンクの型の定義を使用する場合は、このラジオボタンを選択して、あとに示す既存のパートナーリンクの型を使用する手順に従います。
新しくパートナーリンクの型を作成して使用。指定した WSDL ファイルに新しくパートナーリンクの型の定義を作成し、このパートナーリンク要素でそれを使用する場合は、このラジオボタンを選択して、あとに示す新しいパートナーリンクの型を使用する手順に従います。

既存のパートナーリンクの型を使用するには、次の手順に従います。

「既存のパートナーリンクの型を使用」ラジオボタンを選択し、ドロップダウンリストから「パートナーリンクの型」を選択します。「自分のロール」、「パートナーのロール」のいずれかまたは両方のフィールドに、自動的に値が入ります。
「了解」をクリックします。
IDE が、BPEL ファイルを指定された値に変更します。

ビジネスプロセス (「自分のロール」) とパートナー (「パートナーのロール」) のロールを入れ替えるには、「ロールの入れ替え」ボタンをクリックします。

新しいパートナーリンクの型を追加し、パートナーリンク要素がそれを使用するように構成するには、次の手順に従います。

「新しくパートナーリンクの型を作成して使用」ラジオボタンを選択し、パートナーリンクの型の名前を指定します。
次の手順で、ビジネスプロセス (「自分のロール」)、パートナー (「パートナーのロール」) の、いずれかまたは両方のロールを指定します。

定義するロールに対応するチェックボックスを選択します。
「ロール名」フィールドに、ロール名を指定します。
ドロップダウンリストから「ポート型」を選択します。

「了解」をクリックします。
IDE が、WSDL ファイルに新しいパートナーリンクの型の定義を追加し、BPEL ファイルを指定された値に変更します。

少なくとも 1 つのロールを設定してください。そうしないと、パートナーリンクが正しく構成されません。

関連項目: 受信; 返信; 呼び出し; WSDL および XML スキーマインポートの追加; WSDL エディタについて; BPEL デザイナーパレット: Web サービス; BPEL デザイナーのデザインビューについて

著作権と商標について