［ネームスペースの適用］アクションについて

統合アクティビティが常に有効なXMLドキュメントを受信するのが理想的です（つまり、ドキュメントはデータをスキーマに照らして検証し、マップし、適切に変換して、有効なXMLドキュメントを送信します）。しかし、必ずしもそうなるとは限りません。ネームスペースをすべて無視したいという場合もあります。何らかの方法でXMLドキュメントを検証できることが重要です。このようなさまざまなXML処理の事例では、統合アクティビティに備わっているプレフィックスとネームスペースの処理を変更または上書きする方法が必要です。

［ネームスペースの適用］アクションには、アクションモデル内で入出力メッセージのためのネームスペースとネームスペースプレフィックスを有効に管理するメカニズムが用意されています。このアクションを使用することにより、Webサービスのネームスペース宣言とプレフィックス宣言を1ヶ所に集約したり、入出力メッセージに宣言されたものを上書きしたり、ネームスペースをすべて無視したりできます。

［ネームスペースの適用］アクションは入出力メッセージに適用できます。1つのメッセージパートに複数の［ネームスペースの適用］アクションを用意して、アクションモデルに指定されている条件に基づいてネームスペースを効果的に変更することもできます。宣言されたネームスペースは、アクションモデルの終わりに達するか、または別の［ネームスペースの適用］アクションが実行されるまで有効です。つまり、最新の［ネームスペースの適用］アクションだけが有効です。

新しい統合アクティビティを作成すると、WSDLがネームスペースを宣言している場合には、［ネームスペースの適用］アクションが出力メッセージ用に自動的に作成されます。コンポーネントを作成した後は、追加の［ネームスペースの適用］アクションを手動で作成できます。

［ネームスペースの適用］アクションの作成

［フォルトのスロー］アクションについて

［フォルトのスロー］アクションを使用して、次のことを行います。

［フォルトのスロー］は、指定した条件が真である場合にのみ実行されます。［フォルトのスロー］アクションが実行されたときに書き込まれるメッセージパートはフォルトドキュメントと呼ばれ、このメッセージ内のXMLはERRORというグローバルオブジェクトに含まれます。

［フォルトのスロー］アクションは、次のようにいくつかの方法で使用できます。

［フォルトのスロー］アクションの追加

［試行/フォルト時］アクションについて

［試行/フォルト時］アクションは、［試行/フォルト時］アクションの［実行］ブランチ内でフォルトが発生したときに一連のアクションを実行します。定義済みのフォルトを［実行］ブランチ内にいくつでも指定できます。［試行/フォルト時］アクションを使用して、予期されるエラーを捕捉し、修復やフォルトの報告を実行する他のアクションを実行します。たとえば、［試行/フォルト時］を使用してファイルの検出に失敗する［XML交換］アクションに応答することができます。

［試行/フォルト時］アクションを追加すると、いくつかの行がアクションモデルに追加されます。

アクションがフォルトを生成する可能性があることに気付いたら、それらのアクションを［実行］ブランチに配置します。次いで、固有の状況を処理する各［フォルト時］ブランチの下にエラー処理アクションを配置します。フォルトが発生すると、［フォルト時］ブランチのアクションが実行されます。

前述の例で、［XML交換］アクションでフォルトが予期される場合には、［実行］ブランチの下にアクションを配置します。ある［フォルト時］ブランチには、別の場所からのファイル読み取りを試行する別の［XML交換］アクションを追加し、別の［フォルト時］ブランチには、拡張子の異なるファイルを検索する別の［XML交換］アクションを追加することができます。

［試行/フォルト時］アクションの追加

［WS交換］アクションについて

［WS（Webサービス）交換］アクションは統合アクティビティで最も重要なアクションであり、WSDLファイルに指定された呼び出し規則に従って、統合アクティビティがWebサービスを呼び出せるようにします。統合アクティビティはアクションモデル作成時に［WS交換］アクションを自動的に作成します。

ほとんどの場合、アクションモデルに別の［WS交換］アクションを追加する必要はありません。しかし、そうする必要のある状況もあります。次の手順では、［WS交換］アクションを追加する方法を説明します。

［WS交換］アクションの追加

［XML交換］アクションについて

［XML交換］アクションは、外部XMLドキュメントをDOMに読み込み、DOMのデータをXMLファイルとして書き出します。［XML交換］アクションには次の4種類があります。

GET交換を使用する場合は、統合アクティビティに取り込むXMLドキュメントを示すURLを［交換URL式］フィールドに入力します。［応答パート］フィールドでは、XMLを受信するDOM（入力、出力、_SystemFault、またはプロジェクト）を選択します。

PUT交換を使用する場合は、XMLドキュメントを書き込む場所を示すURLを［交換URL式］に入力します。［要求パート］フィールドでは、XMLとしてデータを送信する元のDOMの名前を選択します。

POST交換を使用する場合は、XMLドキュメントを書き込む場所を示すURLを［交換URL式］に入力します。［要求パート］では、XMLとしてデータを送信する元のDOMの名前を選択します。

POST with Response交換を使用する場合は、Postの場合と同じパラメータと、追加パラメータを1つ指定します。つまり、Post with Response交換から応答XMLドキュメントを受信するために、［応答パート］のDOMも指定する必要があります。Post交換との違いは、Post with Responseが起点サーバから応答XMLオブジェクトを予期するところにあります。

［XML交換］アクションの追加

［中断］アクションについて

［中断］アクションは、［要素の繰り返し］、［グループの繰り返し］、または［次の間の繰り返し］ループの実行を停止します。アクションモデルは実行を継続し、ループの外にある次のアクションに進みます。

［中断］の使用が適しているのは、ループを使用して特定の1つの項目のノードリストを検索している場合などです。ターゲット項目が検出された場合は、繰り返しを継続する必要はありません。［中断］を使用して、ループを直ちに終了することができます。

［中断］アクションの追加

［続行］アクションについて

［続行］アクションは、現在実行している［要素の繰り返し］、［グループの繰り返し］、または［次の間の繰り返し］ループなどの繰り返し部分を停止し、次の繰り返し部分をループの最初から実行します。［続行］アクションによって、ループ内の下流アクションをスキップしつつ、ループを続行して次の繰り返し部分に進むことができます。

［続行］アクションは、リスト内のある項目を何らかの理由でスキップしなければならないが、ループの実行は続行する必要がある場合に適しています。

［続行］アクションの追加

［グループの宣言］アクションについて

［グループの宣言］アクションは、DOMに関する2つの特別なリストを作成するときに使用します。作成したこれらのグループリストは、［グループの繰り返し］アクションでループの基礎として使用できます。リストを作成するには、グループ名とXPathを指定します。次いで、統合アクティビティは次のようにリストを作成します。

グループを使用すると、入力DOMの繰り返し要素を選択し、その繰り返し要素のすべての兄弟の間で固有な値を使用することで、作成する要素の数を減らすことができます。出力DOMでは、要素が重複せず、固有な要素値ごとに要素が1つ存在します。

［グループの宣言］アクションの追加

［要素の繰り返し］アクションについて

［繰り返し］アクションはアクションモデル内にループ構造を作成します。ループを使用すると、1つ以上の一連のアクションを繰り返すことができます。ループには、［要素の繰り返し］、［グループの繰り返し］、［次の間の繰り返し］の3種類があります。

XMLでは、ドキュメント内に、1つの要素のインスタンスを複数含めることができます（データベーステーブルに複数のレコードがあることに似ています）。インスタンスの数はドキュメントごとに異なる可能性があり、ドキュメントスキーマ（DTDまたはXMLスキーマ）に定義されます。たとえば、毎日の請求書の項目を含むXMLドキュメントを受信するとします。XMLドキュメントの項目の数は毎日異なります。XMLドキュメントに「項目」のインスタンスがいくつあるのかがわからないと、この項目の数を入力XMLドキュメントから出力XMLドキュメントにプログラムによって転送する場合、問題になります。［要素の繰り返し］アクションはこの問題を解決します。

［要素の繰り返し］アクションを使用すると、複数回出現する要素にマークを付けることができます。このアクションは、マークが付いた要素の各インスタンスに対して、次のインスタンスが存在しなくなるまで1つ以上のアクションを実行する処理ループを設定します。前述の例では、処理ループに項目数を転送する単一の［マップ］アクションが含まれ、このアクションはすべての項目がマップされるまで繰り返されます。

［要素の繰り返し］アクションは、別名の概念も使用します。別名は2つの役割を果たします。別名はマークが付いた繰り返し要素の代替名または省略名なので、長いXPath式を何回も指定せずに済みます。場合によっては、繰り返し要素がドキュメント階層の数レベル下にあることもあります。マークが付いた子要素を転送する［マップ］アクションを［繰り返し］ループ内に作成する場合に、別名を使用すれば長いXPath式を入力し直すよりも短時間で済みます。別名は、［繰り返し］ループ内の［マップ］アクションにとって、ループが処理されるたびに繰り返し要素の次のインスタンスを使用するための標識にもなります。別名を使用しない［要素の繰り返し］ループ内の［マップ］アクションは、常にソースメッセージ内の要素の最初のインスタンスを参照します。

［要素の繰り返し］アクションを使用すると、ループ内で複数のアクションを処理できます。最も単純な例として、現在の要素インスタンスの値を入力パートから出力パートに転送する［マップ］アクションが繰り返しループに1つだけ含まれている場合があります。この処理ループに複数のアクションを定義することもできます。たとえば、現在の値を転送する［マップ］アクションや、各転送の監査を作成してファイルに書き込む［ログ］アクションがあります。

［要素の繰り返し］アクションの追加

［グループの繰り返し］アクションについて

受信するXMLドキュメントの形式が、常に自分のビジネスプロセスの要件に合う形式であるとは限りません。［グループの繰り返し］アクションを使用すると、データを再構築し、データの集計値を計算するフレームワークを確立できます。グループ化により、入力データの繰り返し要素を選択し、その繰り返し要素のすべての兄弟の間で固有な値を使用することで、作成する要素の数を減らすことができます。

［グループの繰り返し］アクションは、［グループの宣言］アクションによって作成される2つのリストのいずれかに基づいて、処理ループを設定します。ループは、使用するリスト（グループリストと詳細リストのどちらか）内にあるエントリ数と同じ回数だけ実行されます。［グループの繰り返し］と［マップ］コマンドを組み合わせることにより、元のものとは異なる構造とデータを持つ新しいXMLドキュメントを作成できます。

［要素の繰り返し］アクションと同じく、［グループの繰り返し］アクションも別名の概念を使用します。［グループの繰り返し］ダイアログボックスで使用するソースグループの値は、［グループの宣言］アクションで作成されたリスト名です。リスト名は2つの役割を果たします。リスト名は、ループ内の［マップ］アクションのXPathソースの代替名または省略名です。リスト名を使用することで、長いXPath式を何回も指定せずに済みます。グループリスト名を［マップ］アクションソースのDOM名の代わりに使用すると、グループリスト名は［繰り返し］ループ内の［マップ］アクションにとって、ループが処理されるたびにグループリストの次のインスタンスを使用するための標識にもなります。グループ名を使用しない［グループの繰り返し］ループ内の［マップ］アクションは、常にソースパート内の要素の最初のインスタンスを参照します。

［グループの繰り返し］アクションで作成されたターゲット別名も、2つの役割を果たします。ターゲット別名はループ内の［マップ］アクションのXPathターゲットの代替名または省略名です。ターゲット別名を使用することで、長いXPath式を何回も指定せずに済みます。ターゲット別名をパート名の代わりに使用すると、ターゲット別名は繰り返しループ内の［マップ］アクションにとって、ターゲットメッセージパートでソースの新しいインスタンスを作成するための標識にもなります。ターゲット別名を使用しない［グループの繰り返し］ループ内の［マップ］アクションは、常に、ターゲットメッセージパート内に作成された最初のインスタンスを、ソースグループリストの後続のインスタンスで上書きします。

［グループの繰り返し］アクションの作成は次の3つの作業から成ります。

［グループの繰り返し］アクションの追加

［次の間の繰り返し］アクションについて

［次の間の繰り返し］アクションは、指定した条件がTrueである限り1つ以上のアクションを繰り返します。［次の間の繰り返し］アクションに作成するターゲット別名は、2つの役割を果たします。ターゲット別名はループ内の［マップ］アクションのXPathターゲットの代替名または省略名です。ターゲット別名を使用することで、長いXPath式を何回も指定せずに済みます。ターゲット別名を［マップ］アクションのDOM名の代わりに使用すると、ターゲット別名は繰り返しループ内の［マップ］アクションにとって、ターゲットDOMでソースの新しいインスタンスを作成するための標識にもなります。ターゲット別名を使用しない［グループの繰り返し］ループ内の［マップ］アクションは、常に、ターゲットDOM内に作成された最初のインスタンスを、ソースの後続のインスタンスで上書きします。

［次の間の繰り返し］アクションの追加

デフォルトのマッピング動作

［マップ］アクションを使用してXMLドキュメント内の要素と属性をマップすると、特定のデフォルト動作が生じます。次の表に、これらのデフォルト動作を示します。

これらの動作の多くは、［高度なマッピング］ダイアログボックスを使用してアクションごとに変更できます（「［詳細］マッピングオプション」を参照）。

マークアップを含むリーフ要素

ランタイムにJavaまたはECMAScript操作によって要素が入力されると、問題が発生する場合があります。要素はマークアップ（<や>などの不正な文字を含む文字列）が含まれるデータを受信する場合があります。統合アクティビティがこのような要素の内容を出力DOMのノードにマップしようすると、出力ドキュメントの形式が不正になります。統合アクティビティでは、マークアップを含むすべてのデータをターゲットドキュメントの新しいCDATAセクションにマッピングすることによって、この問題を解決します。

属性のコピー

［属性のコピー］を使用して、属性をマップする方法を指定します。［属性のコピー］には次のオプションがあります。

ディープコピー

デフォルトの統合アクティビティの動作では、一度にすべてのブランチをマップします（ターゲットノードとそのすべての子）。この操作をディープコピーを呼びます。場合によっては、この動作をオフにして、子を除いた親要素だけをコピーすることもできます。ディープコピーを無効にするには、［従属要素のマップ］の選択を解除します。

ターゲットの作成

［ターゲットの作成］は、ソースノードがソースDOMにあるかどうかに基づいて、［マップ］アクションの［ターゲット］グループに指定した宛先ノードを作成する場合に使用します（「［マップ］アクションの追加」を参照）。デフォルトでは、ランタイムソースDOMにマッピングのソースXPathで指定したノードが含まれているかどうかにかかわりなく、統合アクティビティは常にターゲットを作成します。

たとえば、［マップ］アクションで、ソースXPathを次のように指定したとします。

$Input/Root/MySourceElement

ターゲットXPathで、次のように指定したとします。

$Output/Root/MyParentNode/SomeOtherElement

着信する入力ドキュメントにRoot/MySourceElementに対応するノードがない場合、統合アクティビティはデフォルトで空のRoot/MyParentNode/SomeOtherElementノードを出力DOMに作成します。場合によっては、これが希望する処理ではないこともあります。［ターゲットの作成］マッピングを使用することにより、デフォルト動作を変更できます。

ターゲットをCDATAセクションとして作成

［ターゲットをCＤＡＴＡセクションとして作成］は、要素データをCDATAセクションにマップする方法を制御するときに使用します。