この記事では、変数を作成して操作し、クラウド フローに値を格納する方法を示します。 たとえば、変数はループの実行回数の追跡に役立ちます。 配列を反復処理したり、特定の項目について配列をチェックしたりするには、変数を使用して、各配列項目に適用されるインデックス番号を参照できます。
整数、浮動小数点数、ブール値、文字列、配列、オブジェクトなどのデータ型の変数を作成できます。 変数を作成した後は、次のような他のタスクを実行できます :
- 変数の値を取得または参照します。
- 変数を一定の値で増減させます。これは増分または減分とも呼ばれます。
- 変数に異なる値を割り当てます。
- 文字列または配列の最後の項目として、変数の値を挿入または追加します。
変数は存在し、それらを作成するクラウド フロー内でのみグローバルです。 また、フロー内のループの反復全体にわたって持続します。
変数を参照するときは、アクションの名前ではなく、変数の名前をトークンとして使用します。これは、アクションの出力を参照する通常の方法です。
警告
既定では、「それぞれに適用」ループの各反復は順番に実行されます。 ループの反復を並行して実行して、パフォーマンスを向上させることができます。 「それぞれに適用」ループで変数を使用する場合、ループ変数が予測可能な結果を返すことが重要であれば、ループの繰り返しを順次実行する必要があります。
前提条件
変数を作成および操作するためのアクションを追加する前に、フローはトリガーで開始する必要があります。 モバイル デバイスを使用して変数を追加することはできません。
変数を操作するには、以下が必要です。
- Power Automate へのアクセス権。
- 変数を作成するクラウド フロー。
Power Automate を初めて使用する場合は、クラウドフローの概要とPower Automate のホームページを見るを参照してください。
変数を初期化する
変数を作成し、そのデータ型と初期値を、デザイナー のフローの 1 つのアクション内ですべて宣言できます。 変数はグローバル レベルでのみ宣言でき、スコープ、条件、ループ内では宣言できません。
Power Automate では、新しいデザイナーまたはクラシックデザイナーのいずれかを使用してクラウドフローを構成できます。 手順はどちらのデザイナーでも似ています。 事例付きの詳細は、新しいデザイナーとクラシックなデザイナーの違いを見分けるをご参照ください。
Power Automate にサインインします。
クラウド フローを作成するか、開きます。
クラウド フローを開くには:
- 左側のナビゲーション メニューでマイ フローを選択し、フローを選択します。
- コマンド バーで 編集 を選択します。
変数を追加するステップで、次のいずれかのステップに従います。
- 最後のステップの下にアクションを追加するには、プラス記号(+) を選択してください。
- ステップ間にアクションを追加するには、入力デバイスのポインターを接続矢印の上に移動して、プラス記号 (+) が表示されます。 アクション ペインで、プラス記号 (+) >アクションの追加 を選択します。
アクションの追加 の検索ボックスで、フィルターに使用する 変数の初期化 を入力します。
行動リストから、変数の初期化 - 変数を選択します。
変数に対して、以下の情報を入力してください。
Property 必須 価値 説明設定 件名 はい < variable-name> 初期化する変数の名前です。 タイプ はい < variable-type> 変数のデータ型です。 価値 いいえ < start-value> 変数の初期値です。
ヒント: オプションですが、変数の開始値が常にわかるように、この値をベスト プラクティスとして設定してください。例:
必要となる他のアクションを追加します。 終了したら 保存 を選択します。
変数の初期化アクションには配列として構造化された variable セクションがありますが、アクションは一度に 1 つの変数までしか作成できません。 新しい変数ごとに個別の変数を初期化アクションが必要です。
他の変数タイプの例
文字列変数
"name": "myStringVariable",
"type": "String",
"value": "lorem ipsum"
ブール変数
"name": "myBooleanVariable",
"type": "Boolean",
"value": false
整数を含む配列
"name": "myArrayVariable",
"type": "Array",
"value": [1, 2, 3]
文字列を含む配列
"name": "myArrayVariable",
"type": "Array",
"value": ["red", "orange", "yellow"]
変数の値を取得
変数の内容を取得したり参照したりするには、variables() 関数を使用します。
たとえば、この式は、variables() 関数を使用して配列変数からアイテムを取得します。
string() 関数は、変数の内容を文字列形式 "1, 2, 3, red" で返します。
@{string(variables('myArrayVariable'))}
変数の増分
変数を定数値により大きくするまたは増分するには、増分変数アクションを デザイナーのフローに追加します。
Power Automate では、新しいデザイナーまたはクラシックデザイナーのいずれかを使用してクラウドフローを構成できます。 手順はどちらのデザイナーでも似ています。 事例付きの詳細は、新しいデザイナーとクラシックなデザイナーの違いを見分けるをご参照ください。
増分変数アクションは、整数変数と浮動小数点変数でのみ機能します。
Power Automate にサインインします。
クラウド フローを作成するか、開きます。
クラウド フローを開くには:
- 左側のナビゲーション メニューでマイ フローを選択し、フローを選択します。
- コマンド バーで 編集 を選択します。
デザイナーで、既存の変数を大きくするステップの下で、プラス記号 (+) を選択します。
ステップ間にアクションを追加するには、プラス記号 (+) が表示されるまで、入力デバイスのポインタを接続矢印の上に移動します。 アクション ペインで、プラス記号 (+) >アクションの追加 を選択します。
検索ボックスに、フィルターとして 増分変数 と入力します。
行動リストから、増分変数 - 変数を選択します。
変数の増分に関する次の情報を提供します。
プロパティ 必要 値 内容 件名 はい < variable-name> 増分する変数名 値 いいえ < increment-value> 変数の増分に使用される値。 既定値は 1 です。 ヒント: オプションですが、変数の増分の特定の値が常にわかるように、この値をベスト プラクティスとして設定してください。
例:
完了後は、デザイナーのコマンドバーで保存を選択します。
例: ループ カウンターを作成する
変数は通常、ループが実行される回数をカウントするために使用されます。 たとえば、この例では、デザイナーでメールの添付ファイルをカウントするループを作成することで、このタスクのための変数の作成方法と使用方法を示します。
Power Automate では、新しいデザイナーまたはクラシックデザイナーのいずれかを使用してクラウドフローを構成できます。 手順はどちらのデザイナーでも似ています。 事例付きの詳細は、新しいデザイナーとクラシックなデザイナーの違いを見分けるをご参照ください。
クラウド フローを作成し、新しいメールと添付ファイルをチェックするトリガーを追加します。
この例では、新しいメールが届いたとき (V3) の Office 365 Outlook トリガーを使用します。 このトリガーは、電子メールに添付ファイルがある場合にのみ起動するように設定できます。 ただし、Outlook.com コネクタなど、添付ファイル付きの新着メールをチェックする任意のコネクタを使用できます。
トリガーで、添付ファイルを確認し、それらの添付ファイルをフローに渡すには、これらのプロパティではいを選択します。
- 添付ファイルを含む
- 添付ファイルがある場合のみ
変数の初期化 アクションを以下の値で追加します:
- 名前: カウント
- 種類: 整数
- 値: 0 (開始値)
個々に適用ループを追加して、添付ファイルを循環します。
- 変数の初期化アクションで、新しいステップを選択します。
- 検索ボックスで、検索フィルターにそれぞれに適用 を入力し、それぞれに適用を選択します。
ループで、前の手順から出力を選択 ボックス内を選択します。 動的コンテンツ リストが表示されたら、添付ファイルを選択します。
添付ファイル プロパティは、電子メールからのすべての電子メールの添付ファイルを含む配列をループに渡します。
個々に適用ループで、アクションの追加のプラス サイン (+) を選択します。
検索ボックスに、フィルターとして 増分変数 と入力します。
アクション リストで、変数の増分を選択します。
Note
インクリメント変数アクションはループ内に表示される必要があります。
変数の増分アクションで、名前リストでカウント変数を選択します。
ループで、添付ファイルの数を送信するアクションを追加します。 アクションで、たとえばカウント変数からの値を含めます。 たとえば、次のスクリーンショットでは、メールの送信 (V2) が添付ファイルの数を送信します:
デザイナーのコマンド バーで、保存を選択します。
変数を減分
変数を定数値で小さくする、つまり減分するには、代わりに変数の減分を見つけて選択することを除いて、変数を増やすための手順に従います。 このアクションは、整数変数と浮動小数点変数でのみ機能します。
変数の減分アクションのプロパティは次のとおりです。
| プロパティ | 必要 | 値 | 内容 |
|---|---|---|---|
| 件名 | はい | < variable-name> | 減分する変数名 |
| 値 | いいえ | < increment-value> | 変数の減分に使用される値。 既定値は 1 です。 ヒント: オプションですが、変数の減分の特定の値が常にわかるように、この値をベスト プラクティスとして設定してください。 |
変数の設定
既存の変数に別の値を割り当てるには、次の場合を除いて、変数を増やすための手順に従います。
代わりに、変数の設定アクションを見つけて選択します。
割り当てる変数名と値を指定します。 新しい値と変数の両方が同じデータ型である必要があります。 このアクションには既定値がないため、この値は必須です。
変数の設定アクションのプロパティは次のとおりです。
| プロパティ | 必要 | 値 | 内容 |
|---|---|---|---|
| 件名 | はい | < variable-name> | 変更する変数名 |
| 値 | はい | < new-value> | 変数に割り当てる値です。 両方とも同じデータ型である必要があります。 |
変数を増分または減分する場合を除いて、ループ内の変数を変更すると、ループを並行して実行した場合に予期しない結果が発生する可能性があります。 このような場合は、ループを順番に実行するように設定してみてください。これが既定の設定です。
変数に追加
文字列または配列を格納する変数の場合、それらの文字列または配列の最後の項目としての変数の値を挿入または追加できます。 代わりに次の手順に従うことを除いて、変数を増分するための手順に従うことができます。
変数が文字列であるか配列であるかに基づいて、これらのアクションの 1 つを見つけて選択します。
- 文字列変数に追加
- 配列変数に追加
文字列または配列の最後の項目として追加する値を指定します。 この値は必須です。
追加先... アクションのプロパティは次のとおりです。
| プロパティ | 必要 | 値 | 内容 |
|---|---|---|---|
| 件名 | はい | < variable-name> | 変更する変数名 |
| 値 | はい | < append-value> | 任意の型の追加する値 |