Codes für Filter und Formate

Vorbemerkung: Dieser Abschnitt beschreibt die Zeichen zum Definieren von alphanumerischen Eingabefiltern und Anzeigeformaten. Die Zeichen für numerische Anzeigeformaten werden im Abschnitt Anzeigeformate beschrieben.

Ein Eingabefilter besteht aus drei Teilen in folgender Reihenfolge:

Initiator "Argument" Platzhalter

• Der Initiator weist 4D an, die nachfolgenden Zeichen bei der Dateneingabe in ein Feld als Eingabefilter zu verwenden
• Argumente definieren die erlaubten Zeichen
• Platzhalter definieren die für die Zeichen verfügbaren Stellen

Zum Beispiel lässt folgender Eingabefilter nur zu, dass die Buchstaben “a,” “b,” “c” oder “g” zwei Stellen eingegeben werden:

&"a;b;c;g"##

Bei diesem Beispiel ist das kaufmännische Und-Zeichen (&) der Initiator, "a;b;c;g" das Argument und die Nummernzeichen (#) die Platzhalter. Der Filter kann folgendermaßen interpretiert werden: "Lasse die Buchstaben ‘a’, ‘b’, ‘c’ oder ‘g’ an zwei Stellen zu". Also kann der Benutzer “ag,” “gc,” “ba,” “ab,” “aa,” “ac” oder andere Kombinationen der vier erlaubten Zeichen eingeben.

Eingabefilter lassen sich auch miteinander kombinieren. Der folgende Eingabefilter lässt nur zu, dass die Buchstaben “a,” “b,” “c” oder “g” an zwei Stellen, gefolgt von den Zahlen 1, 3 oder 8 n einer Stelle eingegeben werden:

&"a;b;c;g"#,#&"1;3;8"#

Der Benutzer muss zwei der erlaubten Buchstaben verwenden, gefolgt von einer der erlaubten Zahlen.

Ein Anzeigeformat kombiniert Platzhalter und Standardzeichen.

Zwei Zeichen starten einen Filter: Das kaufmännische Und (&) bzw. die Tilde (~). Diese Zeichen weisen 4D an, das direkt darauf folgende Argument als Filter für die nachfolgenden Platzhalter zu verwenden.

Die Tilde (~) weist 4D zusätzlich an, alle Buchstaben großzuschreiben. Es verhindert nicht das Eintippen von Kleinbuchstaben; es wandelt sie lediglich in Großbuchstaben um.

Die folgenden Eingabefilter haben dieselbe Auswirkung:

&"P"#
~"P"#

Der Unterschied ist, dass der Filter mit dem kaufmännischen Und kein kleingeschriebenes “p” zulässt. Der  Filter mit der Tilde (~) akzeptiert das kleingeschriebene “p”, konvertiert es jedoch in Großbuchstaben.

Da keine Buchstaben verwendet werden, sind die folgenden Eingabefilter gleich:

&"1;5;8"#
~"1;5;8"#

Ein Filterargument folgt auf den Initiator und definiert die Zeichen, die in den nachfolgenden Platzhaltern erlaubt sind. Um ein Filterargument zu erzeugen, müssen Sie die gültigen Zeichen zwischen Anführungszeichen setzen.

Argumente bestehen aus Kleinbuchstaben, Großbuchstaben, Zahlen, Satzzeichen und Sonderzeichen (!@#$%^&*()[]":´;?><,./`~). Setzen Sie einen Kleinbuchstaben im Argument, kann der Benutzer nur die Kleinbuchstabenform verwenden. Setzen Sie einen Großbuchstaben, kann er nur die Großbuchstabenform verwenden.

• Ein Argument kann ein einzelnes Zeichen sein (ein Buchstabe oder eine Zahl), zum Beispiel “j,” “J” oder “6.”
• Ein Argument kann eine Reihe von Zeichen sein, getrennt durch ein Strichpunkt, zum Beispiel “a;r;t” oder “1;5.”
• Ein Argument kann Zeichenbereiche enthalten. Ein Bereich wird durch das erste Zeichen, einen Strich und das letzte Zeichen bestimmt. Beispiele hierfür sind “a-c” und “1-5.” Das Argument “a-c” ist dasselbe wie “a;b;c” und “1-5” ist dasselbe wie “1;2;3;4;5.”
• Ein Argument kann einzelne Buchstaben, einzelne Zahlen und einen oder mehrere Bereiche enthalten, zum Beispiel “a;m-z;3;5-9.”

Die folgende Tabelle zeigt hilfreiche Abkürzungen für Argumente. Sie werden in Filtern ohne Anführungszeichen verwendet:

Folgende Eingabefilter sind gleichbedeutend:

&9#
&"0-9"#
&"1;2;3;4;5;6;7;8;9;0"#

Folgende Eingabefilter sind gleichbedeutend:

&a#
&"a-z;A-Z"#

Folgende Eingabefilter sind gleichbedeutend:

&A#
&"A-Z"#

Das Nummernzeichen (#) ist der einzige Platzhalter für alphanumerische Filter und Formate (für numerische Filter und Formate sind weitere Zeichen zulässig). Sie verwenden ein Nummernzeichen für jedes Zeichen, das der Benutzer im Datenfeld eingeben kann.

Der folgende Eingabefilter erlaubt dem Benutzer, Buchstaben an vier Stellen einzugeben:

&a####

Der folgende Eingabefilter erlaubt dem Benutzer Großbuchstaben an drei Stellen, gefolgt von Zahlen an zwei Stellen einzugeben:

&A###&9##

Geben Sie keine Platzhalter an, erlaubt der Filtercode beliebig viele Zeichen. Folgender Eingabefilter erlaubt dem Benutzer nur, Zahlen einzugeben, jedoch in unbeschränkter Länge:

&9

Hinweis: Im Struktureditor können Sie die maximale Anzahl zugelassener Zeichen in einem alphanumerischen Datenfeld festlegen (siehe 4D Datenfeldtypen).

Wenn ein Datenfeld mit einem Eingabefilter zur Dateneingabe ausgewählt wird, zeigt 4D einen Unterstrich (_) für jeden Platzhalter. Wenn der Benutzer einen gültigen Wert eingibt, wird der jeweilige Unterstrich hervorgehoben und durch das eingegebene Zeichen ersetzt.
Sie können 4D anweisen, welches Zeichen für den Unterstrich gesetzt werden soll, wenn Sie den Eingabefilter mit einem Ausrufezeichen (!) und dem entsprechenden Zeichen beginnen.
Sie können anstelle des Unterstrichs auch ein anderes Zeichen verwenden. Wenn Sie zum Beispiel "XXXX" anzeigen lassen und der Benutzer gibt nur zwei der erlaubten Zeichen ein (zum Beispiel "AA"), zeigt das Datenfeld nach dem Speichern "AAXX".

Die folgende Abbildung zeigt ein ausgewähltes Datenfeld mit Null und Unterstrichen.

Alle Zeichen, Satzzeichen und Leerzeichen können als tote Zeichen verwendet werden. Tote Zeichen werden bei der Dateneingabe angezeigt, jedoch von der Eingabemarke übersprungen und nicht als Teil der Daten eingegeben.

Die Zeichen, die Sie als tote Zeichen verwenden wollen, werden vor, nach und zwischen Platzhaltern eingefügt. Sie erscheinen zur Klarheit während der Dateneingabe.
Der Eingabefilter für die Sozialversicherungsnummer (&9###-##-####) verwendet Bindestriche als tote Zeichen. Hat der Benutzer die Stelle unmittelbar vor einem toten Zeichen eingegeben, springt die Eingabemarke zum ersten Zeichen nach dem toten Zeichen.