--- title: "Liste der Textblockvariante" slug: "blockname" updated: 2026-06-15T09:03:32Z published: 2026-06-15T09:03:32Z canonical: "kb.moveit.at/blockname" --- > ## Documentation Index > Fetch the complete documentation index at: https://kb.moveit.at/llms.txt > Use this file to discover all available pages before exploring further. # [*B-Blockname] | 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 1. 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.