Globale Platzhalter #

An verschiedenen Stellen in der EULANDA® ist es möglich Texte dynamisch mit Platzhaltern zu erzeugen. Neben Platzhaltern die von Modulen abhängig sind gibt es eine Reihe von Platzhaltern die allgemein gültig sind. Diese sind unten aufgeführt.

Dieser Beitrag richtet sich an Administratoren, Poweruser und Entwickler. Teilweise sind Kenntnisse über die internen Strukturen von EULANDA®, wie über die SQL-Registry erforderlich.

Beispiele: #

• E-Mail Vorgaben für Berichte Zu jedem Druck-Bericht kann eine Vorgabe für den E-Mail-Betreff und den Text der E-Mail hinterlegt werden. Neben Platzhaltern für das aktuelle Objekt (z.B. die Rechnung) können auch alle nachfolgenden globalen Platzhalter verwendet werden.

• E-Mail-Signatur (global und persönlich) in den Einstellungen

• Im Briefmodul (ab EULANDA® 7.5) Hierbei müssen die Platzhalter in geschweifte Klammern gestellt und ihnen ein kaufmännisches “Und” vorangestellt werden. Zum Beispiel &{grundwerte.firmenstamm.Firma}.

• Archivierungsschnittstelle (optional) In der Archivierungsschnittstelle können Platzhalter u.A. zur Steuerung der Archivierung, zur Bestimmung des Export-Verzeichnisses und zur Erzeugung zusätzlicher Text- oder XML-Dateien, die für die Übergabe an ein externes Archivierungssystem benötigt werden.

• Beim Erstellen von Kurzinfos (für Entwickler) In der Kurzinfo-Definition werden die Platzhalter jedoch in doppelte Dollar-Zeichen eingekleidet, statt in Prozentzeichen.

Grundwerte #

Grundsätzlich sind alle Text- und Zahlenwerte verfügbar, die in der Registry unterhalb des Schlüssels „\MODULES\Grundwerte“ liegen. Die einzelnen Unterschlüssel müssen im Platzhalter mit einem einzelnen Punkt getrennt werden und am Ende folgt - ebenfalls mit einem Punkt getrennt - der Name des Wertes, wie er in der Registry gespeichert ist.

Soll Beispielsweise die Bankleitzahl der zweiten im Firmenstamm hinterlegten Bankverbindung ausgegeben werden, verwendet man den Platzhalter grundwerte.Bank.2.BLZ da sich der gesuchte Wert „BLZ“ in der Registry unter „\MODULES\Grundwerte\Bank\2“ befindet

Über ein angehängtes “.ValueExists()” bzw. “.KeyExists()” lässt sich prüfen, ob der Wert resp. der Schlüssel überhaupt vorhanden ist.

Beispiele #

Usergrundwerte #

Analog zu “Grundwerte” werden über “usergrundwerte” alle Registry-Werte aus dem Registry-Schlüssel “\USER<aktueller Benutzer>\Grundwerte” zur Verfügung gestellt. I.A. sind hier keine speziellen Werte von EULANDA® hinterlegt. Es dient vielmehr dazu eigene Werte oder auch Unterschlüssel anzulegen, die es erlauben benutzerabhängige Ausgaben zu realisieren (z.B. Unterschrift).

Über ein angehängtes “.ValueExists()” bzw. “.KeyExists()” lässt sich prüfen, ob der Wert resp. der Schlüssel überhaupt vorhanden ist.

Usergrundwerte.Controls hat eine Sonderrolle. Siehe nächster Absatz.

Usergrundwerte.Controls #

Hierüber lassen sich die aktuellen Farb- und Schrifteinstellungen abrufen. Die zurückgegebenen Werte sind so formatiert, dass diese in HTML/CSS verwendet werden können.

Der komplette Platzhalter hat folgenden Aufbau:

usergrundwerte.controls.<Element>.<Eigenschaft>

Beispielsweise gibt %usergrundwerte.controls.FieldEditing.FontFamily% die Schriftart eines eingabefeldes im Änderungsmodus zurück.

Eine Beispiel-HTML-Seite hierzu findet man in EULANDA® auf der Entwicklerseite (Schnellstartleiste / Systemverwaltung) unter “ControlProperties”.

Elemente #

Eigenschaften #

Session #

Analog zu “Grundwerte” wird hier der Registry Schlüssel “\SESSION” samt der vorhandenen Unterschlüssel zurückgegeben, soweit dieser in der jeweiligen EULANDA-Version vorhanden ist. Bei dem Session-Schlüssel handelt es sich um “flüchtige” Einträge, die nicht zurück in den Server gespeichert werden. Diese sind also nur im aktuellen laufenden Prozess vorhanden.

Über ein angehängtes “.ValueExists()” bzw. “.KeyExists()” lässt sich prüfen, ob der Wert resp. der Schlüssel überhaupt vorhanden ist.

Properties (Mandanten Eigenschaften) #

Bei diesen Platzhaltern wird durch voranstellen von “properties.” der Pfad des jeweiligen Ordners angezeigt. Soll beispielsweise der Desktop-Ordner angezeigt werden, gibt man property.folder.desktop ein. Als Ausgabe wird C:\Users\Mustermann\Desktop angezeigt.

Folder #

Global #

Client #

Exe #

Wts #

IExplorer #

Templates #

EULANDA® bietet ab Version 6 die Möglichkeit von Datenobjekt-Bezogenen oder allgemeinen Text-Vorlagen. Je nach Ausstattungslinie können diese Mustervorlagen auch angepasst oder durch eigene Vorlagen ergänzt werden.

Beispiel #

Zeigt den Text an, der auch von “Adresse in Zwischenablage” erzeugt wird

ellib.ShowMessage _
ellib.ReplaceObjectValues("%template.cnsoft.toClipboard%","AD",13705,"")

Features #

Abfrage, ob ein EULANDA-Feature aktiv ist. Der Aufbau sieht folgendermaßen aus:

feature.<Name des Features>

Es wird eine “0” für “Feature nicht aktiv bzw. nicht vorhanden” und “1” für “Feature ist aktiv” zurückgegeben. Den benötigten Featurenamen finden sie in den Einstellungen unter “Features und Programmfunktionen”. Nach Auswahl eines Features wird der “interne Name” dort im Bereich “zusätzliche Informationen” angezeigt.

Beispiel #

Über die Abfrage der vorhandenen Features werden beispielsweise im Kurzinfo “Aktive Vorgänge” (interner Name: cnsoft.Common.AktiveVorgaenge) auf der Startseite Teilbereiche ein- und ausgeblendet.

Systemvariablen #

Daneben sind noch folgende zwei Systemvariablen zulässig.

Windows-Umgebungsvariablen #

Diese lassen sich über den Prefix “env.” einbinden. Also beispielsweise “env.PATH” für die Suchpfade.

cnMessage-Tabelle (EULANDA® 8) #

Einträge aus der CnMessages-Tabelle können über die allgemeine Syntax:

%msg.Type.SubType%

abgerufen werden.

Daneben gibt es noch einige Sonderformen:

msgbox ellib.replacebasicvars("%msg.1047.256%") ' Januar`
`msgbox ellib.replacebasicvars("%msg.1500.ArtNr%") ' Artikelnummer`
`msgbox ellib.replacebasicvars("%msg.1043.FR%") ' Frankreich`
`msgbox ellib.replacebasicvars("%msg.10002%") ' Der Beleg ist bereits gebucht`
`msgbox ellib.replacebasicvars("%msg.1000.10002%") ' Der Beleg ist bereits gebucht