xpath 関数を使用して、メッセージ部分に XPath 値を割り当てたり、メッセージ部分を参照する XPath に値を割り当てたりすることができます。 メッセージおよびメッセージ部分への割り当ての詳細については、「メッセージ の構築」を参照してください。
注
xpath 関数の詳細については、XML パス言語 (XPath) に関するサード パーティのドキュメントを参照してください。
注
xpath 関数の使用は、メッセージの割り当てに限定されません。 次に例を示すように、任意の式で使用することもできます。
If ((System.Double) xpath(_RequestMessage.part, "number(//book[last()]/price)") == 75.00 && (System.Boolean) xpath(msgBoolean, "string(//boolean)") == false)...
注
文字列に値を割り当てる場合は、XPath string() 関数を使用します。 例えば次が挙げられます。
myString = xpath(msg, "string(/*/book[1]/title)");
注
エンジンはスキーマ対応ではないため、値の読み取りまたは書き込みは、包含メッセージ内に存在するノード (完全なパスが存在する必要があります) からのみ、またはエンジンによって例外が発生します。 これは、既定値を指定した場合でも当てはまります。
メッセージ パーツ内の XPath に割り当てる
次のスキーマについて考えてみましょう。
<?xml version="1.0" encoding="utf-16"?>
<xs:schema xmlns:b="http://schemas.microsoft.com/BizTalk/2003" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="catalog">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="unbounded" name="book">
<xs:complexType>
<xs:sequence>
<xs:element name="title" type="xs:string" />
<xs:element name="author">
<xs:complexType>
<xs:sequence>
<xs:element name="FirstName" type="xs:string" />
<xs:element name="LastName" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="price" type="xs:string" />
</xs:sequence>
<xs:attribute name="country" type="xs:string" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
次のように関数を使用して、そのスキーマ型のドキュメント インスタンスに値を設定できます。
//assumes that a message named _ResponseMessage is already constructed
_ResponseMessage.part = _RequestMessage.part;
xpath(_ResponseMessage.part, "/*/book[1]/@country") = "USA";
xpath(_ResponseMessage.part, "/*/book[1]/title") = "Legends";
xpath(_ResponseMessage.part, "/*/book[1]/author/FirstName") = "A";
xpath(_ResponseMessage.part, "/*/book[1]/author/LastName") = "B";
xpath(_ResponseMessage.part, "/*/book[1]/price") = 50;
XPath からのメッセージ パーツへの割り当て
//assumes that a message named objMessage is already constructed
objMessage.BooleanPart = xpath("false()");
objMessage.IntPart = xpath("100");
objMessage.StringPart = xpath("'Hello'");
objMessage.StringPart2 = xpath("'World'");
XPath を使用してノードとノード セットから割り当てる
XPath を使用して、XML ノードとノード セットを XML 要素、クラス、またはスキーマベースまたはクラスベースのメッセージに割り当てることもできます。
Book という XML シリアル化可能なクラスがあり、次の例を考えてみましょう。
[Serializable]
Class Book {...}
例 1 — カタログから 4 番目の book 要素を選択し、それを XML 要素変数に割り当てます。
myXmlElement = xpath(myMsg, "/catalog/book[3]");
例 2 — カタログから 4 番目の book 要素を選択し、XML 逆シリアル化を使用して Book クラス インスタンスに変換します。
myBook = xpath(myMsg, "/catalog/book[3]");
例 3 — カタログから 4 番目の book 要素を選択し、Book 型のメッセージに変換します。
myBookMsg = xpath(myMsg, "/catalog/book[3]");
例 4 — カタログ内のすべての book 要素を選択します。MyMethod は XmlNodeSet をパラメーターとして受け取ります。
MyMethod(xpath(myMsg, "/catalog/book"));
例 5 - "BookOfTheMonth" コンテナーに book 要素を追加します。
xpath(MyMsg2, "/RecommendedBooks/BookOfTheMonth") = myBook;
例 6 - 20 以下の価格のすべての書籍を、推奨される書籍のセットに追加します。
xpath(MyMsg2, "/RecommendedBooks/BestPriceBooks") = xpath(MyMsg, "/catalog/book[@price <= 20]");
例 7 - XML 要素を返すユーザー コードを呼び出します。
xpath(MyMsg2, "/RecommendedBooks/AdvertisedByPartner") = GetPartnerAdvertisedBook();
例 5 と 7 を適用する前に、
<RecommendedBooks>
<BookOfTheMonth/>
<BestPriceBooks/>
<AdvertisedByPartner/>
</RecommendedBooks>
例 5 と 7 を適用した後:
<RecommendedBooks>
<BookOfTheMonth>
<Book country="USA">
<title>McSharry</title>
<author>
<FirstName>Nancy</FirstName>
<LastName>Jensen</LastName>
</author>
</Book>
</BookOfTheMonth>
<BestPriceBooks/>
<AdvertisedByPartner>
<Book country="USA">
<title>The Rooster</title>
<author>
<FirstName>Mindy</FirstName>
<LastName>Martin</LastName>
</author>
</Book>
</AdvertisedByPartner>
</RecommendedBooks>