==== Aufbau der XML-Struktur ====

=== Zur Verfügung stehende Hauptelemente ===

Nachfolgende Auflistung zeigt die für die Gestaltung von Layouts zur Verfügung stehenden XML- Hauptelemente:

  * ''<layout> ''Root-Element eines Layouts
  * ''<page> ''Definiert eine Seite des Layouts
  * ''<badgedata> ''Definiert durch seine Unterelemente die Layout-Größe
  * ''<textbox> ''Element zum Anzeigen von Text
  * ''<frame> ''Rahmen-/Linienelement
  * ''<bitmap> ''Bildelement
  * ''<backgroundBitmap> ''Hintergrundbild (Achtung: nur einmal pro ''<page>''-Element zu verwenden!) \\ \\
=== Das <layout> Element ===

Das ''<layout>''  Element ist das Root-Element einer XML-basierten Layout-Vorlage, durch das die komplette Layout-Definition umschlossen wird. \\ \\

=== Das <page> Element ===

Das ''<page>''  Element entspricht einer Seite eines Besucherausweises bzw. Besucherscheins. Alle Layout-Elemente, die von ''<page>''  Tags umschlossen werden, werden auf derselben Seite dargestellt. \\  \\ Das erste ''<page>''  Element einer Layout-Definition muss das ''<badgedata>''  Element enthalten, mit dem die Größe des Layouts festgelegt wird. \\  \\ Das ''<page>''  Tag bietet als optionales Attribut paper. Mit diesem kann ein Papier-Typ vorgegeben werden (z.B. paper=“DIN A4“). Der Papier-Typ entspricht dem Namen der Papier-Vorlage in der Datenbank.

<panel type="success" title=" " icon="glyphicon glyphicon-info-sign">**Hinweis**: Das Attribut paper kann in jedem <page> Element angegeben werden, zur Zeit wird aber nur das Attribut des ersten <page> Elements in einem Layout ausgewertet und als Papier-Typ für alle vorhandenen Seiten verwendet. </panel> 

=== Das <badgedata> Element ===

Das ''<badgedata>''  Element definiert verschiedene Eigenschaften einer Layout-Seite. Unter anderem wird die Größe des Layouts definiert.

Das Element beinhaltet folgende Unterelemente:

  * ''<badgename>''Name des Layouts (optional, wird im Vorschau-Fenster als Titeltext angezeigt)
  * ''<vsize>''Vertikale Größe in mm
  * ''<hsize>''Horizontale Größe in mm
  * ''<hflip>''Spiegelung des Inhaltes beim Druck um die horizontale Achse (optional, Standard: 0, 0 = Deaktiviert, 1 = Aktiviert) \\ \\
=== Das <textbox> Element ===

Mit dem ''<textbox>''  Element wird ein Text im Layout erzeugt. Das Element beinhaltet folgende Unterelemente:

  * ''<top> ''Oberer Seitenabstand (mm, Kommazahl z.B. 10.5)
  * ''<left> ''Linker Seitenabstand (mm, Kommazahl z.B. 10.5)
  * ''<width> ''Breite (mm, Kommazahl z.B. 10.5)
  * ''<height> ''Höhe (mm, Kommazahl z.B. 10.5)
  * ''<rotation> ''Rotationswinkel im Uhrzeigersinn in ° (optional, Standard: 0, ganzzahliger Wert) Rotationspunkt ist der Mittelpunkt der Textbox.
  * ''<pt> ''Schriftgröße (z.B ''<pt>''8''</pt>'') (optional, Standard: 12, ganzzahliger Wert)
  * ''<content> ''Inhalt der Textbox
  * ''<bold> ''Fettschrift (optional, Standard: 0, 0 = Deaktiviert, 1 = Aktiviert)
  * ''<weight> ''Fettschrift, überschreibt ''<bold>''  (optional, Standard: 0)
  * ''<italic> ''Kursivschrift (optional, Standard: 0, 0 = Deaktiviert, 1 = Aktiviert)
  * ''<underlined> ''Unterstreichung (optional, Standard: 0, 0 = Deaktiviert, 1 = Aktiviert)
  * ''<capitaliszed> ''Kapitälchen (optional, Standard: 0, 0 = Deaktiviert, 1 = Aktiviert)
  * ''<rgb> ''Textfarbe (optional, Standard: 000000, Hex-Farbwert)
  * '' <font>''Name der zu verwendenden Schriftart
  * ''<antialiased> ''Antialising (optional, Standard: 1, 0 = Deaktiviert, 1 = Aktiviert)
  * ''<halign> ''Horizontale Ausrichtung (optional, Standard: l; l = Links , r = Rechts, c = Mitte)
  * ''<fitting> ''Anpassung des Textes, wenn Textbox zu klein (optional, Standard: 0, 0 = Deaktiviert, 1 = Aktiviert)
  * ''<wrapping> ''Zeilenumbruch des Textes, sobald der Text das Ende der Textbox erreicht hat (optional, Standard: 0, 0 = Deaktiviert, 1 = Aktiviert)
  * ''<clipping> ''Beschneidung des Textes, wenn Textbox zu klein (optional, Standard: 0, 0 = Deaktiviert, 1 = Aktiviert) * ''<rtl> ''Rechts-Nach-Link Ausrichtung des Textes, z.B. für Arabisch (optional, Standard: 0, 0 = Deaktiviert, 1 = Aktiviert)
  * ''<padding> ''Einfügen eines vertikalen Abstands zwischen Text und Textboxrand (optional, Default 1, 0 = Deaktiviert, 1 = Aktiviert)
Das ''<textbox>''  Tag besitzt außerdem das optionale Attribut type, mit dem die Textbox eingeordnet werden kann. Über den Typ können in der Maske „Layout ändern“ Schriftart, Farbe etc. für alle Elemente desselben Typs geändert werden. Folgende Werte stehen zur Auswahl: * caption * label * content * footer

<panel type="warning" title=" " icon="glyphicon glyphicon-alert">**Achtung:**  Alle ''<textbox>''  Elemente gleichen Typs müssen die gleiche Formatierung besitzen, d.h. werden innerhalb der Elemente die oben beschriebenen Tags verwendet, müssen diese mit den gleichen Werten gefüllt werden. </panel>

<panel type="success" title=" " icon="glyphicon glyphicon-info-sign">**Hinweis:**  Soll das ''<textbox>''  Element in der Maske „Layout ändern“ nicht mittels einer der Type-Gruppen editierbar sein, muss das Attribut weggelassen werden. </panel> \\ \\

=== Das <frame> Element ===

Mit dem ''<frame>''  Element können Linien und Rahmen abgebildet werden. Das Element beinhaltet folgende Unterelemente:

  * ''<top>''Oberer Seiten-Offset (mm, Kommazahl z.B. 10.5) * ''<left>''Linker Seiten-Offset (mm, Kommazahl z.B. 10.5)
  * ''<width>''Breite (mm, Kommazahl z.B. 10.5)
  * ''<height>''Höhe (mm, Kommazahl z.B. 10.5)
  * ''<rotation>''Rotationswinkel im Uhrzeigersinn in ° (optional, Default: 0, int) Rotationspunkt ist der Mittelpunkt des Frames.
  * ''<solid>''Gefüllt (0 = FALSE, 1 = TRUE) * ''<rgb>''Farbe (optional, Default 000000 → Hex schwarz)
=== Das <bitmap> und <backgroundBitmap> Element ===

Mit dem ''<bitmap>''  Element können Bilder in die Vorlage eingefügt werden. Das Element beinhaltet folgende Unterelemente:

  * ''<top>''Oberer Seitenabstand (mm, Kommazahl z.B. 10.5) * ''<left>''Linker Seitenabstand (mm, Kommazahl z.B. 10.5) * ''<width>''Breite (mm, Kommazahl z.B. 10.5)
  * ''<height>''Höhe (mm, Kommazahl z.B. 10.5) * ''<halign>''Horizontale Ausrichtung (optional, Standard: l; l = Links , r = Rechts, c = Mitte)
  * ''<valign>''Vertikale Ausrichtung (optional, Standard: t; t = Oben , b = Unten, c = Mitte) * ''<rotation>''Rotationswinkel im Uhrzeigersinn in ° (optional, Standard: 0, ganzzahliger Wert). Rotationspunkt ist der Mittelpunkt der Grafik.
  * ''<ident>''Name des Bildes (Name aus der Datenbank)
Das spezielle ''<backgroundBitmap>''  Element identifiziert ein optionales Hintergrundbild. Es entspricht inhaltlich dem Element, darf aber nur einmal pro ''<page>''  verwendet werden und muss als erstes Element auf der Seite definiert werden. Bilder, die ohne „Contentmarker“ eingefügt werden (also statische Bilder), müssen in der Datenbank vorhanden sein, damit sie angezeigt werden. Sie können entweder zusammen mit dem Layout aus einer .vxlt Datei importiert werden oder über den Media Browser manuell hinzugefügt werden.