--- schema_version: "1" id: 2c4626c9a6bf1f67100306f9a854e18d71f18a1d295dc9eeecad6d4f3c4536dd title: Parse Template リファレンス collection: mulesoft version: current locale: ja-jp portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/mule-runtime/4.9/parse-template-reference.md canonical_url: https://docs.mulesoft.com/jp/mule-runtime/4.9/parse-template-reference source_site: docs.mulesoft.com content_type: documentation content_hash: 5439d148fb0cbb4ed75ad2c434756343198d282663b6807a87bd2b38f83abaed description: MuleSoft Documentation Site release: "4.9" latest: false --- # Parse Template リファレンス Parse Template はテンプレートを処理して結果を得るために使用する Mule コンポーネントです。テンプレートはテキストとして定義され、埋め込まれた Mule 式は評価され、結果に置き換えられます。外部ファイル参照を使用してテンプレートを設定することも、コンポーネント定義自体に埋め込むこともできます。 [例](#code_example) ## [](#parse-template-の設定)Parse Template の設定 1. Studio で、Parse Template メッセージプロセッサーをパレットからキャンバスまでドラッグします。 2. この表で説明している項目を設定します。 ![エラーメッセージが表示されている Parse Template](/mulesoft/current/ja-jp/mule-runtime/4.9/_images/parse.png)

項目	値	説明
Content (コンテンツ)	テンプレート文字列	テンプレートとして使用する文字列。外部ファイルでテンプレートを定義する代わりに、この項目を使用してインラインで記述できます。評価され、結果に置き換えられる式を埋め込むことができます。
Display Name (表示名)	Parse Template	アプリケーションのトランスフォーマーの一意な名前を表示するためにカスタマイズします。
Location (場所)	ファイルパス	メッセージプロパティまたは変数から抽出された値を挿入するテンプレートとして Mule が使用するファイルの場所を定義します。
Target Variable (対象変数)	変数名	[Target Value (対象値)] で定義された式を評価した結果を保存する変数の名前。
Target Value (対象値)	式	Parse Template の実行後に評価される Mule 式。この式の結果は、[Target Variable (対象変数)] 項目で定義された名前の変数に保存されます。

項目

値

説明

Content (コンテンツ)

テンプレート文字列

テンプレートとして使用する文字列。外部ファイルでテンプレートを定義する代わりに、この項目を使用してインラインで記述できます。評価され、結果に置き換えられる式を埋め込むことができます。

Display Name (表示名)

Parse Template

アプリケーションのトランスフォーマーの一意な名前を表示するためにカスタマイズします。

Location (場所)

ファイルパス

メッセージプロパティまたは変数から抽出された値を挿入するテンプレートとして Mule が使用するファイルの場所を定義します。

Target Variable (対象変数)

変数名

[Target Value (対象値)] で定義された式を評価した結果を保存する変数の名前。

Target Value (対象値)

式

Parse Template の実行後に評価される Mule 式。この式の結果は、[Target Variable (対象変数)] 項目で定義された名前の変数に保存されます。

Studio または Standalone Mule インスタンスで XML エディターを使用している場合: - `parse-template` 要素をフローに追加してから、下の表に従って設定します。 ```xml ``` `parse-template` 要素の属性:

要素属性値

要素属性	値
`content`	使用するテンプレートを表す文字列であり、このテンプレートでは埋め込まれた式が評価され、その結果に置き換えられます。
`location`	メッセージプロパティまたは変数から抽出された値を挿入するテンプレートとして Mule が使用するファイルの場所を定義するファイルパス。
`doc:name`	アプリケーションのトランスフォーマーの一意な名前を表示するためにカスタマイズします。(注意: Mule スタンドアロンでは不要)。
`target`	Parse Template が実行された後に `targetValue` で定義された式の結果が保存される変数の名前。
`targetValue`	Parse Template が実行された後に評価され、結果が `target` 属性で定義された名前の変数に保存される Mule 式。

content

使用するテンプレートを表す文字列であり、このテンプレートでは埋め込まれた式が評価され、その結果に置き換えられます。

location

メッセージプロパティまたは変数から抽出された値を挿入するテンプレートとして Mule が使用するファイルの場所を定義するファイルパス。

doc:name

アプリケーションのトランスフォーマーの一意な名前を表示するためにカスタマイズします。(注意: Mule スタンドアロンでは不要)。

target

Parse Template が実行された後に targetValue で定義された式の結果が保存される変数の名前。

targetValue

Parse Template が実行された後に評価され、結果が target 属性で定義された名前の変数に保存される Mule 式。

## [](#code_example)例この例では、Parse Template を使用してデータを HTML に動的に読み込みます。 - [データベースクエリの結果の動的処理](#ex_1) - [HTML 行でのデータの動的な生成](#ex_2) ### [](#ex_1)データベースクエリの結果の動的処理この例では、データベースから従業員データを HTML テンプレートに読み込む Mule アプリケーションで Parse Template を使用します。フローは、テンプレートで構築された出力をコール元に返します。 ![Parse Template を使用した Listener から Error handling へのステップが表示されているフロー](/mulesoft/current/ja-jp/mule-runtime/4.9/_images/parse-template-flow.png) #### [](#parse-template-への入力)Parse Template への入力 `http://localhost:8081/getEmployee?id=1234` など、従業員の ID を識別するクエリパラメーターを含む URI でフローを開始し、Select 操作で次の入力を Parse Template に返すとします。 ```html { "first_name": "Melba", "last_name": "Roy Mouton", "department": "Computers", "job_title": "Assistant Chief of Research Programs", "start_date": "01/01/2021", "employee_type": "mathematician" } ``` #### [](#template)テンプレートコンテンツテンプレートでは、名前、部門、役職、開始日、および従業員種別の各値を含む項目を入力ペイロードから選択します。 ```html

First Name	Last Name	Department	Job Title	Start Date	Employee Type
#[payload['first_name']]	#[payload['last_name']]	#[payload['department']]	#[payload['job_title']]	#[payload['start_date']]	#[payload['employee_type']]

``` #### [](#configuration-xml-設定-xml)Configuration XML (設定 XML) この例の Mule 設定 XML では、Parse Template で設定 `location="src/main/resources/responseHtml.template"` を使用してテンプレートファイルを読み込みます。 ```xml

SELECT * FROM Employees WHERE id=#[attributes.queryParams['id']]

``` #### [](#テンプレートの出力)テンプレートの出力この[例](#template)では、テンプレートで構築された出力が返されます。出力は、選択された従業員データを含む HTML です。 ```xml

First Name	Last Name	Department	Job Title	Start Date	Employee Type
"Melba"	"Roy Mouton"	"Computers"	"Assistant Chief of Research Programs"	"01/01/2021"	"mathematician"

``` ### [](#ex_2)HTML 行でのデータの動的な生成この例では、オブジェクトの配列として表される従業員レコードで Parse Template を使用します。 ![Listener、Set Payload、Parse Template、Logger が含まれるフロー](/mulesoft/current/ja-jp/mule-runtime/4.9/_images/parse-template-flow2.png) #### [](#parse-template-への入力-2)Parse Template への入力 Parse Template コンポーネントは Set Payload から次のペイロードを受け取るとします。 ```html { Employee: [ { "first_name" : "Melba", "last_name" : "Roy Mouton", "department" : "Computers", "job_title" : "Assistant Chief of Research Programs", "start_date" : "01/01/2021", "employee_type" : "mathematician" }, { "first_name" : "Annie", "last_name" : "Easley", "department" : "Software Development", "job_title" : "Technical Lead", "start_date" : "06/02/2020", "employee_type" : "Rocket Scientist" } ] } ``` #### [](#template2)テンプレートコンテンツ次のテンプレートでは、DataWeave スクリプトを使用して入力配列を反復処理し、配列内のオブジェクトごとに HTML 行を作成します。 ```html #[%dw 2.0 output application/java --- payload.*Employee[0] map ((item) -> "") joinBy ""]

First Name	Last Name	Department	Job Title	Start Date	Employee Type
" ++ (item.first_name default "") ++ "	" ++ (item.last_name default "") ++ "	" ++ (item.department default "") ++ "	" ++ (item.job_title default "") ++ "	" ++ (item.start_date default "") ++ "	" ++ (item.employee_type default "") ++ "

``` #### [](#configuration-xml-設定-xml-2)Configuration XML (設定 XML) Mule 設定 XML では、Parse Template で設定 `location="/path/to/my.template"` を使用してテンプレートファイルを読み込みます。 ```xml

``` #### [](#テンプレートの出力-2)テンプレートの出力この[例](#template2)では、テンプレートで構築された出力が返されます。出力は、動的に作成された行と、配列内のオブジェクトのデータを含む HTML です。 ```xml

First Name	Last Name	Department	Job Title	Start Date	Employee Type
Melba	Roy Mouton	Computers	Assistant Chief of Research Programs	01/01/2021	mathematician
Annie	Easley	Software Development	Technical Lead	06/02/2020	Rocket Scientist

``` ## [](#特殊文字)特殊文字 Parse Template は、テンプレート内での式の使用や、これらの式でのリテラルの使用をサポートします。テンプレートは、`\#[` といったシーケンスや引用符など、一部の特殊文字を認識します。これらの文字をエスケープすることで通常の文字として扱うことができます。 - `#[an-expression]`: テンプレート内では `#[]` を使用して式を指定します。たとえば、テンプレートの HTML 要素内で `#[upper("mulesoft")]` という式を指定すると `MULESOFT` に解決されます。空白の式 (`#[]`) はエラーとなりますが、`#['']` や `#[""]` などの空白文字列は有効な式です。 - サブ式: 引用符で囲まれたサブ式を解決するには、サブ式を別の `#[]` で囲みます。たとえば、次のテンプレートスニペットでは、4 つの要素で同じサブ式 (`upper("world")`) が引用符の内部または外部に指定されています。最初の 2 つは同じ結果を返します。最後の 2 つは、サブ式が引用符内に指定されていますが、別の `#[]` で囲まれていないため、`upper("world")` を処理せずにそのまま返します。 Parse Template スニペット: ```XML #['hello #[upper("world")]'] #['hello ' ++ upper("world")] #['hello upper("world")'] #['hello ++ upper("world")'] ``` 出力される値: ```XML hello WORLD hello WORLD hello upper("world") hello ++ upper("world") ``` - エスケープ文字 (`\`): Parse Template は、文字シーケンスの `#[` で式の開始を示します。この文字シーケンスを式として解釈せずにリテラル文字として扱うには、`\` でエスケープします。たとえば、`#[` は `#[` を返します。また、式の文字列に含まれる特殊文字を通常の文字として扱いたい場合があります。式に含まれる文字列内の特殊文字をエスケープするには、特殊文字の前に `\` を付けます。特殊文字の例としては、`#[` のシーケンス、引用符 (`'` または `"`)、アポストロフィ (`'`)、`$` などがあります。`\#` や `[` は、文字列内でこれらの 2 文字が (`\#` が `[` の前に来て) 連続していない限り、エスケープする必要はありません。 Parse Template スニペット: ```XML \#[ #['abcd\#[-1234' ++ now() as String ++ '.log'] 'abc'def' #['abc\'def'] "xyz"xyz" #["xyz\"xyz"] #["abc\$DEF\#ghi\[JKL]"] ``` 出力される値: ```XML #[ abcd#[-12342020-07-06T17:20:10.683-07:00.log 'abc'def' abc'def "xyz"xyz" xyz"xyz abc$DEF#ghi[JKL] ``` 詳細は、[「特殊文字のエスケープ」](https://docs.mulesoft.com/dataweave/latest/dataweave-language-introduction#escape-special-characters)を参照してください。 ## [](#関連情報)関連情報 [Set Variable トランスフォーマー](https://docs.mulesoft.com/jp/mule-runtime/4.9/variable-transformer-reference)