変数のデータ型

フロー内に変数を作成すると、Power Automate Desktop はその内容に応じて特定の型に変換します。

これらのデータ型の中には、数値 などのアプリケーション全体で広く使われているものもあれば、ブラウザー インスタンス などの明示的なアクションやアクションのグループを必要とするものもあります。

シンプルなデータの種類

  • テキスト値 - メールアドレスから .txt ファイルのテキスト内容まで、あらゆる種類のテキストです。

    テキストデータ型プロパティ

    テキスト値 変数を作成するには、変数の設定アクション を使用して、入力パラメーターに表記なしで希望のテキストを入力します。

    作成されたテキスト値変数の例。

  • 数値 - これは数値に適用される型です。 数学演算で使用できるデータ型はこれのみです。

    テキスト値 変数を作成するには、変数の設定アクション を使用して、入力パラメーターに表記なしで希望の数値を入力します。

    ハードコードされた数値を除いて、パーセント記号の範囲内で変数を使った数式を使うことができます。 数式については、変数や % 表記の使用 の記事で詳しく紹介されています。

    作成された数値変数の例。

  • ブール値 - この値は、True または False のいずれかになります。

    ブール値 変数を作成するには、変数の設定アクション を使用し、入力パラメータに %True% または %False% という式を入力します。

    さらに、論理演算子、変数、パーセンテージ表記を使用して、複雑な式を作成できます。 論理式については、変数や % 表記の使用 の記事で詳しく紹介されています。

    作成されたブール値変数の例。

高度なデータ型

  • リスト - リストはアイテムの集合です。 個々のリスト項目の種類に応じて、テキスト値のリスト、数値のリストなどがあります。 リストのデータ型は、プログラミング用語では 1 次元配列に相当します。

    新規リストの作成 アクションでリストを作成し、リストにアイテムを追加する アクションでそのリストにアイテムを追加することができます。

    リストの例。

    また、出力としてリストを生成するアクションを使ってリストを作成することもできます。 たとえば、ファイルからテキストを読み込む アクションはテキスト値のリストを返すことができ、フォルダ内のファイルを取得する アクションは、ファイルのリストを返します。

    リストの特定の項目を取得するには、次の表記を使用します : %VariableName[ItemNumber]%

    以下の例では、フローは先に表示されたリストの最初の番号を新しい変数に格納します。 リストの最初の項目のインデックスは 0 である必要があることに注意してください。

    リストの最初の項目にアクセスに使用する式。

    一般的な方法は、それぞれ のアクションを使用してリストの項目を反復処理する方法です。

    リスト データ型プロパティ

  • データテーブル - データテーブルには、表形式のデータが含まれています。 データテーブルは、プログラミング用語では 2 次元配列に相当します。

    データテーブルには、各アイテムの位置を一意に説明する行と列が含まれています。 データテーブルは、他のデータ行をアイテムとして含むリストと見なすことができます。

    データテーブル変数の例。

    Power Automate Desktop は、次の 3 つのアクションを提供してデータテーブルを生成します: Excel ワークシートから読み込む アクション、 SQL ステートメントを実行する アクション、Web ページからデータを抽出する アクション。

    または、Power Automate Desktop には独自のデータテーブルを作成するアクションはありませんが、変数を設定する アクションとプログラミング配列表記を使用してデータテーブルを作成できます。

    この表記法は、カンマで区切られた複数の一次元配列を中括弧で囲んだものです。 最終的な式は、次の形式である必要があります : %{['Product1', '10 USD'], ['Product2', '20 USD']}%

    変数の設定アクションを使用してデータテーブルを作成する方法の例。

    データテーブルの特定の項目を取得するには、次の表記を使用します : %VariableName[RowNumber][ColumnNumber]%RowNumberColumnNumber の最初の項目 (行または列) は 0 である必要があります。

    たとえば、フローが Excel ワークシートのコンテンツを取得し、それを ExcelData 変数に保管するとします。 取得したテーブルの 2 行目の最初のセルにアクセスするには、以下に表示されている式を使用します。

    読み込んだ Excel ファイルの最初の行の 2 番目のセルにアクセス二使用する式。

    Note

    ExcelData 変数には、Excelワークシートから読む アクションを使って Excel ワークシートから抽出された値のテーブルが含まれています。 これには、Excel ファイル全体ではなく、特定のワークシートの値の一部が含まれています。

    列ヘッダーを含むデータブル内の特定の列にアクセスする場合は、%ExcelData[rowNumber]['ColumnName'] 表記を使用します。

    For each アクションを使用してデータ テーブルをループする場合、現在のイテレーションのデータを含む変数はデータ行と見なされます。

    データテーブル データ型プロパティ

  • データ行- データ行には、データテーブルの単一行の値が含まれます。 For each アクションを使用してデータ テーブルをループする場合、現在のイテレーションのデータを含む変数はデータ行になります。

    データ行の特定のアイテムを取得する場合は、%VariableName[ItemNumber]% のような表記を使用します

    または、%VariableName['ColumnName']% 表記を使用できます。 各列の名前は、データ行を取得したデータテーブルによって定義されます。

    データ行 データ型プロパティ

    データ行変数の例。

  • カスタム オブジェクト – プロパティと値のペアが含まれており、簡単に JSON 形式に変換することができます。

    新しい カスタム オブジェクト を作成するには、変数の設定 アクションと次の構造式を使用します :%{ 'Property1': 'Value1', 'Property2': 'Value2', 'Property3': 'Value2' }%

    作成されたカスタム オブジェクト変数の例。

既知の問題と制限事項

  • 問題: データ行とデータテーブル変数の値が変数ペインに正しく表示されない。
  • 回避策: なし。

インスタンス

接続

その他

Active Directory

  • Active Directory エントリ - サーバーへの接続 アクションによって確立された Active Directory サーバーへの接続が含まれています。
  • グループ情報 - 指定された ActiveDirectory グループに関する情報が含まれます。
  • グループ メンバー - 指定された ActiveDirectory グループのメンバーを表します。
  • ユーザー情報 - 指定された ActiveDirectory ユーザーに関する情報が含まれます。

Active Directory データ型のプロパティ

AWS

  • EC2 クライアント - EC2 セッションの作成 アクションを介して作成された EC2 セッションが含まれています。
  • EC2 インスタンス - 取得した EC2 インスタンスを表します。
  • EC2 インスタンス情報 - EC2 インスタンスに関する情報が含まれています。
  • インスタンスの状態の変化 - 起動または停止した EC2 インスタンスに関する情報が含まれています。
  • EBS スナップショット - EBS スナップショットを表します。
  • EBS ボリューム - EBSボリュームを表します。

AWS データ型プロパティ

Azure

  • Azure クライアント - セッションの作成 アクションを介して作成された Azure セッションが含まれています。
  • Azure リソース グループ - 取得した Azure リソースグループを表します。
  • Azure マネージド ディスク - 取得した Azure ディスクを表します。
  • Azure スナップショット - Azure のスナップショットを表します。
  • Azure 仮想マシン - 取得した Azure 仮想マシンを表します。
  • Azure 仮想マシン情報 - Azure 仮想マシンに関する情報が含まれています。
  • Azure サブスクリプション - 取得した Azure サブスクリプションを表します。

Azure データ型プロパティ

CMD

  • CMD セッション - CMD セッションを開く アクションを介して作成された CMD セッションが含まれています。

CMD データ型プロパティ

日付と時間

  • Datetime - 日付と時刻の情報が含まれています。 変数アクションの設定 を介して日時変数を作成するには、次の式 %d"yyyy-MM-dd HH:mm:ss.ff+zzz"% に入力パラメーターを入力します:

    表記 内容
    yyyy
    MM
    dd 曜日
    HH 時間
    mm 分間
    ss
    ff Milliseconds
    zzz UTC オフセット

日付と時刻のデータ型のプロパティ

電子メール

  • メールメッセージ - 電子メールメッセージを表します。 メールを取得する アクションはこれらの変数を設定します。

メール データ型プロパティ

Exchange

  • Exchange メール メッセージ - Exchange サーバーから取得した電子メールメッセージを表します。 Exchange 電子メールメッセージの取得 アクションによって生成された変数を使用します。

Exchange 接続データ型プロパティ

ファイルとフォルダ

  • ファイル - ファイルを表します。
  • フォルダー - フォルダーを表します。

ファイルとフォルダーのデータ型プロパティ

FTP

  • FTP ファイル - FTP ファイルを表します。
  • FTP ディレクトリ - FTP ディレクトリを表します

FTP データ型プロパティ

OCR

  • OCR エンジン - OCR エンジンの作成 アクションを介して作成された OCR エンジンが含まれています。

Outlook

  • Outlook メールメッセージ - Outlook 電子メールメッセージを表します。 Outlook 電子メールメッセージの取得 アクションによって生成された変数を使用します。

Outlook データ型プロパティ

ターミナル

  • ターミナル セッション - ターミナル セッションを開く アクションを介して作成されたターミナル セッションが含まれています。

ターミナル接続データ型プロパティ

XML

  • XML ノード - XML ドキュメントのコンテンツが含まれています。 ファイルから XML を読み込む アクションはこれらの変数を設定します。

XML データ型プロパティ。