With 関数

[アーティクル]
06/10/2024

適用対象: キャンバスアプリデスクトップフローモデル駆動型アプリ Power Pages Power Platform CLI

値を計算し、名前付きの値のインラインレコードを含む 1 つのレコードに対してアクションを実行します。

内容

With 関数は単一レコードの数式を評価します。数式は、値を計算したり、操作 (データの変更や接続の操作など) を実行したりできます。 ForAll 関数を使用して、レコードのテーブル内のすべてのレコードの数式を評価します。

現在処理されているレコードのフィールドは、この数式内で使用できます。 ThisRecord 演算子を使用するか、他の値を参照するのと同様に名前でフィールドを参照します。 As 演算子を使用して処理対象のレコードを指定することもできます。そうすると数式がわかりやすくなり、入れ子になったレコードにアクセスしやすくなります。詳細については、以下の例と「レコードのスコープに関する作業」を参照してください。

With を使用して、複雑な数式を小さな名前の付いたサブ数式に分割することで、複雑な数式を読みやすくします。これらの名前付きの値は、With のスコープに限定された単純なローカル変数のように機能します。 UpdateContext 関数で使用されるものと同じインラインレコード構文を With で使用できます。 With を使用すると、自己完結型で理解しやすく、宣言式のコンテキストで使用できるため、コンテキスト変数やグローバル変数よりも推奨されています。

With を使用して、Patch または Match などの関数によって返されるレコードのフィールドにアクセスします。 With は、これらの関数からの値を、さらに計算やアクションで使用できるまで保持します。

With へのレコード引数がエラーの場合、そのエラーは関数によって返され、数式は評価されません。

構文

あり( レコード、式 )

記録 – 必須。実行されるレコード。名前の値には、インライン構文 { name1: value1, name2: value2, ... } を使用します
式 – 必須。 レコードについて評価する数式。この数式は、レコードの任意のフィールドをレコードスコープとして直接参照できます。

例

単純な名前付き値

With( { radius: 10,
        height: 15 },
    Pi() * (radius*radius) * height
)
// Result: 4712.38898038 (as shown in a label control)

この例では、名前付き値のレコードを使用して、シリンダーの体積を計算します。 With を使用すると、すべての入力値をまとめて取得できるため、計算自体から簡単に分離できます。

With のネスト

With 関数を使用した金利計算機。

With( { AnnualRate: RateSlider/8/100,        // slider moves in 1/8th increments and convert to decimal
        Amount: AmountSlider*10000,          // slider moves by 10,000 increment
        Years: YearsSlider,                  // slider moves in single year increments, no adjustment required
        AnnualPayments: 12 },                // number of payments per year
      With( { r: AnnualRate/AnnualPayments,  // interest rate
              P: Amount,                     // loan amount
              n: Years*AnnualPayments },     // number of payments
            r*P / (1 - (1+r)^-n)             // standard interest calculation
      )
)

この例では、With 関数をネストして、毎月の住宅ローン支払いの 2 層計算を作成します。競合がない限り、すべての外部 With の名前付きの値は内部 With で使用できます。

スライダーコントロールは 1 ずつしか移動できないため、スライダーを分割または乗算して、効果的にカスタムの増分を作成します。金利の場合、RateSlider は Max プロパティを48 に設定され、1/8 パーセントポイントの増分の場合は 8 で除算され、0.125% から 6% の範囲をカバーするパーセンテージから小数に変換するには 100 で除算されます。ローン金額の場合、AmountSlider は Max プロパティを 60 に設定され、10,000 倍されて、10,000 から 600,000 の範囲をカバーします。

スライダーが移動し、新しいローンの支払いが表示されると、With が自動的に再計算されます。変数は使用されず、スライダーコントロールの OnChange プロパティを使用する必要はありません。

このアプリを作成するための詳細な手順は次のとおりです。

新しいアプリを作成します。
Slider コントロールを追加して RateSlider という名前を付けます。 Max プロパティを 48 に設定します。
Label コントロールをスライダーコントロールの左側に追加します。 Text プロパティを"金利:" に設定します。
Label コントロールをスライダーコントロールの右側に追加します。 Text プロパティを数式 RateSlider/8 & " %" に設定します。
別の Slider コントロールを追加して AmountSlider という名前を付けます。 Max プロパティを 60 に設定します。
Label コントロールをこのスライダーコントロールの左側に追加します。 Text プロパティを"ローン金額:" に設定します。
Label コントロールをこのスライダーコントロールの右側に追加します。 Text プロパティを数式 AmountSlider/8 * 10000 に設定します。
別の Slider コントロールを追加して YearsSlider という名前を付けます。 Max プロパティを 40 に設定します。
Label コントロールをこのスライダーコントロールの左側に追加します。 Text プロパティを"年数:" に設定します。
Label コントロールをこのスライダーコントロールの右側に追加します。 Text プロパティを数式 YearsSlider に設定します。
Label コントロールを追加し、その Text プロパティを上記の数式に設定します。
Label コントロールを最後の Label コントロールの左側に追加します。 Text プロパティを"毎月の定期支払い:"に設定します。

Patch から返された主キー

With( Patch( Orders, Defaults( Orders ), { OrderStatus: "New" } ),
      ForAll( NewOrderDetails,
              Patch( OrderDetails, Defaults( OrderDetails ),
                     { Order: OrderID,          // from With's first argument, primary key of Patch result
                       Quantity: Quantity,      // from ForAll's NewOrderDetails table
                       ProductID: ProductID }   // from ForAll's NewOrderDetails table
              )
      )
)

この例では、レコードを SQL Server の注文テーブルに追加します。次に、Patch 関数によって OrderID フィールドに返された受注の主キーを使用して、OrderDetails テーブルに関連レコードを作成します。

正規表現で抽出された値

With(
    Match( "PT2H1M39S", "PT(?:(?<hours>\d+)H)?(?:(?<minutes>\d+)M)?(?:(?<seconds>\d+)S)?" ),
    Time( Value( hours ), Value( minutes ), Value( seconds ) )
)
// Result: 2:01 AM (as shown in a label control, use the Text function to see the seconds)

この例では、ISO 8601 期間値から時間、分、秒を抽出し、これらのサブマッチを使用して Date/Time 値を作成します。

サブマッチには数字が含まれていますが、テキスト文字列のままです。 Value 関数を使用して、数学的操作を実行する前に数値に変換します。

コンポーネント内のレコードをマップします

レコードのマップを参照します。

次の方法で共有