Create entity selection
Create entity selection ( dsTable : Table { ; settings : Object } ) : 4D.EntitySelection
| Parámetros | Tipo | Descripción | |
|---|---|---|---|
| dsTable | Tabla | → | Tabla de la base 4D cuya selección actual se utilizará para construir la selección de entidades |
| settings | Object | → | Opciones de construcción: context |
| Resultado | 4D.EntitySelection | ← | Selección de entidades que coinciden con la clase de datos relacionada con la tabla dada |
Historia
| Lanzamiento | Modificaciones |
|---|---|
| 17 R5 | Modificado |
| 17 | Created |
Descripción
El comando Create entity selection crea y devuelve una nueva entity selection modificable relativa a la dataclass correspondiente con la dsTable dada, de acuerdo con la selección actual de esta tabla.
Si la selección actual está ordenada, se crea una entity selection ordenada (se mantiene el orden de la selección actual). Si la selección actual no está ordenada, se crea una selección de entidades no ordenada.
Si dsTable no está expuesto en ds, se devuelve un error. Este comando no puede utilizarse con un datastore remoto.
En el parámetro opcional settings, puede pasar un objeto que contenga la siguiente propiedad:
| Propiedad | Tipo | Descripción |
|---|---|---|
| context | Text | Etiqueta para el contexto de optimización aplicado a la selección de entidades. |
Por razones de rendimiento, en 4D monopuesto y 4D Server, la selección de entidades devuelta está directamente conectada a la selección actual de dsTable (no es una copia). Mientras no se reemplace la selección actual, los cambios realizados en una se reflejan en la otra. Por ejemplo, REDUCE SELECTION reduce la selección de entidades, y .add() aplicada a la selección de entidades añade la entidad a la selección actual. Para obtener una selección de entidades independiente, llame a .copy() en el resultado:
$es:=Create entity selection([Employee]).copy()
Ejemplo
var $employees : cs.EmployeeSelection
ALL RECORDS([Employee])
$employees:=Create entity selection([Employee])
// La entity selection $employees ahora contiene un conjunto de referencias
// en todas las entidades relacionadas con la clase de datos Employee
Ver también
USE ENTITY SELECTIONdataClass.newSelection()
Propiedades
| Número de comando | 1512 |
| Hilo seguro | sí |