Ausdrücke verwalten

Home

4D v18

Ausdrücke verwalten

Überblick

4D Write Pro Dokumente können Referenzen auf dynamische 4D Ausdrücke enthalten, wie Variablen, Felder, Formeln, Projektmethoden oder 4D Befehle. Referenzen sind auch auf spezifische Ausdrücke, wie Seitennummer möglich (siehe Absatz unten Ausdrücke für Dokument oder Seite einfügen).

Ausdrücke werden mit dem Befehl ST INSERT EXPRESSION in 4D Write Pro Bereiche eingefügt. Über den Befehl ST Get expression lassen sie sich lesen, über die Befehle WP Get text und ST Get plain text zurückgeben.

Erlaubte Ausdrücke (siehe unten) werden beim Einfügen, beim Anzeigen oder Drucken von Dokumenten oder beim Aufrufen des Befehls ST COMPUTE EXPRESSIONS bewertet. Mit dem Befehl ST FREEZE EXPRESSIONS werden sie zu statischen Werten - außer für die Variablen $wp_pageNumber und $wp_pageCount (siehe unten).

Beispiel

Die Auswahl in einem 4D Write Pro Bereich mit dem Inhalt einer Variablen ersetzen:

 C_TEXT(fullName)

 fullName:="John Smith"

 Case of

    :(Form event code=On Clicked)

       ST INSERT EXPRESSION(myArea;"fullName";ST Start highlight;ST End highlight)

 End case

Standardeinstellung 4D Filtern

Aus Sicherheitsgründen muss der Entwickler die Bewertung von Projektmethoden und 4D Befehlen steuern, die in 4D Write Pro Dokumente eingefügt werden, um die Verwendung unpassender Ausdrücke, unvorhergesehene Änderungen oder Nebeneffekte in der Anwendung zu verhindern. Das unterbindet Aufrufen von Befehlen wie DELETE SELECTION oder von Projektmethoden wie "LöscheRechnungen".

Verwenden Sie die Einstellung zum Filtern auf Datenbankebene. Diese Option liegt in den Datenbank-Eigenschaften auf der Seite Sicherheit:

Standardmäßig ist die Option Aktivieren für alle markiert, d.h. Befehle und Methoden müssen explizit zugelassen sein, sonst werden Bewertungsfehler zurückgegeben. Sie können das Filtern für alle Benutzer oder teilweise deaktivieren (für Designer und Administrator). Die Option gilt für die gesamte 4D Anwendung und steuert alle Bewertungen von Benutzerformeln. Weitere Informationen dazu finden Sie im Handbuch Designmodus.

Ist diese Option aktiviert:

Können Benutzer nur Befehle aufrufen, für die Formeln möglich sind. Diese Liste erscheint im rechten Teil des Formeleditors:

Können Benutzer keine Projektmethode ausführen. Sollen Projektmethoden in 4D Write Pro Dokumenten ausführbar sein, müssen sie explizit mit dem Befehl SET ALLOWED METHODS deklariert werden.

Wird beim Bewerten eines Ausdrucks in einem 4D Write Pro Dokument eine nicht-zulässige 4D Methode bzw. ein Befehl gefunden, wird der Wert durch " ## Error # 48" ersetzt.

Beispiel

Sie haben in Ihrem 4D Write Pro Dokument folgenden Ausdruck eingefügt:

ST INSERT EXPRESSION(*;"WriteProArea";"Gender")

Standardmäßig ist die Option zur Sicherheit markiert, d.h. die Methode Gender gibt einen Fehler zurück:

Führen Sie folgenden Code aus:

 ARRAY TEXT(aTallow;1)

 aTallow{1}:="Gender"

 SET ALLOWED METHODS(aTallow)

wird die Methode Gender bewertet und gibt folgenden Wert zurück:

Kompatibilität

In bisherigen Releases war das Filtern für 4D Write Pro Dokumente nicht aktiviert. Enthalten Ihre 4D Write Pro Dokumente Referenzen auf 4D Methoden, werden sie nach Konvertieren in 4D v16 oder höher nicht mehr bewertet. Stattdessen erscheint die Meldung "## Error # 48".
In diesem Fall müssen Sie die Methoden mit dem Befehl SET ALLOWED METHODS in die Liste der zugelassenen Methode aufnehmen.

Ausdrücke für Dokument oder Seite einfügen

Über den Befehl ST INSERT EXPRESSION können Sie spezielle Ausdrücke für Dokument- oder Seitenattribute in den verschiedenen Bereichen Haupt-, Kopf-, Fußteil einfügen.

Syntax des Ausdrucks	Typ	Beschreibung
$wp_title	Text	Titel definiert im Attribut wk title
$wp_author	Text	Autor definiert im Attribut wk author
$wp_subject[	Text	Betreff definiert im Attribut wk subject
$wp_company	Text	Firma definiert im Attribut wk company
$wp_notes	Text	Hinweise definiert im Attribut wk notes
$wp_dateCreation	Datum	Erstellungsdatum definiert im Attribut wk date creation
$wp_dateModified	Datum	Änderungsdatum definiert im Attribut wk date modified
$wp_pageNumber	Lange Ganzzahl	Seitennummer wie vorgegeben: Von Beginn des Dokuments (Standard) oder ab Seitenabschnitt, wenn der Start Seitenabschnitt definiert ist. Dieser Ausdruck ist immer dynamisch, außer für Ausdrücke durch den Befehl ST FREEZE EXPRESSIONS
$wp_pageCount	Lange Ganzzahl	Anzahl Seiten: Gesamtanzahl der Seiten. außer für Ausdrücke durch den Befehl ST FREEZE EXPRESSIONS

Achten Sie beim Einfügen eines Ausdrucks darauf, dass der Cursor im passenden Bereich steht (Kopfteil, Fußteil oder Hauptteil des Dokuments) und rufen dann den Befehl ST INSERT EXPRESSION auf. Um beispielsweise die Seitennummer im ausgewählten Fußteilbereich einzufügen:

ST INSERT EXPRESSION(*;"4DWPArea";"$wp_pageNumber")

Hier ein Beispiel für Gestaltung eines Dokuments:

Unterstützung der virtuellen Struktur

In 4D Write Pro Dokumente eingefügte Ausdrücke vom Typ Tabelle oder Feld unterstützen die virtuelle Strukturdefinition der Anwendung. Die virtuelle Struktur in Formeln wird über die Befehle SET FIELD TITLES(...;*) und SET TABLE TITLES(...;*) definiert.

Bei einer virtuellen Struktur zeigen Referenzen auf Ausdrücke mit Feldern virtuelle Namen an, wenn das 4D Write Pro Dokument nicht Werte, sondern Referenzen zeigt. Befehle zum Verwalten von Referenzen erwarten und verwenden virtuelle oder reale Namen folgendermaßen:

Befehl	Unterstützung virtuelle Struktur
WP Get text	Gibt Name der virtuellen Struktur zurück, wenn die Option wk expressions as source im Parameter expressions gesetzt ist.
ST Get plain text	Gibt Name der virtuellen Struktur zurück, wenn die Option ST 4D Expressions as sources im Parameter refMode gesetzt ist.
ST Get expression	Ignoriert die virtuelle Struktur. Gibt immer Name der realen Tabelle bzw. des Feldes zurück.
ST INSERT EXPRESSION	Ignoriert die virtuelle Struktur. Erwartet immer Name der realen Tabelle bzw. des Feldes

Hinweis: Wird ein Dokument im Modus "Zeige Ausdruck" angezeigt, werden Referenzen auf Tabellen oder Felder, die nicht zur virtuellen Struktur gehören, mit Fragezeichen angezeigt:
zum Beispiel [VirtualTableName]? wenn das Feld nicht in der virtuellen Struktur definiert ist.

Siehe auch

Befehle aus dem Kapitel Mehrfachstil Text verwenden
ST INSERT EXPRESSION