15 Oracle Service Busコンソールでの式エディタの操作

この章では、パイプラインまたはメッセージ・フローでXQueryおよびXPath式を使用する方法について説明します。

パイプラインでは、メッセージ・コンテキスト変数へのXQuery式の割当て、XQuery式のブール結果に基づくif-thenアクションの割当て、XPath式に対して相対的に指定した位置へのXQuery式の結果の挿入、コンテキスト変数のXQuery式を使用したログ用のメッセージ・コンテキストの指定などを実行できます。

コンテキストで必要な式を作成するために、メッセージ・フローの該当するコンテキストで、「XQuery式エディタ」、「XQuery条件エディタ」、「XPath式エディタ」を使用できます。

この章の構成は、次のとおりです。

15.1 インラインXQueryおよびXPath式の作成と編集

「ステージ構成の編集」ページでステージまたはルート・ノードにアクションを追加する場合、構成の詳細を入力するページにスケルトン構造が表示されます。図15-1に例を示します。

図15-1 アクション構成スケルトンの例

「図15-1 アクション構成スケルトンの例」の説明

コンテキスト上適切である場合は、XQueryエディタへアクセスするためのリンクがスケルトンによって用意されます。アクションのコンテキスト上必要である場合、インラインで実行される式をこのエディタで作成できます。

始める前に:

次の説明では、パイプライン・ステージ、エラー・ハンドラ・ステージ、またはルート・ノードの「ステージ構成の編集」ページでアクションの作成または編集を行うものとします。「コンソールでのパイプラインの表示と編集」および「コンソールでのパイプライン・アクションの追加と編集」を参照してください。

インライン式を作成または変更するには:

「ステージ構成の編集」ページで、アクション内に式を追加または編集する場所を特定します。
「式」リンクをクリックして、コンテキストに適切なエディタを開きます。式がまだ定義されていない場合は、その位置において使用可能な式の種類がリンクに示されます。
- XQuery式を作成するには、「式」をクリックします。Service Bus以外で作成したXQueryまたはXSLTリソースをインポートしてインラインXQueryにバインドすることもできます。
- if-thenアクション用にXQuery条件式を作成するには、「条件」をクリックします。
- メッセージ・コンテキスト変数用のXPath式を作成するには、「XPath」をクリックします。
式がその位置に対してすでに定義されている場合、「式」、「条件」または「XPath」リンクは式自体を示すtrue()のようなリンクに置き換わります。式の長さが長すぎる場合は、$body/urn:POSta...のような式の一部になります。式(または式のフラグメント)をクリックして適切なエディタで式を開きます。
次のトピックの説明を参照して、式を構築します。
(オプション)次のいずれか、または両方を実行します。
- 式を検証するには、「検証」をクリックします。
- 式をテストするには、「テスト」をクリックします。「XQueryトランスフォーメーションのテストの前提条件とガイドライン」を参照してください。
「保存」をクリックしてエディタを閉じ、式をアクションに挿入します。

15.2 XQueryエディタのレイアウトとタスクについて

XQuery式エディタ、XQuery条件エディタ、およびXPath式エディタは、それぞれ次のコンポーネントから構成されています。

15.2.1 パレット

各エディタの左側のパネルには、次に示すパレットがあります。エディタでパレットの名前をクリックすると、そのパレットが表示されます。各パレットには、エディタ内で式に挿入できるエンティティが含まれています。

「ネームスペース定義」パレットには、Service Busのデフォルト・ネームスペース、変数のネームスペースおよびユーザー定義ネームスペースが表示されます。新しいネーム・スペースを定義することもできます。定義されたネーム・スペースはユーザー定義ネーム・スペースのリストに追加されます。

詳細な情報は、次を参照してください:
- エディタ・ワークスペースのテキスト・フィールドでの式の構築
- インライン式で使用するためのネームスペースの作成
「XQuery関数」パレットには、一連の標準XQuery関数が表示されます。式に関数を挿入するときには、入力する必要があるパラメータ値ついてプレースホルダーが使用されます。

詳細な情報は、次を参照してください:
「変数の構造」パレットには、XPath式を使用して、変数や変数のパスを挿入するためのツールが用意されています。

変数の構造は、エディタに表示される変数または変数のパスのグラフィカルな表現です。変数の構造が視覚化されることにより、変数の内容を参照するインラインXQuery式の構築が容易になります。

注意:
変数の構造では、変数は作成されません。変数は、ステージでの割当てアクションの対象として実行時に作成されます。

Service Busには事前定義されたメッセージ・コンテキスト変数(attachments、body、header、outboundおよびinbound)があり、その内容を変数の構造として表示できます。ユーザーが独自に変数の構造を定義することもできます。

詳細は、次を参照してください。
- エディタ・ワークスペースのテキスト・フィールドでの式の構築
- XQueryエディタによる変数の構造の作成

15.2.2 ワークスペース

ページの右側は、XQuery式、XQuery条件、またはXPathを作成するためのワークスペースになっています。ワークスペースはそれぞれのエディタによって異なります。

15.2.3 プロパティ・インスペクタ

プロパティ・インスペクタは、3種類のエディタのすべてで、ページの右下に表示されます。パレットの1つからアイテムを式に追加するために選択すると、選択したアイテムがプロパティ・インスペクタに表示されます。表示されたアイテムは、ワークスペースに貼り付けることができます。エディタ・ワークスペースのテキスト・フィールドでの式の構築を参照してください。

15.3 エディタ・ワークスペースのテキスト・フィールドでの式の構築

XQuery式エディタ、XQuery条件エディタ、およびXPath式エディタのすべてにテキスト・フィールドがあり、このフィールドに直接入力するか、または、パレットから貼り付けることで、式を構築できます。

始める前に:

この説明では、インラインXQueryおよびXPath式の作成と編集で説明したように、XQuery式エディタ、XQuery条件エディタまたはXPath式エディタで式を作成または編集しているものと仮定します。

テキスト・フィールドで式を構築するには

テキスト・フィールドを含むパネルを表示します。エディタに応じて、次のいずれかを実行します。
- まだ選択していない場合は、XQuery式エディタで、(ワークスペースのボタン・バーの下にある)「XQueryテキスト」を選択します。
- まだ選択していない場合は、XQuery条件エディタで、(ワークスペースのボタン・バーの下にある)「テキスト」を選択します。
- XPath式エディタでは、その他のツールを選択するオプションがないため、何も選択する必要はありません。
  
  注意:
  前述のいずれかのリンクを選択すると、コンテキストに応じた完全な式を作成できるテキスト・フィールドが表示されます。ただし、このトピックで説明されているツールと方法は、外部XQueryリソースのインラインXQueryへのバインドおよび外部XSLTリソースのインラインXQueryへのバインドで説明されているとおり、インポートされたリソースからインライン式への変数のバインドなどのように、エディタにテキスト・フィールドが表示されている場合はいつでも使用できます。
必要に応じて、式または式の一部を、フィールドに入力または貼り付けます。この方法で完全な式が作成できた場合は、ステップ7に進みます。使用していない場合は次の手順に進みます。

次の表15-1の説明に従って、式に追加する項目を含むパレットを選択し、追加する項目を特定します。

表15-1 パレット

パレット説明および使用方法

パレット	説明および使用方法
ネームスペース定義	デフォルトのService Busネームスペース、変数ネームスペースおよびユーザー定義のネームスペースを一覧表示します。定義されている場合は、ネームスペースの略語が一覧表示されます。リストをスクロールして、目的のネームスペースを見つけ出します。ネームスペースを定義することもできます。インライン式で使用するためのネームスペースの作成を参照してください。
XQuery関数	標準のXQuery関数と開発したカスタム関数がタイプ別にアルファベット順で含まれます。ツリー内のノードを展開するにはプラス記号(+)を、折りたたむにはマイナス記号(-)をクリックします。関連項目: XQueryでのデータの変換
変数の構造	変数とそれらのコンテンツがツリー形式で表示されるため、視覚的に確認できます。変数の構造とそのコンテンツを表示できます。パレットの上部にあるリストから構造の名前を選択します。リストには、組込みメッセージ・コンテキスト変数(`attachments`、`body`、`header`、`outbound`、`inbound`)と、型ごと(「XMLタイプ」、「サービス・インタフェース」、「単純な型」)に整理されたユーザー定義の構造が一覧表示されます。ツリー内のノードを展開するにはプラス記号(+)を、折りたたむにはマイナス記号(-)をクリックします。ユーザーが独自に変数の構造を定義することもできます。XQueryエディタによる変数の構造の作成を参照してください。変数の構造では、変数は作成されません。変数は、ステージでの割当てアクションの対象として実行時に作成されます。変数の構造のツリーから項目をテキスト・フィールドに挿入すると、パスを記述するXPath式として挿入されます。「XQueryでのデータ変換」も参照してください。

ネームスペース定義

デフォルトのService Busネームスペース、変数ネームスペースおよびユーザー定義のネームスペースを一覧表示します。定義されている場合は、ネームスペースの略語が一覧表示されます。

リストをスクロールして、目的のネームスペースを見つけ出します。

ネームスペースを定義することもできます。インライン式で使用するためのネームスペースの作成を参照してください。

XQuery関数

標準のXQuery関数と開発したカスタム関数がタイプ別にアルファベット順で含まれます。ツリー内のノードを展開するにはプラス記号(+)を、折りたたむにはマイナス記号(-)をクリックします。

パレット	手順
「ネームスペース定義」パレット	標準のマウスまたはキーボードでの、ネームスペースの選択、コピー、および貼付けを使用します。例: 文字列上でマウス・ポインタをドラッグして、ネームスペースの文字列全体(または、存在する場合は、その略語)を選択します。 [Ctrl]+[C]を押して、文字列をコピーします。テキスト・フィールドの、ネームスペースを挿入する場所をクリックします。 [Ctrl]+[V]を押して、文字列を貼り付けます。
「XQuery関数」パレットまたは「変数の構造」パレット	項目をパレットからテキスト・フィールドにドラッグします。注意: パレットからワークスペースへのドラッグは、Internet Explorerでのみサポートされています。
「XQuery関数」パレットまたは「変数の構造」パレット	パレットの項目をクリックします。「プロパティ・インスペクタ」ペインに項目が表示されます。関数は、提供する必要がある値のプレースホルダーと共に表示されます。変数とそれらの属性は、XPath式として表示されます。テキスト・フィールドの、項目を挿入する場所をクリックします。「プロパティのコピー」をクリックして、テキスト・フィールド内の選択した場所に項目を貼り付けます。
「XQuery関数」パレットまたは「変数の構造」パレット	パレットの項目をクリックします。「プロパティ・インスペクタ」ペインに項目が表示されます。標準のキーボードまたはマウスのアクションを使用して、プロパティ・インスペクタで項目を選択およびコピーします。標準のキーボードまたはマウスのアクションを使用して、テキスト・フィールド内の場所を選択して、項目をテキスト・フィールドに貼り付けます。

15.4 インライン式で使用するネームスペースの作成

「ネームスペース定義」パレットには、デフォルトのネームスペースのリストが含まれています。新しいネームスペースを定義することもできます。

始める前に:

ネームスペースを作成してインライン式で使用するには:

「ネームスペース定義」を選択します。「ネームスペース定義」パレットには、デフォルトのネームスペースのリストと、存在する場合は、変数ネームスペースおよびユーザー定義済のネームスペースのリストが含まれています。
ユーザーのネームスペースを定義および追加するには
1. 「ネームスペースの追加」をクリックします。
2. 「接頭辞」フィールドに、ネームスペースの一意の識別子を入力します。同じ接頭辞を複数回使用することはできません。
3. 「URI」フィールドに、このネームスペースのURLをhttp://url/.../の形式で入力するか、またはURNをuddi:server:の形式で入力します。
4. 「追加」をクリックして、「ユーザー定義済みネームスペース」にネームスペースを追加します。
5. インラインXQueryおよびXPath式の作成と編集の説明に従って、ユーザー定義済ネームスペースをコピーして、XQuery式、XQuery条件またはXPathに貼り付けます。

完了した後に:

インラインXQueryおよびXPath式の作成と編集の説明に従って、続行します。

15.5 XQueryエディタによる変数の構造の作成

XQueryエディタおよびXPathエディタの「変数の構造」パレットには、変数のコンテンツがグラフィカルに表示されます。これには、デフォルトで、組込みのメッセージ・コンテキスト変数attachments、body、header、outbound、およびinboundが含まれています。

変数の構造のマッピングでは、各エントリはラベルを持ち、変数または変数パスを1つまたは複数の構造にマップします。これらのマッピングのスコープは、ステージまたはルート・ノードです。

次に基づいて、独自の変数の構造を宣言することもできます。

次のようなXMLタイプ
- スキーマ要素
- WSDL要素
- スキーマ・タイプ
- WSDLタイプ
- MFL
サービス・インタフェース
単純な型(文字列または任意のXML)

この機能は、すべてのユーザー定義変数と$inbound、$outboundおよび$faultに対して直接使用できます。ただし、この機能を使用して$attachmentsのXML添付ファイル、$headerのヘッダーまたは$bodyのドキュメントとRPCパラメータに直接アクセスすることはできません。例外として、WSDLプロキシ・サービスによって受信されたリクエスト・メッセージの$bodyのドキュメントとパラメータには直接アクセスできます。

始める前に:

変数の構造を作成するには

「変数の構造」を選択します。
「変数の構造」パレットで「新しい構造の追加」をクリックします。
続けて、次の表15-3に示す作業のいずれかを行います。

表15-3 新しい変数の構造の作成

内容	次の手順を実行...
変数をXMLスキーマの型にマップする変数の構造の作成	まだ選択していない場合は、「変数の構造」パレットの上部にある「XMLタイプ」を選択します。「構造ラベル」フィールドに、作成する変数の表示名を入力します。この表示名を使用すると、実行時には影響を及ぼさず設計時に構造を認識できるように、構造に意味のある名前を付けることができます。「構造パス」フィールドに、実行時の変数の構造のパスを入力します。このパスは、`$`で始まる必要があります。「タイプ」フィールドで、該当するラジオ・ボタンを選択してから、「スキーマ・タイプ」を選択します。「参照」をクリックします。XMLスキーマ・ブラウザが表示されます。リストからXMLスキーマを選択し、定義ペインからXMLスキーマの型を選択して、「発行」をクリックします。「追加」をクリックして変数の構造を作成します。
変数をWSDLの型にマップする変数の構造の作成	まだ選択していない場合は、「変数の構造」パレットの上部にある「XMLタイプ」を選択します。「構造ラベル」フィールドに、作成する変数の表示名を入力します。この表示名を使用すると、実行時には影響を及ぼさず設計時に構造を認識できるように、構造に意味のある名前を付けることができます。「構造パス」フィールドに、実行時の変数の構造のパスを入力します。「タイプ」フィールドで、該当するラジオ・ボタンを選択してから、「WSDLタイプ」を選択します。「参照」をクリックします。WSDLブラウザが表示されます。WSDLファイルのリストからWSDLファイルを選択し、定義ペインからWSDLの型を選択して、「発行」をクリックします。「追加」をクリックして変数の構造を作成します。
変数をXMLスキーマ要素にマップする変数の構造の作成	まだ選択していない場合は、「変数の構造」パレットの上部にある「XMLタイプ」を選択します。「構造ラベル」フィールドに、作成する変数の表示名を入力します。この表示名を使用すると、実行時には影響を及ぼさず設計時に構造を認識できるように、構造に意味のある名前を付けることができます。「構造パス」フィールドに、実行時の変数の構造のパスを入力します。「タイプ」フィールドで、該当するラジオ・ボタンを選択してから、「スキーマ要素」を選択します。「参照」をクリックします。XMLスキーマ・ブラウザが表示されます。リストからXMLスキーマを選択し、定義ペインからXMLスキーマの型を選択して、「発行」をクリックします。「追加」をクリックして変数の構造を作成します。
変数をWSDL要素にマップする変数の構造の作成	まだ選択していない場合は、「変数の構造」パレットの上部にある「XMLタイプ」を選択します。「構造ラベル」フィールドに、作成する変数の表示名を入力します。この表示名を使用すると、実行時には影響を及ぼさず設計時に構造を認識できるように、構造に意味のある名前を付けることができます。「構造パス」フィールドに、実行時の変数の構造のパスを入力します。「タイプ」フィールドで、該当するラジオ・ボタンを選択してから、「WSDL要素」を選択します。「参照」をクリックします。WSDLブラウザが表示されます。WSDLファイルのリストからWSDLファイルを選択し、定義ペインからWSDL要素を選択して、「発行」をクリックします。「追加」をクリックして変数の構造を作成します。
変数を子要素にマップする変数の構造の作成	まだ選択していない場合は、「変数の構造」パレットの上部にある「XMLタイプ」を選択します。「構造ラベル」フィールドに、作成する変数の表示名を入力します。この表示名を使用すると、実行時には影響を及ぼさず設計時に構造を認識できるように、構造に意味のある名前を付けることができます。「構造パス」フィールドに、実行時の変数の構造のパスを入力します。「タイプ」フィールドで、作成する変数の型を選択します。 XMLスキーマ要素またはWSDL要素の変数を作成するには、このオプションに関連付けられているラジオ・ボタンを選択し、「スキーマ要素」または「WSDL要素」を選択します。 MFL変数を作成するには、このオプションに関連付けられているラジオ・ボタンを選択し、「MFL」を選択します。 XMLスキーマ、WSDLファイルまたはMFLファイルについては、「参照」をクリックし、ブラウザに表示されるリストからオブジェクトを選択して、「発行」をクリックします。たとえば、MFLのリストでMFLを選択し、「発行」をクリックします。作成する構造の子として要素を設定するために、「子として設定」チェックボックスを選択します。「追加」をクリックして変数の構造を作成します。
MFLリソースを使用する変数の構造の作成	まだ選択していない場合は、「変数の構造」パレットの上部にある「XMLタイプ」を選択します。「構造ラベル」フィールドに、作成する変数の表示名を入力します。この表示名を使用すると、実行時には影響を及ぼさず設計時に構造を認識できるように、構造に意味のある名前を付けることができます。「構造パス」フィールドに、実行時の変数の構造のパスを入力します。「タイプ」フィールドで、該当するラジオ・ボタンを選択してから、「参照」を選択します。MFLブラウザが表示されます。 MFLのリストからMFLを選択し、「発行」をクリックします。「追加」をクリックして変数の構造を作成します。
サービス・インタフェース変数の構造の作成	「変数の構造」パレットの上部で、「サービス・インタフェース」を選択します。「構造ラベル」フィールドに、作成する変数の表示名を入力します。この表示名を使用すると、実行時には影響を及ぼさず設計時に構造を認識できるように、構造に意味のある名前を付けることができます。「構造パス」フィールドには、デフォルトの$bodyがすでに設定されています。このフィールドは変更できません。 WSDLベースのサービス・フィールドで「サービス・ブラウザ」アイコンを選択し、サービス・ブラウザに表示されるサービスのリストでサービスを選択して、「発行」をクリックします。選択したサービスは、「WSDLベースのサービス」フィールドに表示されます。「操作」フィールドで、操作を選択するか、または操作を含めない場合は「なし」を選択します。「追加」をクリックして変数を作成します。
単純な変数の構造の作成	「変数の構造」パレットの上部で、「単純な型」を選択します。「構造ラベル」フィールドに、作成する変数の表示名を入力します。この表示名を使用すると、実行時には影響を及ぼさず設計時に構造を認識できるように、構造に意味のある名前を付けることができます。「構造名」フィールドに、作成する変数の構造の名前を入力します。「タイプ」フィールドで、「文字列」または「任意のXML」を選択します。「追加」をクリックして変数を作成します。

完了した後に:

インラインXQueryおよびXPath式の作成と編集の説明に従って、続行します。

15.6 XQueryエディタでのカスタムXPath関数の作成

カスタムXQuery関数の作成は、Javaコードの記述が必要な開発プロセスです。詳細は、「カスタムXPath関数の作成」を参照してください。

15.7 外部XQueryリソースのインラインXQueryへのバインディング

XQueryリソースをインラインXQuery式にバインドして、アクションの一部としてインラインで実行できます。

始める前に:

この説明では、インラインXQueryおよびXPath式の作成と編集で説明したように、XQuery/XSLT式エディタ、XQuery条件エディタまたはXPath式エディタで式を作成または編集しているものと仮定します。

XQueryリソースをインライン式にバインドするには

「変数の構造」をクリックします。
ワークスペース(ボタン・バーの下)で、「XQueryリソース」を選択します。
「1.実行するXQueryリソースを選択します」ボックスで「参照」をクリックします。
XQueryブラウザで、使用するXQueryに関連付けられているラジオ・ボタンを選択し、「発行」をクリックします。
「2.変数のバインド」ボックスで、トランスフォーメーション用の入力パラメータを定義します。「変数名」の下にリストされている各変数に対して、これにマッピングされるXQuery式を入力します。マッピングはパラメータごとに定義する必要があります。たとえば、XQueryトランスフォーメーションにoneおよびtwoという入力パラメータがある場合、「変数名」フィールドには、「one」および「two」という2つのラベルが表示されます。各ラベルに、XQuery式が入力されるテキスト・ボックスが1つ表示されます。
次のXQuery式は、このフィールドの有効な入力例です。
```
$body/*[1]
$body/po:PurchaseOrder
```
注意:
bodyという変数名はこのフィールドでは無効な入力となり、例外が発生します。
完了した後は、次のいずれかの操作に進みます。
- 「検証」をクリックします。式の検証が成功した場合は、メッセージが表示されます。
- 「テスト」をクリックします。「XQueryトランスフォーメーションのテストの前提条件とガイドライン」を参照してください。
- 変更を保存するか、または破棄します。

15.8 外部XSLTリソースのインラインXQueryへのバインディング

「XQuery/XSLT式エディタ」ページでは、実行用XSLTリソースを選択できます。このエディタの詳細は、インラインXQueryおよびXPath式の作成と編集を参照してください。

実行用XSLTリソースを選択するには

「XSLTリソース」オプションを選択します。
「実行するXSLTリソースを選択します」フィールドで、「XSLT参照」アイコンをクリックします。
XSLTブラウザで、実行するXSLTに関連付けられているラジオ・ボタンを選択し、「発行」をクリックします。
「変数のバインド」フィールドの下に、ラベルとそれに対応するテキスト・ボックスがトランスフォーメーションの入力パラメータごとに表示されます。各ラベルはパラメータ名に相当し、各テキスト・ボックスはそのパラメータにマッピングされるXQuery式を定義するためのものです。マッピングはパラメータごとに定義する必要があります。たとえば、XSLトランスフォーメーションにoneおよびtwoという入力パラメータがある場合、「変数マッピング」フィールドには、「one」および「two」というラベルと、ラベルごとにXQuery式を入力するテキスト・ボックスが表示されます。入力変数のマッピングの他に、トランスフォーメーションの入力ドキュメントのXQuery式を指定する必要もあります。このマッピングは、「入力ドキュメント」というラベルが付いたテキスト・ボックスで指定します。
次のXQuery式は、このフィールドの有効な入力例です。
```
$body/*[1]
$body/po:PurchaseOrder
```
注意:
bodyという変数名はこのフィールドでは無効な入力となり、例外が発生します。
次の任意の作業を続行します。
- インライン式で使用するためのネームスペースの作成
- XQueryエディタによる変数の構造の作成
- エディタ・ワークスペースのテキスト・フィールドでの式の構築
- 外部XQueryリソースのインラインXQueryへのバインド
- 「検証」をクリックします。式の検証が成功した場合は、メッセージが表示されます。
- 「テスト」をクリックします。「XQueryトランスフォーメーションのテストの前提条件とガイドライン」を参照してください。

15.9 動的XQuery式のインラインXQueryへのバインディング

「XQuery/XSLT式エディタ」ページでは、あらかじめ登録したXQueryリソースの名前を実行時に評価する動的XQuery式を指定できます。このエディタの詳細は、インラインXQueryおよびXPath式の作成と編集を参照してください。

動的XQuery式を定義するには

「動的XQuery」オプションを選択します。
「XQueryリソースの式の入力」領域で、実行時に事前登録されたXQueryリソース名を評価するXQuery式を入力します。
XQueryリソース(リソースの完全な名前を表す)の構文は次のとおりです。

Project/folder1/folder2/XQueryResourceName
「XQueryテンプレートまたはカスタム変数を使用して変数をバインドします」領域に、トランスフォーメーションの入力パラメータを定義します。
- 「XQueryテンプレートの選択」フィールドの「参照」をクリックして、問合せ形式(変数の数と名前)のテンプレートとして使用する既存の登録済のリソースを選択します。テンプレートを選択すると、「変数のバインド」領域に変数が表示されます。テンプレートは構成で保持されることはありません。かわりに、テンプレートは、問合せに変数を指定するのに役立つクイック・スタートとして機能します。
- 「カスタム変数の追加」フィールドに変数名を入力し、「追加」をクリックします。「変数名」の下にリストされている各変数に対して、これにマッピングされるXQuery式を入力します。マッピングはパラメータごとに定義する必要があります。たとえば、XQueryトランスフォーメーションにoneおよびtwoという入力パラメータがある場合、「変数名」フィールドには、「one」および「two」という2つのラベルが表示されます。各ラベルに、XQuery式が入力されるテキスト・ボックスが1つ表示されます。
次のXQuery式は、変数フィールドの有効な入力例です。
```
$body/*[1]
$body/po:PurchaseOrder
```
完了した後は、次のいずれかの操作に進みます。
- 「検証」をクリックします。式の検証が成功した場合は、メッセージが表示されます。
- 「テスト」をクリックします。「XQueryトランスフォーメーションのテストの前提条件とガイドライン」を参照してください。
- 変更を保存するか、または破棄します。

15.10 動的XSLT式のインラインXQueryへのバインディング

「XQuery/XSLT式エディタ」ページでは、あらかじめ登録したXSLTリソースの名前を実行時に評価する動的XPath/XQuery式を指定できます。このエディタの詳細は、インラインXQueryおよびXPath式の作成と編集を参照してください。

動的XSLT式を定義するには

「動的XSLT」オプションを選択します。
「XSLTリソースの式を入力」領域で、実行時にあらかじめ登録したXSLTリソースの名前に評価するXPath/XQuery式を入力します。例: $body/*:name/text()
XSLTリソース(リソースの完全な名前を表す)の構文は次のとおりです。

Project/folder1/folder2/myXSLResourceName
「入力のバインド」領域で、XML入力ドキュメントを選択するインラインXQuery/XPath式を入力します。例: $body/message。
「XSLTテンプレートまたはカスタム変数を使用して変数をバインド」領域に、トランスフォーメーションの入力パラメータを定義します。
- 「XSLTテンプレートの選択」フィールドの「参照」をクリックして、問合せ形式(変数の数と名前)のテンプレートとして使用する既存の登録済XSLTリソースを選択します。テンプレートを選択すると、「変数のバインド」領域に変数が表示されます。テンプレートは構成で保持されることはありません。かわりに、テンプレートは、問合せに変数を指定するのに役立つクイック・スタートとして機能します。
- 手動で変数を追加するには、「カスタム変数の追加」フィールドで変数名を入力し、「追加」をクリックします。
- 「変数名」の下にリストされた各変数に、マップされるXQuery/XPath式を入力します。マッピングはパラメータごとに定義する必要があります。たとえば、XQueryトランスフォーメーションにoneおよびtwoという入力パラメータがある場合、「変数名」フィールドには、「one」および「two」という2つのラベルが表示されます。各ラベルに、XQuery式が入力されるテキスト・ボックスが1つ表示されます。
次のXQuery式は、変数フィールドの有効な入力例です。
```
$body/*[1]
$body/po:PurchaseOrder
```
完了した後は、次のいずれかの操作に進みます。
- 「検証」をクリックします。式の検証が成功した場合は、メッセージが表示されます。
- 「テスト」をクリックします。「XQueryトランスフォーメーションのテストの前提条件とガイドライン」を参照してください。
- 変更を保存するか、または破棄します。

15.11 「ビルダー」オプションを使用したXQuery比較式の入力

始める前に:

次の手順は、インラインXQueryおよびXPath式の作成と編集の説明に従って、XQuery条件エディタでXQuery条件式を作成または編集していることを前提としています。

XQuery比較式を入力するには

まだ選択していない場合は、XQuery条件エディタで、(ワークスペースのボタン・バーの下にある)「ビルダー」を選択します。
まだ選択していない場合は、「式ビルダー」ボックスで、「比較式」を選択します。
「オペランド」フィールドに、コンテキスト変数、ネームスペース定義、またはXQuery関数を入力します。
オペランドを構築する場合、「XQuery関数」パレットからXQuery関数を、「ネームスペース定義」パレットからネームスペースを貼り付けることができます。エディタ・ワークスペースのテキスト・フィールドでの式の構築を参照してください。
「演算子」リストから、比較演算子を選択します。
「値」フィールドに、テキストまたはコンテキスト変数を入力します。
テキストは引用符で囲む必要があります。たとえば、"true"は有効ですが、trueは無効です。
「追加」をクリックします。入力したテキストが「式」ペインに表示されます。
追加の条件を構築する際は、ステップ3 - 6を繰り返します。各条件は、条件リストの最後に追加されます。
複数の条件を使用する場合は、次の点を考慮してください。
- 追加の式を作成する場合は、「組合せ」フィールドで必ず「AND」または「OR」オプションを選択してください。
- 条件を選択し、上矢印および下矢印をクリックして、条件のリスト内を上下に移動できます。「編集」アイコンをクリックして条件を更新したり、「削除」アイコンをクリックして条件を削除したりすることもできます。
- 条件の全体定義では、単項式と比較式を混ぜることもできます。
(オプション)次のいずれか、または両方を実行します。
- 「検証」をクリックします。式の検証が成功した場合は、メッセージが表示されます。
- 式をテストするには、「テスト」をクリックします。「XQueryトランスフォーメーションのテストの前提条件とガイドライン」を参照してください。
「保存」をクリックしてエディタを閉じ、式をアクションに挿入します。

完了した後に:

「コンソールでのパイプライン・アクションの追加と編集」の説明に従って、アクションの構成を続行します。

15.12 「ビルダー」オプションを使用した単項式の入力

始める前に:

XQuery比較式を入力するには

まだ選択していない場合は、XQuery条件エディタで、(ワークスペースのボタン・バーの下にある)「ビルダー」を選択します。
まだ選択していない場合は、「式ビルダー」ボックスで、「単項式」を選択します。
「NOT」チェックボックスを選択してこの式を否定の式にするか、または空白のままにします。
「式」フィールドに、コンテキスト変数、ネームスペースの定義、またはXQuery関数を入力します。
式を構築する場合、「XQuery関数」パレットからXQuery関数を、「ネームスペース定義」パレットからネームスペースを貼り付けることができます。エディタ・ワークスペースのテキスト・フィールドでの式の構築を参照してください。
「追加」をクリックして、「式」ペインにテキストを追加します。
追加の条件を構築する際は、ステップ3 - 5を繰り返します。各条件は、条件リストの最後に追加されます。
単項式を構築する際は、次の点を考慮してください。
- 追加の式を作成する場合は、「組合せ」フィールドで必ず「AND」または「OR」オプションを選択してください。
- 条件を選択し、上矢印および下矢印をクリックして、条件のリスト内を上下に移動できます。「編集」アイコンをクリックして条件を更新したり、「削除」アイコンをクリックして条件を削除したりすることもできます。
- 条件の全体定義では、単項式と比較式を混ぜることもできます。
(オプション)次のいずれか、または両方を実行します。
- 「検証」をクリックします。式の検証が成功した場合は、メッセージが表示されます。
- 式をテストするには、「テスト」をクリックします。「XQueryトランスフォーメーションのテストの前提条件とガイドライン」を参照してください。
「保存」をクリックしてエディタを閉じ、式をアクションに挿入します。