Create entity selection
*Create entity selection ( dsTable : Table { ; settings : Object } ) : 4D.EntitySelection
| 引数 | 型 | 説明 | |
|---|---|---|---|
| dsTable | テーブル | → | エンティティセレクションの元となるカレントセレクションが属する 4Dデータベースのテーブル |
| settings | Object | → | ビルドオプション: context |
| 戻り値 | 4D.EntitySelection | ← | 指定したテーブルに対応するデータクラスのエンティティセレクション |
説明
Create entity selection コマンドは、dsTable で指定したテーブルに対応するデータクラスの追加可能な新規エンティティセレくションを、同テーブルのカレントセレクションに基づいてビルドして返します。
ソートされたカレントセレクションの場合、順列のある エンティティセレクションが作成されます (カレントセレクションの並び順が受け継がれます)。 カレントセレクションがソートされていない場合、順列のないエンティティセレクションが作成されます。
ds において dsTable が公開されていない場合には、エラーが返されます。 リモートデータストアの場合は、このコマンドは使用できません。
任意の settings には、以下のプロパティを持つオブジェクトを渡せます:
| プロパティ | 型 | 説明 |
|---|---|---|
| context | Text | エンティティセレクションに適用されている 最適化コンテキスト のラベル。 |
例題
var $employees : cs.EmployeeSelection
ALL RECORDS([Employee])
$employees:=Create entity selection([Employee])
// $employees エンティティセレクションには、
// Employee データクラスの全エンティティへの参照が格納されています