Textvorlagen #

EULANDA unterstützt in vielen Bereichen Textvorlagen die über Platzhalter direkt auf bestimmte Datenfelder zugreifen können.

Zum Beispiel kann der E-Mail-Text, der beim Mailen einer Rechnung erzeugt wird, eine persönliche Anrede und die Rechnungsnummern enthalten.

Daneben können auch allgemeine Daten, wie Firmenstammdaten oder das aktuelle Datum etc. eingebunden werden.

Als Platzhalter dient der Spaltenname der jeweiligen Datenbank-Tabelle. Dieser Spaltenname muss in Prozentzeichen eingeschlossen werden.

Beispiel: #

Falls Sie im Text ein Prozentzeichen als solches und nicht als Platzhalter ausgeben möchten, fügen einfach zwei Prozentzeichen ein (%%).

Wo finde ich die benötigten Feldnamen? #

Wenn Sie wissen möchten, wie ein bestimmtes Feld heißt, wählen Sie das entsprechende Feld in der Maske aus und drücken STRG+F9 für die Kontext-Info. Es erscheint dann ein neues Fenster. Hier finden Sie im Bereich “Edit Control” unter “Feldname” den echten Datenbankfeldnamen.

Daneben sind noch eine Vielzahl von weitere Platzhalter verfügbar, diese sind im Kapitel Globale Platzhalter dokumentiert.

Verknüpfte Tabellen #

Manchmal ist ein gewünschter Wert gar nicht direkt in der Tabelle, sondern nur in einer verknüpften Tabelle vorhanden. Zum Beispiel wird die Kundenanrede nicht in der Rechnung gespeichert, sondern nur in der verknüpften Adresse. Das Feld heißt in der Adresse “Anrede”. Aber %Anrede% steht in der E-Mail-Vorlage der Rechnung nicht zur Verfügung. Stattdessen können Sie aber über die Verknüpfung “Rechnungsadresse” auf alle Felder der zugehörigen Adresse zugreifen. In unserem Beispiel können Sie also mit %Rechnungsadresse.Anrede% auf die gesuchte Anrede zugreifen.

Vollständige Liste aller Verknüpfungen #

Die Verfügbarkeit ist abhängig von der eingesetzten EULANDA-Version und den verwendeten Modulen.

Mehrfach-Verknüpfungen sind nicht möglich.

Verknüpfungsnamen per SQL abfragen #

Die jeweils aktuelle Liste der Verknüpfungen steht in Version 2024 auch als SQL-Sicht zur Verfügung:

SELECT * dbo.EXTRA_DATAOBJECT_LINKS where LINK_TYPE_DESC = 'ONE_TO_ONE'

Ausgabeformatierung #

Speziell bei den E-Mail-Vorlagen ist es möglich, Formatierungsoptionen anzugeben. Diese werden vor den Feldnamen gesetzt und mit einem Doppelpunkt getrennt. Es ist auch möglich mehrere Formatierungsoptionen anzugeben. Diese werden dann auch wieder durch einen Doppelpunkt voneinander getrennt. Es wird aber jeweils nur eine Formatierungsoption derselben Art ausgeführt.

Einfache Bedingungen #

Manchmal möchte man einen bestimmten Textblock nur drucken, wenn ein Feld nicht leer ist oder einen bestimmten Inhalt hat. Um dies zu erreichen, stellt man ein Fragezeichen vor den Wert. Das Ende dieses Textblockes wird durch ein einzelnes Fragezeichen in Prozentzeichen %?% gekennzeichnet. In eine Programmiersprache würde man dies einen WENN-DANN oder IF-THEN-Befehl nennen.

Zum Beispiel wird im Folgenden das Wort “Bauvorhaben” zusammen mit dem Inhalt des Objekt-Feldes nur dann ausgegeben, wenn auch das Feld Objekt gefüllt ist:

%?Objekt% Bauvorhaben: %Objekt% %?%

Es ist auch möglich einen Textblock auszugeben für den Fall, dass Objekt nicht gesetzt ist (IF-THEN-ELSE). Dies wird durch das Fragezeichen und Pipe-Symbol erreicht %?|%.

%?Objekt% Bauvorhaben: %Objekt% %?|% Es wurde kein Bauvorhaben angegeben %?%

Vergleichsoperatoren #

Es ist möglich einfache Vergleiche durchzuführen. Hierzu wird nach dem Feldname der Operatir (z.B. Gleichheitszeichen) und der Vergleichswert angegeben %?<feldname><Operator><Wert>%. Der Vergleich erfolgt immer unabhängig von Groß-/Kleinschreibung.

Die Textblöcke können sich hierbei auch auf mehrere Zeilen erstrecken und in einem solchen Textblock können sich weitere Bedingungen befinden.

Spezielle Bedingung für numerische Daten sind zur Zeit nicht möglich.

Globale Optionen für besondere Kodierung #

Die Werte aus der Datenbank werden normalerweise in den Texteingefügt, wie sie sind. eine spezielle Umwandlung von Sonderzeichen erfolgt hierbei nicht. Dies ist bei den E-Mail-Vorgaben normalerweise auch nicht notwendig. Werden die Textvorlagen aber zum Beispiel zum Erzeugen von XML-Dokumenten verwendet, so müssen bestimmte Sonderzeichen umgewandelt werden.

Hierzu kann am Anfang der Vorlage eine Kodierungs-Direktive gesetzt werden.

Für Entwickler #

Die zugrundeliegende Austauschfunktion steht Entwicklern auch als iScript-Methode “ellib.ReplaceObjectValues” zur Verfügung.

Im Folgenden wird eine Vorlage verwendet, um die Adresse mit der ID 956 zu formatieren und anzuzeigen:

option explicit

dim s
const Vorlage = "%Match% - %Land%-%PLZ% %Ort%"
s = ellib.ReplaceObjectValues(Vorlage, "Eulanda.Adresse", 956, "")
msgbox s