Unter Textbausteinen verstehen wir vorformulierte Texte und Formulierungen, die in Textfeldern in der Sachbearbeitung abgerufen werden können, um dem Benutzer die wiederholte Eingabe solcher Texte zu ersparen.

Damit für ein bestimmtes Feld auch nur die für dieses Feld sinnvollen Textbausteine angezeigt werden, sind die Textbausteine Gruppen zugeordnet. Jede Textbausteingruppe hat einen Namen (definiert in Codetable “TXMTXT - Textmodul”).

Zu jeder Gruppe können verschiedene Textbausteine mit ihrem jeweiligen Namen (kurze, technische Baustein-ID, maximal 8 Stellen) und einer Bezeichnung im Klartext (als textuelle Kurzbeschreibung, um die Textbausteine identifizieren zu können) über die Transaktion “Verwalten von Textbausteinen” (DBITXM) hinterlegt werden.

Jedem Textfeld der Applikation, zu dem es Textbausteine geben soll, wird der Gruppenname der Bausteingruppe für dieses Feld zugeordnet (Details hierzu sind in der Entwickler-Dokumentation unter “TXMMOD - Zuordnung von Textbausteinen” zu finden).

Bei Klick auf das Icon werden dann alle Textbausteine dieser Bausteingruppe aufgelistet und die gewünschten Bausteine können ausgewählt werden. Die gewählten Bausteine werden ans Ende des im Textfeld bereits vorhandenen Textes angefügt.

In der Spalte “Sel.” kann man eine Reihenfolge der Textbausteine festlegen, in der diese dann im Textfeld eingefügt werden.

Weitere Informationen zur IDs und Identifikationsnummern von Textbausteinen sind in der Dokumentation zu “Info Textbaustein” zu finden.

Textbausteine können über “*Textbaustein-ID” direkt aus der Datenbank abgerufen und in beliebigen Textfeldern aufgelöst werden. Dabei können auch mehrere Bausteine (*xxx) gleichzeitig aufgelöst werden.

Alternativ führt auch ein im Textfeld enthaltenes "**" zur Auswahlliste der Textbausteine. Die gewählten Bausteine werden jedoch an der Position des "**" eingefügt, was insbesondere bei nachträglichen Korrekturen oder Ergänzungen hilfreich ist.

Beispiel

Der Textbaustein “Certificate of health” (LCRDOC.CERTHEAL), der unter der Gruppe “Dokumente L/C” zu finden ist (siehe auch Beispiel unter “Info Textbaustein” (INFTXM)) :

Es ist möglich, vorher definierte Texte direkt im Textfeld mithilfe der Eingabe eines *-Zeichens direkt vor der zu verwendenden Textbaustein-ID aufzurufen (d.h. für oben stehendes Beispiel “*LCRDOC.CERTHEAL”). Durch Verlassen des Feldes in einer Transaktion über die Tab-Taste oder durch Klicken des Icons wird der entsprechende Textbaustein dann im Text aufgelöst und (in diesem Fall “+ certificate of health” angezeigt. Kann ein “*-Textbaustein” nicht eindeutig zugewiesen werden, wird die Auswahlliste der Textbausteine angezeigt. Um sicherzustellen, dass alle “*-Textbausteine” vor dem Speichern aufgelöst werden, wird dies vorher durch eine interne Überprüfung kontrolliert.

Ist an einer oder mehreren Stellen in einem vorformulierten Textblock eine manuelle Eingabe eines Textes durch den Benutzer erforderlich, wird an diese Stelle ein Sternchen “*” als Platzhalter eingefügt. Das Sternchen funktioniert als Stopper. Wurde ein solcher Baustein abgerufen, springt der Cursor auf das erste enthaltene Sternchen, damit der Benutzer es durch eine andere Zeichenfolge ersetzt. Mit [tab] wird zum nächsten Sternchen gesprungen. Eine Transaktion kann nicht gespeichert werden, wenn noch Sternchen in einem der Eingabefelder enthalten sind.

Mit Swift Release 2018/2020 wurde für diverse Nachrichten-Tags der erlaubte Zeichensatz dahingehend geändert, dass auch Sternchen “*” ein erlaubtes Zeichen ist. Um einen Text mit einem Sternchen in einem Eingabefeld zu speichern, muss die Checkbox “Erlaube *” neben dem entsprechenden Eingabefeld markiert werden.

Es besteht die Möglichkeit, Kontraktfelder in dem Textbereich des Textbausteins einzugeben, sodass der Text automatisch die betreffenden Kontraktinformationen enthält.

Zur Eingabe von Feldern in Textbausteinen ist der vollständige Name des betreffenden Feldes erforderlich. Beispielsweise ist das folgende Format anzuwenden:

{<Hauptgruppe>\<Gruppe>\<Feldname>}

Ein Beispiel für das Einstellen der eigenen Referenznummer der Bank für eine Garantie:

{GIDGRP\REC\OWNREF}

Im Textbaustein wird die Referenznummer des Kontraktes an der Stelle des Feldaufrufs ausgegeben.

Es besteht die Möglichkeit, einen Langtext aus einem Codetable im Textbereich des Textbausteins einzugeben, so dass statt des Codes der zugehörige Langtext ausgegeben wird.

Beispiel zum Abruf des Langtextes aus dem embedded Codetable des Feldes GID.HNDDTYP in Sprache “DE”:

{=gettbltext(gidgrp\rec\hndtyp,“GID:HNDTYP”,“DE”)}

Für externe Codetable wird statt des Feldnamens der Name des Codetables angegeben.