「ソース」ビュー

「ソース」ビューでは、基礎となる XML ソースコードが表示されます。XML を直接編集することができます。

ソースエディタの最上部には、開いている各ドキュメントのタブがあります。それぞれのタブには、ドキュメントの名前が表示されます。ドキュメントが変更後に保存されていない場合は、名前のあとにアスタリスク (*) が表示されます。タブを右クリックすると、さまざまなコマンドにアクセスできます。

ツールバーはソースエディタウィンドウの最上部にあります。

ソースエディタに表示されるソースコードは、構文上の色分けが行われます。

ソースエディタのステータス行は、水平スクロールバーの下にあります。挿入モードと上書きモードを切り替えるには Insert キーを使用します。

「WSDL」ビュー

「WSDL」ビューでは、GUI コンポーネントを使用して WSDL ファイルの要素と属性を設定します。

WSDL ビューには 2 つのサブビュー、つまり、ツリービューと列ビューがあります。サブビューを切り替えるには、WSDL エディタのツールバーのボタンを使用します。

コンポーネントノードの中には、拡張属性を追加できるものがあります。「拡張属性の追加」ダイアログでは、名前と名前空間を指定できます。属性を追加すると、「プロパティー」ウィンドウで値を指定できます。これらのコンポーネントノードでは、拡張属性を削除することもできます。

コンポーネントノードを右クリックして「移動」>「ソース」を選択すると、そのコンポーネントのブロックの先頭にカーソルがある状態で、「ソース」ビューが表示されます。

リファクタリングを実行できます。

• コンポーネントノードを右クリックして「使用状況を検索」を選択すると、その選択したコンポーネントがどのコンポーネントで使用されているかが表示されます。
• コンポーネントノードを右クリックして「リファクタリング」>「名前を変更」を選択すると、関連する XSD、WSDL、および BPEL の各ファイル内の該当するコンポーネントの名前がすべて変更されます。
• コンポーネントノードを右クリックして「リファクタリング」>「安全な削除」を選択すると、そのコンポーネントへの参照を調べてから削除を実行できます。

「名前」プロパティーの値を変更することで、コンポーネントの名前を変更することもできます。WSDL エディタでは同じファイル内の該当個所すべての名前が変更されますが、他のファイル内のものは変更されません。

ルート要素の構成

ドキュメントの追加

WSDL ファイルの任意の要素にドキュメントを追加できます。

ドキュメントを追加するには、次の手順に従います。

1. 「WSDL」ビューで、要素を右クリックして「追加」>「ドキュメント」を選択します。
   ドキュメントノードが表示されます。
2. ドキュメントノードを選択します。
3. 「プロパティー」ウィンドウが表示されない場合は、「ウィンドウ」>「プロパティー」を選択します。
4. ドキュメントのテキストを入力します。

XML スキーマと WSDL ファイルのインポート

WSDL エディタを使用して、XML スキーマファイルまたはプロジェクトに含まれる別の WSDL ファイルをインポートできます。

XML スキーマをインポートするには、次の手順に従います。

1. 「WSDL」ビューでルートノードを右クリックし、「追加」>「スキーマをインポート」を選択します。
   「インポートカスタマイザ」ダイアログが表示されます。
2. 「位置」リストで「ファイル別」または「名前空間別」ノードを展開し、XML スキーマファイルのある場所に移動して選択します。
   「位置」リストの下の「名前空間」フィールドが、自動的に入力されます。
3. (省略可能)「新規接頭辞」フィールドに、使用する接頭辞を入力します。
4. 「了解」をクリックします。

別の WSDL ファイルをインポートするには、次の手順に従います。

1. 「WSDL」ビューでルートノードを右クリックし、「追加」>「WSDL をインポート」を選択します。
   「インポートカスタマイザ」ダイアログが表示されます。
2. 「位置」リストで 「ファイル別」または「名前空間別」ノードを展開し、WSDL ファイルのある場所に移動して選択します。
   「位置」リストの下の「名前空間」フィールドが、自動的に入力されます。
3. (省略可能)「新規接頭辞」フィールドに、使用する接頭辞を入力します。
4. 「了解」をクリックします。

ポート型からの結合とサービスの作成

既存のポート型から、結合とサービスを簡単に作成することができます。あとで結合を修正する場合は、「結合の作成」の適切な手順を参照してください。

ポート型から結合とサービスを作成するには、次の手順に従います。

1. 「WSDL」ビューでポート型ノードを右クリックし、「追加」>「結合およびサービスポート」を選択します。
   「結合およびサービスポートを生成」ダイアログが表示されます。
2. 結合の名前を指定します。
3. このリリースでサポートされる結合の種類は SOAP プロトコルのみです。
4. 結合サブタイプオプションには、SOAP メッセージへの結合を変換する方法を指定します。メッセージ部品と結合サブタイプの設定が WS-I Basic Profile に準拠していない場合は、エラーメッセージが表示されます。
5. サービスの名前を指定します。
6. ポートの名前を指定します。
7. 「了解」をクリックします。
   結合ノードとサービスノードが表示されます。結合ノードには、SOAP 結合ノードおよび 1 つ以上の操作が含まれます。サービスノードにはポートノードが含まれます。

• ポートの SOAP アドレスノードには、ポートのアドレスを指定する場所プロパティーが含まれます。ウィザードにより、場所プロパティーのダミー値が生成されます。ダミー値は、必ず有効な値に置き換えてください。

結合の作成

既存のポート型から簡単に結合とサービスを作成するのではなく、結合、サービス、およびそのサブノードを個別に作成することができます。この節では、結合の作成方法、および SOAP 情報の構成方法について説明します。

• 「結合およびサービスポートを生成」ダイアログの結合サブタイプオプションは、この節で説明するスタイルプロパティーと使用プロパティーの組み合わせになっています。

結合を作成するには、次の手順に従います。

1. 「WSDL」ビューで、「結合」ノードを右クリックして「結合を追加」を選択します。
   結合ノードが表示されます。
2. 「プロパティー」ウィンドウが表示されない場合は、「ウィンドウ」>「プロパティー」を選択します。
3. 結合ノードを選択します。
4. (省略可能) 「名前」プロパティーに新しい名前を設定します。
5. 「型」プロパティーに、結合で参照するポート型を設定します。
6. 結合ノードを右クリックし、「追加」>「結合操作」を選択します。
7. 結合のポート型に複数の操作がある場合は、「操作を選択」ダイアログが表示されます。1 つ以上の操作を選択し、「了解」をクリックします。
   1 つ以上の操作ノードが表示されます。

SOAP 結合ノードを追加するには、次の手順に従います。

1. 「WSDL」ビューで、結合ノードを右クリックして「追加」>「SOAP 結合」を選択します。
   SOAP 結合ノードが表示されます。
2. 「プロパティー」ウィンドウが表示されない場合は、「ウィンドウ」>「プロパティー」を選択します。
3. SOAP 結合ノードを選択します。
4. スタイルプロパティーには、SOAP メッセージへの結合を変換する方法を指定します。値に、「ドキュメント」または「RPC」を設定します。

操作の SOAP 要素を変更するには、次の手順に従います。

1. 「WSDL」ビューで、操作ノードを右クリックして「追加」>「SOAP 操作」を選択します。
   SOAP 操作ノードが表示されます。このノードには、操作に関する概要が含まれています。
2. 「プロパティー」ウィンドウが表示されない場合は、「ウィンドウ」>「プロパティー」を選択します。
3. SOAP 操作ノードを選択します。
4. 「soapAction」プロパティーには、操作の SOAPAction ヘッダーの値を指定します。
5. スタイルプロパティーには、SOAP メッセージへの結合を変換する方法を指定します。値に、「ドキュメント」または「RPC」を設定します。
6. 実際のシナリオに応じて、「入力」、「出力」、「フォルト」の各ノードに要素を追加してください。
• 「入力」ノードで追加できる要素は、soap:body および soap:header です。
• 「出力」ノードで追加できる要素は、soap:body および soap:header です。
• 「フォルト」ノードで追加できる要素は、soap:fault です。
7. soap:headerfault 要素を追加するには、「soap:header」ノードを右クリックし、「追加 headerfault」を選択します。
8. soap:body 要素を追加した場合は、次のプロパティーを設定できます。
• 「部品」プロパティーには、SOAP 本体の要素でどのメッセージ部品が使用されているかが示されます。
• 「encodingStyle」プロパティーには、メッセージで使用されるエンコーディングを表す URI のリストを設定できます。
• 使用プロパティーには、SOAP メッセージへの結合を変換する方法を指定します。値に、「literal」または「encoded」を設定します。
• 名前空間プロパティーには、エンコーディング使用の情報が提供されます。
9. soap:header 要素を追加した場合は、次のプロパティーを設定できます。「メッセージ」および「部品」プロパティーは必須です。
• 「メッセージ」および「部品」プロパティーは、ヘッダーの種類を定義するメッセージ部品を参照します。
• 使用プロパティーには、SOAP メッセージへの結合を変換する方法を指定します。値に、「literal」または「encoded」を設定します。
• 「encodingStyle」プロパティーには、メッセージで使用されるエンコーディングを表す URI のリストを設定できます。
• 名前空間プロパティーには、エンコーディング使用の情報が提供されます。
10. soap:headerfault 要素を追加した場合は、次のプロパティーを設定できます。「メッセージ」および「部品」プロパティーは必須です。
• 「メッセージ」および「部品」プロパティーは、ヘッダーの種類を定義するメッセージ部品を参照します。
• 使用プロパティーには、SOAP メッセージへの結合を変換する方法を指定します。値に、「literal」または「encoded」を設定します。
• 「encodingStyle」プロパティーには、メッセージで使用されるエンコーディングを表す URI のリストを設定できます。
• 名前空間プロパティーには、エンコーディング使用の情報が提供されます。
11. soap:fault 要素を追加した場合は、次のプロパティーを設定できます。
• 「encodingStyle」プロパティーには、メッセージで使用されるエンコーディングを表す URI のリストを設定できます。
• 使用プロパティーには、SOAP メッセージへの結合を変換する方法を指定します。値に、「literal」または「encoded」を設定します。
• 名前空間プロパティーには、エンコーディング使用の情報が提供されます。

結合の削除

WSDL ファイルから結合を削除することができます。

結合を削除するには、次の手順に従います。

• 「WSDL」ビューで結合ノードを右クリックし、「削除」を選択します。

ポート型からの結合とサービスの作成

既存のポート型から、結合とサービスを簡単に作成することができます。あとでサービスを修正する場合は、「サービスの作成」の適切な手順を参照してください。

ポート型から結合とサービスを作成するには、次の手順に従います。

1. 「WSDL」ビューでポート型ノードを右クリックし、「追加」>「結合およびサービスポート」を選択します。
   「結合およびサービスポートを生成」ダイアログが表示されます。
2. 結合の名前を指定します。
3. このリリースでサポートされる結合の種類は SOAP プロトコルのみです。
4. 結合サブタイプオプションには、SOAP メッセージへの結合を変換する方法を指定します。メッセージ部品と結合サブタイプの設定が WS-I Basic Profile に準拠していない場合は、エラーメッセージが表示されます。
5. サービスの名前を指定します。
6. ポートの名前を指定します。
7. 「了解」をクリックします。
   結合ノードとサービスノードが表示されます。結合ノードには、SOAP 結合ノードおよび 1 つ以上の操作が含まれます。サービスノードにはポートノードが含まれます。

• ポートの SOAP アドレスノードには、ポートのアドレスを指定する場所プロパティーが含まれます。ウィザードにより、場所プロパティーのダミー値が生成されます。ダミー値は、必ず有効な値に置き換えてください。

サービスの作成

既存のポート型から簡単に結合とサービスを作成するのではなく、結合、サービス、およびそのサブノードを個別に作成することができます。この節では、サービスの作成方法、および SOAP 情報の構成方法について説明します。

サービスのポートを構成するには、その前に結合を作成する必要があります。

サービスを作成するには、次の手順に従います。

1. 「WSDL」ビューで、「サービス」ノードを右クリックして「追加 サービス」を選択します。
   サービスノードが表示されます。
2. 「プロパティー」ウィンドウが表示されない場合は、「ウィンドウ」>「プロパティー」を選択します。
3. サービスノードを選択します。
4. (省略可能) 「名前」プロパティーに新しい名前を設定します。
5. サービスノードを右クリックし、「追加」>「サービスポート」を選択します。
   ポートノードが表示されます。
6. ポートノードを選択します。
7. (省略可能) 「名前」プロパティーに新しい名前を設定します。
8. 「結合」プロパティーに必要な結合を設定します。

SOAP アドレスノードを追加するには、次の手順に従います。

1. ポートノードを右クリックし、「追加」>「SOAP アドレス」を選択します。
   SOAP アドレスノードが表示されます。
2. 「プロパティー」ウィンドウが表示されない場合は、「ウィンドウ」>「プロパティー」を選択します。
3. SOAP アドレスノードを選択します。
4. 「場所」プロパティーにポートのベース URI を設定します。

サービスとポートの削除

WSDL ファイルからサービスまたはポートを削除することができます。

サービスまたはポートを削除するには、次の手順に従います。

• 「WSDL」ビューでサービスまたはポートノードを右クリックし、「削除」を選択します。

パートナーリンク型の追加

BPEL プロセスにパートナーリンクを追加するには、その前に WSDL ファイルにパートナーリンク型を追加する必要があります。

BPEL プロセスで、パートナーリンクは BPEL プロセスとパートナーサービス間の対話を表します。各パートナーリンクには、パートナーリンク型が関連付けられています。

パートナーリンク型は、2 つのサービス間の対話関係を明らかにするものです。パートナーリンク型は 1 つまたは 2 つのロールを持つことができます。ロールは、その関係の中でサービスが持つ機能を記述したものです。ロールの例としては、loanRequestor と loanProcessor があります。各ロールは、サービスがメッセージを受信するために使用するポート型を指定する必要があります。

パートナーリンク型を自動的に追加するには、次の手順に従います。

1. 次のいずれかの作業を行うと、パートナーリンク型が自動的に生成されます。パートナーリンク型にはデフォルトのロールがあります。
• WSDL ファイルを新規作成します。
• ポート型を作成します。
2. (省略可能) 2 つめのロールを追加するには、次の操作を実行します。
1. パートナーリンク型ノードを右クリックし、「追加」>「ロール」を選択します。
2. 「プロパティー」ウィンドウが表示されない場合は、「ウィンドウ」>「プロパティー」を選択します。
3. ロールを選択します。
4. (省略可能) デフォルトの名前を変更します。
5. ポート型を指定します。

パートナーリンク型を手動で追加するには、次の手順に従います。

1. 「WSDL」ビューでルートノードを右クリックし、「追加」>「パートナーリンク型」を選択します。
   「拡張性要素」ノードにパートナーリンク型ノードが表示されます。パートナーリンク型にはデフォルトのロールがあります。
2. (省略可能) 2 つめのロールを追加するには、パートナーリンク型ノードを右クリックして「追加」>「ロール」を選択します。
3. 「プロパティー」ウィンドウが表示されない場合は、「ウィンドウ」>「プロパティー」を選択します。
4. ロールごとに、次の操作を実行します。
1. ロールを選択します。
2. (省略可能) デフォルトの名前を変更します。
3. ポート型を指定します。

プロパティーおよびプロパティー別名の定義

BPEL サービスエンジン実行環境では、相互関係と呼ばれる仕組みが使用され、BPEL プロセスとそのパートナーサービスの間で一般的に発生し、長時間実行される複数のステートフルなメッセージ交換を追跡します。

BPEL プロセスで相互関係を有効にする手順には、次の初期手順があり、この手順は WSDL ファイルで行う必要があります。

• WSDL ファイルに 1 つ以上のプロパティーを定義します。
  プロパティーによって、ビジネスデータと、BPEL プロセスの大域コンテキストで重要な役割を果たす名前との間に関係が作成されます。各プロパティーは、グローバルに一意な名前 (たとえば claimNumberProperty) と型 (たとえば xsd:string) で構成されます。
• WSDL ファイルにプロパティー別名を定義します。
  プロパティー別名は、メッセージ部品の特定の要素または属性に、特定のプロパティーをマッピングします。プロパティー別名を作成するときは、そのプロパティーとメッセージを指定する必要があります。

WSDL ファイルでこの手順を実行すると、BPEL プロセスに相互関係セットを定義できるようになります。相互関係セットは、1 つ以上のプロパティーを参照します。その相互関係セットは、メッセージアクティビティー (呼び出し、返信、受信)、およびピック要素のメッセージ時分岐によって使用されます。

プロパティーを定義するには、次の手順に従います。

1. 「WSDL」ビューでルートノードを右クリックし、「追加」>「プロパティー」を選択します。
   「拡張性要素」ノードにプロパティーノードが表示されます。
2. 「プロパティー」ウィンドウが表示されない場合は、「ウィンドウ」>「プロパティー」を選択します。
3. プロパティーノードを選択します。
4. (省略可能) デフォルトの名前を変更します。
5. 組み込み単純型に、string や date などの要素または型プロパティーを設定できます。

プロパティー別名を定義するには、次の手順に従います。

1. 「WSDL」ビューでルートノードを右クリックし、「追加」>「プロパティー別名」を選択します。
   「拡張性要素」ノードにプロパティー別名ノードが表示されます。
2. 「プロパティー」ウィンドウが表示されない場合は、「ウィンドウ」>「プロパティー」を選択します。
3. プロパティー別名ノードを選択します。
4. 「プロパティー名」および「メッセージ型」プロパティーの値を指定します。これらのプロパティーを使用すると、データをメッセージからプロパティー値にマッピングできます。
5. 次のオプションプロパティーの値を指定できます: 部分。
6. クエリーを追加するには、プロパティー別名ノードを右クリックして「追加 クエリー」を選択します。
   クエリーノードが表示されます。クエリーノードでは、オプション属性 queryLanguage を設定できます。