Criar uma seleção de entidades (entity selection)
*Create entity selection ( dsTable : Table { ; settings : Object } ) : 4D.EntitySelection
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| dsTable | Tabela | → | Tabela do banco de dados 4D cuja seleção atual se utilizará para construir a seleção de entidades |
| settings | Object | → | Opção de construção: context |
| Resultado | 4D. EntitySelection | ← | Seleção de entidades que coincidem com a classe de dados relacionada com a tabela dada |
Descrição
The Create entity selection command builds and returns a new, alterable entity selection related to the dataclass matching the given dsTable, according to the current selection of this table.
If the current selection is sorted, an ordered entity selection is created (the order of the current selection is kept). Se a seleção atual não for ordenada, se cria uma seleção de entidades não ordenada.
If the dsTable is not exposed in ds, an error is returned. Esse comando não pode usado com uma datastore remota.
No parâmetro opcional settings, você pode passar um objeto que contenha a seguinte propriedade:
| Propriedade | Tipo | Descrição |
|---|---|---|
| context | Text | Rótulo para o contexto de otimização aplicado à seleção de entidades. |
Exemplo
var $employees : cs. EmployeeSelection ALL RECORDS([Employee])
$employees:=Create entity selection([Employee])
// A entity selection $employees agora contém um conjunto de referências
// em todas as entidades relacionadas com a classe de dados Employee