[[:de:v3:vistrax:verbindungseinstellungen|ZURÜCK]] [[:de:v3:vistrax:einrichtungshilfen|WEITER]] \\ \\ ===== KAPITEL 8: Das XML-Layout Schema ===== ==== Einführung ==== Innerhalb von vistrax werden XML-Layout-Vorlagen an zwei entscheidenden Stellen eingesetzt: * Vorlagen für Besucherausweise * Vorlagen für Besucherscheine Die Nutzung von XML-basierten Layout-Vorlagen ermöglicht es Ihnen ein individuelles Layout zu erstellen und zu verwenden. Das eingesetzte Layout kann während der Benutzung gewechselt werden. \\ \\ Die Platzhalter für dynamische Informationen (sog. XML-Elemente/-Tags) können je nach Anforderung von Ihnen hinzugefügt oder entfernt werden. XML-Dateien für vistrax sind mit der Kodierung UTF8 ohne BOM zu speichern. Eine andere Kodierung kann während des Imports unter Umständen nicht richtig verarbeitet werden. Beim Bearbeiten einer exportierten XML-Layout-Vorlage ist darauf zu achten, dass ein geeigneter Editor verwendet wird, welcher die notwendige Kodierung der XML-Datei nicht verändert. Wir empfehlen den kostenlosen Editor [[https://notepad-plus-plus.org/downloads/|Notepad++]]. ==== 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: * Root-Element eines Layouts * Definiert eine Seite des Layouts * Definiert durch seine Unterelemente die Layout-Größe * Element zum Anzeigen von Text * Rahmen-/Linienelement * Bildelement * Hintergrundbild (Achtung: nur einmal pro -Element zu verwenden!) === Das Element === Das Element ist das Root-Element einer XML-basierten Layout-Vorlage, durch das die komplette Layout-Definition umschlossen wird. === Das Element === Das Element entspricht einer Seite eines Besucherausweises bzw. Besucherscheins. Alle Layout-Elemente, die von Tags umschlossen werden, werden auf derselben Seite dargestellt. Das erste Element einer Layout-Definition muss das Element enthalten, mit dem die Größe des Layouts festgelegt wird. Das 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. Das Attribut "paper" kann in jedem Element angegeben werden, zur Zeit wird aber nur das Attribut des ersten Elements in einem Layout ausgewertet und als Papier-Typ für alle vorhandenen Seiten verwendet. === Das Element === Das Element definiert verschiedene Eigenschaften einer Layout-Seite. Unter anderem wird die Größe des Layouts definiert. Das Element beinhaltet folgende Unterelemente: * Name des Layouts (optional, wird im Vorschau-Fenster als Titeltext angezeigt) * Vertikale Größe in mm * Horizontale Größe in mm * Spiegelung des Inhaltes beim Druck um die horizontale Achse (optional, 0 = Deaktiviert, 1 = Aktiviert, Standard: 0) === Das Element === Mit dem Element wird ein Text im Layout erzeugt. Das Element beinhaltet folgende Unterelemente: * Oberer Seitenabstand (mm, Kommazahl z.B. 10.5) * Linker Seitenabstand (mm, Kommazahl z.B. 10.5) * Breite (mm, Kommazahl z.B. 10.5) * Höhe (mm, Kommazahl z.B. 10.5) * Rotationswinkel im Uhrzeigersinn in ° (optional, Standard: 0, ganzzahliger Wert) Rotationspunkt ist der Mittelpunkt der Textbox. * Schriftgröße (z.B 8) (optional, Standard: 12, ganzzahliger Wert) * Inhalt der Textbox * Fettschrift (optional, 0 = Deaktiviert, 1 = Aktiviert, Standard: 0) * Fettschrift, überschreibt (optional, Standard: 0) * Kursivschrift (optional, 0 = Deaktiviert, 1 = Aktiviert, Standard: 0) * Unterstreichung (optional, 0 = Deaktiviert, 1 = Aktiviert, Standard: 0) * Kapitälchen (optional, 0 = Deaktiviert, 1 = Aktiviert, Standard: 0) * Textfarbe (optional, Standard: 000000, Hex-Farbwert) * Name der zu verwendenden Schriftart * Antialising (optional, 0 = Deaktiviert, 1 = Aktiviert, Standard: 1) * Horizontale Ausrichtung (optional, Standard: l; l = Links , r = Rechts, c = Mitte) * Anpassung des Textes, wenn Textbox zu klein (optional, 0 = Deaktiviert, 1 = Aktiviert, Standard: 0) * Zeilenumbruch des Textes, sobald der Text das Ende der Textbox erreicht hat (optional, 0 = Deaktiviert, 1 = Aktiviert, Standard: 0) * Beschneidung des Textes, wenn Textbox zu klein (optional, 0 = Deaktiviert, 1 = Aktiviert, Standard: 0) * Rechts-Nach-Link Ausrichtung des Textes, z.B. für Arabisch (optional, 0 = Deaktiviert, 1 = Aktiviert, Standard: 0) * Einfügen eines vertikalen Abstands zwischen Text und Textboxrand (optional, 0 = Deaktiviert, 1 = Aktiviert, Standard = 1) Das 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 Alle Elemente des gleichen Typs müssen die gleiche Formatierung besitzen. Werden innerhalb der Elemente die oben beschriebenen Tags verwendet, müssen diese mit den gleichen Werten gefüllt werden. Soll das Element in der Maske „Layout ändern“ nicht mittels einer der Type-Gruppen editierbar sein, muss das Attribut weggelassen werden. === Das Element === Mit dem Element können Linien und Rahmen abgebildet werden. Das Element beinhaltet folgende Unterelemente: * Oberer Seiten-Offset (mm, Kommazahl z.B. 10.5) * Linker Seiten-Offset (mm, Kommazahl z.B. 10.5) * Breite (mm, Kommazahl z.B. 10.5) * Höhe (mm, Kommazahl z.B. 10.5) * Rotationswinkel im Uhrzeigersinn in ° (int, optional, Default: 0) Rotationspunkt ist der Mittelpunkt des Frames. * Gefüllt (0 = FALSE, 1 = TRUE) * Farbe (optional, Default: 000000 → Hex schwarz) === Das und Element === Mit dem Element können Bilder in die Vorlage eingefügt werden. Das Element beinhaltet folgende Unterelemente: * Oberer Seitenabstand (mm, Kommazahl z.B. 10.5) * Linker Seitenabstand (mm, Kommazahl z.B. 10.5) * Breite (mm, Kommazahl z.B. 10.5) * Höhe (mm, Kommazahl z.B. 10.5) * Horizontale Ausrichtung (optional, Standard: l; l = Links , r = Rechts, c = Mitte) * Vertikale Ausrichtung (optional, Standard: t; t = Oben , b = Unten, c = Mitte) * Rotationswinkel im Uhrzeigersinn in ° (optional, Standard: 0, ganzzahliger Wert). Rotationspunkt ist der Mittelpunkt der Grafik. * Name des Bildes (Name aus der Datenbank) Das spezielle Element identifiziert ein optionales Hintergrundbild. Es entspricht inhaltlich dem Element, darf aber nur einmal pro 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. ==== Contentmarker ==== Neben der Unterstützung von statischen Texten und Bildern bietet das Layout-System die Möglichkeit, Texte und Bilder mit dynamischen Inhalten zu füllen. Diese Inhalte werden dann aus den aktuellen Laufzeitinformationen ermittelt (z. B. des Mandanten, des Besuchers, der Firma etc.). Dynamische Inhalte werden mittels fest definierten Platzhaltern (sog. „Contentmarker“) eingefügt. === - Contentmarker === Bei einer Textbox kann der statische Inhalt des '''' Unterelementes durch einen der folgenden Contentmarker ersetzt werden: %%badge_no%% Ausweisnummer \\ %%badge_barcode%% Ausweisnummer als barcode \\ %%mandator_name%% Name der Mandanten \\ %%company_name%% Name der Besucher-Firma \\ %%company_city%% Stadt der Besucher-Firma \\ %%company_country%% Land der Besucher-Firma \\ %%company_remarks%% Hinweise zur Firma, aktivieren Sie das Wrapping-Element des -Elementes bei langen Texten (1). \\ %%visitor_salutation%% Anrede des Besuchers \\ %%visitor_title%% Titel des Besuchers \\ %%visitor_firstname%% Vorname des Besuchers \\ %%visitor_lastname%% Nachname des Besuchers \\ %%visitor_email%% E-Mail des Besuchers \\ %%visitor_phone%% Telefonnummer des Besuchers \\ %%visitor_mobile%% Mobiltelefonnummer des Besuchers \\ %%visitor_category%% Besucherkategorie \\ %%visitor_name%% \\ %%visitor_name2%% , \\ %%visitor_name3%% \\ %%visitor_remarks%% Hinweise zum Besucher, aktivieren Sie das Wrapping-Element des -Elementes bei langen Texten (1). \\ %%identitycardno%% Personalausweisnummer \\ %%employee_salutation%% Anrede des Mitarbeiters \\ %%employee_title%% Titel des Mitarbeiters \\ %%employee_firstname%% Vorname des Mitarbeiters \\ %%employee_lastname%% Nachname des Mitarbeiters \\ %%employee_division%% Abteilung des Mitarbeiters \\ %%employee_email%% E-Mail des Mitarbeiters \\ %%employee_phone%% Telefonnummer des Mitarbeiters \\ %%employee_mobile%% Mobiltelefonnummer des Mitarbeiters \\ %%employee_name%% \\ %%employee_name2%% , \\ %%employee_name3%% \\ %%valid_from%% Anfangsdatum Gültigkeit (Datum & Zeit) \\ %%valid_from_dateonly%% Anfangsdatum Gültigkeit (nur Datum) \\ %%valid_from_timeonly%% Anfangsdatum Gültigkeit (nur Uhrzeit) \\ %%valid_to%% Enddatum Gültigkeit (Datum & Zeit) \\ %%valid_to_dateonly%% Enddatum Gültigkeit (nur Datum) \\ %%valid_to_timeonly%% Enddatum Gültigkeit (nur Uhrzeit) \\ %%valid_date_time_line1%% Informationen zum Gültigkeitszeitraum, abhängig vom Validity Mode nur mit …_Line2 zu verwenden. \\ %%valid_date_time_line2%% Informationen zum Gültigkeitszeitraum, abhängig vom Validity Mode nur mit …_Line1 zu verwenden. \\ %%date%% Das aktuelle Datum \\ %%time%% Die aktuelle Uhrzeit \\ %%now%% Das aktuelle Datum und die aktuelle Uhrzeit \\ %%vehicle%% Kfz-Nummernschild \\ %%visit_remarks%% Hinweise zum Besuch, aktivieren Sie das Wrapping-Element des -Elementes bei langen Texten (1). \\ %%reason%% Besuchsgrund \\ %%gate%% Eingang \\ %%whereabouts%% Aufenthaltsort(e) \\ %%_%% Ein Leerzeichen zwischen zwei anderen Contentmarkern. Dadurch lassen sich überflüssige Leerzeichen vermeiden, falls einer der umschließenden Contentmarker ohne Inhalt ist. Sollten durch die Ersetzungen der anderen Contentmarker mehrere aufeinanderfolgende %%_%% entstehen (z.B. weil der Inhalt eines Contentmarkers nicht existiert), so werden diese zu einem Leerzeichen zusammengefasst. Kombinationen aus einem Leerzeichen und einem %%_%%-Contentmarker werden zu einem Leerzeichen zusammengefasst. %%_%%-Contentmarker zu Beginn und zu Ende eines Textes werden entfernt. \\ \\ == Beispiele: == * DayLong: %valid_date_time_line1% = 01.02.2013 - 02.02.2013 %valid_date_time_line2% = * DayToDay: %valid_date_time_line1% = 01.02.2013 - 02.02.2013 %valid_date_time_line2% = 08:00:00 - 17:00:00 * Continuous: %valid_date_time_line1% = 01.02.2013 08:00:00 - %valid_date_time_line2% = 02.02.2013 17:00:00 \\ \\ === - Contentmarker === Bei einem Bild kann der statische Inhalt des '''' Unterelementes durch einen der folgenden Contentmarker ersetzt werden: %%company_logo%% Firmenlogo der Besucher-Firma %%mandator_logo%% Mandantenlogo %%visitor_photo%% Foto des Besuchers %%employee_photo%% Foto des Mitarbeiters \\ \\ ==== Aufbau einer Layout-Vorlage ==== === Grundgerüst === Das Grundgerüst einer Layout-Vorlage besteht aus einem einzigen '''' Element und mehreren '''' (inkl. '''') Elementen. Der Aufbau ist wie nachfolgend skizziert: 120 90 Das obige Grundgerüst stellt lediglich eine leere Seite dar. Das Grundgerüst kann durch weitere Page-Elemente ergänzt werden. [[:de:v3:vistrax:xmllayout:beispiel|→Ein ausführlicheres Beispiel finden Sie hier← ]] \\ \\ [[:de:v3:vistrax:verbindungseinstellungen|ZURÜCK]] [[:de:v3:vistrax:einrichtungshilfen|WEITER]]