Saltar al contenido principal
Versión: 21 R4

Create entity selection

Create entity selection ( dsTable : Table { ; settings : Object } ) : 4D.EntitySelection

ParámetrosTipoDescripción
dsTableTabla→Tabla de la base 4D cuya selección actual se utilizará para construir la selección de entidades
settingsObject→Opciones de construcción: context
Resultado4D.EntitySelection←Selección de entidades que coinciden con la clase de datos relacionada con la tabla dada
Historia
LanzamientoModificaciones
17 R5Modificado
17Created

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:

PropiedadTipoDescripción
contextTextEtiqueta para el contexto de optimización aplicado a la selección de entidades.
info

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 SELECTION
dataClass.newSelection()

Propiedades​

Número de comando1512
Hilo segurosí