| Oracle® Fusion Middleware Oracle SOA Suite開発者ガイド 11g リリース1 (11.1.1.4.0) B56238-03 |
|
 前 |
 次 |
この章ではXSLTマッパーの使用方法を説明します。XSLTマッパーを使用すると、Oracle BPEL Process ManagerまたはOracle Mediatorでソース・スキーマ要素とターゲット・スキーマ要素の間のデータ・トランスフォーメーションを作成できます。バージョン1.0のXSLTがサポートされています。
項目は次のとおりです。
Oracle BPEL Process ManagerからXSLTマッパーを起動する方法は、第38.2.1項「Oracle BPEL Process ManagerでXSLマップ・ファイルを作成する方法」を参照してください。Oracle MediatorからXSLTマッパーを起動する方法は、第38.2.3項「Oracle MediatorでXSLマップ・ファイルを作成する方法」を参照してください。
マップ・ファイルの内容は、XSLTマッパーを使用して作成します。図38-1に、XSLTマッパーのレイアウトを示します。
「ソース」および「ターゲット」スキーマはツリーとして表され、ツリー内のノードは様々なアイコンを使用して表されます。表示されているアイコンは、スキーマまたはノードのプロパティを示します。例:
XSD属性は、XSD要素とは異なるアイコンで表されます。
オプション要素は、必須要素とは異なるアイコンで表されます。
繰返し要素は、非繰返し要素とは異なるアイコンで表されます。
要素または属性を選択すると、要素および属性の様々なプロパティ(タイプ、カーディナリティなど)が、XSLTマッパーの右下にある「プロパティ・インスペクタ」に表示されます。図38-1の右上にある「コンポーネント・パレット」には、XSLTマッパーで提供されるすべての関数が表示されます。XSLTマッパーは、関数をドロップして、ソース・ノードおよびターゲット・ノードに接続するための実際の描画領域です。
XSLTマップを最初に作成したとき、ターゲット・ツリーにターゲットXSDの要素と属性構造が示されます。XSLTマップは、XSLTコンストラクトとXPath式をターゲット・ツリーの適切な位置に挿入して作成します。実行すると、XSLTマップは適切な要素と属性をターゲットXSDに生成します。
設計ビューまたはソース・ビューで編集できます。マップを最初に作成したときには、設計ビューが開きます。設計ビューはグラフィカルに表示され、マップの編集が可能です。作成したXSLTのテキスト表現を確認するには、ソース・ビューに切り替えます。ビューを切り替えるには、XSLTマッパーの下部にある「ソース」または「設計」タブをクリックします。
設計ビュー使用時は、「コンポーネント・パレット」の次のページを使用できます。
一般: 一般的に使用されるXPath関数とXSLTコンストラクトです。
拡張: データベース、相互参照関数などのより高度なXPath関数です。
ユーザー定義: ユーザー定義関数とテンプレートです。このページが表示されるのは、ユーザーのXSLにテンプレートがある場合か、ユーザー定義の外部関数がプリファレンス・ページを使用して定義されている場合のみです。
すべてのページ: すべての関数を1ページで表示します。
コンポーネント: よく使用する関数や最近使用した関数があります。関数をよく使用する関数に追加するには、「コンポーネント・パレット」で関数を右クリックし、「お気に入りに追加」を選択します。
|
注意: XSLTマッパーでは、次の関数はOracle Mediatorでのみ使用できます。Oracle BPEL Process Managerでは使用できません。
Oracle BPEL Process Managerの場合は、これらの関数をassignアクティビティで使用できます。 |
ソース・ビュー使用時は、「XML」と「http://www.w3.org/1999/XSL/Transform」ページを使用できます。
XSLTマッパーには、次に示す3つの個別のコンテキスト依存メニューがあります。
ソース・パネル
ターゲット・パネル
中央パネル
3つの個別パネルでそれぞれ右クリックすると、各コンテキスト・メニューを確認できます。
デフォルトでは、設計ビューにはソースおよびターゲット・ツリーの全ノードに対する定義済の接頭辞がすべて表示されます。設計ビューの中央のパネルにあるコンテキスト・メニューから「接頭辞の非表示」を選択すると、接頭辞の非表示を選択できます。接頭辞が非表示のときに「接頭辞の表示」を選択すると再度表示されます。
マップの設計ビューの表示が、ソース・ビュー内で生成されたXSLTとどのように関連するかを理解することが重要です。この項では、簡単な例を紹介します。
初期マップを作成すると、図38-2に示すように、XSLTマッパーによってソース・スキーマとターゲット・スキーマがグラフィカルに表示されます。
この時点では、マップされたターゲット・フィールドはありません。ソース・ビューに切り替えると、空のXSLTマップが表示されます。XSLT文を設計ビューでグラフィカルに作成すると、XSLTテキストが生成されます。設計ビューでのマッピング操作の例を図38-3に示します。
設計ビューにより、ソース・ビューに次のXSLT文が生成されます。
ソース・ツリーの「OrderDate」属性は、図38-3中のターゲット・ツリーの「InvoiceDate」属性に線でリンクしています。この結果、例38-1に示すように、XSLT形式のvalue-of文が生成されます。
図38-3に示すソース・ツリーの「First」と「Last」の名前フィールドは、XPathのconcat関数によって連結されます。この結果は、ターゲット・ツリーの「Name」フィールドにリンクされます。これによって、例38-2に示すXSLT文が生成されます。
図38-3に示すターゲット・ツリーに挿入されたXSLT for-eachコンストラクトに注意してください。ソース・ツリーのHighPriorityItems/Item要素ごとにShippedItems/Item要素がターゲット・ツリーに作成され、ProductNameとQuantityがそれぞれにコピーされています。例38-3に示すXSLT構文が生成されます。
例38-3 for-eachコンストラクト
<xsl:for-each
select="/ns0:PurchaseOrder/Items/HighPriorityItems/Item">
<Item>
<ProductName>
<xsl:value-of select="ProductName"/>
</ProductName>
<Quantity>
<xsl:value-of select="Quantity"/>
</Quantity>
</Item>
</xsl:for-each>
図38-3に示したソース・ツリーの「Item」とターゲット・ツリーの「for-each」コンストラクトをリンクする線が、for-each選択属性に使用されるXPath式を決定します。一般的に、XSLTコントラクトには、主にソース・ツリー要素を参照するXPath文により移入された選択属性またはテスト属性があります。
for-eachコンストラクトの下のvalue-of文のXPath式は、for-eachに参照されるXPathに関連があることに注意してください。通常、XSLTマッパーは、for-each文の中に相対パスを作成します。
for-eachコンストラクトの中に絶対パスを作成する必要がある場合は、ソース・ビュー内で行う必要があります。設計ビューに戻ったときに、パスが絶対パスであり、XSLTマッパーで変更されないことに注意します。
|
注意: 例38-3で、ProductNameおよびQuantityのフィールドは、ソースとターゲットの両方で必要なフィールドです。これらのフィールドがソースおよびターゲットでオプションである場合は、これらのマッピングの前後に、ソース・ノードの存在をテストするxsl:if文を挿入することをお薦めします。この文を挿入しないと、入力ドキュメントにソース・ノードが存在しない場合は、ターゲット・ドキュメントに空のノードが作成されます。たとえば、ProductNameがソースとターゲットの両方でオプションの場合は、これらを次のようにマップします。
<xsl:if test="ProductName">
<ProductName>
<xsl:value-of select="ProductName"/>
</ProductName>
</xsl:if>
|
この例で生成されたXSLTマップ全体を例38-4に示します。
例38-4 XSLTマップ全体
<xsl:template match="/">
<tns1:Invoice>
<xsl:attribute name="InvoiceDate">
<xsl:value-of select="/ns0:PurchaseOrder/@OrderDate"/>
</xsl:attribute>
<ShippedTo>
<Name>
<xsl:value-of select="concat
(/ns0:PurchaseOrder/ShipTo/Name/First,/ns0:PurchaseOrder/ShipTo/Name/Last)"/>
</Name>
</ShippedTo>
<ShippedItems>
<xsl:for-each select="/ns0:PurchaseOrder/Items/HighPriorityItems/Item">
<Item>
<ProductName>
<xsl:value-of select="ProductName"/>
</ProductName>
<Quantity>
<xsl:value-of select="Quantity"/>
</Quantity>
</Item>
</xsl:for-each>
</ShippedItems>
</tns1:Invoice>
</xsl:template>
この章の以降の各項では、ソース要素とターゲット要素をリンクする方法、XSLTコンストラクトを追加する方法、および設計ビューでXPath式を作成する方法を説明します。
ターゲット・ツリーの1つのノードは、1回のみリンクできます(つまり、ターゲット・ツリー内の1つのノードに2つのリンクは接続できません)。
不完全な関数および式は、ソース・ビューのXPath式には表示されません。不完全な式が1つ以上ある状態で設計ビューからソース・ビューに切り替えると、「マッパー・メッセージ」ウィンドウに警告メッセージが表示されます。
XSLTマッパーで重複する要素をマップすると、スタイルシートが無効になり、設計ビューで作業できなくなります。重複する名前の要素をマップした場合は、「ログ」ウィンドウにエラー・メッセージが表示されます。例38-5に詳細を示します。
例38-5 名前の重複によるエラー・メッセージ
Error: This Node is Already Mapped : "/ns0:rulebase/for-each/ns0:if/ns0:atom/ns0:rel" Error: This Node is Already Mapped : "/ns0:rulebase/for-each/ns0:if/ns0:atom/choice_1/ns0:ind" Error: This Node is Already Mapped : "/ns0:rulebase/for-each/ns0:if/ns0:atom/choice_1/ns0:var"
設計ビューで重複ノードを作成するには、1回実行されるfor-each文を各重複ノードの前後に記述します。
トランスフォーメーションはXSLマップ・ファイル内で実行されます。このファイル内で、ソース・スキーマ要素をターゲット・スキーマ要素にマップします。この項では、XSLマップ・ファイルの作成方法について説明します。
transformアクティビティにより、Oracle BPEL Process ManagerのXSLTマッパーを使用してトランスフォーメーションを作成できます。このツールを使用すると、1つ以上のソース要素をターゲット要素にマップできます。たとえば、受信したソース注文書スキーマ・データを、送信する請求書スキーマ・データにマップできます。
Oracle BPEL Process ManagerでXSLマップ・ファイルを作成する手順は、次のとおりです。
「コンポーネント・パレット」から、transformアクティビティをBPELプロセス・ダイアグラムにドラッグします。図38-4に例を示します。
transformアクティビティをダブルクリックします。
図38-5に示す「Transform」ダイアログが表示されます。
次の情報を指定します。
要素のマップ元となるソース変数を追加します。追加するには、「追加」アイコンをクリックして、変数と、必要に応じて変数のパート(たとえば、注文書リクエストで構成されるペイロード・スキーマ)を選択します。
|
注意: 複数の入力変数を選択できます。定義されている最初の変数が、XSLマップへのメインXML入力を表します。ここで追加される他の変数は、XSLマップでは入力パラメータとして定義されます。 |
要素のマップ先となるターゲット変数を追加します。
マップ先となる変数のターゲット・パート(たとえば、請求書で構成されるペイロード・スキーマ)を追加します。
「マッパー・ファイル」フィールドで、マップ・ファイル名を指定するか、デフォルト名をそのまま使用します。マップ・ファイルは、XSLTマッパーを使用して、マッピングを作成するファイルです。
「追加」アイコン(「マッパー・ファイル」フィールドの右側にある2番目のアイコン)をクリックして、マッピングを作成します。ファイルが存在する場合は、「編集」アイコン(3番目のアイコン)をクリックしてマッピングを編集します。
XSLTマッパーが表示されます。
第38.1項「XSLTマッパーの概要」に移動して、XSLTマッパーの使用方法の概要を確認します。
|
注意: 拡張子が.xsltの既存のファイル(たとえば、xform.xslt)を選択すると、xform.xsltファイルを使用するつもりでもXSLTマッパーが開き、xform.xslt.xslという名前のXSLファイルが作成されます。拡張子が.xslではないすべてのファイルに.xsl拡張子が追加され、新規ファイルでマッピングを作成する必要が発生します。回避策として、ファイル名には必ず拡張子.xslを付けるようにします。XSLファイルの拡張子が.xsltである場合は、.xslに変更します。 |
次の手順では、po.xsdファイルとinvoice.xsdファイルを使用して、Oracle BPEL Process ManagerでXSLマップを作成する方法の概要を説明します。
Oracle BPEL Process Managerで、インポートされたソースとターゲット・スキーマ・ファイルからXSLマップ・ファイルを作成する手順は、次のとおりです。
Oracle JDeveloperで、新規XSLマップを作成するアプリケーション・プロジェクトを選択します。
po.xsdファイルとinvoice.xsdファイルをプロジェクトにインポートします(たとえば、Oracle JDeveloperの「構造」ウィンドウで「スキーマ」を右クリックして、「スキーマのインポート」を選択します)。
選択したプロジェクトを右クリックし、「新規」を選択します。
「新規ギャラリ」ダイアログが表示されます。
「カテゴリ」ツリーで、「SOA層」を開いて「トランスフォーメーション」を選択します。
「項目」リストで、「XSLマップ」をダブルクリックします。
「XSLマップ・ファイルの作成」ダイアログが表示されます。このダイアログでは、ターゲットのスキーマ・ファイルまたはWeb Services Description Language(WSDL)ファイルのルート要素にソースのスキーマ・ファイルまたはWSDLファイルのルート要素をマップする、XSLマップ・ファイルを作成できます。次の点に注意してください。
プロジェクトに追加されたWSDLファイルは、「プロジェクトのWSDLファイル」の下に表示されます。
プロジェクトに追加されたスキーマ・ファイルは、「プロジェクトのスキーマ・ファイル」の下に表示されます。
プロジェクトの一部ではないスキーマ・ファイルは、スキーマ・ファイルのインポート機能を使用してインポートできます。「スキーマ・ファイルのインポート」アイコン(スキーマ・ファイル・リストの右上にある1番目のアイコン)をクリックしてください。
プロジェクトの一部ではないWSDLファイルは、WSDLファイルのインポート機能を使用してインポートできます。「WSDLファイルのインポート」アイコン(スキーマ・ファイル・リストの右上にある2番目のアイコン)をクリックしてください。
「ファイル名」フィールドにXSLマップ・ファイル名を入力します。
ソース・ツリーとターゲット・ツリーでルート要素を選択します。図38-6の例では、ソース・ルート要素にPurchaseOrder要素が選択され、ターゲット・ルート要素にInvoice要素が選択されています。
「OK」をクリックします。
図38-7に示すように、新しいXSLマップが作成されます。
この時点でファイルを保存して閉じるか、トランスフォーメーションの設計を開始します。XSLTマッパーの使用方法は、第38.1項「XSLTマッパーの概要」を参照してください。
「コンポーネント・パレット」からtransformアクティビティをBPELプロセスにドラッグします。
transformアクティビティをダブルクリックします。
次の情報を指定します。
要素のマップ元となるソース変数を追加します。追加するには、「追加」アイコンをクリックして、変数と、必要に応じて変数のパート(たとえば、注文書リクエストで構成されるペイロード・スキーマ)を選択します。
|
注意: 複数の入力変数を選択できます。定義されている最初の変数が、XSLマップへのメインXML入力を表します。ここで追加される他の変数は、XSLマップでは入力パラメータとして定義されます。 |
要素のマップ先となるターゲット変数を追加します。
マップ先となる変数のターゲット・パート(たとえば、請求書で構成されるペイロード・スキーマ)を追加します。
「マッパー・ファイル」フィールドの右側にある「検索」アイコン(1番目のアイコン)をクリックし、ステップ6で指定したファイル名を参照します。
「開く」をクリックします。
「OK」をクリックします。
XSLTマッパーにXSLマップ・ファイルが表示されます。
第38.1項「XSLTマッパーの概要」に移動して、XSLTマッパーの使用方法の概要を確認します。
XSLTマッパーを使用すると、Oracle Mediatorで、XMLスキーマ間でデータを変換するためのXSLファイルを作成できます。XSLファイルを定義した後は、そのファイルを複数のルーティング・ルール仕様で再利用できます。この項では、XSLTマッパーを使用してトランスフォーメーション・マップXSLファイルを作成する方法の概要を示します。
XSLTマッパーは、Oracle JDeveloperの「アプリケーション・ナビゲータ」でXSLファイルをクリックするか、メディエータ・エディタで「トランスフォーメーション」アイコンをクリックすると使用できます。手順については次に説明します。新規のトランスフォーメーション・マップを作成するか、既存のトランスフォーメーション・マップを更新できます。
メディエータ・エディタでXSLTマッパーを起動してデータ・トランスフォーメーションXSLファイルを作成または更新するには、次の手順に従います。
メディエータ・エディタでXSLマップ・ファイルを作成する手順は、次のとおりです。
メディエータ・エディタを開きます。
「ルーティング・ルール」の左側の「+」アイコンをクリックして「ルーティング・ルール」パネルを開きます。
「ルーティング・ルール」パネルにトランスフォーメーション・マップ・アイコンが表示されます。
図38-8に示すように、「次を使用して変換」フィールドの右側にある適切なトランスフォーメーション・マップ・アイコンをクリックして、トランスフォーメーション・マップ・ダイアログを表示します。
このトランスフォーメーション・マップ・ダイアログには、既存のトランスフォーメーション・マップ(XSL)ファイルを選択するか、新規のマップ・ファイルを作成するオプションが表示されます。たとえば、「同期リプライ」セクションのトランスフォーメーション・マップ・アイコンを選択すると、図38-9に示すダイアログが表示されます。
ルーティング・ルールに同期リプライまたはフォルトが含まれている場合、「リプライ・トランスフォーメーション・マップ」ダイアログまたは「フォルト・トランスフォーメーション・マップ」ダイアログには、「リクエストをリプライ・ペイロードに含める」オプションが表示されます。 このオプションを有効化すると、リクエスト・メッセージから情報を取得できます。リクエスト・メッセージ、リプライおよびフォルト・メッセージは、複数のパートで構成できるため、複数のソース・スキーマを指定できます。コールバックとコールバック・タイムアウト・トランスフォーメーションも、複数のパートで構成できます。
各メッセージ・パートには変数が入ります。リプライ・トランスフォーメーションでは、リプライ・メッセージにはメイン・パート(検出される最初のパート)のスキーマ、およびそれに続く各パートのin.partname変数が含まれます。インクルード・リクエスト・メッセージには、各パートのinitial.partname変数が含まれます。
たとえば、リプライのメイン・パートがout1.HoustonStoreProductスキーマで、変数として処理される他の2つのパートがin.HoustonStoreProductとin.HoustonStoreProduct2であるとします。リクエスト・メッセージには、変数として処理されるinitial.expense、initial.expense2およびinitial.expense3の3つのパートが含まれます。図38-10に例を示します。
次のいずれかのオプションを選択します。
「既存のマッパー・ファイルの使用」を選択し、「検索」アイコンをクリックして既存のXSLTマッパー・ファイルを参照(またはデフォルト値をそのまま使用)します。
「新規マッパー・ファイルの作成」を選択し、ファイル名を入力(またはデフォルト値をそのまま使用)します。ステップ3で説明したように、WSDLファイルのソース・メッセージに複数のパートがある場合は、各パートに変数が使用されます。トランスフォーメーションのターゲットに複数のパートがある場合は、複数のトランスフォーメーション・ファイルがこれらのターゲットにマップされます。この場合、メディエータの「トランスフォーメーション」ダイアログには、各ターゲット・パートごとに別々のパネルが表示されます。たとえば、ターゲットが3つのパートのリクエストがあるとします。
図38-11に例を示します。
「OK」をクリックします。
「新規マッパー・ファイルの作成」を選択した場合は、XSLTマッパーが開き、ソース・スキーマ要素をターゲット・スキーマ要素に関連付けることができます。
第38.1項「XSLTマッパーの概要」に移動して、XSLTマッパーの使用方法の概要を確認します。
基本的なフォーマット・データ以外の既存のマッピング・エントリをすべてXSLファイルから手動で削除した場合、XSLファイルのエラーは、実行時のトランスフォーメーション中には表示されません。マッピング・エントリは必ず指定してください。たとえば、次の処理を実行するとします。
XSLTマッパーで、入力データから出力データへのトランスフォーメーション・マッピングを作成します。
出力データをファイル・アダプタを使用してファイルに書き込むように、アプリケーションを設計します。
XSLファイルを手動で変更し、基本的なフォーマット・データ以外のマッピング・エントリをすべて削除します。例:
<?xml version="1.0" encoding="UTF-8" ?> <xsl:stylesheet version="1.0" xmlns:xp20="http://www.oracle.com/XSL/Transform/java/oracle.tip.pc.services.fu nctions.Xpath20" xmlns:bpws="http://schemas.xmlsoap.org/ws/2003/03/business-process/" xmlns:ns0="http://xmlns.oracle.com/pcbpel/adapter/file/MediaterDemo/Validation UsingSchematron/WriteAccounInfoToFile/" xmlns:orcl="http://www.oracle.com/XSL/Transform/java/oracle.tip.pc.services.fu nctions.ExtFunc" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:dvm="http://www.oracle.com/XSL/Transform/java/oracle.tip.dvm.LookupValue " xmlns:hwf="http://xmlns.oracle.com/bpel/workflow/xpath" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:mhdr="http://www.oracle.com/XSL/Transform/java/oracle.tip.mediator.servi ce.common.functions.GetRequestHeaderExtnFunction" xmlns:ids="http://xmlns.oracle.com/bpel/services/IdentityService/xpath" xmlns:imp1="http://www.mycompany.com/MyExample/NewAccount" xmlns:tns="http://oracle.com/sca/soapservice/MediaterDemo/ValidationUsingSchem atron/CreateNewCustomerService" xmlns:xref="http://www.oracle.com/XSL/Transform/java/oracle.tip.xref.xpath.XRe fXPathFunctions" xmlns:plt="http://schemas.xmlsoap.org/ws/2003/05/partner-link/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:ora="http://schemas.oracle.com/xpath/extension" xmlns:inp1="http://www.mycompany.com/MyExample/NewCustomer" exclude-result-prefixes="xsi xsl tns xsd inp1 ns0 imp1 plt xp20 bpws orcl dvm hwf mhdr ids xref ora"> </xsl:stylesheet>
この場合でも、ファイルのコンパイルは可能ですが、XSLマッピングは無効になっています。
SOAコンポジット・アプリケーションのインスタンスをデプロイおよび作成します。
インスタンスの作成中に、書込み操作が入力を受信しなかったために失敗し、例外エラーが発生します。ただし、XSLトランスフォーメーション中にエラーは表示されないことに注意してください。
「ファイル」→「インポート」→「SOAアーカイブをSOAプロジェクトへ」を選択して、Oracle Enterprise Manager Fusion Middleware ControlコンソールからOracle JDeveloperにエクスポートされたSOAアーカイブをインポートする場合、マップ・ハンドラが削除済のため、XSLマップ・ファイルを開けません。
これを解決するには、次の手順を実行します。
「ファイル」→「新規」→「SOA層」→「トランスフォーメーション」→「XSLスタイルシートからのXSLマップ」を選択し、「OK」をクリックします。
「XSLスタイルシートからのXSLマップ・ファイルの作成」が表示されます。
「ファイル名」フィールドで、新しいマップ名(Transformation_new.xslなど)を入力します。
「作成元のXSLスタイルシート」フィールドで、マップ・ヘッダーのないマップ・ファイル名(この例ではTransformation_old.xsl)を入力します。
ソースとターゲットには、マップ・ヘッダーのリカバリに使用するための正しいマップ・ソースおよびターゲット・スキーマ情報を入力します。
新規マップ・ファイルを正常に作成した後、古いマップ・ファイル(Transformation_old.xsl)を削除します。
参照が壊れないようにするため、リカバリされたヘッダーを持つ新規マップ・ファイルの名前を古いマップ・ファイル名に変更します(この例では、Transformation_new.xsltをTransformation_old.xslに名前を変更します)。
トランスフォーメーション・マッピングを定義せずに、Oracle Mediatorを介してペイロードを渡すようにSOAコンポジット・アプリケーションを設計した場合、ペイロードはOracle Mediatorを介して渡されます。ただし、ペイロードが正しく渡されるには、ソース・メッセージとターゲット・メッセージのパート名とタイプを必ず同じにする必要があります。これらが同じでない場合、ターゲット参照は実行に失敗し、「入力ソースがNullです」または「Partが見つかりません」などのエラー・メッセージが表示される場合があります。
XSLファイルのXML表現と、シナリオで使用するXML表現(このシナリオでは、トランスフォーメーションを実行するか、assignアクティビティを使用してメッセージを渡します)は、XMLが構文的およびセマンティク的に同じであっても異なる場合があります。たとえば、メディエータ・サービス・コンポーネントを使用して、ネームスペースのない要素が含まれたインバウンド・ペイロードをアウトバウンド・ペイロードにマップした場合は、空のネームスペース・タグが含まれた出力メッセージを受信する場合があります。
<Country xmlns="">US</Country>
これは正常な動作です。空のネームスペースxmlns=""は自動的に追加されます。
次の各項では、Oracle BPEL Process ManagerまたはOracle MediatorでXSLTマッパーを使用する方法を説明します。
追加ソースを既存のXSLTマップに追加できます。これらのソースはグローバル・パラメータとして定義され、その構造を定義するスキーマを持っています。マップのロジックによっては、複数のソース文書が必要となる場合があります。たとえば、請求書を作成するには、マップの入力として注文書と顧客データ文書の両方にアクセスする必要がある場合があります。
XSLには、BPEL変数の認識機能はないことに注意してください。XSL設計時に複数のソースを追加する場合は、これらの複数のソースをBPELプロセスのtransformアクティビティ内でも必ず追加してください。
追加ソースを追加する手順は、次のとおりです。
ソース・パネルを右クリックして、コンテキスト・メニューを表示します。図38-12に詳細を示します。
「ソースの追加」を選択します。
図38-13に示す「ソースの追加」ダイアログが表示されます。
ソースのパラメータ名を入力します(名前はネームスペースや接頭辞で修飾することもできます)。
「ソース・スキーマ」セクションで、「選択」をクリックして、新しいソースのスキーマを選択します。
「タイプ・チューザ」ダイアログが表示されます。
新規XSLTマップを作成する場合と同じ方法で、パラメータに対して適切なスキーマまたはWSDLファイルを選択またはインポートします。この例では、サンプルのcustomer.xsdファイルの「Customer」要素を選択しています。
「OK」をクリックします。
「パラメータとしてソースを作成」ダイアログの「ソース・スキーマ」セクションに、スキーマの定義が表示されます。
「OK」をクリックします。
選択したスキーマがインポートされ、ソース・パネルのメイン・ソースの上にパラメータが表示されます。図38-14に示すように、パラメータを展開して、基礎となるスキーマの構造を表示できます。
パラメータは、先頭に$を付けることで、XPath式で参照できます。たとえば、CUSTという名前のパラメータは、XPath式では$CUSTと表示されます。パラメータの下のノードも参照できます(たとえば、$CUST/customer/Header/customerid)。
ソースの属性またはリーフ要素をターゲットの属性またはリーフ要素にコピーするには、ソースをターゲットにドラッグします。たとえば、図38-15に示すように、要素PurchaseOrder/IDをInvoice/IDにコピーし、属性PurchaseOrder/OrderDateをInvoice/InvoiceDateにコピーします。
次の手順に従って、定数値を設定します。
定数値を設定する手順は、次のとおりです。
ターゲット・ツリーでノードを選択します。
マウスを右クリックして、コンテキスト・メニューを起動します。
「テキストの設定」メニュー・オプションを選択します。
メニューには次の選択項目があります。
<空>: 空のノードを作成できます。
テキストの入力: テキストを入力できます。
「テキストの入力」を選択します。
「テキストの設定」ダイアログが表示されます。
「テキストの設定」ダイアログでテキストを入力します(たとえば、図38-16に示す「Discount Applied」)。
「OK」をクリックして、テキストを保存します。
テキストが関連付けられたノードの横に「T」のアイコンが表示されます。入力したテキストの先頭の文字がノード名の横に表示されます。
ノードに関連付けられているテキストを変更するには、ノードを右クリックして「テキストの編集」を選択し、「テキストの設定」ダイアログを再度起動します。
テキストを変更して「OK」をクリックします。
フィールドの詳細は、「テキストの設定」ダイアログのオンライン・ヘルプを参照してください。
ノードに関連付けられているテキストを削除するには、ノードを右クリックして「テキストの削除」を選択します。
標準のXPath 1.0関数に加え、XSLTマッパーでは、多くのビルトイン拡張関数を使用できます。また、マッパーはユーザー定義関数や名前付きテンプレートにも対応しています。これらの拡張関数には、接頭辞oraextまたはorclが付加されており、XPath 2.0関数に類似しています。
次の手順に従って、関数定義を表示し、関数を使用します。
関数を追加する手順は、次のとおりです。
「コンポーネント・パレット」で関数のカテゴリ(たとえば、「String Functions」)を選択します。
個別の関数(lower-caseなど)を右クリックします。
「ヘルプ」を選択します。図38-17に示すように、関数の説明があるダイアログが表示されます。下部のリンクをクリックして、World Wide Web Consortium(www.w3.org)にあるこの関数の説明にアクセスすることもできます。
「コンポーネント・パレット」からXSLTマッパーの中央のパネルに、関数をドラッグします。次に、ソース・ツリーのソース・パラメータを関数に接続し、関数の出力をターゲット・ツリーのノードに接続できます。次の例では、「コンポーネント・パレット」の「String」セクションから「concat」関数を中央のパネルにドラッグします。
PurchaseOrder/ShipTo/Name/FirstとPurchaseOrder/ShipTo/Name/Lastを連結します。姓および名からスレッドをドラッグし、concat関数の入力(左)側にドロップして、Invoice/ShippedTo/Nameに結果を設定します。
ShippedTo名からスレッドをドラッグし、concat関数の出力(右)側に接続します。図38-18を参照してください。
関数のパラメータを編集するには、関数アイコンをダブルクリックして「関数の編集」ダイアログを起動します。たとえば、新規パラメータのカンマを追加して、前述の例で使用したconcat関数の出力をLast, Firstとするには、「追加」をクリックしてカンマを追加し、この出力となるようにパラメータを並べ替えます。図38-19に詳細を示します。
関数パラメータを追加、削除および順序変更する方法の詳細は、「関数の編集」ダイアログのオンライン・ヘルプを参照してください。
関数の連鎖(ある関数の出力を別の関数の入力にマップすること)によって、複雑な式を作成できます。たとえば、concat関数の出力から先頭と末尾の空白をすべて削除するには、次の手順を実行します。
left-trim関数とright-trim関数をconcat関数の枠線の領域にドラッグします。
図38-20に示すように、一方の関数の出力側から次の関数の入力側に線をドラッグして、2つの関数を連鎖します。
連鎖は、関数を接続リンクにドラッグ・アンド・ドロップして実行することもできます。
一部の複雑なマッピング・ロジックは、ビジュアル・マッピングで表現したり、実現できません。このような場合は、名前付きテンプレートが便利です。名前付きテンプレートを使用すると、共通のマッピング・ロジックを共有できます。共通のマッピング・ロジックを名前付きテンプレートとして定義すると、そのテンプレートは必要に応じて何度でも使用できます。
名前付きテンプレートは2つの方法で定義できます。
ソース・ビューのXSLマップに直接テンプレートを追加します。
XSLマップに組み込む外部ファイルにテンプレートを追加します。
定義したテンプレートは、「コンポーネント・パレット」の「ユーザー定義」ページにある「User Defined Named Templates」リストに表示されます。名前付きテンプレートは、他の関数とほぼ同じ方法で使用できます。唯一異なる点は、名前付きテンプレートの出力は関数または別の名前付きテンプレートにリンクできないことです。名前付きテンプレートの出力をリンクできるのは、ターゲット・ツリー内のターゲット・ノードのみです。
名前付きテンプレートの作成には、XSLT言語の知識が必要です。名前付きテンプレートの作成方法の詳細は、XSLTに関する書籍を参照するか、次のURLにアクセスしてください。
http://www.w3.org/TR/xslt
外部ファイルに定義されたテンプレートの組込み方法の詳細は、第38.3.6.7項「xsl:includeを使用した外部テンプレートのインクルード」を参照してください。
XSLTまたはXPath式で実行できない複雑な機能がある場合は、ユーザー定義のJava関数を作成し、インポートできます。
次の手順に従って、ユーザー独自の関数を作成して使用します。ロジックが複雑すぎるためにXSLマップ内で実行できない場合は、外部のユーザー定義関数が必要になる場合があります。
ユーザー定義関数をインポートする手順は、次のとおりです。
関数をコーディングし、作成します。
XSLTマッパーの拡張関数のコード方法は、Oracle BPELプロセス・マネージャの拡張関数とは異なります。mapper-107-extension-functionsサンプル・シナリオのSampleExtensionFunctions.javaファイルには、2つの例があります。例38-6に、これらの関数のテキストを示します。これらのサンプルおよび他のサンプルは、次のURLからダウンロードできます。
https://soasamples.samplecode.oracle.com/
各関数は、静的関数として宣言する必要があります。入力パラメータと戻り値は、次のいずれかのタイプで宣言する必要があります。
java.lang.String
int
float
double
boolean
oracle.xml.parser.v2.XMLNodeList
oracle.xml.parser.v2.XMLDocumentFragment
例38-6 XSLTマッパー拡張関数
// SampleExtensionFunctions.java
package oracle.sample;
/*
This is a sample XSLT Mapper User Defined Extension Functions implementation
class.
*/
public class SampleExtensionFunctions
{
public static Double toKilograms(Double lb)
{
return new Double(lb.doubleValue()*0.45359237);
}
public static String replaceChar(String inputString, String oldChar, String
newChar )
{
return inputString.replace(oldChar.charAt(0), newChar.charAt(0));
}
}
XML拡張関数構成ファイルを作成します。このファイルは関数とそのパラメータを定義します。
このファイルの名前は、ext-mapper-xpath-functions-config.xmlに設定する必要があります。このファイルのフォーマットに関する詳細は、B.7項「ユーザー定義XPath拡張関数の作成」を参照してください。例38-7に示されているファイルは、例38-6でコーディングされたtoKilograms関数とreplaceChar関数を表しています。
例38-7 XML拡張関数構成ファイル
<?xml version="1.0" encoding="UTF-8"?>
<soa-xpath-functions version="11.1.1"
xmlns="http://xmlns.oracle.com/soa/config/xpath" xmlns:sample=
"http://www.oracle.com/XSL/Transform/java/oracle.sample.SampleExtensionFunctions"
>
<function name="sample:toKilograms">
<className>oracle.sample.SampleExtensionFunctions</className>
<return type="number"/>
<params>
<param name="pounds" type="number"/>
</params>
<desc>Converts a value in pounds to kilograms</desc>
</function>
<function name="sample:replaceChar">
<className>oracle.sample.SampleExtensionFunctions</className>
<return type="string"/>
<params>
<param name="inputString" type="string"/>
<param name="oldChar" type="string"/>
<param name="newChar" type="string"/>
</params>
<desc>Returns a new string resulting from replacing all occurrences
of oldChar in this string with newChar</desc>
</function>
</soa-xpath-functions>
XSLT拡張関数の定義には、他にいくつかのルールが適用されます。
関数にはネームスペースの接頭辞とネームスペースが必要です。この例では、sampleとhttp://www.oracle.com/XSL/Transform/java/oracle.sample.SampleExtensionFunctionsとなります。
Oracle XSLTプロセッサと連携する拡張関数の場合、関数ネームスペースはhttp://www.oracle.com/XSL/Transform/java/で始まる必要があります。
ネームスペースの後半部は、この例ではoracle.sample.SampleExtensionFunctionsですが、拡張関数を実装したJavaクラスの完全な修飾名である必要があります。
表38-1に示したタイプおよび等価のJavaタイプは、パラメータと戻り値に対して使用できます。
XML構成ファイルとコンパイル済クラスの両方が含まれたJARファイルを作成します。構成ファイルは、JARファイル用のMETA-INFディレクトリに格納される必要があります。この項の例の場合、ディレクトリ構造は、JARファイルにoracleディレクトリとMETA-INFディレクトリが追加され、次のようになります。
oracle
sample(クラス・ファイルが格納されます。)
META-INF
ext-mapper-xpath-functions-config.xml
次に、JARファイルをOracle JDeveloperに登録する必要があります。
「ツール」→「プリファレンス」→「SOA」の順に選択します。
「追加」ボタンをクリックし、JARファイルに移動して選択します。
Oracle JDeveloperを再起動します。
新しい関数は、「コンポーネント・パレット」で、「ユーザー定義」ページの「User Defined Extension Functions」グループに表示されます。
関数をランタイム環境で使用できるようにする方法の詳細は、B.7.3項「ユーザー定義関数のランタイムへのデプロイ方法」を参照してください。
XPath式をトランスフォーメーション・マッピングに使用するには、コンポーネント・パレットで「拡張」ページを選択し、次に「Advanced Function」グループを選択して、「xpath-expression」をリストからXSLTマッパーにドラッグします。図38-21を参照してください。
アイコンをダブルクリックすると、図38-22に示すように、「XPath式の編集」ダイアログが表示されます。[Ctrl]キーを押しながら[Space]キーを押してXPathビルディング・アシスタントを起動します。
図38-23は、XPathビルディング・アシスタントを示しています。
XPathビルディング・アシスタントの使用に関する詳細は、「XPath式の編集」ダイアログのオンライン・ヘルプおよびB.6項「Oracle JDeveloperでのXPath式の構築」を参照してください。
複雑なスキーマのマッピングでは、XSLTコンストラクトを追加できる必要があります。たとえば、特定の条件が存在する場合に、ターゲットにノードを作成する必要がある場合があります。この場合は、xsl:if文またはxsl:choose文を使用する必要があります。また、受注の品目リストなど、ソースでnode-setをループ処理し、受注の各品目に対してターゲットXMLにノードを作成する必要がある場合もあります。この場合は、xsl:for-each文を使用する必要があります。XSLTマッパーには、このようなタスクを実行するためのXSLTコンストラクトが用意されています。
for-each、if、chooseなどのXSLTコントラクトをターゲットXSLTツリーに追加する方法は2種類あります。
「コンポーネント・パレット」からXSLTコントラクトを追加する手順は、次のとおりです。
「一般」ページを選択して「XSLT Constructs」グループを開きます。図38-24に詳細を示します。
XSLTコンストラクトをグループからターゲット・ツリーのノードにドラッグします。XSLTコントラクトがそのノードに適用できる場合は、ターゲット・ツリーに挿入されます。whenおよびotherwiseコンストラクトは、あらかじめ挿入されたchooseノードに適用する必要があることに注意してください。
XSLTコンストラクトをターゲット・ツリーのコンテキスト・メニューを使用して追加する手順は、次のとおりです。
XSLTコンストラクトを挿入するターゲット・ツリーの要素を右クリックします。コンテキスト・メニューが表示されます。図38-25に詳細を示します。
「XSLノードの追加」を選択し、次に、挿入するXSLTコンストラクトを選択します。
XSLTコンストラクトが挿入されます。ほとんどの場合、最初はエラー・アイコンがコンストラクトの横に表示されます。これは、コンストラクトにXPath式を定義する必要があることを示しています。
たとえば、for-eachコンストラクトの場合、XPath式はfor-each文のループ対象となるノードセットを定義します。ifコンストラクトの場合、XPath式はifコントラクトの内容の実行可否を決定するために評価されるブール式を定義します。
XPath式は、ターゲット・ツリーの要素や属性のマッピングと同じ方法で作成できます。次の方法は、XSLTで基礎となるXPath式を作成する方法です。これらの方法はすべて、XPath式を設定するためにターゲット・ツリーのXSLTコンストラクトで実行できます。
ノードのリンクによる単純コピーの作成
関数の追加
XPath式の追加
次の各項では、サポートされている各XSLTコンストラクトを挿入する具体的な手順を説明します。
図38-26で、HQAccountとBranchAccountは、PurchaseOrderスキーマのchoice要素の一部であり、実際のインスタンスにはそのいずれか1つが出現します。ここでは、条件付きマッピングの具体例として、PurchaseOrder/HQAccount/AccountNumberが存在する場合のみ、Invoice/BilledToAccount/AccountNumberにコピーします。
xsl:ifを使用した条件付き処理を使用する手順は、次のとおりです。
ターゲット・ツリーでInvoice/BilledToAccount/AccountNumberを選択し、右クリックしてコンテキスト依存メニューを起動します。
「XSLノードの追加」→「if」の順に選択し、PurchaseOrder/HQAccount/AccountNumberをInvoice/BilledToAccount/ifに接続します。
PurchaseOrder/HQAccount/AccountNumberをInvoice/BilledToAccount/if/AccountNumberに接続します。
図38-26に結果を示します。
オプションのソース・ノードをオプションのターゲット・ノードにマップする場合は、ソース・ノードが存在するかどうかをテストするxsl:if文でマッピングを囲むことが重要です。このように処理しないと、入力文書にソース・ノードが存在しない場合は、ターゲット文書に空のノードが作成されます。たとえば、例38-8に示すマッピングがあるとします。
ProductNameフィールドがソースおよびターゲットの両方でオプションであり、その要素がソース文書に存在しない場合は、ターゲット文書に空のProductName要素が作成されます。この状況を回避するには、例38-9に示すように、ターゲット・ノードの作成前に、ソース・ノードが存在するかどうかをテストするif文を追加します。
この同じ例で、PurchaseOrder/HQAccount/AccountNumberが存在する場合は、Invoice/BilledToAccount/AccountNumberにコピーできます。存在しない場合は、PurchaseOrder/BranchAccountをInvoice/BilledToAccount/AccountNumberにコピーします。
xsl:chooseを使用した条件付き処理を使用する手順は、次のとおりです。
ターゲット・ツリーでInvoice/BilledToAccount/AccountNumberを選択し、右クリックしてコンテキスト依存メニューを起動します。
メニューから「XSLノードの追加」→「choose」の順に選択します。
PurchaseOrder/HQAccount/AccountNumberをInvoice/BilledToAccount/choose/whenに接続して、条件を定義します。
PurchaseOrder/HQAccount/AccountNumberをInvoice/BilledToAccount/choose/when/AccountNumberに接続します。
ターゲット・ツリーでXSL追加ノード→「choose」の順に選択し、右クリックしてコンテキスト依存メニューを起動します。
メニューから「XSLノードの追加」→「otherwise」の順に選択します。
PurchaseOrder/BranchAccount/AccountNumberをInvoice/BilledToAccount/choose/otherwise/AccountNumberに接続します。
図38-27に結果を示します。
XSLTマッパーでは、xsl:for-eachコマンドを使用したループを作成できます。例として、PurchaseOrder/Items/HighPriorityItems/ItemをInvoice/ShippedItems/Itemにコピーします。
xsl:for-eachを使用してループを作成する手順は、次のとおりです。
ターゲット・ツリーでInvoice/ShippedItems/Itemを選択し、右クリックしてコンテキスト依存メニューを起動します。
「XSLノードの追加」→「for-each」の順に選択し、PurchaseOrder/Items/HighPriorityItems/ItemをInvoice/ShippedItems/for-eachに接続して繰返しを定義します。
PurchaseOrder/Items/HighPriorityItems/Item/ProductNameをInvoice/ShippedItems/for-each/Item/ProductNameに接続します。
PurchaseOrder/Items/HighPriorityItems/Item/QuantityをInvoice/ShippedItems/for-each/Item/Quantityに接続します。
PurchaseOrder/Items/HighPriorityItems/Item/USPriceをInvoice/ShippedItems/for-each/Item/PriceChargedに接続します。
図38-28に結果を示します。
|
注意:
|
既存のxsl:for-eachをクローニングして追加のループを作成できます。たとえば、HighPriorityItemsに加えて、LowPriorityItemsをすべてShippedItemsにコピーします。
xsl:for-eachをクローニングする手順は、次のとおりです。
Invoice/ShippedItemsの下のfor-eachを選択します。
右クリックして、「XSLノードの追加」→「'for-each'のクローニング」の順に選択します。
これで、for-eachノードのコピーがオリジナルのfor-eachの下に挿入されます。
PurchaseOrder/Items/LowPriorityItems/Itemをコピーしたfor-eachにドラッグし、繰返しを定義します。
PurchaseOrder/Items/LowPriorityItems/Item/ProductNameをコピーしたfor-eachのItem/ProductNameに接続します。
PurchaseOrder/Items/LowPriorityItems/Item/Quantityをコピーしたfor-eachのItem/Quantityに接続します。
PurchaseOrder/Items/LowPriorityItems/Item/USPriceをコピーしたfor-eachのItem/PriceChargedに接続します。
XSLTマッパーを使用すると、xsl:sort文をxsl:for-eachコマンドに追加できます。
xsl:sort文を追加する手順は、次のとおりです。
ターゲット・ツリーのfor-each文を右クリックします。
コンテキスト・メニューが表示されます。
「XSLノードの追加」→「sort」を選択します。図38-29で示されるように、「ソート編集ダイアログ」が表示されます。
必要に応じて、sort文に追加するオプションを選択します。オプションの詳細は、オンライン・ヘルプを参照してください。
「OK」をクリックします。for-eachの後にsort文が追加されます。
ソート対象のフィールドを設定するには、ソース・ツリーの必要なソート・フィールド・ノードをターゲット・ツリーのソート・ノードへドラッグします。これによって、単純なリンクが作成され、xsl:sortの選択属性に対してXPath式が設定されます。
sort文をさらに追加するには、「for-each」を右クリックして別のsortを追加するか、既存のソート・ノードを右クリックして、選択したソート・ノードの前に新しいsort文を挿入します。
ソート・ノードを編集するには、ソート・ノードをダブルクリックするか、右クリックして、コンテキスト・メニューから「ソートの編集」を選択します。この結果、「ソート編集ダイアログ」が起動され、ソート・オプションを変更できます。
ノードをその子ノードと一緒にソース・ツリーからターゲット・ツリーにコピーする場合に、XSLT copy-ofコンストラクトを使用できます。この方法は、通常anyTypeやany要素ノードを処理する場合に行われます。anyTypeやany要素ノードおよび属性ノードは、直接マップできないことに注意してください。copy-of、または要素置換およびタイプ置換を使用してください。
xsl:copy-ofを使用してノードをコピーする手順は、次のとおりです。
copy-ofコマンドで作成するノードをターゲット・ツリーで選択します。
右クリックして、「XSLノードの追加」→「copy-of」の順に選択します。
選択したノードがany要素ノードでない場合は、ダイアログが表示され、選択したノードを置換するか、その子ノードを置換するように求められます。
アプリケーションに対して正しいオプションを選択して、「OK」をクリックします。
copy-ofを使用して選択したノードを置換を選択すると、copy-ofに続いて、XSL内に処理ディレクティブが即座に作成され、どのノードがcopy-ofによって置換されたかが示されます。XSLに処理ディレクティブがないと、設計ビューへの変換が不正に解釈されます。このため、ソース・ビュー使用中に、この処理命令を削除または編集しないでください。
ソース・ツリーからドラッグ・アンド・ドロップするか、またはXPath式を作成することでcopy-ofのソース・ノードを設定します。
|
注意: copy-ofコマンドは必ず設計ビューで作成し、正しい処理ディレクティブがXSLTマッパーに作成され、copy-ofコマンドのターゲット・ツリーの中の正しい場所が指示できるようにします。 |
|
警告: XSLTマッパーでは、現在、copy-ofコマンドを使用して実行されたデータのマッピングを検証しません。必ずcopy-ofがターゲット・ツリーに要素を正しくマップするために使用され、その結果ターゲットのXML文書に有効なデータが含まれるようにします。テスト・ツールを使用して有効性をテストできます。 |
外部XSLファイルに定義されたテンプレートをinclude文を使用して現在のマップに含めることにより、テンプレートを再利用できます。
xsl:includeを使用して外部テンプレートをインクルードする手順は、次のとおりです。
ターゲット・ツリーのルート・ノードを選択し、右クリックします。
メニューから、「インクルード・ファイルの追加」を選択します。
インクルード・ファイル名を選択するダイアログが表示されます。
ファイルを選択して「OK」をクリックします。
ファイルは既存のマップ・ファイルと同じプロジェクト・ディレクトリにコピーされます。相対パス名が作成され、include文指示がターゲット・ツリーに挿入されます。
インクルード・ファイルには名前付きのテンプレート定義しか入りません。これらは解析された後、設計ビュー内で、「コンポーネント・パレット」の「ユーザー定義」ページの「User Defined Named Templates」カテゴリから使用できます。
|
注意: oramds://共有ロケーションは、ユーザー定義の名前付きテンプレート・インクルード・ファイルでは参照できません。 |
リーフ以外のノードのマッピングでは、自動マップ機能が起動します。選択したソースとターゲットの下にあるすべての関連ノードの自動リンクが試行されます。例として、PurchaseOrder/ShipTo/AddressをInvoice/ShippedTo/Addressにマップして自動マップ機能を確認してください。図38-30のように、「Address」のすべてのノードが自動的にマップされます。
自動マップの動作は、Oracle JDeveloperのプリファレンスの設定を変更するか、XSLTマッパーを右クリックし、「自動マップ・プリファレンス」を選択して調整できます。図38-31に示すダイアログが表示されます。
このダイアログでは、自動マッピングを次のようにカスタマイズできます。
自動マッピング機能を起動できます。この機能では、選択したソースとターゲットの下にあるすべての関連ノードの自動リンクが試行されます。この機能が無効の場合は、関連ノードを個別にマップする必要があります。
XSLTマッパーで検出されたソースからターゲットへの考えられるすべてのマッピングを表示および確認してから、作成を確定できます。
自動マップの起動前に、自動マップのプリファレンスをカスタマイズするかどうかを尋ねるプロンプトを表示できます。
ソース・ノードおよびターゲット・ノードの自動マッピングに対して、「標準」または「詳細」のいずれかの方法を選択できます。この処理によって、選択したソースとターゲットの下にあるすべての関連ノードの自動リンクを、XSLTマッパーでどのように試行するかをカスタマイズできます。
ディクショナリを管理できます。XSLTマッパーでは、ソース要素とターゲット要素の自動マップの試行時に、ディクショナリで定義されているルールが使用されます。
フィールドの詳細は、「自動マップ・プリファレンス」ダイアログのオンライン・ヘルプを参照してください。
次の手順に従って、ターゲット・ノードの潜在的なソース・マッピング候補を検索します。
ノードを自動的にマップする手順は、次のとおりです。
ターゲット・ノードを右クリックして、「一致アイテムの表示」を選択します。
「自動マップ・プリファレンス」ダイアログで「OK」をクリックします。
図38-32に示すように、「自動マップ」ダイアログが表示されます。
フィールドの詳細は、「自動マップ」ダイアログのオンライン・ヘルプを参照してください。
自動マッピング・アルゴリズムは、ソース・ノードとターゲット・ノード間の既存のマップに依存します。自動マッピングの実行前に、ソース・ノードとターゲット・ノード間にマップが存在する場合は、これらの既存のマップを使用して、アルゴリズムで使用される有効なシノニムが定義されます。
たとえば、図38-34に示すように、単純なソース・ツリーとターゲット・ツリーがあり、それぞれにtest1とtest2という2つの要素があるとします。
ノードがマップされていない場合、自動マッピング・アルゴリズムで名前test1とtest2が照合されることはありません。ただし、test1ノードとtest2ノードの間にマッピングが存在する場合は、追加のマッピングに対して、名前test1とtest2がシノニムとして事前定義されます。
図38-34の例で、exampleElementをソースからターゲットにドラッグすると、自動マッピング・アルゴリズムによって、ソースのtest1ノードがターゲットのtest2ノードにマップされます。これは、この2つの名前が、マップで以前にリンクされたためです。この結果、マップは図38-35のようになります。
ソース・ノードに現在マップされていないターゲット・ノードのリストを表示できます。
マップされていないターゲット・ノードを表示する手順は、次のとおりです。
XSLTマッパーの中央のパネルで右クリックして、「完了ステータス」を選択します。
このダイアログの下部には、マップされていないターゲット・ノードの数に関する統計が示されます。このダイアログを使用すると、「XSLマップのテスト」ダイアログでトランスフォーメーション・マッピングのロジックをテストする前に、マップされていないノードを識別し、修正できます。
リストからターゲット・ノードを選択します。そのノードがハイライト表示されます。チェック・マークは、ターゲット・ノードがマップされる必要があることを示しています。マップされる必要がない場合、そのチェック・ボックスは空です。
|
注意: 「完了ステータス」ダイアログでは、ノードに対するXSD定義に基づいてノードが必須としてマークされます。ノードが必須としてマークされていても、その親ノードがオプションである場合やXSLマッピングの一部でない場合は、特定のマッピングに対して実際には必須でない可能性があります。 |
図38-36に、「完了ステータス」ダイアログの例を示します。
ディクショナリは、自動マッピングで使用されるXMLファイルです。フィールド名に対するシノニムが含まれています。たとえば、要素QtyOrderedを要素Quantityにマップする必要があるとします。このとき、要素名QtyOrderedとQuantityは互いにシノニムです。このマッピングがマップ間で一般的に使用される場合は、これらのシノニムをディクショナリ・ファイルに保存することをお薦めします。保存したシノニムは、自動マッピングを使用して別のマップに再度適用できます。
ディクショナリは、既存のどのXSLマップからでも作成でき、XSLTマッパーでは既存のマップに対して自動的に生成されないすべてのマッピングを格納できます。
ディクショナリを生成して使用する手順は、次のとおりです。
他のマップで再利用する特定のマッピングが含まれているXSLマップを作成します。
「ツール」→「プリファレンス」→「XSLマップ」→「自動マップ」の順に選択し、現在の自動マッピングの設定をメモしておきます。
|
注意: ディクショナリ・エントリは現在の自動マッピングの設定に依存しているため、将来使用するためにこれらの設定をメモしておく必要があります。ディクショナリ・マッピングを後で再度適用するには、自動マッピング・プリファレンスをディクショナリの作成時に有効だった内容に設定する方法が最善です。したがって、ディクショナリが作成された時点の自動マッピングの設定をメモしておくことが重要です。 |
XSLTマッパーの中央のパネルを右クリックして「ディクショナリの生成」を選択します。
この結果、ディクショナリ名とそのディクショナリを格納するディレクトリの入力を求めるプロンプトが表示されます。
「ディクショナリを開く」チェック・ボックスを選択して、作成したディクショナリを表示します。ディクショナリ・ファイルが空の場合、このチェック・ボックスは、現在の自動マッピングの設定ではフィールドがマップされていないため、マップされたフィールドがないことを示します。
ディクショナリを別のマップで使用するには、「ツール」→「プリファレンス」→「XSLマップ」→「自動マップ」の順に選択して、ディクショナリをロードします。
「ディクショナリ」リストの下の「追加」をクリックします。
類似のマップから以前に作成したディクショナリXMLファイルを参照して選択します。
「OK」をクリックします。
自動マッピング・プリファレンスを終了する前に、ディクショナリの作成時に使用した設定と一致するようにマッピングの設定を変更します。
「OK」をクリックします。
新しいマップの中で、保存済のディクショナリ・マッピングに対応するすべての部分について自動マッピングを実行します。
自動マッピングの詳細は、第38.3.7項「ノードを自動的にマップする方法」を参照してください。
関数が使用されているマッピングでは、ディクショナリを作成できません。このような状況では、自動的にマップされた要素またはXPath関数のマッピングがある要素について、ディクショナリXMLの指示が欠落します。たとえば、設計時に文字列関数を使用してXSDをマップしたとします。XSLTマッパーの中央パネルを右クリックして「ディクショナリの生成」を選択すると、ディクショナリは作成されますが、マッピング時に文字列関数を使用したすべての場所で、指示が作成されません。
単純なタイプのマッピングついては、ディクショナリを作成できます。
マップ・パラメータおよびマップ変数を作成できます。マップ・パラメータはソース・ツリーで作成し、マップ変数はターゲット・ツリーで作成します。
次の点に注意してください。
パラメータはソース・ツリーで作成され、グローバルであるため、マッピングのすべての場所で使用できます。
変数はターゲット・ツリーで作成され、グローバルまたはローカルのいずれかです。ターゲット・ツリーのどの場所で定義されたかによって、グローバルであるか、ローカルであるかが決まります。
グローバル変数は<target>ノードの直下、および実際のターゲット・スキーマ(例: POAcknowledge)のすぐ上で定義されます。グローバル変数を作成するには、<target>ノードを右クリックします。
ローカル変数は、実際のターゲット・スキーマの下にある特定のノード(例: スキーマPOAcknowledge上のサブノードname)で定義されます。ローカル変数は、それぞれが異なるスコープ内にあれば、同じ名前を設定できます。ローカル変数はそのスコープ内でのみ使用できるのに対して、グローバル変数はマッピング内のすべての場所で使用できます。
マップ・パラメータを作成する手順は、次のとおりです。
ソース・ツリーのルートを右クリックし、「パラメータの追加」を選択します。
図38-37に示す「パラメータの追加」ダイアログが表示されます。
パラメータの詳細を指定します。この例では、discountという名前のパラメータが、数値のデフォルト値0.0で指定されます。
「OK」をクリックします。
マップ変数を作成する手順は、次のとおりです。
ターゲット・ツリーで、ターゲット・ツリーのルートまたはいずれかのノードを右クリックして「変数の追加」を選択します。
図38-38に示す「変数の追加」ダイアログが表示されます。
詳細を指定します。
変数はターゲット・ツリーに表示されるため、変数を挿入した後でターゲット・ツリーの他のXSLTコンストラクトと同じようにXPath式を設定できます。このため、このダイアログで必要な情報は変数の名前のみです。変数のコンテンツを設定するには、このダイアログを使用して入力する必要があります。コンテンツは、変数上のXSLT select属性とは別に処理されます。
「OK」をクリックします。
ターゲット・ツリーの選択した位置に変数が追加されます。変数の横には、最初は警告アイコンが表示されます。これは、選択XPath文が定義されていないことを示しています。他のターゲット要素やXSLTコンストラクトで行ったのと同じように、ソース・ノードのリンク、関数の作成、または明示的なXPath式の定義を通じてXPathを定義します。
ソース・ノードおよびターゲット・ノードを検索できます。たとえば、invoiceというソース・ノードでpriceというサブノードの出現箇所をすべて検索できます。
ソース・ノードとターゲット・ノードを検索する手順は、次のとおりです。
ソース・ノードまたはターゲット・ノードを右クリックして、コンテキスト・メニューから「検索」を選択します。
図38-39に示す「ノード検索」ダイアログが表示されます。
検索キーワードを入力します。
必要に応じて追加の詳細を指定します。例:
注釈テキストも検索対象とする場合は、「注釈の検索」を選択します。
検索の範囲を指定します。ソース・ツリーまたはターゲット・ツリー全体の検索、選択した位置からの検索、または選択したサブツリー内の検索を指定できます。
検出された最初の一致がハイライト表示され、「検索」ダイアログが閉じます。一致が検出されない場合は、画面にメッセージが表示されます。
指定した方向の次の一致を検索するには、 [F3] キーを押します。逆方向に検索するには、 [Shift] キーを押しながら [F3] キーを押します。
|
注意: 関数、または「テキストの設定」オプションで設定したテキスト値は検索できません。 |
ターゲットXSL内への空要素の生成を制御する場合は、次の5つのオプションがあります。
マップされないノードを生成しません(デフォルトの選択)。
すべてのマップされていないターゲット・ノードに空ノードを生成します。
すべてのマップされていない必須ターゲット・ノードに空ノードを生成します。
すべてのマップされていないNull値可能なターゲット・ノードに空ノードを生成します。
すべてのマップされていない必須またはNull値可能なターゲット・ノードに空ノードを生成します。
これらのオプションは、次のように設定します。
グローバル・レベルの場合
「ツール」→「プリファレンス」→「XSLマップ」の順に選択します。グローバル設定はマップが作成された場合のみ適用されます。
マップ・レベルの場合
マップのコンテキスト・メニューから「XSL生成オプション」を選択します。次に、マップ・レベルでオプションを設定することで、各マップを別々に設定できます。
選択したマップされないノードに対して空の要素が生成されます。マップされないノードがnillableの場合は、xsi:nil="true"で生成されます。
ソース・スキーマまたはターゲット・スキーマで見つからない要素が、XSLTマッパーによってXSLT文書内で検出された場合、その要素は処理されず、「無効なソース・ノード・パス({0})」エラーが表示されます。XSLマップの生成は失敗します。XSLTの解析中に、これら特定の要素を無視し、保存しておくようにXSLTマッパーに指示するファイルを作成およびインポートできます。これを行うには、Oracle JDeveloperの「ツール」メイン・メニューで「プリファレンス」→「XSLマップ」の順に選択します。
たとえば、事前処理によってmyElementおよびmyOtherElementWithNSという要素が作成される場合があり、これらの要素は、XSLT文書のグラフィカル表示の作成時に、XSLTマッパーによって無視されるようにするとします。無視するこれらの要素を使用し、例38-10に示す構文を記述したファイルを作成してインポートします。
例38-10 無視する要素を使用したファイル
<elements-to-ignore> <element name="myElement"/> <element name="myOtherElementWithNS" namespace="NS"/> </elements-to-ignore>
このファイルをインポートした後は、Oracle JDeveloperを再起動する必要があります。
XSLTマッパーに現在表示されているマップ・ソース・スキーマとターゲット・スキーマは置換できます。
XSLTマッパーでスキーマを置換する手順は、次のとおりです。
ソース・パネルまたはターゲット・パネルのいずれかで右クリックし、「スキーマの置換え」を選択します。
図38-40に示すように、「タイプ・チューザ」ダイアログが開き、使用する新しいソース・スキーマまたはターゲット・スキーマを選択できます。
置換スキーマを選択して「OK」をクリックします。
現在のマップの式を消去するかどうかを選択するプロンプトが表示されます。
「はい」または「いいえ」を選択します。式が消去されない場合は、設計ビューを再度表示する前にソース・ビューのマップを修正する必要がある場合があります。
ソース・ツリーとターゲット・ツリーの要素とタイプは置換できます。
要素置換は、次の場合に使用します。
要素が、基礎となるスキーマ内の置換グループの先頭として定義されている場合。要素は抽象でも抽象でなくてもかまいません。置換グループの任意の要素を元の要素と置換できます。
要素がany要素として定義されている場合。スキーマに定義されているすべてのグローバル要素を置換できます。
タイプ置換は、次の場合に使用します。
基礎となるスキーマでグローバル・タイプを使用でき、そのタイプがソース・ツリーまたはターゲット・ツリーの要素のタイプから導出されている場合。この場合は、グローバル・タイプを要素の元のタイプと置換できます。抽象タイプから導出された任意のタイプをその抽象タイプと置換できます。
ソース・ツリーまたはターゲット・ツリーの要素がanyTypeタイプとして定義されている場合。この場合は、スキーマに定義されている任意のグローバル・タイプを置換できます。
タイプ置換は、XMLのxsi:type属性の使用によってサポートされます。
ソース・ツリーとターゲット・ツリーの要素またはタイプを置換する手順は、次のとおりです。
ソース・ツリーまたはターゲット・ツリーで、置換を適用する要素を右クリックします。
コンテキスト・メニューから「要素またはタイプの置換」を選択します。このオプションが無効な場合、基礎となるスキーマの要素またはそのタイプに対して可能な置換はありません。
図38-41に示す「要素またはタイプの置換」ダイアログが表示されます。
要素の置換またはタイプの置換のいずれかを選択します(基礎となるスキーマによっては1つしか使用できない場合があります)。
置換可能なグローバル・タイプまたは要素のリストがダイアログに表示されます。
置換するタイプまたは要素を選択します。
「OK」をクリックします。
要素またはタイプが、最初に選択した要素と置換されます。この選択によって表示される結果は、この置換がタイプ置換と要素置換のいずれであるか、および対象がソース・ツリーまたはターゲット・ツリーのいずれであるかによって異なります。
要素がターゲット・ツリーにあり、タイプ置換が選択された場合
図38-42に示すように、元の要素の下にxsi:type属性が追加されます。これは設計ビューでは使用できず、選択されたタイプ値に設定されます。ノードが置換されたことを示す「S」アイコンが表示されます。置換タイプ内の任意の構造要素にマップできます。
要素がソース・ツリーにあり、タイプ置換が選択された場合
図38-43に示すように、元の要素の下にxsi:type属性が追加されます。ノードが置換されたことを示す「S」アイコンが表示されます。置換タイプ内の任意の構造要素からマップできます。
要素がターゲット・ツリーにあり、要素置換が選択された場合
図38-44に示すように、ツリー内の元の要素が置換要素で置換されます。コメントは元の要素名が追加されたことを示し、ノードが置換されたことを示す「S」アイコンが表示されます。置換要素内の任意の構造要素にマップできます。
要素がソース・ツリーにあり、要素置換が選択された場合
図38-45に示すように、ソース・ツリーの<要素置換>という新規ノードの下に、元の要素と可能な置換の両方が表示されます。ノードが追加されたことを示す「S」アイコンが表示されます。この機能を使用すると、ソース・オブジェクトに元のノードまたは置換ノードのいずれかを格納できるマップを作成できます。置換要素内の任意の構造要素にマップできます。
|
注意: 要素置換と異なり、ソース・ツリーに表示できるタイプ置換は一度に1つのみです。このために、元のタイプや置換タイプを必要に応じてソースに設定できるマップが作成できなくなるわけではありません。いつでも別のタイプに切り替えることができます。ある時点ではソース・ツリーに表示されない可能性があるノードにマップするXPath式も保持されます。 |
置換ノードを削除するには、「S」アイコンがあるノードを右クリックし、コンテキスト・メニューから「置換の削除」を選択します。
置換が可能なすべてのノードを表示するには、ソース・ツリーまたはターゲット・ツリーを右クリックして、「置換ノード・アイコンの表示」を選択します。
図38-46に示すように、置換が可能なすべてのノードには、「*」アイコンが表示されます。
アイコンを非表示にするには、右クリックして「置換ノード・アイコンの非表示」を選択します。
XSLTマッパーには、スタイルシートまたはマップをテストするためのテスト・ツールが用意されています。テスト・ツールを起動するには、図38-47に示すように、「テスト」メニュー項目を選択します。
図38-48に示す「XSLマップのテスト」ダイアログでは、XSLTマッパーで設計したトランスフォーメーション・マッピングのロジックをテストできます。指定したテスト設定は保存されるため、次回のテスト時に再度入力する必要はありません。Oracle JDeveloperを閉じて再度開いた場合は、テスト設定をもう一度入力する必要があります。
トランスフォーメーション・マッピングのロジックをテストする手順は、次のとおりです。
「ソースXMLファイル」フィールドで、テスト用にサンプルのソースXMLファイルを生成するか、「参照」をクリックして別のソースXMLファイルを指定します。
「OK」をクリックすると、ソースXMLファイルが検証されます。検証に合格するとトランスフォーメーションが実行され、ターゲットXMLファイルが作成されます。
検証に失敗した場合、トランスフォーメーションは実行されず、画面にメッセージが表示されます。
マップ・ソースXSDスキーマに基づいてサンプルのXMLファイルを作成するには、「ソースXMLファイルの生成」チェック・ボックスを選択します。
テスト用のソースXMLファイルを表示するには、「ソースXMLファイルの表示」チェック・ボックスを選択します。ソースXMLファイルがOracle JDeveloperのXMLエディタに表示されます。
マップに定義済のパラメータがある場合は、「スキーマのあるパラメータ」または「スキーマのないパラメータ」表が表示されます。
「スキーマのあるパラメータ」表が表示された場合は、「参照」ボタンを使用してそのパラメータの入力XMLファイルを指定できます。ファイルを生成する場合は「ファイルの生成」チェック・ボックスを選択します。
「スキーマのないパラメータ」表が表示された場合は、「値の指定」チェック・ボックスを選択し、「タイプ」列と「値」列を適切に編集して値を指定します。
「ターゲットXMLファイル」フィールドにファイル名を入力するか、トランスフォーメーションからの結果XML文書が格納されるファイルの名前を参照します。
テスト用のターゲットXMLファイルを表示するには、「ターゲットXMLファイルの表示」チェック・ボックスを選択します。ターゲットXMLファイルがOracle JDeveloperのXMLエディタに表示されます。
ソースとターゲット両方のXMLを表示する場合は、XMLエディタのレイアウトをカスタマイズできます。右上隅にある「自動レイアウトの有効化」を選択してパターンの1つをクリックします。
「OK」をクリックします。
図38-49に示すように、テスト結果が表示されます。
この例では、ソースXMLとターゲットXMLが並んで表示され、その下にXSLマップが表示されています(デフォルト設定)。「スキーマのあるパラメータ」表に対応する追加のソースXMLファイルが、メイン・ソース・ファイルと同じ場所にタブとして表示されます。エディタを右クリックして「XMLの検証」を選択すると、ソースまたはターゲットのXMLを、マップのソースまたはターゲットのXSDスキーマと照合して検証できます。
|
注意: XSLマップ・ファイルにドメイン値マップ(DVM)および相互参照(XREF) XPath関数が含まれている場合は、テストできません。これらの関数は、設計時には実行できず、実行時にのみ実行できます。 |
次の情報を備えたHTMLレポートを生成できます。
XSLマップのファイル名、ソース・スキーマとターゲット・スキーマのファイル名、そのルート要素名、およびそのルート要素のネームスペース
ターゲット文書のマッピング
マップされていないターゲット・フィールド(必須フィールドを含む)
サンプル・トランスフォーメーション・マップの実行
次の手順に従って、レポートを生成します。
中央のパネルで右クリックして、「レポートの生成」を選択します。
図38-50に示すように、「レポートの生成」ダイアログが表示されます。マップのパラメータが定義されている場合は、適切なパラメータ表が表示されることに注意してください。
フィールドの詳細は、「レポートの生成」ダイアログのオンライン・ヘルプを参照してください。
レポートを生成しようとしたときにメモリー不足のエラーが発生した場合は、次のように、JVMのヒープ・サイズを増やします。
JVMのヒープ・サイズを増やす手順は、次のとおりです。
JDev_Oracle_Home\jdev\bin\jdev.confファイルを開きます。
次のセクションに移動します。
# Set the maximum heap to 512M # AddVMOption -Xmx512M
次のように、ヒープのサイズを増やします(例: 1024に変更)。
AddVMOption -Xmx1024M
また、レポートの生成前に「レポートの生成」ダイアログの「レポートを開く」オプションの選択を解除することもできます。
サンプルXMLの生成は、次のパラメータを指定してカスタマイズできます。Oracle JDeveloperの「ツール」メイン・メニューで、「プリファレンス」→「XSLマップ」の順に選択し、「プリファレンス」ダイアログを表示します。
この数は、要素の属性maxOccursが1より大きい値に設定されている場合に、要素の繰返し作成数を指定します。指定した値が特定の要素に対するmaxOccurs属性の値より大きい場合、その特定の要素に対する繰返し作成数は、指定した数ではなく、このmaxOccursの値となります。
選択されている場合は、オプション要素(その属性minOccursが値0に設定されている)が必須要素(その属性minOccursが0より大きい値に設定されている)と同様に生成されます。
サンプルXMLの生成において、オプション要素による再帰の発生を回避するために、オプション要素の生成限度であるXML文書階層ツリーの最大の深さを指定します。
このサンプルでは、XSLTマッパーの次の機能について具体的な例を示します。
要素置換とタイプ置換
複数ソースの使用
新規XSLコンストラクトxsl:sortおよびxsl:copy-of
新規変数の使用
このサンプルに加えて、Oracle Technology Network(OTN)からダウンロード可能な他のトランスフォーメーション・サンプルがあります。表38-2で、これらのサンプルについて説明します。これらのサンプルにアクセスするには、次のURLを参照してください。
https://soasamples.samplecode.oracle.com/
表38-2 トランスフォーメーション・サンプル
| サンプル | 説明 |
|---|---|
|
mapper-101-basic-mapping |
XSLTマップの作成および基本的な編集方法を説明します。 |
|
mapper-102-import-and-test |
次のXSLマッパー機能について説明します。
|
|
mapper-104-auto-mapping |
XSLTマッパーの自動マッピング機能について説明します。 |
|
mapper-105-multiple-sources |
複数ソースの使用について説明します。マップ・サンプルの作成プロセスで、次のトピックについても説明します。
|
|
mapper-107-extension-functions |
ユーザー定義拡張関数の使用について説明します。 |
|
mapper-108-substitution-mapping |
次の場合の要素置換の使用について説明します。
|
|
mapper-109-whats-new |
XSLTマッパーの11gの新機能について説明します。これらの機能は、第38.5.1項「アプリケーションのオープン」から第38.5.7項「マップのテスト」で説明します。 |
最初にサンプル・アプリケーションを作成します。作成したアプリケーションは、ステップ1で説明するWhatsNewApplicationディレクトリで提供されるアプリケーションと同じです。
サンプルmapper-109-whats-newをOTNからダウンロードします。
サンプルには、次のファイルとディレクトリが含まれています。
artifacts/schemas/po.xsdおよびAttachment.xsd: ソース・スキーマ
artifacts/schemas/invoice.xsdおよびReasonCodes.xsd: ターゲット・スキーマ
artifacts/application: このサンプルの開始アプリケーション
WhatsNewApplicationディレクトリ: 完了後のサンプル・マップ
artifacts/applicationフォルダを別の作業領域にコピーします。
Oracle JDeveloperを起動します。
別の領域にコピーしたartifacts/applicationフォルダ内のWhatsNewApplication.jwsをクリックします。
ファイルを移行するかどうかを尋ねるプロンプトが表示された場合は、「はい」をクリックします。
「アプリケーション・ナビゲータ」に、WhatsNewApplicationが表示されます。
ここでは、2つのソースがある新規XSLTマップを作成します。このマップは、WhatsNewApplicationアプリケーションに含まれているBPELプロセスから起動されます。
「アプリケーション・ナビゲータ」で、ProcessPO2Invoice.bpel BPELプロセスをダブルクリックします。
「コンポーネント・パレット」の「Oracle Extensions」セクションから、transformアクティビティをSetDiscontinuedProducts assignアクティビティの下にドラッグします。
transformアクティビティをダブルクリックします。
「一般」タブの「名前」フィールドにPo2Invoiceと入力します。
「トランスフォーメーション」タブで、次の手順を実行します。
「追加」アイコンをクリックします。
「ソース変数」リストから、「inputVariable」を選択します。
「ソース・パート」リストから、「payload」を選択します。
この変数には、BPELプロセスに対する入力である注文書が含まれています。
「OK」をクリックします。
「追加」アイコンを2回クリックし、「ソース変数」リストから「DiscontinuedList」を選択します。transformationアクティビティの前のSetDiscontinuedProducts assignアクティビティに変数が作成されます。
「OK」をクリックします。
「ターゲット変数」リストから、「outputVariable」を選択します。これは、BPELプロセスから戻された請求書です。
「マッパー・ファイル」フィールドで、名前をxsl/Po2Invoiceに変更します。
マッパー名フィールドの右側にある「マッピングの作成」アイコンをクリックして、マッパー・ファイルを作成し、開きます。
XSLTマッパーが開きます。
「ファイル」メニューから「すべて保存」をクリックします。作成したマップは図38-51のようになります。2番目のソースがDiscontinuedListという名前でパラメータとしてロードされていることに注意してください。
ここでは、タイプ置換と要素置換を使用して、注文書の品目を請求書の品目にマップします。
ターゲット・ツリーで、ツリーを開いてInvoice/Items/Itemを表示します。「Item」要素の横にエラー・アイコンが表示されていることに注意してください。
要素の上にマウスを移動して、この要素が抽象タイプとして定義されていることを示すツールのヒントを表示します。
Item要素にマップするには、最初に、最終的なXML出力で要素に使用されるタイプを示す必要があります。
次の手順を実行して、要素で使用するタイプを示します。
「Item」要素を右クリックして、「要素またはタイプの置換」を選択します。
「要素またはタイプの置換」ダイアログが表示されます。
リストから「ShippedItemType」を選択して「OK」をクリックします。
Item要素の構造がすべて挿入されます。xsi:type属性によって、ターゲットXMLのItem要素のタイプが設定されます。
|
注意: invoice.xsdを表示した場合は、ShippedItemTypeが、Item要素のタイプである抽象タイプItemTypeから導出されていることに注意してください。 |
PurchaseOrder/ItemsをInvoice/Itemsにドラッグして自動マッパーを起動し、これらのノードをマップします。自動マッピング機能を確認するには、サンプルのmapper-104-auto-mappingを参照してください。
完了すると、マップ内のItem要素は、図38-52のようになります。
「ファイル」メニューから「すべて保存」を選択して、マップ・ファイルを保存します。
ここでは、追加のソース変数であるDiscontinuedListの情報を使用して、製造が中止された品目を削除します。品目の製品名がDiscontinuedListに含まれている場合、その品目は出荷できず、最終出荷品目リストに掲載することはできません。
ターゲット・ツリーの「Item」ノードの上に「if」文を追加します。追加するには、「Item」ノードを右クリックして、「XSLノードの追加」→「if」の順に選択します。
if文では、現在の品目名を使用して、製造中止の製品が「DiscontinuedList」に存在しているかどうかをテストする必要があります。品目が出荷品目に追加されるのは、その品目が「DiscontinuedList」に含まれていない場合のみです。if文に対するテスト式を定義する方法は多数あります。その中の1つの方法を次の手順で説明します。
次のように選択してif文のテスト式を定義します(変数の設定方法が、以前のバージョンのOracle JDeveloperから変更されていることに注意してください)。
「Invoice」ノードを右クリックして「変数の追加」を選択し、ターゲット・ツリーにグローバル変数を追加します。
「変数の追加」ダイアログが表示されます。
「ローカル名」フィールドに、DelimitedListと入力します。以降の手順で、この変数には、製造中止製品名の区切りリストを含む文字列が設定されます。
「OK」をクリックします。
変数が追加され、横に警告アイコンが表示されます。
変数の値を設定するには、「コンポーネント・パレット」の「String」セクションから「create-delimited-string」関数を中央のパネルにドラッグします。
DiscontinuedList/ProductNameを「create-delimited-string」関数の入力側にドラッグします。
「create-delimited-string」関数の出力側を「DelimitedList」という新規変数にドラッグします。
「create-delimited-string」関数をダブルクリックして、「関数の編集」ダイアログを開きます。
「デリミタ」フィールドに、パイプ(|)文字を追加します。
「OK」をクリックします。
入力ソースは、XPath式では$DiscontinuedListで参照されることに注意してください。このソースは、XPath式で入力パラメータとして参照されます。
if文のXPath式を設定するには、「コンポーネント・パレット」の「String」セクションから「contains」関数を中央のパネルにドラッグします。
「コンポーネント・パレット」の「Logical Functions」セクションの「not」関数を、ステップ3で追加した「contains」関数を囲む影付きの領域にドラッグします。
「contains」関数の出力側の線を「not」関数の入力側にドラッグします。
「not」関数の出力側の線を「if」文にドラッグします。
「contains」関数をダブルクリックして、「関数の編集」ダイアログを開きます。
「inputString」および「searchString」に値を入力し、「OK」をクリックします。
「ファイル」メニューから「すべて保存」を選択して、マップ・ファイルを保存します。
マップ・ファイルは図38-53のようになります。
ここでは、ソースの置換された出荷連絡先要素をターゲットのShippedTo要素にマップします。
ソースのPurchaseOrder/CustomerContacts要素を開いて「Contact」要素を表示します。
この要素の横にエラー・アイコンが表示されていることに注意してください。
要素の上にマウスを置き、この要素が抽象であることを示すツールのヒントを表示します。
この状態で、要素置換を実行して要素をマップする必要があります。
ソース・ツリーの「Contact」要素を右クリックして、「要素またはタイプの置換」を選択します。
「要素またはタイプの置換」ダイアログが表示され、抽象要素Contactの置換グループの要素リストが示されます。
「ShipToContact」を選択し、「OK」をクリックします。
これは、入力XMLに使用する要素です。ソース・ツリーに「ShipToContact」要素の構造が表示されます。
ソース・ツリーのShipToContact/InternationalAddress要素を開いて、住所のフィールドを表示します。
ターゲット・ツリーの「ShippedTo」要素を開いて、ターゲットの住所のフィールドを表示します。
ここでは、自動マッパーを使用できることを示すフィールド名の類似度に注意してください。
ソース・ツリーの「InternationalAddress」要素をターゲット・ツリーの「ShippedTo」要素にドラッグし、自動マッパーを使用して、これらの要素の下の住所フィールドをマップします。
マップのこのセクションが図38-54に示すとおりになるように、自動マッパーで照合されない残りの要素をマップします。
「ファイル」メニューから「すべて保存」を選択して、マップ・ファイルを保存します。
PurchaseOrder/IDをInvoice/IDにマップします。
Invoice/Dataを開いて「any」要素を表示します。
copy-of xsl文を使用して、ソースからターゲットの「any」要素に添付ファイル・データをコピーします。
Invoice/Data/any要素を右クリックして、「XSLノードの追加」→「copy-of」の順に選択します。
copy-of文が追加され、元の「any」要素はグレー表示になります。これは、この要素がcopy-of文で選択されたノードで置換されることを示します。
copy-ofの選択内容を設定するには、ソース・ツリーのPurchaseOrder/Attachments要素を「copy-of」文にドラッグします。
次の手順を実行して、PurchaseOrder/CommentフィールドをInvoice/Commentフィールドにマップします。Invoice/CommentフィールドがanyType要素であることに注意してください。
Invoice/Commentフィールドを右クリックして、「要素またはタイプの置換」を選択します。
提供されているタイプ・リストから「xsd:string」を選択します。
PurchaseOrder/CommentフィールドをInvoice/Commentフィールドにドラッグしてフィールドをマップします。
XSL sort文をfor-each文に追加します。
ターゲット・ツリーの「for-each」文を右クリックして、「XSLノードの追加」→「sort」の順に選択します。
「ソート編集ダイアログ」が表示されます。
「データ型に従ってソート」で「数値」を選択します。
ソート順で「降順」を選択します。
「OK」をクリックします。sortノードがターゲット・ツリーに追加されます。
ソース・ツリーのPurchaseOrder/Items/Item/Priceをターゲット・ツリーの「sort」ノードにドラッグします。
この操作で、ソート対象のフィールドが設定されます。
「ファイル」メニューから「すべて保存」を選択して、マップ・ファイルを保存します。マップは図38-55のようになります。
XSLマップは、XSLTマッパーを使用して、Oracle JDeveloperのBPELプロセスとは別にテストできます。XMLファイルはマップに対する各ソース入力の入力にできます。
中央のパネルを右クリックし、「テスト」を選択します。
警告ダイアログが表示された後、「XSLマップのテスト」ダイアログが表示されます。警告では、独自のサンプル入力XMLを作成してマップをテストできることが通知されます。サンプルXMLジェネレータでは、ソース・ツリーの置換に対するサンプル・データは生成できません。
サンプル入力XMLファイルartifacts/xml/POInput.xmlが用意されています。
次の手順に従って、テスト用のサンプル入力ファイルを選択します。
「ソースXMLファイルの生成」チェック・ボックスの選択を解除します。
「ソースXMLファイル」フィールドの「参照」ボタンをクリックします。
artifacts/xml/POInput.xmlファイルに移動して選択します。
製造中止品目データが含まれた2番目のサンプル・ファイルが作成されています。このファイルはartifacts/xml/DiscontinuedItems.xmlです。
次の手順に従って、このファイルを2番目のソース入力として使用します。
ダイアログの「スキーマのあるパラメータ」セクションで、「DiscontinuedList」パラメータ名の左側にある「ファイルの生成」チェック・ボックスの選択を解除します。
「DiscontinuedList」パラメータの「参照」をクリックし、artifacts/xml/DiscontinuedItems.xmlファイルを選択します。
XSLマッパーのテスト・ダイアログで「OK」をクリックして、テストを実行します。
マップの実行によってPO2Invoice-Target.xmlファイルが生成されます。PO2Invoice-Target.xmlファイルで、xsi:type属性の使用、copy-of文で作成されたAttachmentsノード、sort文による品目の順序を確認してください。
