The Tragedy of Othello, the Moor of Venice

--- schema_version: "1" id: 3cf6bd47a3dc7f43f0ee9efdd904f2844a8c403f4df8b3d2e6e7b4605bb4d7ee title: XML Module での XPath の使用 collection: mulesoft version: current locale: ja-jp portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/xml-module/1.3/xml-xpath.md canonical_url: https://docs.mulesoft.com/jp/xml-module/1.3/xml-xpath source_site: docs.mulesoft.com content_type: documentation content_hash: 94dbddc8c629c5fd9e8471edf27785771842a2afa256319ecc63d27fc37bb605 description: MuleSoft Documentation Site release: "1.3" latest: false --- # XML Module での XPath の使用 `` 操作は、XPath 式の評価をサポートしています。 XPath 式は各要素の任意の数値に一致する可能性があるため、この操作によって文字列のリストが返されます。要素が式に一致しない場合、この操作によって空のリストが返されます。 XPath 式も名前空間に対応しているため、この操作では名前空間のマッピングを使用できます。これらのマッピングは、参照される `namespace-directory` で定義される `namespaces` とマージされます。つまり、評価では両方の名前空間のマッピングのセットが組み合わされます。 MuleSoft は XPath 標準をサポートしていますが、DataWeave でも同じユースケースを実現でき、XML ドキュメントを抽出して変換するツールとして DataWeave をお勧めします。次の例は、ウィリアム・シェイクスピアの戯曲『オセロ』の脚本を記載した XML を処理する方法を示しています。XML ファイルは次のようになります。 ```xml The Tragedy of Othello, the Moor of Venice

Text placed in the public domain by Moby Lexical Tools, 1992.

SGML markup by Jon Bosak, 1992-1994.

XML version by Jon Bosak, 1996-1998.

This work may be freely copied and distributed worldwide.

Dramatis Personae DUKE OF VENICE BRABANTIO, a senator. Other Senators. GRATIANO, brother to Brabantio. LODOVICO, kinsman to Brabantio. OTHELLO, a noble Moor in the service of the Venetian state. CASSIO, his lieutenant. IAGO, his ancient. RODERIGO, a Venetian gentleman. MONTANO, Othello's predecessor in the government of Cyprus. Clown, servant to Othello. DESDEMONA, daughter to Brabantio and wife to Othello. EMILIA, wife to Iago. BIANCA, mistress to Cassio. Sailor, Messenger, Herald, Officers, Gentlemen, Musicians, and Attendants. SCENE Venice: a Sea-port in Cyprus. OTHELLO ACT I SCENE I. Venice. A street. Enter RODERIGO and IAGO RODERIGO Tush! never tell me; I take it much unkindly That thou, Iago, who hast had my purse As if the strings were thine, shouldst know of this. ..... ``` 全文が上記の形式のテキストがあるとします。次のスクリプトを使用して、「`handkerchief`」という単語が含まれるすべての行を抽出できます。 XPath スクリプト ```xml (1) #[{'word': 'handkerchief'}] (2) ```

1	`$` プレフィックスを使用してコンテキストプロパティを参照する XPath 式を提供します。
2	`context-properties` パラメーターで DataWeave を使用してコンテキストプロパティを生成します。

上記の XPath スクリプトにより、次の文字列のリストが出力されます。各 `LINE` はリストの異なる項目です。出力 ```xml For the same handkerchief? What handkerchief? What handkerchief? Have you not sometimes seen a handkerchief I know not that; but such a handkerchief-- Where should I lose that handkerchief, Emilia? Lend me thy handkerchief. That handkerchief Fetch me the handkerchief: my mind misgives. The handkerchief! The handkerchief! The handkerchief! Sure, there's some wonder in this handkerchief: But if I give my wife a handkerchief,-- But, for the handkerchief,-- Boding to all--he had my handkerchief. --Handkerchief--confessions--handkerchief!--To --Is't possible?--Confess--handkerchief!--O devil!-- mean by that same handkerchief you gave me even now? By heaven, that should be my handkerchief! And did you see the handkerchief? That handkerchief which I so loved and gave thee By heaven, I saw my handkerchief in's hand. I saw the handkerchief. It was a handkerchief, an antique token O thou dull Moor! that handkerchief thou speak'st of How came you, Cassio, by that handkerchief ``` デフォルトでは、この操作はメッセージペイロードレベルで XML ドキュメントを変換しようとします。ただし、`content` パラメーターを使用して入力ドキュメントを提供できます。 ```xml

#[vars.othello]

#[{'word': 'handkerchief'}]

``` 上記の例では、他の場所 (この場合、ファイルシステムのファイル) からコンテンツを取得し、シンプルな式を使用して参照しています。 ## [](#名前空間のマッピング)名前空間のマッピング入力 XML ドキュメントに名前空間が異なる要素が含まれている場合があります。次に例を示します。 ```xml Hello! ``` 次の例では、XPath 式で使用される各 `prefix` を対応する名前空間 `uri` にマップします。 ```xml

``` しかし、同じ名前空間を使用する複数の XPath 式を実行する必要がある場合にはどうでしょうか? 毎回マッピングを実行せずに済むように、マッピングに `namespace-directory` を作成し、そのディレクトリを参照することができます。次に例を示します。 ```xml (1)

(2)(3)

```

1	`namespace-directory` 要素を使用して、プレフィックスを実際の名前空間の URI にマップします。これらのプレフィックスは入力ドキュメントのプレフィックスに一致する必要があります。
2	続いて、これらのプレフィックスを XPath 式で参照できます。
3	最後に、`namespaceDirectory` パラメーターを使用してステップ 1 で作成されたマッピングを参照します。

最後に、ユースケースを組み合わせることができます。たとえば、マッピングが含まれるグローバルな `namespaceDirectory` を用意して、操作レベルでマッピングを追加することができます。この組み合わせは、ドキュメントが多数あり、そのすべてに `soap` 名前空間が含まれているが 1 つのドキュメントにしか `mule` 名前空間が含まれていない場合に便利です。 ```xml (1)

(2) (3)

(4)

```

1	以前と同じように `namespace-directory` を宣言しますが、共通の名前空間のみを指定します。
2	XPath 式を提供します。
3	部分的な名前空間ディレクトリを参照します。
4	追加のマッピングを提供します。

マッピングと XPath 式で使用されるプレフィックスが入力ドキュメントで使用されるプレフィックスに一致することが重要です。 ## [](#関数としての-xpath-の使用)関数としての XPath の使用 XML Module は、XPath を使用して値を抽出するための DataWeave 関数を提供します。これは、`` ルーターや `` ルーターなどの場合に便利です。この関数は任意の DataWeave 変換内でも使用できます。 ## [](#foreach-での-xpath-関数の使用) での XPath 関数の使用次の例では、`` を使用して前の[オセロの行](#othello_lines)の例のすべての行を反復処理し、それらを個別に処理します。 ```xml

``` - 最初の引数は XPath 式です。 - 2 つ目の引数は入力ドキュメントで、この場合、メッセージペイロードです。 - 3 つ目の引数はコンテキストプロパティです。この場合は必要ではないため、関数は空のオブジェクトを渡します (`{}`)。 - 4 つ目の引数は**省略可能**であり、式の xpath を評価する名前空間を指定しています。 ## [](#choice-での-xpath-関数の使用) での XPath 関数の使用 [オセロの行](#othello_lines)の例に戻り、入力ドキュメントに単語 `handkerchief` が含まれない場合に何かを実行するとします。 ```xml

``` - `XmlModule::xpath` 関数はリストを返すため、前の例では DataWeave `isEmpty()` 関数を使用して出力が空かどうかをテストします。 - XPath 関数の最初に引数は、`$word` コンテキストプロパティを使用する式です。 - 2 つ目の引数は変数内の入力ドキュメントです。 - 3 つ目の引数はコンテキストプロパティ値を提供します。 - 4 つ目の引数は**省略可能**であり、式の xpath を評価する名前空間を指定しています。 ## [](#名前空間での-xpath-関数の使用)名前空間での XPath 関数の使用入力ドキュメントに XML 名前空間が含まれている場合、評価を実行するために XPath 関数にその情報が必要です。次の例では、`set-payload` コンポーネントを使用して書籍のタイトル、執筆者の名前、書籍の year タグを入力ドキュメントから取得します。このドキュメントには、明示的なデフォルトの `xmlns` 属性と、言語と執筆者に関するその他の `xmlns` 属性があります。 ```xml Fundamentals 2001 David Mills English ``` 最初の例では、書籍のタイトルを取得するために `set-payload` コンポーネントを次のように設定します。 ```xml ``` 結果の出力は `Fundamentals` です。 2 つ目の例では、執筆者の名前を取得するために `set-payload` コンポーネントを次のように設定します。 ```xml ``` 結果の出力は `David Mills` です。 3 つ目の例では、書籍の year タグを取得するために `set-payload` コンポーネントを次のように設定します。 ```xml ``` `xmlns` 属性が含まれる結果の出力は `2001` です。 ## [](#関連情報)関連情報 [XML Module の概要](https://docs.mulesoft.com/jp/xml-module/1.3/)