WP SET DATA CONTEXT

Home

4D v20 R7

WP SET DATA CONTEXT


WP SET DATA CONTEXT ( wpDoc ; contextData )

Parameter	Typ	Beschreibung
wpDoc	Objekt	4D Write Pro document
contextData	Objekt	Data to put in the context

Beschreibung

Der Befehl WP SET DATA CONTEXT setzt das Objekt contextData als Datenkontext des wpDoc 4D Write Pro Dokuments für den aktuellen Prozess. Das Setzen eines neuen Kontexts im selben Prozess ersetzt jeden bestehenden Kontext für das Dokument.

In wpDoc übergeben Sie das 4D Write Pro Dokument, das den Datenkontext erhalten soll.

In contextData übergeben Sie ein Objekt, das den Inhalt des Datenkontexts bestimmt. Sie können jede Art von 4D Objekt übergeben, auch Objekte, die zu ORDA-Klassen gehören, wie z.B. 4D.Entity. Um einen Kontext zurückzusetzen, übergeben Sie ein Null-Objekt.

Ein 4D Write Pro Datenkontext ist flüchtig:

Sie kann zur Laufzeit innerhalb eines 4D Write Pro Dokuments aufgerufen werden.
Im Gegensatz zu anderen 4D Write Pro Eigenschaften wird sie nicht im 4D Write Pro Dokument gespeichert.

Sobald ein Datenkontext festgelegt ist, sind seine Daten im 4D Write Pro Bereich innerhalb des aktuellen Prozesses über die Formel This.data verfügbar.

Hinweis: Zusätzliche Formulare sind über This verfügbar, wenn Sie mit Tabellendatenquellen arbeiten, siehe Ausdrücke mit This.

Ein Datenkontext kann nur in dem Prozess verwendet werden, in dem er definiert wurde:

Wenn Sie den Datenkontext in berechneten Formeln aus einem anderen Prozess verwenden, ist er null und This.data ist undefiniert
Wenn Sie einen Datenkontext setzen, der bereits für dasselbe Dokument in einem anderen Prozess definiert wurde, wird ein Fehler ausgegeben

Um Formeln mit unterschiedlichen Datenkontexten in verschiedenen Prozessen zu berechnen (d.h. verschiedene Rechnungen aus demselben Template-Dokument zu erstellen), empfiehlt es sich, das Dokument mit WP New in jedem dieser Prozesse zu duplizieren, um Fehler zu vermeiden. Beachten Sie, dass der Datenkontext nicht kopiert wird, wenn Sie ein Dokument duplizieren.

Beispiel 1

Fügen Sie ein Objekt in den Kontext des 4D Write Pro Dokuments ein und zeigen Sie seine Informationen auf der Seite an:

 var $person;$info: Object

 

  // Person Objekt erstellen

 $person:=New object()

 $person.firstName:="John"

 $person.lastName:="Doe"

 

  // Kontext mit Hilfe des Objekts Person festlegen

 WP SET DATA CONTEXT(WParea;$person)

 

  // Zugriff auf Kontextdaten mit dem Schlüsselwort "This".

 $info:=Formula(This.data.firstName+" "+This.data.lastName)

 

  // Kontextdaten auf der Seite anzeigen

 WP INSERT FORMULA(WParea;$info;wk replace) // zeigt "John Doe" auf der Seite an.

Hier ist das Ergebnis:

Beispiel 2

Wenn Sie mit einem Template-Dokument arbeiten, können Sie es mit einem Kontext verknüpfen, um die Seite mit Daten zu füllen. Dies ist zum Beispiel für Mailing-Kampagnen nützlich.

Sobald eine Vorlage geladen und der Datenkontext festgelegt ist, könnte eine Briefvorlage wie folgt aussehen:

Das folgende Beispiel durchläuft eine Entity-Auswahl und erstellt eine Druckvorschau für jede Entity:

 var $person: 4D.Entity

 var $people: 4D.EntitySelection

 

 SET PRINT PREVIEW(True)

 $people:=ds.People.all()

 For each($person;$people)

    WP SET DATA CONTEXT(WParea;$person)

    WP PRINT(WParea)

 End for each

Siehe auch

Blog post - ORDA and 4D Write Pro : The power couple!
WP COMPUTE FORMULAS
WP Get data context