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