XML 形式

MIME タイプ: application/xml

ID: xml

XML データ構造は、他のオブジェクト、文字列、または null 値が含まれている可能性がある DataWeave オブジェクトにマップされます。XML で無制限要素を使用してコレクションを表します。コレクションは DataWeave オブジェクトの反復キーにマップされます。また、DataWeave では namespaces、CData、xsi:types がネイティブにサポートされます。

XML 入力の DataWeave リーダーでは、次の解析戦略がサポートされます。

インデックス付き
メモリ内
ストリーミング

DataWeave リーダーおよびライターでこの形式に適用できる解析戦略を理解するには、「DataWeave 解析戦略」を参照してください。

CData カスタム型

CData は、文字データ (CDATA) ブロックを識別するために使用する XML のカスタム DataWeave データ型です。CData 型は、CDATA ブロック内でコンテンツをラップするか、CDATA ブロック内に入力文字列があるかどうかを確認するように XML ライターに指示します。DataWeave では、CData は型 String から継承されます。

例

次の例は、XML 形式の使用方法を示しています。

例: 入力 XML データをストリーミング
例: XML の null または空の文字列
例: 欠落している XML 値に対して null 値を出力
例: 欠落している XML 値に対して null 値を出力
例: XML 属性を DataWeave (dw) 形式で表す
例: XML 名前空間を DataWeave (dw) 形式で表す
例: CDATA 要素を作成
例: String に CDATA があるかどうかを確認
例: inlineCloseOn ライタープロパティを使用
例: 反復 JSON キーを反復 XML 要素に変換
例: XML 要素を JSON 形式に変換して文字を置換

例: 入力 XML データをストリーミング

次の例は、XML ストリーミングの設定方法を示しています。ユーザーは次のリーダープロパティを指定する必要があります。

streaming=true
collectionPath="root.repeated"

collectionPath 設定では、ストリーミングする要素を選択します。

ストリーミング時は、XML パーサーはすべての XML コンテンツがなくてもコンテンツの処理を開始できます。

入力

次の XML が DataWeave ソースへの入力ペイロードとして機能します。これは myXML.xml ファイルのコンテンツであるとします。

myXML.xml

<root>
    <text>
        Text
    </text>
    <repeated>
        <user>
            <name>Mariano</name>
            <lastName>de Achaval</lastName>
            <age>36</age>
        </user>
        <user>
            <lastName>Shokida</lastName>
            <name>Leandro</name>
            <age>30</age>
        </user>
        <user>
            <age>29</age>
            <name>Ana</name>
            <lastName>Felissati</lastName>

        </user>
        <user>
            <age>29</age>
            <lastName>Chibana</lastName>
            <name>Christian</name>
        </user>

    </repeated>
</root>

ソース

DataWeave スクリプトのリーダープロパティ設定は、入力をストリーミングして反復キーを処理するように XML リーダーに指示します。スクリプトは DataWeave map 関数を使用して反復キーを反復処理します。

%dw 2.0
var myInput  readUrl('classpath://myXML.xml', 'application/xml', {streaming:true, collectionPath: "root.repeated"})
output application/dw
---
myInput.root.repeated.*user map {
    n: $.name,
    l: $.lastName,
    a: $.age
}

出力

スクリプトは、マップされた入力 XML を DataWeave (dw) 形式および MIME タイプに変換します。

[
  {
    "n": "Mariano",
    "l": "de Achaval",
    "a": "36"
  },
  {
    "n": "Leandro",
    "l": "Shokida",
    "a": "30"
  },
  {
    "n": "Ana",
    "l": "Felissati",
    "a": "29"
  },
  {
    "n": "Christian",
    "l": "Chibana",
    "a": "29"
  }
]

例: XML の null または空の文字列

XML で null 値を表す標準の方法はないため、nil 属性が true に設定されている場合、リーダーは値を null にマップします。

入力

次の XML が DataWeave ソースへの入力ペイロードとして機能します。 <xsi:nil="true"/> の nil 設定に注意してください。

<book xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <author xsi:nil="true"/>
</book>

ソース

DataWeave スクリプトは入力 XML を JSON 形式および MIME タイプに変換します。

%dw 2.0
output application/json
---
payload

出力

出力は JSON 形式です。入力の nil 値が null に変換されていることに注意してください。

{
  "book": {
    "author": null
  }
}

例: 欠落している XML 値に対して `null` 値を出力

XML リーダープロパティ nullValueOn は、値 blank (デフォルト) または empty を受け入れます。

次の例では nullValueOn のデフォルトを使用するため、title および author 要素の値を null にマップします。

入力

次の XML が DataWeave ソースへの入力として機能します。title および author 要素の値がないことに注意してください。

この入力はファイル myInput.xml 内のコンテンツであるとします。

myXML.xml コンテンツ:

<book>
    <author></author>
    <title>

</title>
</book>

ソース

DataWeave スクリプトは XML 入力を JSON に変換します。デモ目的で nullValueOn のデフォルト (blank) が明示的に設定されていることに注意してください。

%dw 2.0
var myInput readUrl('classpath://myXML.xml', 'application/xml', {nullValueOn: "blank"})
output application/json
---
myInput

出力

JSON 出力の title および author キーは null 値に割り当てられます。

{
  "book": {
    "author": null,
    "title": null
  }
}

例: 欠落している XML 値に対して `null` 値を出力

XML リーダープロパティ nullValueOn は、値 blank (デフォルト) または empty を受け入れます。

次の例では、XML リーダープロパティ nullValueOn が empty に設定されているため、title 要素の値を String にマップし、author 要素の値を null にマップします。

入力

次の XML が DataWeave ソースへの入力として機能します。title および author 要素の値がないことに注意してください。この 2 つの要素の違いは、開始タグと終了タグ間のスペースにあります。title 要素のタグは改行 (非表示文字 \n) によって分割されていますが、author 要素のタグはどの文字によっても分割されていません。

この入力はファイル myInput.xml 内のコンテンツであるとします。

myXML.xml コンテンツ:

<book>
    <author></author>
    <title>

</title>
</book>

ソース

DataWeave スクリプトは DataWeave 変数を使用して myXML.xml のコンテンツを入力し、nullValueOn: "empty" を適用します。スクリプトは XML 入力を JSON に変換します。

%dw 2.0
var myInput readUrl('classpath://myXML.xml', 'application/xml', {nullValueOn: "empty"})
output application/json
---
myInput

出力

JSON 出力では author 要素の値が null にマップされ、title 要素の値が String 値の "\n\n" (改行文字) にマップされます。

{
  "book": {
    "author": null,
    "title": "\n\n"
  }
}

例: XML 属性を DataWeave (dw) 形式で表す

次の例では、XML 属性を正規 DataWeave 表現 (application/dw 形式および MIME タイプ) にマップします。

入力

この XML が DataWeave ソースへの入力ペイロードとして機能します。入力に XML 属性が含まれていることに注意してください。

<users>
  <company>MuleSoft</company>
  <user name="Leandro" lastName="Shokida"/>
  <user name="Mariano" lastName="Achaval"/>
</users>

ソース

DataWeave スクリプトは XML 入力ペイロードを DataWeave (dw) 形式および MIME タイプに変換します。

%dw 2.0
output application/dw
---
payload

出力

出力は、XML 入力が DataWeave (dw) 形式でどのように表されるかを示しています。XML 入力からの属性と空の値がどのように表されているかに注意してください。

{
  users: {
    company: "MuleSoft",
    user @(name: "Leandro",lastName: "Shokida"): "",
    user @(name: "Mariano",lastName: "Achaval"): ""
  }
}

例: XML 名前空間を DataWeave (dw) 形式で表す

次の例では、XML 名前空間を正規 DataWeave 表現 (application/dw 形式および MIME タイプ) にマップします。

入力

この XML が DataWeave ソースへの入力ペイロードとして機能します。入力に XML 名前空間が含まれていることに注意してください。

<root>
    <h:table xmlns:h="http://www.w3.org/TR/html4/">
      <h:tr>
        <h:td>Apples</h:td>
        <h:td>Bananas</h:td>
      </h:tr>
    </h:table>

    <f:table xmlns:f="https://www.w3schools.com/furniture">
      <f:name>African Coffee Table</f:name>
      <f:width>80</f:width>
      <f:length>120</f:length>
    </f:table>
</root>

ソース

DataWeave スクリプトは XML 入力ペイロードを DataWeave (dw) 形式および MIME タイプに変換します。

%dw 2.0
output application/dw
---
payload

出力

出力は、XML 入力が DataWeave (dw) 形式でどのように表されるかを示しています。XML からの名前空間がどのように表されているかに注意してください。

ns h http://www.w3.org/TR/html4/
ns f https://www.w3schools.com/furniture
---
{
  root: {
      h#table: {
        h#tr: {
          h#td: "Apples",
          h#td: "Bananas"
        }
      },
      f#table: {
        f#name: "African Coffee Table",
        f#width: "80",
        f#length: "120"
      }
  }
}

例: CDATA 要素を作成

次の例は、CData 型を使用して XML 出力内で CDATA 要素を作成する方法を示しています。

ソース

DataWeave スクリプトの本文では、String 値が CData 型に型強制されます。

%dw 2.0
output application/xml
---
{
    test: "A text <a>" as CData
}

出力

出力では、入力の String 値が CDATA ブロックで囲まれ、CDATA ブロックには入力からの特殊文字 (< と >) が含まれます。

<?xml version='1.0' encoding='UTF-8'?>
<test><![CDATA[A text <a>]]></test>

例: `String` に CDATA があるかどうかを確認

次の例は、提供された String 値が CDATA かどうかを示しています。

入力

この XML が DataWeave ソースへの入力ペイロードとして機能します。test 要素に CDATA ブロックが含まれていることに注意してください。

<?xml version='1.0' encoding='UTF-8'?>
<test><![CDATA[A text <a>]]></test>

ソース

DataWeave スクリプトは is CData 式を使用して String 値が CDATA かどうかを判別します。

%dw 2.0
output application/json
---
{
    test: payload.test is CDATA
}

出力

JSON 出力には、入力の true 値が CDATA であることを示す値 String が含まれます。

{
    "test": true
}

例: `inlineCloseOn` ライタープロパティを使用

次の例では、inlineCloseOn ライタープロパティを値 none と共に使用して、入力からのキー-値ペアに基づいてアクションを実行します。

ソース

DataWeave スクリプトは本文コンテンツを XML に変換します。emptyElement キーの値が null であることに注意してください。

%dw 2.0s
output application/xml inlineCloseOn="none"
---
{
  someXml: {
    parentElement: {
      emptyElement1: null,
      emptyElement2: null,
      emptyElement3: null
    }
  }
}

出力

emptyElement 要素は空です。これに値 null は含まれません。

<?xml version='1.0' encoding='UTF-8'?>
<someXml>
  <parentElement>
    <emptyElement1></emptyElement1>
    <emptyElement2></emptyElement2>
    <emptyElement3></emptyElement3>
  </parentElement>
</someXml>

例: 反復 JSON キーを反復 XML 要素に変換

XML は反復 (無制限) 要素を使用してコレクションをエンコードします。DataWeave では、同じキーを繰り返して無制限の要素を表します。

次の例は、オブジェクトの JSON 配列内の反復キーを反復 XML 要素に変換する方法を示しています。

入力

この JSON 入力が DataWeave ソースへのペイロードとして機能します。配列内の name キーが反復していることに注意してください。

{
  "friends": [
    {"name": "Mariano"},
    {"name": "Shoki"},
    {"name": "Tomo"},
    {"name": "Ana"}
  ]
}

ソース

DataWeave スクリプトは、friends キーの値を選択します。

%dw 2.0
output application/xml
---
friends: {
    (payload.friends)
}

出力

出力では、name キーが XML 要素として表されます。

<?xml version='1.0' encoding='UTF-8'?>
<friends>
  <name>Mariano</name>
  <name>Shoki</name>
  <name>Tomo</name>
  <name>Ana</name>
</friends>

「自己終了 XML タグの出力」の例も参照してください。

例: XML 要素を JSON 形式に変換して文字を置換

この例では、Id、Name、Address など、従業員の詳細を含む XML ファイルを反復処理して、ファイルを JSON 形式に変換します。DataWeave スクリプトでは、replace 関数を使用して各 Address 要素を反復処理し、文字 - と / を空白スペースに置き換えます。

入力

この XML 入力が DataWeave ソースへのペイロードとして機能します。Address 要素に - と / の文字が含まれていることに注意してください。

<?xml version='1.0' encoding='UTF-8'?>
<root>
<employees>
<Id>1</Id>
<Name>Mule</Name>
<Address>MuleSoft Avenue - 123</Address>
</employees>
<employees>
<Id>2</Id>
<Name>Max</Name>
<Address>MuleSoft Avenue-456/5/e</Address>
</employees>
</root>

ソース

次の DataWeave スクリプトでは、ペイロード要素を反復処理して、オブジェクトへのマッピングを実行します。payload01.Address replace /([\-\,\/])/ with " " の指示により、- と / の文字が空白スペースに置き換えられます。

%dw 2.0
output application/json
---
payload.root.*employees map ((payload01 , indexOfPayload01) ->
{ Id: payload01.Id as String, Name: payload01.Name as String, Address: payload01.Address replace /([\-\,\/])/ with " " }
)

出力

出力は、JSON に変換された XML 要素を表します。

[
  {
    "Id": "1",
    "Name": "Mule",
    "Address": "MuleSoft Avenue   123"
  },
  {
    "Id": "2",
    "Name": "Max",
    "Address": "MuleSoft Avenue 456 5 e"
  }
]

Configuration のプロパティ

DataWeave では、XML 形式に対して次の設定プロパティがサポートされます。

Reader のプロパティ

XML 形式は、入力データを読み取るための指示を提供するプロパティを受け入れます。

パラメーター型デフォルト説明

パラメーター	型	デフォルト	説明
`collectionPath`	`String`	`null`	コレクションが配置されているドキュメントへのパス。ストリーミングする要素の場所を識別するパス式を指定します。「例: 入力 XML データをストリーミング」を参照してください。
`externalEntities`	`Boolean`	`false`	外部エンティティを処理する必要があるかどうかを示します。デフォルトでは、これは XXE 攻撃を回避するために無効になっています。有効な値は、`true` または `false` です。
`indexedReader`	`Boolean`	`true`	DataWeave では、しきい値に達したとき、デフォルトでインデックス付きリーダーを使用します。US-ASCII、UTF-8、および ISO-8859-1 エンコードのみをサポートします。他のエンコードでは、`false` に設定されている場合、DataWeave ではメモリ内リーダーを使用します。有効な値は、`true` または `false` です。
`maxAttributeSize`	`Number`	`-1`	XML 属性で受け入れられる最大文字数を設定します。Mule 4.2.1 以降で使用できます。
`maxEntityCount`	`Number`	`1`	エンティティ拡張の最大数。この制限は、Billion Laughs 攻撃を回避するために設定されます。
`nullValueOn`	`String`	`blank`	空または空白のテキストを含む要素を `null` 値として読み取るかどうかを示します。有効な値は、`empty`、`none`、`blank` です。「例: 欠落している XML 値に対して `null` 値を出力」と「例: 欠落している XML 値に対して `null` 値を出力」を参照してください。
`optimizeFor`	`String`	`'speed'`	XML パーサーの設定方法を示します。有効な値は、`speed` と `memory` です。
`streaming`	`Boolean`	`false`	入力をストリーミングするかどうかを示します (エントリを順次アクセスする場合のみ使用します)。有効なオプションは、`true` または `false` です。「例: 入力 XML データをストリーミング」を参照してください。
`supportDtd`	`Boolean`	`false`	DTD サポートを有効または無効にします。無効にすると、内部および外部のサブセットがスキップされ、処理されません。有効な値は、`true` または `false` です。Mule システムプロパティ `com.mulesoft.dw.xml.supportDTD` を設定してこのプロパティを有効にすることもできます。このプロパティのデフォルトは、Mule バージョン 4.3.0-20210601 (2021 年 6 月の DataWeave バージョン 2.3.0 のパッチを含む) で `true` から `false` に変更されました。

collectionPath

String

null

コレクションが配置されているドキュメントへのパス。ストリーミングする要素の場所を識別するパス式を指定します。「例: 入力 XML データをストリーミング」を参照してください。

externalEntities

Boolean

false

外部エンティティを処理する必要があるかどうかを示します。デフォルトでは、これは XXE 攻撃を回避するために無効になっています。有効な値は、true または false です。

indexedReader

Boolean

true

DataWeave では、しきい値に達したとき、デフォルトでインデックス付きリーダーを使用します。US-ASCII、UTF-8、および ISO-8859-1 エンコードのみをサポートします。他のエンコードでは、false に設定されている場合、DataWeave ではメモリ内リーダーを使用します。有効な値は、true または false です。

maxAttributeSize

Number

-1

XML 属性で受け入れられる最大文字数を設定します。Mule 4.2.1 以降で使用できます。

maxEntityCount

Number

1

エンティティ拡張の最大数。この制限は、Billion Laughs 攻撃を回避するために設定されます。

nullValueOn

String

blank

空または空白のテキストを含む要素を null 値として読み取るかどうかを示します。有効な値は、empty、none、blank です。「例: 欠落している XML 値に対して null 値を出力」と「例: 欠落している XML 値に対して null 値を出力」を参照してください。

optimizeFor

String

'speed'

XML パーサーの設定方法を示します。有効な値は、speed と memory です。

streaming

Boolean

false

入力をストリーミングするかどうかを示します (エントリを順次アクセスする場合のみ使用します)。有効なオプションは、true または false です。「例: 入力 XML データをストリーミング」を参照してください。

supportDtd

Boolean

false

DTD サポートを有効または無効にします。無効にすると、内部および外部のサブセットがスキップされ、処理されません。有効な値は、true または false です。Mule システムプロパティ com.mulesoft.dw.xml.supportDTD を設定してこのプロパティを有効にすることもできます。このプロパティのデフォルトは、Mule バージョン 4.3.0-20210601 (2021 年 6 月の DataWeave バージョン 2.3.0 のパッチを含む) で true から false に変更されました。

Writer のプロパティ

XML 形式は、出力データを書き込むための指示を提供するプロパティを受け入れます。

パラメーター型デフォルト説明

パラメーター	型	デフォルト	説明
`bufferSize`	`Number`	`8192`	バッファライターのサイズ。
`encoding`	`String`	`null`	使用するライターのエンコード。
`deferred`	`Boolean`	`false`	`true` に設定すると、DataWeave は出力をデータストリームとして生成し、スクリプトの実行はそれがコンシュームされるまで延期されます。有効な値は、`true` または `false` です。
`escapeCR`	`Boolean`	`false`	キャリッジリターン (CR) をエスケープするかどうか。有効な値は、`true` または `false` です。Mule 4.2.1 以降で使用できます。
`indent`	`Boolean`	`true`	コードをインデントして読みやすくするか、コードを 1 行に圧縮するかを示します。有効な値は、`true` または `false` です。
`inlineCloseOn`	`String`	`empty`	ライターでどのような場合にインラインの終了タグを使用し、どのような場合に開始終了タグを使用するかを示します。有効な値は、`empty` または `none` です。
`onInvalidChar`	`String`	`null`	有効な値は、`base64`、`ignore`、`none` です。
`skipNullOn`	`String`	`null`	指定されたデータ構造の `null` 値をスキップします。デフォルトでは、ライターはスキップしません。有効な値は、`elements`、`attributes`、`everywhere` です。
`writeDeclaration`	`Boolean`	`true`	XML ヘッダーの宣言を書き込むかどうかを示します。有効な値は、`true` または `false` です。
`writeNilOnNull`	`Boolean`	`false`	値が `null` の場合に nil 属性を書き込むかどうかを示します。有効な値は、`true` または `false` です。

bufferSize

Number

8192

バッファライターのサイズ。

encoding

String

null

使用するライターのエンコード。

deferred

Boolean

false

true に設定すると、DataWeave は出力をデータストリームとして生成し、スクリプトの実行はそれがコンシュームされるまで延期されます。有効な値は、true または false です。

escapeCR

Boolean

false

キャリッジリターン (CR) をエスケープするかどうか。有効な値は、true または false です。Mule 4.2.1 以降で使用できます。

indent

Boolean

true

コードをインデントして読みやすくするか、コードを 1 行に圧縮するかを示します。有効な値は、true または false です。

inlineCloseOn

String

empty

ライターでどのような場合にインラインの終了タグを使用し、どのような場合に開始終了タグを使用するかを示します。有効な値は、empty または none です。

onInvalidChar

String

null

有効な値は、base64、ignore、none です。

skipNullOn

String

null

指定されたデータ構造の null 値をスキップします。デフォルトでは、ライターはスキップしません。有効な値は、elements、attributes、everywhere です。

writeDeclaration

Boolean

true

XML ヘッダーの宣言を書き込むかどうかを示します。有効な値は、true または false です。

writeNilOnNull

Boolean

false

値が null の場合に nil 属性を書き込むかどうかを示します。有効な値は、true または false です。

サポートされる MIME タイプ

XML 形式では、次の MIME タイプがサポートされます。

MIME タイプ

MIME タイプ
`*/xml`
`/+xml`

*/xml

/+xml

XML 形式

CData カスタム型

例

例: 入力 XML データをストリーミング

入力

ソース

出力

例: XML の null または空の文字列

入力

ソース

出力

例: 欠落している XML 値に対して ​null​ 値を出力

入力

ソース

出力

例: 欠落している XML 値に対して ​null​ 値を出力

入力

ソース

出力

例: XML 属性を DataWeave (dw) 形式で表す

入力

ソース

出力

例: XML 名前空間を DataWeave (dw) 形式で表す

入力

ソース

出力

例: CDATA 要素を作成

ソース

出力

例: String​ に CDATA があるかどうかを確認

入力

ソース

出力

例: inlineCloseOn​ ライタープロパティを使用

ソース

出力

例: 反復 JSON キーを反復 XML 要素に変換

入力

ソース

出力

例: XML 要素を JSON 形式に変換して文字を置換

入力

ソース

出力

Configuration のプロパティ

Reader のプロパティ

Writer のプロパティ

サポートされる MIME タイプ

例: 欠落している XML 値に対して `null` 値を出力

例: 欠落している XML 値に対して `null` 値を出力

例: `String` に CDATA があるかどうかを確認

例: `inlineCloseOn` ライタープロパティを使用