Create entity selection

Home

4D v19.8


Create entity selection ( dsTable {; settings} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
dsTable	Tabelle	Aktuelle Auswahl der Tabelle in der 4D Datenbank zum Anlegen der Entity-Selection
settings	Objekt	Aufbauoption: Kontext
Funktionsergebnis	EntitySelection	Entity-Selection in der Dataclass, die mit der gegebenen Tabelle verknüpft ist

Beschreibung

Der Befehl Create entity selection erstellt eine neue, änderbare Entity-Selection, anhand der in dsTable angegebenen aktuellen Auswahl der Tabelle, die mit der Dataclass verbunden ist.

Hinweis: Weitere Informationen dazu finden Sie im Abschnitt Shareable vs alterable Entity-Selections.

Ist die aktuelle Auswahl sortiert, wird eine sortierte Entity-Selection angelegt, die die Reihenfolge der aktuellen Auswahl beibehält. Ist die aktuelle Auswahl unsortiert, wird eine unsortierte Entity-Selection angelegt. Weitere Informationen dazu finden Sie im Abschnitt Sortierte vs unsortierte Entity-Selections.

Ist dsTable nicht in ds abgebildet, wird ein Fehler zurückgegeben
Dieser Befehl lässt sich nicht mit einem Remote Datastore verwenden

settings

Im optionalen Parameter settings können Sie ein Objekt mit zusätzlichen Optionen übergeben. Folgende Eigenschaft wird unterstützt:

Eigenschaft	Typ	Beschreibung
context	Text	Optimierungskontext für die Entity-Selection. Diesen Kontext verwendet der Code beim Verwalten der Entity-Selection, so dass sie von der Optimierung profitiert. Dieses Feature wurde zur Bearbeitung von ORDA Client/Server eingerichtet. Weitere Informationen dazu finden Sie im Abschnitt Client/Server Optimierung.

Beispiel

 C_OBJECT($employees)

 ALL RECORDS([Employee])

 $employees:=Create entity selection([Employee])

  // Die Entity-Selection $employees enthält jetzt einen Satz Referenzen auf alle Entities in der Dataclass Employee

Siehe auch

USE ENTITY SELECTION