Platzhalter und Alias-System #

EULANDA verarbeitet HTML- und CSS-Dateien vor der Auslieferung an den Browser. Dabei kommen zwei Systeme zum Einsatz: ESX-Platzhalter für dynamische Werte und das Alias-System für Ressourcen-Umleitungen.

ESX-Platzhalter #

Dateien mit der Endung .esx enthalten %platzhalter%-Variablen, die von EULANDA serverseitig ersetzt werden.

Beispiel: Benutzerfarben in CSS #

/* w10.css.esx — Benutzerfarben werden zur Laufzeit eingesetzt */
html, body {
  %usergrundwerte.controls.surface.css%
}
nav a {
  color: %usergrundwerte.controls.Surface.color%
}

Die .css-Property bei usergrundwerte.controls liefert einen kompletten CSS-Block (font-family, font-size, color, background-color), während Einzelwerte wie .color oder .backgroundcolor nur den jeweiligen Wert liefern.

Platzhalter-Kategorien #

Kategorie	Beispiel	Beschreibung
`grundwerte.firmenstamm.*`	`%grundwerte.firmenstamm.Firma%`	Firmenstammdaten (Name, Anschrift, USt-IdNr.)
`grundwerte.Bank.*`	`%grundwerte.Bank.1.IBAN%`	Bankverbindungen
`usergrundwerte.controls.*`	`%usergrundwerte.controls.surface.css%`	Benutzer-Farben, Schriften, CSS-Blöcke
`property.folder.*`	`%property.folder.exe%`	Systempfade
`property.exe.*`	`%property.exe.version%`	Versionsinformationen
`property.global.*`	`%property.global.uilang%`	Sprach- und Mandanteneinstellungen
`system.*`	`%system.today%`, `%system.username%`	Datum, Benutzer, PC-Name
`session.*`	`%session.xyz%`	Flüchtige Session-Werte
`feature.*`	`%feature.partslists%`	Feature-Toggles (0/1)
`env.*`	`%env.PATH%`	Windows-Umgebungsvariablen
`msg.*`	`%msg.1047.256%`	Lokalisierte Texte (CnMessage-Tabelle)
`template.*`	`%template.cnsoft.EmailDisclaimer%`	Vorlagentexte

Die vollständige Referenz finden Sie unter Platzhalter.

Verwendung in HTML-Seiten #

ESX-Platzhalter können auch in .htm-Dateien verwendet werden, sofern diese als .esx gespeichert oder über das SSI-System mit PATCH=REPLACE eingebunden werden:

<!--#SET VAR="PG_NAME" value="meinseite"-->
<!--#INCLUDE VIRTUAL="/include/page-customscripts.inc" PATCH=REPLACE-->

In diesem Fall wird %PG_NAME% im Include durch meinseite ersetzt.

Alias-System #

Ressourcennamen können über .alias-Dateien auf andere Ressourcen umgeleitet werden. Die Datei heißt immer .alias und kann in jedem Ordner der Web-Registry vorkommen.

Format #

; Kommentar
action_import.png=inbox_out.png
default.htm=e8.default.htm

Syntax #

Syntax	Bedeutung
`name=ziel`	Ressource `name` wird auf `ziel` umgeleitet
`;kommentar`	Kommentarzeile
`@import:eulanda://pfad/.alias`	Andere Alias-Datei importieren
`@import:important!eulanda://pfad/.alias`	Import mit Überschreibungspriorität

Hauptanwendung: Icon-Mapping #

Die Alias-Datei unter \MODULES\WEB\icons\.alias enthält ca. 400 Zuordnungen. Damit werden die Dateinamen der Icon-Bibliothek auf semantische EULANDA-Namen abgebildet:

; Dokumenttyp-Icons
object_eulanda_artikel.png=object_cube.png
object_eulanda_adresse.png=object_person.png

; Workflow-Symbole
action_import.png=inbox_out.png
action_export.png=outbox.png

Kettenbildung #

Aliase können auf andere Aliase verweisen:

action_help_remotesupport.png → action_help_GetSupport.png → lifebelt.png

Vererbung und Benutzer-Override #

Unterordner können die Alias-Datei des übergeordneten Ordners importieren. Über die Root-Alias-Datei werden zusätzlich Benutzer-Overrides eingebunden:

@import:important!eulanda://./ALLUSER/.globalalias
@import:important!eulanda://./CURRENTUSER/.globalalias

Damit können Solution-Partner und Endkunden eigene Icon-Zuordnungen oder Seitenumleitungen definieren, ohne die Originaldateien zu ändern.

Seitenumleitungen #

Neben Icons können auch HTML-Seiten umgeleitet werden:

default.htm=e8.default.htm

Dies ermöglicht Versionswechsel, ohne die aufrufenden Stellen ändern zu müssen.