【PowerApps】ForAll関数とは？応用例なども交えて詳しく解説

PowerAppsで、たくさんのデータに同じ処理をしたい時、ForAll関数が役に立ちます。

「顧客全員のポイントを更新」「商品リストから条件に合うものを抽出」など、繰り返しの処理が必要なシーンで使われますね。

この記事では、ForAllの基本から、PatchやCollectなど他の関数との連携、注意点まで、実例付きで解説。ぜひ最後までご覧ください。

ForAll関数とは？

PowerAppsでアプリ開発を行う上で、データの操作は避けて通れない道です。特に、複数のレコードに対して同じ処理を繰り返したい場面は頻繁に発生します。そんな時に便利なのがForAll関数です。

テーブルやコレクションと呼ばれるデータの集まりに対して、指定した処理を各要素に順番に実行していくことができます。

例えば、以下のようなケースでForAll関数が使われます。

• 社員データベース: 全社員の給与を5%アップする。
• 商品リスト: 在庫数が10個未満の商品に「在庫僅少」のラベルを付ける。
• 顧客情報: 特定の条件に合致する顧客にメールを一斉送信する（※Power Automateとの連携が必要になる場合があります）。
• アンケート結果: 回答結果の点数をすべて2倍にする。

レコード一つ一つに対して手作業で修正を加えることもできますが、はっきりいって非効率でしかありません。ミスも発生しやすくなるので、ForAll関数で自動化しようという話です。

ForAll関数の基本

ForAll関数は、一言でいうと「テーブルやコレクションの各レコードに対して、同じ処理を繰り返し実行する」ための関数です。基本形は以下のようになります。

ForAll( 対象データ, 実行する処理 )

• 対象データ (Records): ここには、繰り返し処理を行いたいテーブルやコレクションを指定します。例えば、顧客リスト、商品在庫データ、アンケート結果など、複数のレコードが含まれるデータソースが該当します。
• 実行する処理 (Formula): ここには、対象データの各レコードに対して実行したい具体的な処理内容を記述します。数式や関数を組み合わせて、データの更新、計算、他のコレクションへの追加など、さまざまな操作が可能です。

ThisRecord: 今、どのレコードを処理している？

ForAll関数で処理を繰り返していると、「今、どのレコードのデータを処理しているのか」を知りたくなることがあります。その時に使うのがThisRecord。

ThisRecordは、ForAll関数が現在処理しているレコード全体を指す、いわば「目印」のようなものです。実行する処理 (Formula)の中でThisRecordを使うと、現在処理中のレコードの各フィールド（列）の値にアクセスできます。

具体例：社員の給与を10%アップ

Employeesという社員テーブルがあり、各社員のName（名前）とSalary（給与）のフィールドがあるとします。全社員の給与を10%アップする場合、ForAll関数を使って次のように記述できます。

ForAll(
    Employees, // 社員テーブルを対象データに指定
    Patch(Employees, ThisRecord, {Salary: ThisRecord.Salary * 1.1}) // 給与を1.1倍に更新
)

ThisRecord.Salaryとすることで、「今処理している社員の給与」を参照し、その値を1.1倍しています。Patch関数は、既存のレコードを更新するための関数です。

Value: 何回目の繰り返し？

ForAll関数は、Sequence関数と組み合わせて使うことで、さらに活用の幅が広がります。

• Sequence(n)関数: 1からnまでの連番を含むテーブルを作成します。例えば、Sequence(3)は、[1, 2, 3]というテーブルを生成します。

Sequence関数とForAll関数を一緒に使う場合、Valueという特別な値を使って、「今、何回目の繰り返し処理を行っているか」を取得できます。

具体例：連番とその2乗をコレクションに追加

ForAll(
    Sequence(5), // 1から5までの連番テーブルを作成
    Collect(Numbers, {Index: Value, Squared: Value * Value}) // 連番(Index)とその2乗(Squared)をNumbersコレクションに追加
)

この例では、Value は1回目の繰り返しでは1、2回目の繰り返しでは2となり、Numbersコレクションには、{Index: 1, Squared: 1}, {Index: 2, Squared: 4}…といったレコードが追加されていきます。

Sequence関数を使わない場合

Sequence関数を使わず、例えばEmployeesテーブルを直接ForAll関数に渡した場合(ForAll(Employees, …)のようにした場合)、Valueは使用できません。ValueはSequence関数が生成する数値テーブルの要素を参照するためのものと覚えておきましょう。

ForAll関数の実践的な使用例

ForAll関数の基本を理解したところで、次は実践的な使用例を見ていきましょう。ここでは、ForAll関数が特に役立つ4つのシナリオを紹介します。

例1：テーブルデータの一括更新 (Patch関数との組み合わせ)

ForAll関数は、Patch関数と組み合わせることで、テーブル内の複数のレコードを一括で更新できます。これは、データベース管理やデータメンテナンスの場面で非常に役立ちます。

想定シーン: Productsテーブルがあり、各商品(Name)のPrice（価格）を10%値上げする必要があるとします。

ForAll(
    Products,
    Patch(Products, ThisRecord, {Price: ThisRecord.Price * 1.1})
)

• ForAll関数でProductsテーブルの各レコードを順に処理します。
• ThisRecordで現在のレコードを参照し、Patch関数でそのレコードのPriceフィールドを更新します。
• ThisRecord.Price * 1.1で、元の価格の1.1倍（10%増）の値を新しい価格として設定します。

例2：新しいコレクションへの結果の保存 (Collect関数との組み合わせ)

ForAll関数は、Collect関数と組み合わせることで、元のデータを変更せずに、処理結果を新しいコレクションに保存できます。これは、元のデータを保持しつつ、加工したデータも利用したい場合に便利です。

想定シーン: Ordersテーブル（CustomerName、OrderAmount）があり、各注文の金額(OrderAmount)に500円の手数料を加えた新しいコレクションProcessedOrdersを作成します。

ClearCollect(ProcessedOrders,
    ForAll(
        Orders,
        {
            CustomerName: ThisRecord.CustomerName,
            OrderAmount: ThisRecord.OrderAmount + 500
        }
    )
);

• ClearCollectでProcessedOrdersコレクションを初期化（または新規作成）します。
• ForAll関数でOrdersテーブルの各レコードを処理します。
• 各レコードについて、CustomerNameはそのまま、OrderAmountに500を加えた新しいレコードを作成し、ProcessedOrdersコレクションに追加します。

例3：条件に基づく操作 (If関数との組み合わせ)

ForAll関数は、If関数と組み合わせることで、特定の条件を満たすレコードに対してのみ処理を実行できます。これにより、データの状態に応じた柔軟な操作が可能になります。

想定シーン: Employeesテーブルがあり、Statusが”Active”の社員に対してのみ、Bonusフィールドに1000を追加します。

ForAll(
    Employees,
    If(
        ThisRecord.Status = "Active",
        Patch(Employees, ThisRecord, {Bonus: ThisRecord.Bonus + 1000})
    )
)

• ForAll関数でEmployeesテーブルの各レコードを処理します。
• If関数で、ThisRecord.Statusが”Active”かどうかをチェックします。
• 条件が真の場合（”Active”の場合）のみ、Patch関数でBonusフィールドに1000を追加します。

例4：データに行番号を挿入する

ForAll関数、Sequence関数、Index関数、そしてPatch関数を組み合わせることで、テーブルの各レコードに行番号を付与できます。これは、レポート作成やデータ表示の際に役立ちます。

想定シーン: Dataテーブルがあり、各レコードにRowNumberという新しいフィールドを追加し、行番号を格納します。

With(
    {_items: Data}, // 一時的なテーブルを作成
    ForAll(
        Sequence(CountRows(_items)), // レコード数分の連番を生成
        Patch(
            Index(_items, Value), // Value(現在の行番号)に対応するレコードを取得
            {RowNumber: Value} // RowNumberフィールドにValueを格納
        )
    )
)

• With関数で元データを_itemsという名前の一時的なテーブルにします。
• CountRows(_items)で_itemsのレコード数を取得します。
• Sequence(CountRows(_items))で、1からレコード数までの連番を生成します。
• ForAll関数とValueで、各連番（行番号）を処理します。
• Index(_items, Value)でValueで示される順番のレコードを取り出します。
• Patch関数で、取得したレコードにRowNumberフィールドを追加し、Value（行番号）を格納します。

ForAll関数の応用と注意点

ForAll関数は非常に強力な関数ですが、いくつか注意すべき点と、さらに応用的な使い方があります。

ForAll関数内での変数の更新 (注意点と代替案)

ForAll関数を使用する際、よくある誤解として、「ForAll関数の中で変数を更新できる」というものがあります。しかし、ForAll関数の中でSet関数やUpdateContext関数を使って変数を直接更新することはできません。これは、ForAll関数の設計思想によるもので、意図しない副作用を防ぐための仕様です。

誤った例：

// これはエラーになります！
ForAll(
    Data,
    Set(total, total + ThisRecord.Value) // ForAll内でSetは使えない
)

代替案：Last関数を使用して直前のレコードを参照

ForAll関数内で、直前のレコードの状態を参照したい場合は、Last関数とCollect関数を組み合わせることで実現できます。

想定シーン: Numbersテーブルがあり、各数値の累積和を計算して新しいコレクションCumulativeSumsに追加したい。

Clear(CumulativeSums); // コレクションを初期化
ForAll(
    Numbers,
    Collect(
        CumulativeSums,
        {
            Value: ThisRecord.Value,
            CumulativeSum: ThisRecord.Value + If(IsEmpty(CumulativeSums), 0, Last(CumulativeSums).CumulativeSum)
        }
    )
)

• Clear(CumulativeSums)でCumulativeSumsコレクションを初期化します。
• ForAll関数でNumbersテーブルの各レコードを処理します。
• IsEmpty(CumulativeSums)で、CumulativeSumsが空かどうかを確認します（最初のレコードの処理を判定）。
• 空の場合は、現在のレコードの値(ThisRecord.Value)をそのまま累積和とします。
• 空でない場合は、Last(CumulativeSums).CumulativeSumでCumulativeSumsの最後のレコードのCumulativeSum（直前の累積和）を取得し、現在のレコードの値と足し合わせて、新しい累積和を計算します。
• Collectで、現在の値と計算された累積和をCumulativeSumsコレクションに追加します。

このように、Last関数を使うことで、直前のレコードの状態を参照しながら処理を進めることができます。

パフォーマンスに関する考慮事項

ForAll関数は非常に便利ですが、大量のデータを処理する場合にはパフォーマンスに注意が必要です。ForAll関数は、各レコードに対して逐次的に処理を行うため、レコード数が多くなると処理時間が長くなる可能性があります。

特に、ForAll関数の中でPatch関数を頻繁に使用する場合や、ネットワーク経由でデータソースにアクセスする場合には、パフォーマンスが低下する可能性があります。

パフォーマンス改善のヒント:

• 可能な限り、ForAll関数の外で処理をまとめる: 例えば、ForAll関数の中で何度も同じ計算を行うのではなく、事前に計算結果をコレクションに格納しておき、ForAll関数ではそのコレクションを参照するだけにすると、処理が効率化される場合があります。
• データソースへのアクセスを最小限にする: ForAll関数の中で何度も同じデータソースにアクセスするのではなく、必要なデータを事前に取得しておき、ForAll関数ではそのデータを使用するようにすると、ネットワーク負荷を軽減できます。
• Concurrent関数を検討する: ForAllとよく似た機能を持つConcurrent関数を使うと、処理を並列化できる場合があります(ただし、Concurrentの結果はテーブルにはなりません)。処理の順序が重要でない場合は、Concurrent関数の使用も検討しましょう。

AddColumns関数との使い分け

ForAll関数と似た機能を持つ関数に、AddColumns関数があります。AddColumns関数は、テーブルに新しい列を追加し、その列の値を計算することができます。

AddColumns関数は、多くの場合、ForAll関数よりも効率的に処理できます。特に、新しい列を追加するだけで、既存のレコードを更新する必要がない場合は、AddColumns関数を使用することを検討しましょう。

例：OrdersテーブルにTotalAmount列を追加する

// AddColumnsを使用
AddColumns(Orders, "TotalAmount", Quantity * UnitPrice)

// ForAllを使用 (非推奨 - この場合はAddColumnsの方が効率的)
ForAll(Orders, Patch(Orders, ThisRecord, {TotalAmount: Quantity * UnitPrice}))

この例では、AddColumns関数を使用する方が、ForAll関数とPatch関数を使用するよりも効率的です。

まとめ

ForAll関数は、PowerAppsでデータ操作を効率化する便利な関数です。テーブルやコレクションの各レコードに対し、同じ処理を繰り返し実行できます。ThisRecordで現在のレコードを参照し、Sequence関数とValueを組み合わせれば、繰り返し回数に応じた処理も可能です。

ただし、ForAll内での変数更新はできないため、Last関数などを活用しましょう。大量データ処理時のパフォーマンスにも注意が必要です。

弊社ではPowerAppsを活用したローコード開発に力を入れており、開発後の内製化までも幅広くご支援可能です。弊社がこれまで支援した実績などは以下からご覧いただけます。お困りごとがあればお気軽にお問い合わせください。