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
O comando Create entity selection cria e retorna uma nova seleção de entidade alterável relacionada à classe de dados correspondente à dsTable fornecida, de acordo com a seleção atual dessa tabela.
Se a seleção atual for ordenada, uma entidade ordenada é criada (a ordem da seleção atual é mantida). Se a seleção atual não for ordenada, se cria uma seleção de entidades não ordenada.
Se dsTable não for exposta em ds, um erro será retornado. 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