AquaLogic Service Bus Console の使い方

XQuery トランスフォーメーション

この節の内容は以下のとおりです。

XQuery トランスフォーメーションの概要

トランスフォーメーションマップは、2 つのデータ型の間のマッピングを記述したものです。AquaLogic Service Bus は、XQuery または eXtensible Stylesheet Language Transformation (XSLT) 標準のどちらかを使用したデータマッピングに対応しています。XSLT マップは、XML から XML へのマッピングを記述するのに対して、XQuery マップでは、XML から XML、XML から非 XML、非 XML から XML へのマッピングを記述できます。

XQuery トランスフォーメーションは、BEA AquaLogic Service Bus に用意されている基本的な XML トランスフォーメーションツールです。XQuery トランスフォーメーション (.xq ファイル) の作成を支援するために、BEA XQuery Mapper ツールが用意されています。XQuery Mapper は、Eclipse 開発環境のプラグインです。したがって、XQuery Mapper を使用するには、Eclipse をインストールして起動する必要があります。

Eclipse と XQuery Mapper は、AquaLogic Platform のインストールに含まれます。ただし、AquaLogic Service Bus と共に XQuery Mapper を使用する場合は、XQuery Mapper を個別に呼び出す必要があります。詳細については、『XQuery Mapper を使用したデータの変換』の「XQuery を使用したデータの変換」にある「XQuery Mapper の起動」を参照してください。

XQuery トランスフォーメーションは、プロキシサービスのメッセージフローで XQuery 式を編集するときに使用することができます。[XQuery 式エディタ] ページで XQuery 式を編集するときに、[XQ トランスフォーメーション] オプションを選択すると、特定の XQuery トランスフォーメーションを実行できます。

プロキシサービスのメッセージフローでは、メッセージコンテキスト変数への XQuery 式の割り当て、XQuery 式のブール結果に基づく if then else アクションの割り当て、XPath 式に対して相対的に指定した位置への XQuery 式の結果の挿入、コンテキスト変数の XQuery 式を使用したログ用のメッセージコンテキストの指定などを実行できます。詳細については、「メッセージフローの概要」、「アクションの追加」、および「インライン XQuery 式エディタの使用」を参照してください。

以下の表は [リソースブラウザ] モジュールと [プロジェクトエクスプローラ] モジュールでアクセスできる XQuery トランスフォーメーションのページをまとめたものです。各ページに関連するタスクとヘルプトピックを確認できます。

ページ	関連タスク	ヘルプトピック
XQuery の概要	XQuery トランスフォーメーションのリストの表示。XQuery 名が表示される。	XQuery トランスフォーメーションの表示と検索
	XQuery トランスフォーメーションのリストのフィルタ	XQuery トランスフォーメーションの表示と検索
	XQuery トランスフォーメーションの削除	XQuery トランスフォーメーションの削除
新しい XQuery の作成	新しい XQuery トランスフォーメーションの追加	XQuery トランスフォーメーションの追加
XQuery トランスフォーメーションの詳細	XQuery トランスフォーメーションの詳細の表示	XQuery トランスフォーメーションの詳細の表示と変更
XQuery トランスフォーメーションの詳細	XQuery トランスフォーメーションの詳細の編集	XQuery トランスフォーメーションの詳細の表示と変更

XQuery トランスフォーメーションの表示と検索

[XQuery の概要] ページでは、XQuery トランスフォーメーションのリストを参照できます。XQuery トランスフォーメーションには 2 つのデータ型の間のマッピングが記述されます。詳細については、「XQuery トランスフォーメーションの概要」を参照してください。

XQuery トランスフォーメーションを表示および検索するには

左側のナビゲーションペインで、[リソースブラウザ] の下にある [XQuery] を選択します。[XQuery の概要] ページが表示され、XQuery トランスフォーメーションごとに以下の情報が表示されます。各プロパティの詳細については、「XQuery トランスフォーメーションの詳細の表示と変更」を参照してください。

プロパティ	説明
XQuery 名	この XQuery トランスフォーメーションに割り当てられた名前。この名前は XQuery トランスフォーメーションの詳細ページにリンクされている。詳細については、XQuery トランスフォーメーションの詳細の表示と変更」を参照。
パス	プロジェクト名、および XQuery トランスフォーメーションが格納されるフォルダの名前。このリソースを含むプロジェクトまたはフォルダにリンクされている。詳細については、「プロジェクトの詳細の表示」または「フォルダの詳細の表示」を参照。
アクション	[テストコンソールの起動] アイコンをクリックすると、テストコンソールが起動される。テストコンソールは、サービスおよびトランスフォーメーションの設計の検証とテストに使用する。XQuery トランスフォーメーションの場合、セッション内で作業しているかセッション外で作業しているかに関わらずテストコンソールを使用できる。詳細については、「トランスフォーメーションのテスト」を参照。
オプション	[削除] アイコンをクリックすると、指定した XQuery トランスフォーメーションが削除される。詳細については、「XQuery トランスフォーメーションの削除」を参照。

特定のトランスフォーメーションを検索するには、以下のいずれか 1 つを実行します。

トランスフォーメーション名でフィルタする。[名前] フィールドと [パス] フィールドに、検索対象の名前とパスを入力してから、[検索] をクリックします。このパスは、プロジェクト名、および XQuery トランスフォーメーションが格納されるフォルダの名前になります。検索条件に一致するトランスフォーメーションが表示されます。
リストを再ソートする。ソート可能なカラムには昇順および降順の矢印ボタンが表示されます (この場合は [XQuery 名] カラムと [パス] カラム)。このボタンをクリックしてソート順を変更します。
ページをスクロールする。右下隅のコントロールを使用します。ページを移動するには、ページ番号を選択するか、次のページ、前のページ、最初のページ、または最後のページに移動する矢印ボタンを使用します。

注意 : [すべて表示] をクリックすると、すべての XQuery トランスフォーメーションが表示されます。

XQuery トランスフォーメーションの詳細の表示と変更

XQuery トランスフォーメーションの詳細ページでは、個々の XQuery トランスフォーメーションの詳細を確認および変更できます。XQuery トランスフォーメーションには 2 つのデータ型の間のマッピングが記述されています。詳細については、「XQuery トランスフォーメーションの概要」を参照してください。

XQuery トランスフォーメーションの詳細を表示および変更するには

対象の XQuery トランスフォーメーションを検索します。詳細については、「XQuery トランスフォーメーションの表示と検索」を参照してください。

XQuery トランスフォーメーション名をクリックします。XQuery トランスフォーメーションの詳細ページに以下の情報が表示されます。

プロパティ	説明
リソース名	この XQuery トランスフォーメーションに割り当てられた名前。
作成者	この XQuery トランスフォーメーションを作成したか、コンフィグレーションにインポートしたユーザ。
作成日	ユーザがこの XQuery トランスフォーメーションを作成したか、コンフィグレーションにインポートした日時。
参照先	この XQuery トランスフォーメーションが参照するオブジェクトの数。該当する参照がある場合は、リンクをクリックするとオブジェクトのリストが表示される。詳細については、「参照の表示」を参照。
参照元	この XQuery トランスフォーメーションを参照するオブジェクトの数。該当する参照がある場合は、リンクをクリックするとオブジェクトのリストが表示される。たとえば、この XQuery トランスフォーメーションを特定のプロキシサービスのメッセージフロー内の変数に割り当てた場合に、このリンクをクリックすると、そのプロキシサービスが参照として表示される。詳細については、「参照の表示」を参照。
説明	この XQuery トランスフォーメーションの説明 (説明が存在する場合)。
XQuery	XQuery トランスフォーメーションのフルテキスト。
XQuery 変数	この XQuery トランスフォーメーションに対し選択されている XQuery 変数。

セッションの作成または編集をまだ行っていない場合は、左側のナビゲーションペインで、[Change Center] の下にある [作成] をクリックして新しいセッションを作成するか、[編集] をクリックして既存のセッションに入り、現在のコンフィグレーションを変更します。詳細については、「Change Center の使用」を参照してください。

[編集] をクリックして、フィールドを変更します。各フィールドの説明については、「XQuery トランスフォーメーションの追加」を参照してください。

注意 : [リソース名] フィールドは変更できません。

以下のいずれか 1 つを実行します。

[保存] をクリックして、XQuery トランスフォーメーションを更新する。XQuery トランスフォーメーションが更新されます。

[XQuery の概要] ページが表示されます。

[取り消し] をクリックして、変更を取り消す。

注意 : 更新された XQuery トランスフォーメーションは現在のセッションに保存されます。コンフィグレーションに対する変更が完了したら、左側のナビゲーションペインで、[Change Center] の下にある [アクティブ化] をクリックします。セッションが終了し、コンフィグレーションがランタイムにデプロイされます。または、セッション中の任意の時点で [破棄] をクリックして、現在のセッションでそれまでに行った変更内容を削除します。

XQuery トランスフォーメーション

XQuery トランスフォーメーションの概要

XQuery トランスフォーメーションの表示と検索

XQuery トランスフォーメーションを表示および検索するには

関連トピック

XQuery トランスフォーメーションの追加

新しい XQuery トランスフォーメーションを追加するには

関連トピック

XQuery トランスフォーメーションの詳細の表示と変更

XQuery トランスフォーメーションの詳細を表示および変更するには

関連トピック

XQuery トランスフォーメーションの削除

XQuery トランスフォーメーションを削除するには

関連トピック