XML アクション
-
[アーティクル]
-
-
Power Automate はデスクトップ フローを使用して XML 属性と要素を管理する機能を提供します。
XML ファイルを読み取るには、ファイルから XML を読み取るアクションを使用します。 パスを指定するか、ファイルを参照して、エンコード オプションの 1 つを選択します。
ファイルを選択した後、XPath 式を実行する アクションを使用し、Xpath クエリを実行します。 次の例では、ファイルから XML を読み取る アクションで生成した変数を使用してドキュメントを指定します。
![[XPath 式を実行] アクションのスクリーンショット。](media/xml/xpath-expression-example.png)
XML ファイルから属性を取得するには、XML 属性を取得するアクションを使用します。 次の例で、状態 は clientlist の要素である クライアント の属性です。 値はテキスト値として取得されます。
![[XML 要素の属性を取得] アクションのスクリーンショット。](media/xml/get-xml-attribute-example.png)
同様に、要素値を取得するには、XML 要素の値を取得するアクションを使用します。 それぞれのアクションを使用して要素と属性を管理し、XML 属性または要素の取得、設定、削除を行います。
ファイルから XML を読み取ります
XML ファイルの内容を変数に読み取ります。
| 引数 |
オプション |
受入 |
Default Value |
説明設定 |
| File path |
いいえ |
ファイル |
|
読み取る XML ドキュメントを含むファイル |
| Encoding |
N/A |
システムのデフォルト、ASCII、Unicode、Unicode ビッグ エンディアン、UTF-8 |
システムの既定値 |
指定されたファイルに使用するエンコード |
生成された変数
| 引数 |
タイプ |
説明設定 |
| XmlDocument |
XML ノード |
XML ドキュメントを読み取って保持する変数 |
例外
| 例外 |
内容 |
| ディレクトリが見つかりません |
ディレクトリが存在しないことを示します |
| ファイルが見つかりません |
ファイルが存在しないことを示します |
| ファイルを読み取れませんでした |
ファイルの読み取りで問題が発生したことを示します |
| ファイルに有効な XML ドキュメントが含まれていません |
ファイルに有効な XML ドキュメントが含まれていないことを示します |
XML をファイルに書き込みます
XML ノード変数の内容をファイルに書き込みます。
| 引数 |
オプション |
受入 |
Default Value |
説明設定 |
| File path |
いいえ |
ファイル |
|
XML ドキュメントを書き込むファイルです |
| 書き込む XML |
いいえ |
テキスト値 |
|
ファイルに書き込む XML ノードまたはドキュメントです |
| Encoding |
N/A |
システムのデフォルト、ASCII、Unicode、Unicode ビッグ エンディアン、UTF-8 |
システムの既定値 |
指定されたファイルに使用するエンコード |
| 形式 XML |
N/A |
ブール値 |
True |
XML を書式設定するかどうかを指定します |
| レベルごとにインデント |
はい |
数値 |
2 |
XML の各レベルでインデントするスペースの数を指定します |
生成された変数
このアクションは変数を生成しません。
例外
| 例外 |
説明設定 |
| 無効なディレクトリが指定されました |
指定されたディレクトリが無効であることを示します |
| ファイルに XML を書き込めませんでした |
XML をファイルに書き込むときに問題が発生したことを示します |
XPath 式を実行する
指定した XPath クエリに基づいて XML ドキュメントから値を抽出します。
| 引数 |
オプション |
受入 |
Default Value |
説明設定 |
| 解析する XML ドキュメント |
いいえ |
テキスト値 |
|
テキストとしての XML、または以前に定義された変数 (解析する XML ドキュメントを含む) |
| XPath クエリ |
いいえ |
Text 値 |
|
XML ドキュメントに対して実行する XPath 式 |
| 最初の値のみ取得します |
N/A |
ブール値 |
False |
単一の値 (最初の値のみ) を取得するか、指定された XPath 式に一致するすべての値を取得するかを指定します |
生成される変数
| 引数 |
型 |
説明 |
| XPathResult |
XML ノード |
抽出されたノード (XML ノード) |
| XPathResults |
XML ノードの一覧 |
抽出されたノード (XML ノードの一覧) |
例外
| 例外 |
内容 |
| 無効な XML ドキュメントが指定されました |
指定された XML ドキュメントが無効であることを示します |
| 無効な XPath 式が指定されました |
指定された XPath 式が無効であることを示します |
XML 要素の属性を取得します
XML 要素の属性値を取得します。
| 引数 |
オプション |
受入 |
Default Value |
説明設定 |
| XML ドキュメント |
いいえ |
XML ノード |
|
属性を取得する XML ドキュメントまたは XML 要素です |
| XPath クエリ |
はい |
Text 値 |
|
サブ要素を見つけてその属性を取得する XPath 式 |
| Attribute name |
いいえ |
Text 値 |
|
値を取得する属性の名前 |
| 次として値を取得する |
N/A |
テキスト値、数値、Datetime 値、ブール値 |
テキスト値 |
属性値のデータの種類を指定します |
生成された変数
| 引数 |
タイプ |
説明設定 |
| XmlAttributeValue |
ブール値 |
XML 属性の取得された値です |
| XmlAttributeValue |
日時 |
XML 属性の取得された値です |
| XmlAttributeValue |
数値 |
XML 属性の取得された値です |
| XmlAttributeValue |
テキスト値 |
XML 属性の取得された値 |
例外
| 例外 |
説明 |
| 無効な XPath 式が指定されました |
指定された XPath 式が無効であることを示します |
| XPath 式は要素を返しません |
XPath 式が要素を返さないことを示します |
| 要素に属性が見つかりません |
要素に属性が存在しないことを示します |
| 属性値を要求されたデータ型に変換できませんでした |
属性値を要求されたデータ型に変換するときに問題が発生したことを示します |
XML 要素の属性を設定します
XML 要素の属性値を設定します。
| 引数 |
オプション |
受入 |
Default Value |
説明設定 |
| XML ドキュメント |
いいえ |
XML ノード |
|
属性を設定する XML ドキュメントまたは XML 要素です |
| XPath クエリ |
はい |
Text 値 |
|
サブ要素を見つけてその属性を設定する XPath 式 |
| Attribute name |
いいえ |
Text 値 |
|
値を設定する属性名です |
| 属性値 |
いいえ |
Text 値 |
|
属性の新しい値です |
生成された変数
このアクションは変数を生成しません。
例外
| 例外 |
説明 |
| 無効な XPath 式が指定されました |
指定された XPath 式が無効であることを示します |
| XPath 式は要素を返しません |
XPath 式が要素を返さないことを示します |
| XML 属性の設定に失敗しました |
XML 属性の設定中に問題が発生したことを示します |
XML 要素の属性を削除します
XML 要素から属性を削除します。
| 引数 |
オプション |
受入 |
Default Value |
説明設定 |
| XML ドキュメント |
いいえ |
XML ノード |
|
属性を削除する XML ドキュメントまたは XML 要素です |
| XPath クエリ |
はい |
Text 値 |
|
サブ要素を見つけてその属性を削除する XPath 式 |
| Attribute name |
いいえ |
Text 値 |
|
削除する属性名です |
生成された変数
このアクションは変数を生成しません。
例外
| 例外 |
説明 |
| 無効な XPath 式が指定されました |
指定された XPath 式が無効であることを示します |
| XPath 式は要素を返しません |
XPath 式が要素を返さないことを示します |
| 要素に属性が見つかりません |
要素に属性が存在しないことを示します |
| XML 属性の削除に失敗しました |
XML 属性の削除中に問題が発生したことを示します |
XML 要素の値を取得する
XML 要素の値を取得します。
| 引数 |
オプション |
受入 |
Default Value |
説明設定 |
| XML ドキュメント |
いいえ |
XML ノード |
|
値を取得する XML ドキュメントまたは XML 要素です |
| XPath クエリ |
はい |
Text 値 |
|
サブ要素を見つけてその値を取得する XPath 式 |
| 次として値を取得する |
N/A |
テキスト値、数値、Datetime 値、ブール値 |
テキスト値 |
XML 要素の値のデータの種類を指定します |
生成された変数
| 引数 |
タイプ |
説明設定 |
| XmlElementValue |
ブール値 |
XML 要素の値です |
| XmlElementValue |
日時 |
XML 要素の値です |
| XmlElementValue |
数値 |
XML 要素の値です |
| XmlElementValue |
テキスト値 |
XML 要素の値 |
例外
| 例外 |
説明 |
| 無効な XPath 式が指定されました |
指定された XPath 式が無効であることを示します |
| XPath 式は要素を返しません |
XPath 式が要素を返さないことを示します |
| 要素の値を要求されたデータ型に変換できませんでした |
要素の値を要求されたデータ型に変換するときに問題が発生したことを示します |
XML 要素の値を設定します
XML 要素の値を設定します。
| 引数 |
オプション |
受入 |
Default Value |
説明設定 |
| XML ドキュメント |
いいえ |
XML ノード |
|
値を取得する XML ドキュメントまたは XML 要素です |
| XPath クエリ |
はい |
Text 値 |
|
サブ要素を見つけてその値を取得する XPath 式 |
| XML 要素の値 |
いいえ |
Text 値 |
|
XML 要素の新しい値です |
生成された変数
このアクションは変数を生成しません。
例外
| 例外 |
説明 |
| 無効な XPath 式が指定されました |
指定された XPath 式が無効であることを示します |
| XPath 式は要素を返しません |
XPath 式が要素を返さないことを示します |
| 要素の値を設定できませんでした |
要素の値の設定で問題が発生したことを示します |
XML 要素を挿入
新しい XML 要素を XML ドキュメントに挿入します。
| 引数 |
オプション |
受入 |
Default Value |
説明設定 |
| XML ドキュメント |
いいえ |
XML ノード |
|
新しい XML 要素を挿入する XML ドキュメント |
| XPath クエリ |
いいえ |
Text 値 |
|
親 XML 要素を検索して新しい要素をそこに挿入する XPath 式 |
| 挿入する XML 要素 |
いいえ |
XML ノード |
|
XML ドキュメントに挿入する新しい XML 要素 |
生成された変数
このアクションは変数を生成しません。
例外
| 例外 |
説明 |
| 無効な XPath 式が指定されました |
指定された XPath 式が無効であることを示します |
| XPath 式は要素を返しません |
XPath 式が要素を返さないことを示します |
| XML 要素を挿入できませんでした |
XML 要素の挿入で問題が発生したことを示します |
XML 要素の削除
XML ドキュメントから 1 つまたは複数の XML 要素を削除します。
| 引数 |
オプション |
受入 |
Default Value |
説明設定 |
| XML ドキュメント |
いいえ |
XML ノード |
|
削除する XML 要素が含まれている XML ドキュメント |
| XPath クエリ |
いいえ |
Text 値 |
|
削除する要素を検索する XPath 式 |
生成される変数
このアクションは変数を生成しません。
例外
| 例外 |
説明 |
| 無効な XPath 式が指定されました |
指定された XPath 式が無効であることを示します |
| XML 要素を削除できませんでした |
XML 要素の削除中に問題が発生したことを示します |