ISS+ | EASY |
|---|---|
Vollständig | Nicht |
[*B-Blockname] ist eine Kennung zum Austausch eines Standardtextblockes.
In diesen Textblöcken können Datenbankfelder aus der Adresstabelle und aus dem Objektkopf verwendet werden.
Beispiel 01 [*B-Kopf1]
[*D-AdrHdr.Name1] [*Date]
[*D-AdrHdr.Name2]
[*D-AdrHdr.Street]
[*D-AdrHdr.PLZ]-[*D-AdrHdr.Ort]
[*B-Anrede[*D-AdrHdr.Sex]],
vielen Dank für Ihre Anfrage vom [*D-OffHdr.DatOrd].
Ergebnis
Emil Mustermann 14.08.1995
Musterstraße 17
D-8888-Musterstadt
Sehr geehrter Herr Mustermann,
vielen Dank für Ihre Anfrage vom 13.01.2017.
Das Symbol [*B-Blockname] kann auch mehrere Textblöcke gleichzeitig bearbeiten. Dazu werden die Blocknamen hintereinander angeordnet und durch Kommas getrennt. Allgemein gilt die Form [*B-Blockname1,Blockname2,...,BlocknameN]
Beispiel 02 Blockliste
[*B-Kopf1,Kopf2,Kopf3]
Diese Erweiterung kann auch für Datenfelder genutzt werden, in denen eine Liste mehrerer Textblöcke hinterlegt ist.
Wenn das Datenfeld VSPTXT die Blocknamen V01, V02 und V03 enthält, werden mit der Umsetzung **[B-[D-VSPTXT]] automatisch alle drei Textblöcke geladen und eingesetzt.
Intern wandelt das System solche Listen in folgende Form um:
[*B-[*D-VSPTXT]]
[*B-V01,V02,V03]
[*B-V01][*B-V02][*B-V03]
Weitere Ausgabemöglichkeiten von Werten
Die Funktionsarten ermöglichen unterschiedliche Ausgabeformate, die je nach benötigtem Ergebnis eingesetzt werden.
Integer (I): Ergebnis ist eine Zahl
Charakter (C): Ergebnis besteht aus max. 255 Zeichen
String: Ergebnis setzt sich aus einer ungestimmten Anzahl von Zeichen zusammen.
1. Anzahl Elemente einer Liste
Die Funktion dient zur Ermittlung der Anzahl an Einträgen innerhalb einer Liste.
Die Syntax lautet: [*ENTRIES-Ausdruck,Listentrennzeichen]
• Als Ausdruck kann jeder gültige Ausdruck verwendet werden
• Das Listentrennzeichen ist optional, ohne Angabe wird das Trennzeichen Komma verwendet
Beispiel
Anzahl einer Liste [*ENTRIES-[*D-AdrHdr.AdrPCd1],]
Anzahl einer Liste 3
Erklärung
Hier wird die Anzahl der Elemente einer Liste ermittelt. Im Beispiel umfasst der Datensatz drei Einträge, die sich in die Werte A, ## und 4600 aufteilen.
2. Teilbegriff in Ausdruck austauschen
Die Funktion dient zum Ersetzen eines Teilbegriffs innerhalb eines Ausdrucks.
Die Syntax lautet: [*REPLACE-Ausdruck,von-String,nach-String]
• Als Ausdruck kann jeder gültige Ausdruck verwendet werden
• Von-String kann ein beliebiger Ausdruck sein
• Nach-String kann ebenfalls ein beliebiger Ausdruck sein
Beispiel
REPLACE (ersetzen) [*REPLACE-[*D-AdrHdr.AdrPCd1], ,#]
Ergebnis
ersetzen A##4600
Erklärung
Hier wird nach dem Datenbankfeld "AdrHdr.AdrPCd1" gesucht. Wird der Ausdruck " " (Leerzeichen) gefunden, wird er durch das Zeichen mit "#" ersetzt werden.
3. Teilstring
Die Funktion dient dazu, einen festgelegten Abschnitt aus einem Ausdruck auszulesen.
Die Syntax lautet: [*SUBSTRING-Ausdruck,von-Position,Länge]
• Als Ausdruck kann jeder gültige Ausdruck verwendet werden
• Von-Position muss ein ganzzahliger Wert sein
• Länge ist optional; ohne Angabe wird der gesamte Reststring ab der angegebenen Position ausgegeben
Beispiel
Teile eines Strings ab - bis [*SUBSTRING-[*D-AdrHdr.AdrPCd1],4,2]
Teile eines Strings ab [*SUBSTRING-[*D-AdrHdr.AdrPCd1],3]
Ergebnis
Teile eines Strings von bis 46
Teile eines Strings ab 4600
Erklärung
Der String lautet "A##4600"
bei ab - bis werden also von Stelle 4 nur 2 Stellen ausgegeben, in unserem Beispiel also "46"
bei ab wird ab dem 3. String alles ausgegeben.
4. Länge eines Strings
Die Funktion dient zur Ermittlung der Anzahl der Zeichen innerhalb eines Ausdrucks.
Die Syntax lautet: [*LENGTH-Ausdruckt]
Als Ausdruck kann jeder Ausdruck genommen werden.
Beispiel
Länge eines Strings [*LENGTH-[*D-AdrHdr.AdrPCd1]]
Ergebnis
Länge eines Strings 7
Erklärung
Hier wird die Zeichenlänge des Wertes "AdrHdr.AdrPCd1" ermittelt. Der Datensatz lautet "A##4600" und umfasst insgesamt 7 Zeichen.
5. Numerische Werte formatiert ausgeben
[*STRING-Ausdruck,Formatangabe]
• Als Ausdruck kann jeder numerische Wert verwendet werden.
• Als Formatangabe können alle Progress-Formatangaben eingesetzt werden.
• Funktionen können verschachtelt werden.
Beispiel
Stringumwandlung der PLZ 10-stellig [*STRING-[*V-vCusAdrPcd1n],9999999999]]
Ergebnis
Stringumwandlung der PLZ 10-stellig 0000004600
Erklärung
Hier wird die Anzahl der Liste ermittelt und auf 10 Stellen mit "0" aufgefüllt. Ausgegeben wird der 10-stellige Datensatz als String.
6. Textvariable als Integer ausgeben
Die Funktion dient dazu, einen numerischen Wert aus einer Textvariablen auszulesen und als Integer zurückzugeben.
Als Ausdruck kann jeder numerische Wert innerhalb einer Textvariable verwendet werden. Die Ausgabe erfolgt ebenfalls als numerischer Wert.
Beispiel
Integer mit Textvariable [*I-vCusAdrPcd1n@4600] - 1= Ja (trifft zu), 0 = Nein (trifft nicht zu)
Ergebnis
Integer mit Textvariable 1
Erklärung
Hier wird ein Element (Textvariable) aus einer Liste rausgeholt. Wird dies (in unserem Fall "4600") gefunden, dann wird "1" ausgegeben. Wird diese Textvariable nicht gefunden, dann wird "0" ausgegeben. Erhält man "1", dann wird "Text A" im Formular angedruckt, erhält man "0", dann wird "Text B" angedruckt.
7. Datenbankfeld als Integer ausgeben
Die Funktion dient dazu, einen numerischen Wert aus einem Datenbankfeld auszulesen und als Integer zurückzugeben.
Als Ausdruck kann jeder numerische Wert aus einem Datenbankfeld verwendet werden. Die Ausgabe erfolgt ebenfalls als numerischer Wert.
Beispiel
Integer mit Datenbankfeld [*I-adrhdr.AdrSex@4] - 1= Ja (trifft zu), 0 = Nein (trifft nicht zu)
Ergebnis
Integer mit Datenbankfeld 1
Erklärung
Ist das angegebene Datenbankfeld/Variable mit einem numerischen (Integer)Wert hinter dem @-Zeichen gefüllt, so wird eine "1" ausgegeben (TRUE), ansonsten eine "0" (FALSE)
8. Textvariable als Charakter ausgeben
Die Funktion dient zur Prüfung, ob eine Textvariable einen bestimmten Zeichenwert enthält.
Als Ausdruck kann jeder beliebige Wert einer Textvariable verwendet werden. Die Ausgabe erfolgt numerisch.
Beispiel
Charakter mit Textvariable [*C-vCusAdrSex@Firma]
Ergebnis
Charakter mit Textvariable 1
Erklärung
Ist das angegebene Datenbankfeld/Variable mit einer Zeichenkette (Charakter)Wert hinter dem @-Zeichen gefüllt, so wird eine "1" ausgegeben (TRUE), ansonsten eine "0" (FALSE).
9. Datenbankfeld als Charakter ausgeben
Die Funktion dient zur Prüfung, ob ein Datenbankfeld eine bestimmte Zeichenkette enthält.
Als Ausdruck kann jeder beliebige Wert aus einem Datenbankfeld verwendet werden. Die Ausgabe erfolgt numerisch.
Beispiel
Charakter mit Datenbankfeld [*C-adrhdr.AdrNam02@Muster]
Ergebnis
Charakter mit Datenbankfeld 1
Erklärung
Ist das angegebene Datenbankfeld/Variable mit einer Zeichenkette (Charakter)Wert hinter dem @-Zeichen gefüllt, so wird eine "1" ausgegeben (TRUE), ansonsten eine "0" (FALSE).
10. Textvariable als logischen Wert ausgeben
Die Funktion dient zur Prüfung, ob eine Textvariable gefüllt ist.
Als Ausdruck kann jeder numerische Wert aus einer Textvariable verwendet werden. Die Ausgabe erfolgt numerisch.
Beispiel
Logisch [*L-adrhdr.AdrNam03]
Ergebnis
Logisch 1
Erklärung
Hier wird nachgesehen ob das Datenbankfeld/Textvariable gefüllt ist oder nicht, wenn es gefüllt ist, wird eine "1" (TRUE), ansonsten eine "0" (FALSE) ausgegeben.
11. Datenbankfeld als logischen Wert ausgeben
Die Funktion dient zur Prüfung, ob ein Datenbankfeld gefüllt ist und ermöglicht zusätzlich die Ausgabe eines definierten Wertes.
Als Ausdruck kann jeder beliebige Wert aus einem Datenbankfeld verwendet werden. Die Ausgabe erfolgt numerisch bzw. mit dem festgelegten Wert hinter dem @-Zeichen.
Beispiel
Logisch mit @ [*L-adrhdr.AdrNam03@xxx]
Ergebnis
Logisch mit @ xxx
Erklärung
Hier wird nachgesehen ob das Datenbankfeld/Textvariable gefüllt ist oder nicht, wenn es gefüllt ist, wird der Wert der hinter dem @-Zeichen steht ausgegeben, ansonsten eine "0" (FALSE) ausgegeben.