適用対象:
キャンバス アプリ Copilot Studio デスクトップ フロー モデル駆動型アプリ Power Platform CLI Dataverse 関数 Power Pages
最初、最後、または特定の レコード、またはテーブルからの最初または最後のレコードのセットを返します。
説明設定
First関数は、テーブルの最初のレコードを返します。
FirstN関数は、テーブルのレコードの最初のセットを返します。2 番目の引数は、返すレコードの数を指定します。
Last関数は、テーブルの最後のレコードを返します。
LastN関数は、テーブルのレコードの最後のセットを返します。2 番目の引数は、返すレコードの数を指定します。
Index関数は、テーブル内の順序付けられた位置に基づいて、テーブルのレコードを返します。 レコード番号は 1 で始まるため、 First( table ) は Index( table, 1 ) と同じレコードを返します。
Index は、要求されたレコード インデックスが 1 未満、テーブル内のレコード数より大きい場合、またはテーブルが空の場合にエラーを返します。
First、 Index、および 1 つのレコードを返 Last 。 FirstN レコードを 1 つだけ指定した場合でも、テーブルを返 LastN 。
委任
データ ソースと共に使用する場合、これらの関数は委任できません。 データ ソースの最初の部分のみが取得され、その後にその関数が適用されます。 結果は完全なストーリーを表さない場合があります。 この制限が存在することを知らせ、可能であれば委任できる代替の選択肢に切り替えるように提案する警告が、作成時に表示される場合があります。 詳しくは、「委任の概要」を参照してください。
たとえば、100 万レコードの大きなテーブルを含むデータ ソースで使用する場合、 Last は委任以外の制限の対象となり、データ ソース全体の最後のレコードは返されません。 同様に、 Index を使用して 100 万件のレコードの途中でレコードを要求すると、非委任制限に基づいてインデックスが範囲外であるため、エラーが発生します。
構文
First( 表 )
Last( 表 )
- 表 - 必須。 操作の対象となるテーブル。
FirstN( テーブル [, NumberOfRecords ] )
LastN( テーブル [, NumberOfRecords ] )
- 表 - 必須。 操作の対象となるテーブル。
- NumberOfRecords - オプション。 返されるレコードの数。 この引数を指定しない場合は、関数は 1 つのレコードを返します。
Index( Table, RecordIndex )
- 表 - 必須。 操作の対象となるテーブル。
- RecordIndex - 必須。 返すレコードのインデックスです。 レコード番号は 1 から始まります。
使用例
次の例では、この表のデータを含む IceCreamデータ ソースを使用します。
このテーブルは、この式 (Button コントロールの OnStart 式を入れ、ボタンを押す) でコレクションに配置することができます。
Collect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 },
{ Flavor: "Vanilla", Quantity: 200 },
{ Flavor: "Strawberry", Quantity: 300 },
{ Flavor: "Mint Chocolate", Quantity: 60 },
{ Flavor: "Pistachio", Quantity: 200 } ) )
| 式 | 説明設定 | 結果 |
|---|---|---|
| First( IceCream ) | IceCream の最初のレコードを返します。 | { フレーバー: "チョコレート", 数量: 100 } |
| Last( IceCream ) | IceCream の最後のレコードを返します。 | { フレーバー: "ピスタチオ", 数量: 200 } |
| Index( IceCream, 3 ) | IceCream の 3 番目のレコードを返します。 | { フレーバー: "ストロベリー", 数量: 300 } |
| FirstN( IceCream, 2 ) | IceCream の最初の 2 つのレコードを含むテーブルを返します。 |
|
| LastN( IceCream, 2 ) | IceCream の最後の 2 つのレコードを含むテーブルを返します。 |
|
| Index( IceCream, 4).量 | テーブルの 4 番目のレコードを返し、Quantity 列を抽出します。 | 60 |
| Index( IceCream, 10 ) | 要求されたレコードがテーブルの範囲を超えているため、エラーを返します。 | エラー |