変数のデータ型

09/22/2020

フロー内に変数を作成すると、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]%。 RowNumber と ColumnNumber の最初の項目 (行または列) は 0 である必要があります。

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

Note

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

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

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

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

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

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

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

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

既知の問題と制限事項

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

インスタンス

Web ブラウザーインスタンス – 新規 Internet Explorer を起動する などのブラウザ起動アクションで作成されたブラウザーインスタンスが含まれています。

Web ブラウザーインスタンスのデータ型のプロパティ
ウィンドウインスタンス – ウィンドウを取得 アクションで作成されたウィンドウのインスタンスを含みます。

ウィンドウインスタンスのデータ型のプロパティ
Excel インスタンス–Excel を起動する アクションを通じて作成された Excel インスタンスが含まれています。

Excel インスタンスのデータ型のプロパティ
Outlook インスタンス – Outlook を起動する アクションを通じて作成された Outlook インスタンスが含まれています。

接続

SQL 接続 - Open SQL 接続アクション によって確立された SQL データベースへの接続が含まれています。

SQL 接続データ型プロパティ
Exchange 接続 - Exchange サーバーに接続しする アクションを介して確立された Exchange サーバーへの接続が含まれています。

Exchange 接続データ型プロパティ
FTP 接続 - Open FTP 接続 と Open secure FTP 接続 アクションによって作成された FTP 接続が含まれています。

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

その他

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 オフセット