XQuery Mapper を使用したデータの変換

例 : XQuery Mapper を使用したデータ トランスフォーメーション

ここで説明している例は、プロジェクトに含まれているサンプル プロジェクトに基づいています。サンプル プロジェクトを開くための詳細については、「XQuery Mapper サンプル プロジェクトの作成」を参照してください。

以下のシナリオの例が用意されています。

異なるスキーマからのデータの結合

XQuery Mapper を使用して、次の図のように、2 つの異なるスキーマのコンテンツを結合できます。

この例では、(CustInfo.xsd で有効な) 顧客データが (PO.xsd で有効な) 反復する要素 line-items と結合されて、POCustInfo.xsd スキーマに対して有効な単一の XML ドキュメントになります。

XQuery トランスフォーメーションのテストについては、「データ トランスフォーメーションのテスト」を参照してください。

反復する要素のマップと結合の作成

異なるスキーマ (この例では、PriceQuote.xsd、AvailableQuote.xsd、および taxrate.xsd) に対して有効な XML ファイルのデータを結合し、単一のスキーマ Quote.xsd に対して有効なファイルを作成します。

この例では、以下の手順を示します。

手順 1. XQuery ファイルの作成

この手順では、AvailQuote.xsd、PriceQuote.xsd、および taxrate.xsd スキーマを使用して、XQuery トランスフォーメーションを作成します。その後、複数の priceQuote および availRequest ソース要素を対応するターゲット要素にマップします。

手順 2. 制約の追加

priceQuote/priceRequests および availRequest ソース要素は、共通の要素 widgetId を共有しています。 この手順では、availRequest スキーマの widgetId が priceQuote/priceRequests 要素の widgetId と等しい場合に、クエリがターゲット反復要素 quoteResponse を返す必要のある制限を追加します。

現在、quoteResponse 要素は空です。次の手順で要素のコンテンツを追加します。

手順 3. 要素を返すデータの追加

この手順では、quoteResponse ターゲット要素にデータ リンクを追加します。

デザイン ビューで Join.xq を開き、以下のソース要素とターゲット要素の間のリンクを作成します。

ソース要素とターゲット要素の間のリンクが、次の図のように示されます。

手順 4. 見積もり値を計算する関数の追加

この手順では、見積もりの合計値を計算する関数を追加します。

手順 5. 複数の条件を持つ制約の追加

[制限] ビューの [Where 句] ペインを使用して制約を作成すると、XQuery で返されるターゲット反復要素を制限できます。 実行時には、where 句の条件を満たす反復要素のみが XQuery の for ループで反復処理されます。

この手順では、for ループの where 句に別の条件を追加して (つまり、複合条件となる)、for ループで返されるデータをさらに制限します。

XQuery のテスト

以下の手順を実行して、where 句の条件が両方とも満たされた場合に XQuery が動作することを確認します。

和集合の作成

この例では、[制約] ビューの [和集合] オプションを使用して、同じ型のデータを大きなデータ セットにマップする XQuery を作成します。

XQuery トランスフォーメーションのテストについては、「データ トランスフォーメーションのテスト」を参照してください。

反復ソースと非反復ターゲットの間のトランスフォーメーションの作成

この例では、反復するソース XML 要素を、反復しないターゲット XML 要素にマップします。

次の図に、この例で作成したトランスフォーメーションを示します。

XQuery ファイルのテストについては、「データ トランスフォーメーションのテスト」を参照してください。

非反復ソースと反復ターゲットの間のトランスフォーメーションの作成

この例では、反復しないソース要素を、反復するターゲット要素にマップします。

次の図に、この例で作成したトランスフォーメーションを示します。

XQuery ファイルのテストについては、「データ トランスフォーメーションのテスト」を参照してください。

ネストされた If-Then-Else 式の作成

この例では、ウィジェット ID と州税率に基づいて価格を計算する XQuery トランスフォーメーションを作成します。 以下のロジックを表す if-then-else 式を作成します。

この例では、以下の手順を示します。

手順 1. XQuery トランスフォーメーションの作成

この手順では、PurchaseAgree.xsd および Supplier.xsd スキーマを使用して XQuery トランスフォーメーションを作成します。

手順 2. 最初の "If" 条件の作成

この手順では、ウィジェット ID が 0 - 200 の場合に価格を $10.00 に指定する If 式を作成します。

手順 3. 最初のネストされた If-Then-Else 条件の作成

この手順では、ウィジェット ID が 201 - 400 の場合に価格を $20.00 にするネストされた If 式を作成します。このためには、前の手順で作成した Else 式の内部にネストされた if-then-else 式を挿入します。

手順 4. 2 つ目のネストされた If-Then-Else 条件の作成

この手順では、ウィジェット ID が 401 - 600 の場合に価格を $30.00 にするネストされた If 式を作成します。このためには、前の手順で作成した Else 式の内部にネストされた if-then-else 式を挿入します。

XQuery ファイルのテストについては、「データ トランスフォーメーションのテスト」を参照してください。

FLWOR 式の作成

この例では、For-Let-Where-Order By-Return 式を使用して、合計値が 2000 を超えるアイテムについて、見積もりからウィジェット ID を抽出します。

[式の構造] ペインで [For...Return] を選択すると、FLWOR 式のソース コードを表示できます。以下のコード リストに示すようなコードが作成されます。

for $quote in ($quote1/quoteResponse)

let $widget := ($quote/widgetId)

where $quote/totalCost > 2000

order by $widget ascending

return

	$quote

XQuery トランスフォーメーションのテストについては、「データ トランスフォーメーションのテスト」を参照してください。

再帰的なスキーマの使用

この例では、再帰的な要素を含むスキーマを使用してデータ トランスフォーメーションを作成します。

スキーマの要素は、コード リスト 3-8 の例に示すように、親と同じタイプの子要素を含んでいる場合に再帰的と見なされます。この例では、product 要素が再帰的な要素です。これは、この要素のタイプが productType であり、productType にはタイプが同じ productType である child-product 要素が含まれているためです (productType は自身を参照)。

<?xml version="1.0"?>

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
   targetNamespace="http://www.acme.org/Product"
   xmlns="http://www.acme.org/Product" elementformDefault="qualified"
   attributeFormDefault="unqualified">

   <xs:complexType name="productType">

      <xs:sequence>

         <xs:element name="part-description" minOccurs="0"
            maxOccurs="unbounded" type="xs:string" />

         <xs:element name="child-product" minOccurs="0"
            maxOccurs="unbounded" type="producttype" />

      </xs:sequence>

   </xs:complexType>

   <xs:element name="product" type="productType">

   </xs:element>

</xs:schema>

再帰的なスキーマを使用してトランスフォーメーションを作成するには、以下の手順を実行します。

次の図に、ソース要素と再帰的な child-product ターゲット要素の間のリンクを示します。

XQuery ファイルのテストについては、「データ トランスフォーメーションのテスト」を参照してください。

キー フィールドによるデータのグループ

[キー フィールドによるグループ] 機能を使用して、1 つまたは複数のキー値に基づいてデータをグループ化できます。

この例では、入力 XML ドキュメントとして以下のコード リストを使用します。

<input-warehouse-inventory xmlns="http://www.creditpo.org/repkeyin">

<input-line-item>

   <input-warehouse-id>Warehouse1</input-warehouse-id>

   <input-location-desc>Location1</input-location-desc>

   <input-part-no>1</input-part-no>

   <input-quantity>10</input-quantity> 

</input-line-item>

<input-line-item>

   <input-warehouse-id>Warehouse2</input-warehouse-id>

   <input-location-desc>Location2</input-location-desc>

   <input-part-no>2</input-part-no>

   <input-quantity>20</input-quantity>

</input-line-item>

<input-line-item>

   <input-warehouse-id>Warehouse1</input-warehouse-id>

   <input-location-desc>Location1</input-location-desc>

   <input-part-no>3</input-part-no>

   <input-quantity>30</input-quantity>

</input-line-item>

</input-warehouse-inventory>

この例では、input-warehouse-id 要素と input-location-desc 要素をキー フィールドとして使用して、出力ドキュメントのデータをグループ化します。

反復する要素 input-line-item の最初のインスタンスと 3 つ目のインスタンスには、input-warehouse-id 要素と input-location-desc 要素の同じ値 (それぞれ Warehouse1 と Location1) が含まれます。

この例では、コード リスト 3-10 に示すように、出力ドキュメントの Warehouse1 キーと Location1 キーを使用して、ライン アイテムの最初のインスタンスと 3 つ目のインスタンスをグループ化する XQuery を作成します。

<ns0:output-inventory xmlns:ns0="http://www.creditpo.org/repkeyout";>

   <ns0:output-warehouse-inventory>

      <ns0:output-warehouse-id>Warehouse1</ns0:output-warehouse-id>

      <ns0:output-location-desc>Location1</ns0:output-location-desc>

      <ns0:output-line-item>

         <ns0:output-part-no>1</ns0:output-part-no>

         <ns0:output-quantity>10</ns0:output-quantity>

      </ns0:output-line-item>

      <ns0:output-line-item>

         <ns0:output-part-no>3</ns0:output-part-no>

         <ns0:output-quantity>30</ns0:output-quantity>

      </ns0:output-line-item>

   </ns0:output-warehouse-inventory>

   <ns0:output-warehouse-inventory>

      <ns0:output-warehouse-id>Warehouse2</ns0:output-warehouse-id>

      <ns0:output-location-desc>Location2</ns0:output-location-desc>

         <ns0:output-line-item>

            <ns0:output-part-no>2</ns0:output-part-no>

            <ns0:output-quantity>20</ns0:output-quantity>

         </ns0:output-line-item>

   </ns0:output-warehouse-inventory>

</ns0:output-inventory>

Group-By 式を作成するには、以下の手順を実行します。