dataClass.get()

Home

4D v19.8

dataClass.get()


dataClass.get() ( primaryKey {; settings} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
primaryKey	Lange Ganzzahl, Text	Wert des Primärschlüssels der Entity
settings	Objekt	Aufbauoption: Kontext
Funktionsergebnis	Entity	Entity, die zum angegebenen Primärschlüssel passt

Beschreibung

Die Methode dataClass.get() sucht in der Dataclass nach der Entity mit dem passenden Parameter primaryKey.

In primaryKey übergeben Sie den Wert des Primärschlüssels der zu findenden Entity. Der Typ des Werts muss zum Typ des Primärschlüssels passen, der im Datastore gesetzt wurde (Lange Ganzzahl oder Text). Mit der Methode entity.getKey() und ihrem Parameter dk key as string können Sie sicherstellen, dass der Wert des Primärschlüssels immer als Text zurückgegeben wird.

Wird mit primaryKey keine Entity gefunden, wird eine Null Entity zurückgegeben.

Lazy loading wird angewendet, d.h. verknüpfte Daten werden nur bei Bedarf geladen.

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 1

 C_OBJECT($entity)

 $entity:=ds.Employee.get(167) // gibt die Entity mit dem Primärschlüsselwert 167 zurück

 $entity:=ds.Invoice.get("DGGX20030") // gibt die Entity mit dem Primärschlüsselwert "DGGX20030" zurück

Beispiel 2

Anwendungsbeispiele zur Eigenschaft context:

 C_OBJECT($e1;$e2;$e3;$e4;$settings;$settings2)

 

 $settings:=New object("context";"detail")

 $settings2:=New object("context";"summary")

 

 $e1:=ds.Employee.get(1;$settings)

 completeAllData($e1) // In der Methode completeAllData wird eine Optimierung ausgelöst und dem Kontext "detail" zugewiesen

 

 $e2:=ds.Employee.get(2;$settings)

 completeAllData($e2) // In der Methode completeAllData wird die dem Kontext "detail" zugewiesene Optimierung angewandt.

 

 $e3:=ds.Employee.get(3;$settings2)

 completeSummary($e3) // In der Methode completeSummary wird eine Optimierung ausgelöst und dem Kontext "summary" zugewiesen.

 

 $e4:=ds.Employee.get(4;$settings2)

 completeSummary($e4) // In der Methode completeSummary wird die dem Kontext "summary" zugewiesene Optimierung angewandt.

Siehe auch

entity.getKey()
Find in field
QUERY