変数のデータ型
フローで作成した変数は、Power Automate により、その内容に基づいて特定の型に変換されます。
これらのデータ型の中には、数値 などのアプリケーション全体で広く使われているものもあれば、ブラウザー インスタンス などの明示的なアクションやアクションのグループを必要とするものもあります。
シンプルなデータ型
シンプルなデータ型は、テキストや数値などの単一の値を表します。 これらのデータ型を個別に使用することも、リストやデータテーブルなどのより複雑なデータ構造を作成するために利用することもできます。
テキスト値
電子メールアドレスから .txt ファイルのテキスト コンテンツまで、あらゆる種類のテキスト。
テキスト値 変数を作成するには、変数の設定 アクションを使用して、入力パラメーターに表記なしで希望のテキストを入力します。
数値
これは、数値に適用されるタイプです。 数学演算で使用できるデータ型はこれのみです。
数値 変数を作成するには、変数の設定 アクションを使用して、入力パラメーターに表記なしで希望の数値を入力します。
ハードコードされた数値を除いて、パーセント記号の範囲内で変数を使った数式を使うことができます。 数式については、変数や % 表記の使用 の記事で詳しく紹介されています。
ブール値
値は True または False のいずれかになります。
ブール値 変数を作成するには、変数の設定 アクションを使用し、入力パラメータに %True% または %False% という式を入力します。
さらに、論理演算子、変数、パーセンテージ表記を使用して、複雑な式を作成できます。 論理式については、変数や % 表記の使用 の記事で詳しく紹介されています。
高度なデータ型
高度なデータ型は、複雑なデータ構造を表します。 これらは、他のデータ型のコレクションとして機能し、1 つのエンティティとしてアクセスすることができます。
リスト
リストはアイテムのコレクションです。 個々のリスト項目の種類に応じて、テキスト値のリスト、数値のリストなどがあります。 リストのデータ型は、プログラミング用語では 1 次元配列に相当します。
新規リストの作成 アクションでリストを作成し、リストにアイテムを追加する アクションでそのリストにアイテムを追加することができます。
また、出力としてリストを生成するアクションを使ってリストを作成することもできます。 たとえば、ファイルからテキストを読み込む アクションはテキスト値のリストを返すことができ、フォルダ内のファイルを取得する アクションは、ファイルのリストを返します。
リストの特定の項目を取得するには、次の表記を使用します : %VariableName[ItemNumber]%
以下の例では、フローは先に表示されたリストの最初の番号を新しい変数に格納します。 リストの最初の項目のインデックスは 0 である必要があることに注意してください。
一般的な方法は、For Each のアクションを使用してリストの項目を反復処理する方法です。
データテーブル
データテーブルには、表形式のデータが含まれています。 データテーブルは、プログラミング用語では 2 次元配列に相当します。
データテーブルには、各アイテムの位置を一意に説明する行と列が含まれています。 データテーブルは、データ行を品目として含むリストと見なすことができます。
Power Automate は、データ テーブルを生成する 3 つのアクションを提供します。Excel ワークシートから読み取る アクション、SQL ステートメントの実行 アクション、Web ページからデータを抽出する アクションです。
または、Power Automate には独自のデータテーブルを作成するアクションはありませんが、変数の設定 アクションおよびプログラミング配列表記を使用してデータテーブルを作成できます。
この表記法は、カンマで区切られた複数の一次元配列を中括弧で囲んだものです。 最終的な式は、次の形式である必要があります : %{['Product1', '10 USD'], ['Product2', '20 USD']}%。
新しいデータテーブルの作成中に列ヘッダーを追加する場合は、最初の列の ^['ColumnName1'、'ColumnName2'] 式を使用します。
既存のテーブルに新しい行を追加するには、データテーブルの変数名、プラス文字 (+)、および括弧内に追加する値を作成します。
データテーブルの特定の項目を取得するには、次の表記を使用します : %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' }%。
既存のプロパティの値を更新したり、新しいプロパティを追加したりするには、変数を設定する アクションを展開し、プロパティ名を 設定 フィールドに入力してから、その値を To フィールドに入力します。
リテラル値とは別に、変数を使用してカスタム オブジェクトのプロパティと値を動的に設定できます。 たとえば、次のフローでは、2 つの変数を使用して、新しい空のカスタム オブジェクトに新しいプロパティを追加します。
PDF テーブル情報の一覧
このデータ型の変数は、PDF からテーブルを抽出する アクションを介してのみ生成できます。
リストの各項目は、抽出されたテーブルを説明し、それに関するすべての重要な情報を提供します。 特定のデータテーブル情報アイテムにアクセスするには、%VariableName[ItemNumber]% 表記を使用します。
すべてのリスト アイテムには、特定の詳細を個別に取得できる 4 つのプロパティがあります。 利用可能なプロパティは次のとおりです。
- DataTable - 抽出されたテーブルを返します。
- TableStartingPage - テーブルの先頭を含むファイル ページのインデックスを返します。
- TableEndingPage - テーブルの末尾を含むファイル ページのインデックスを返します。
- TableOrderInPage - ページ上のテーブルの順序を返します。
このデータ型のプロパティに関する詳細については、変数のデータ型のプロパティ を参照してください。
特定のプロパティの値にアクセスするには、%VariableName[ItemNumber].PropertyName% 表記を使用します。 たとえば、次の式は、ExtractedPDFTables 変数の最初のアイテムのデータテーブル値を返します。
既知の問題と制限事項
- 問題: データテーブルまたはデータ行セルに複数行のエントリが含まれている場合、変数ビューアーにはその最初の行のみが表示されます。
- 回避策: なし。
インスタンス
Web ブラウザー インスタンス – 新規 Internet Explorer を起動する などのブラウザ起動アクションで作成されたブラウザー インスタンスが含まれています。
ウィンドウ インスタンス – ウィンドウを取得 アクションで作成されたウィンドウのインスタンスを含みます。
Excel インスタンス–Excel を起動する アクションを通じて作成された Excel インスタンスが含まれています。
Outlook インスタンス – Outlook を起動する アクションを通じて作成された Outlook インスタンスが含まれています。
接続
SQL 接続 - Open SQL 接続アクション によって確立された SQL データベースへの接続が含まれています。
Exchange 接続 - Exchange サーバーに接続しする アクションを介して確立された Exchange サーバーへの接続が含まれています。
FTP 接続 - FTP 接続を開く と secure FTP 接続を開く アクションによって作成された FTP 接続が含まれています。
その他
一般の値
- 一般的な値 - このデータ型は、Power Automate が変数または入力パラメータのデータ型を定義できない設計時に使用されます。 一般的な値は、実行時にデータに基づいて他のデータ型に変換されます。
Active Directory
- Active Directory エントリ - サーバーへの接続 アクションによって確立された Active Directory サーバーへの接続が含まれています。
- グループ情報 - 名前、表示名、説明、指定した Active Directory グループのメンバーを含みます。
- グループ メンバー - 指定された Active Directory グループのメンバーを表します。
- ユーザー情報 - 指定した Active Directory ユーザーに関する、次のような情報を含みます: 氏名、イニシャルと識別名、職業の詳細 (会社名、部門、役職)、連絡先情報 (電話番号、内線番号、メール)、所在地 (国、市、都道府県、住所、郵便番号)。
AWS
- EC2 クライアント - EC2 セッションの作成 アクションを介して作成された EC2 セッションが含まれています。
- EC2 インスタンス - 取得した EC2 インスタンスを表します。
- EC2 インスタンス情報 - EC2 インスタンスに関する情報が含まれています。
- インスタンスの状態の変化 - 起動または停止した EC2 インスタンスに関する情報が含まれています。
- EBS スナップショット - EBS スナップショットを表します。
- EBS ボリューム - EBSボリュームを表します。
Azure
- Azure クライアント - セッションの作成 アクションを介して作成された Azure セッションが含まれています。
- Azure リソース グループ - 取得した Azure リソースグループを表します。
- Azure マネージド ディスク - 取得した Azure ディスクを表します。
- Azure スナップショット - Azure のスナップショットを表します。
- Azure 仮想マシン - 取得した Azure 仮想マシンを表します。
- Azure 仮想マシン情報 - Azure 仮想マシンに関する情報が含まれています。
- Azure サブスクリプション - 取得した Azure サブスクリプションを表します。
CMD
- CMD セッション - CMD セッションを開く アクションを介して作成された CMD セッションが含まれています。
日付と時間
Datetime - 日付と時刻の情報が含まれています。 変数の設定 アクションを介して日時変数を作成するには、次の式 %d"yyyy-MM-dd HH:mm:ss.ff+zzz"% に入力パラメーターを入力します:
表記 内容 yyyy 年 MM 月 dd 曜日 HH 時 mm 分間 ss 秒 ff ミリ秒 zzz UTC オフセット たとえば、%d"2022-03-25"% の場合、2022 年 3 月 25 日の日付をターゲット変数に割り当てます。
メール
- メールメッセージ - 電子メールメッセージを表します。 メールを取得する アクションはこれらの変数を設定します。
Exchange
- Exchange メール メッセージ - Exchange サーバーから取得した電子メールメッセージを表します。 Exchange 電子メールメッセージの取得 アクションによって生成された変数を使用します。
ファイルとフォルダ
- ファイル - ファイルを表します。
- フォルダー - フォルダーを表します。
- FileSystemObject -フォルダまたはファイルのいずれかを表します。 このデータ型は、フォルダーとファイルを受け入れる入力パラメーターで使用されます。
FTP
- FTP ファイル - FTP ファイルを表します。
- FTP ディレクトリ - FTP ディレクトリを表します
OCR
- OCR エンジン - OCR エンジンの作成 アクションを介して作成された OCR エンジンが含まれています。
Outlook
- Outlook メールメッセージ - Outlook 電子メールメッセージを表します。 Outlook 電子メールメッセージの取得 アクションによって生成された変数を使用します。
ターミナル
- ターミナル セッション - ターミナル セッションを開く アクションを介して作成されたターミナル セッションが含まれています。
XML
- XML ノード - XML ドキュメントのコンテンツが含まれています。 ファイルから XML を読み込む アクションはこれらの変数を設定します。
エラー
- エラー - デスクトップ フローで最後に発生したエラーに関する情報が含まれています。 最後のエラーを取得 アクションはこのタイプの変数を作成します。
Note
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。
フィードバック
フィードバックの送信と表示