技術リファレンス&アーキテクチャガイド

XML JSON 相互変換&ツリー構造パース チートシート — リファレンスガイド

W3C XML 1.0規格とRFC 8259 JSONの双方向変換、属性プレフィックス(@_)、CDATAセクション処理、SOAPエンベロープ解析の完全ガイド。

主要パラメータ&設定項目

変換方向モードstring

変換方向の指定(XML → JSON または JSON → XML)。

初期値: xml-to-json
属性プレフィックスstring

XMLのタグ属性と子要素を区別するためのプロパティ接頭辞(例: @_ または @)。

初期値: @_
テキスト要素キーstring

属性を持つ要素のテキストコンテンツを格納するJSONプロパティ名(標準: #text)。

初期値: #text

プロの活用テクニック&推奨設定

標準プレフィックス(@_)による属性の衝突防止

XMLの属性(<item id='1'>)と子要素(<item><id>1</id></item>)の名前衝突を防ぐため、属性キーには標準プレフィックス「@_」を付与して安全に構造化します。

CDATAセクションによる特殊文字の安全な格納

エスケープされていない記号(<, >, &)を含むCDATAブロック(<![CDATA[...]]>)は、JSON変換時に自動的にプレーンな文字列値として展開されます。

完全ローカル処理による社内SOAP/XML電文の保護

すべてのXMLパーサー処理はブラウザのDOMメモリ内でのみ実行されます。社内業務システムや金融系SOAP電文が外部サーバーへ送信されることはありません。

よくあるトラブルと解決策

XML要素が1つだけの場合にJSON配列ではなく単一オブジェクトになってしまう

子要素が1件のみのリストタグはパーサーが配列ではなく単一オブジェクトとして扱いがちです。本ツールは配列強制フラグを提供し、常に配列型として正規化可能です。

未エスケープ文字(& や <)によるXMLパースエラー

テキスト中の「&」などはW3C XML規格違反となります。「&amp;」等の実体参照にエスケープするか、対象テキストを<![CDATA[ ... ]]>で囲んでください。

よくある質問 (FAQ)

XMLの属性はJSONへどのように変換されますか?▼

JSONには属性という概念がないため、XML属性は「@_id: '123'」のように接頭辞付きキーとしてオブジェクト内にマッピングされ、テキスト値は「#text」に格納されます。

企業のSOAPエンベロープやXML名前空間に対応していますか?▼

はい。xmlns等の名前空間宣言や、プレフィックス付きタグ(soap:Envelope、soap:Body等)はJSONオブジェクトのキーとして忠実に保持されます。

XML内のコメントはJSON変換時にどうなりますか?▼

RFC 8259 JSON規格ではコメントの記述が禁止されているため、JSON変換時にXMLコメントは安全に自動除外されます。

社内の機密XMLデータを貼り付けても安全ですか?▼

はい、完全に安全です。ToolsAAは100%クライアントサイド('use client')で動作し、ブラウザの外部へデータが送信されることは一切ありません。

関連するおすすめ開発ツール

すべてのツール →