Erstellen einer Besuchsberichtsvorlage im HTML-Format

HTML-Platzhalter

In den HTML-Besuchsberichtsvorlagen werden Platzhalter durch Verwendung von Text eingerahmt von Markern im Content von HTML-Tags oder als Attribute von HTML-Elementen definiert. Es gibt fünf Arten von Platzhaltern. Drei davon werden durch Verwendung von Text definiert, der durch Marker eingerahmt ist. Zwei davon werden durch Attribute für HTML-Elemente definiert.

Layout

Als Teil des Inhalts von HTML-Tags können Platzhalter an jeder beliebigen Stelle des Dokuments eingefügt werden. Daher ist der folgende Aufbau vollständig gültig.

<span>Service-Auftragsnummer ##ServiceOrder## weist Anfangsdatum ##StartDate## auf.</span>

Die Platzhalter ##ServiceOrder## und ##StartDate## werden im eigentlichen Besuchsbericht durch die entsprechenden Werte des Besuchs ersetzt.

Zum Definieren eines Datensatzabschnitts werden zwei Attribute verwendet: "data-dataset" und "data-datasetrow".

Mit dem Attribut "data-dataset" wird das Element festgelegt, das vorhanden ist, wenn Einzeldatensätze im dataset-Datensatz vorhanden sind. Wenn der dataset-Datensatz keine Einzeldatensätze enthält, wird das Element überhaupt nicht angezeigt. Wenn Kopf- und Fußzeileninhalte nur angezeigt werden soll, wenn Einzeldatensätze vorhanden sind, müssen diese im Element enthalten sein. Wenn Kopf- und Fußzeileninhalte immer angezeigt werden sollen, auch wenn es keine Einzeldatensätze gibt, müssen sie sich außerhalb des Elements befinden.

Das Attribut "data-datasetrow" kennzeichnet das Element, das für jeden Einzeldatensatz des dataset-Datensatzes wiederholt wird. Jeder wiederholte Abschnitt wird mit den Datenwerten eines Einzeldatensatzes aus dem dataset-Datensatz gefüllt. Ein Element mit dem Attribut "data-datasetrow" wird häufig innerhalb eines Elements mit einem passenden "data-dataset"-Attribut definiert.

Damit die über-/Unterordnungsbeziehungen dargestellt werden können, muss das Datensatzelement des untergeordneten Elements im Zeilenelement des übergeordneten Datensatzes eingebettet sein. Diese Über-/Unterordnungsbeziehungen sind zwischen Service-Leistungen und beispielsweise Lohnkosten vorhanden.

Wenn im Falle von Service-Leistungen und Lohnkosten für die Service-Leistung Lohnkosten dargestellt werden müssen, muss das Datensatzelement für die Lohnkosten im Datensatzzeilenelement für die Service-Leistung eingebettet sein. Datensätze haben eine Struktur zur Erkennung, ob sie als untergeordneter Satz verwendet werden. Anstatt alle Lohnkosten eines Besuchs anzuzeigen, werden im Abschnitt mit den eingebetteten Lohnkosten nur die Lohnkosten für die aktuelle Service-Leistung angezeigt.

Keine Dokumentdatensatzelemente

Der Dokumentdatensatz (document dataset) ist der Basisdatensatz und hat nur einen Einzeldatensatz. Datensatzelement und Datensatzzeilenelement brauchen und sollten für den Dokumentdatensatz nicht ausgewiesen werden.

Optionales Datensatzelement

Das Ausweisen eines Datensatzelements mit dem "data-dataset"-Attribut, das Datensatzzeilenelemente enthält, ist optional. Wenn nur ein sich wiederholendes Element für den Datensatz angezeigt werden muss, kann nur ein Element mit dem "data-datasetrow"-Attribut ausgewiesen werden. Dies ist in Beispiel 2 dargestellt. Für den Service-Leistungsdatensatz (activities dataset) wird kein "data-dataset"-Attribut verwendet. Nur ein "data-datasetrow"-Attribut weist das Element aus, das für jeden Einzeldatensatz im Service-Leistungsdatensatz wiederholt werden soll.

Datenwerte es übergeordneten Elements im untergeordneten Element

Wenn ein Datensatz- oder ein Datensatzzeilenelement Platzhalter für Daten enthält, die keiner der Datensatzeigenschaften entsprechen, werden diese unter Verwendung des übergeordneten Datensatzes ersetzt. Wenn der übergeordnete Datensatz keine entsprechenden Daten enthält, wird der Platzhalter zugeordnet und durch die Werte aus dem Dokumentdatensatz ersetzt. Dies ist in Beispiel 2 dargestellt. Für die Datensatzzeile für Service-Leistungen (activities datasetrow) wird der Code des Service-Auftrags zusammen mit der Leistungsposition gedruckt. Dazu wird der Platzhalter ##ServiceOrderCode## des Dokumentdatensatzes verwendet.

Summen

Für alle Datensätze, mit denen Kosten angezeigt werden, werden Summen berechnet. In der Standardvorlage werden diese Summen im Absatz "Übersicht" (Summary) aufgeführt.

Die Platzhalter "Totalxxx" und "GrandTotal" zeigt Werte für alle Kosten der ausgewählten Service-Leistungen an. Die Einzelpositionen dieser Kosten müssen nicht unbedingt im Bericht angezeigt werden. Die Platzhalter "TotalDetailxxx" und "GrandDetailTotal" enthalten nur Werte aus den Einzelkostenpositionen.

Bearbeiten der Vorlage

Für das Bearbeiten einer HTML-Besuchsberichtsvorlage sind grundlegende HTML-Kenntnisse erforderlich. Eine HTML-Datei kann in einem Text-Editor geöffnet und dort bearbeitet werden. Es gibt aber viele weitaus bessere Tools, um HTML-Dateien zu erstellen und zu bearbeiten.

Stil und Abbildungen

Es werden keine externen Dateien durch die Vorlage unterstützt. Stil und Abbildungen müssen in der Vorlagendatei eingebettet sein. Der Stil in Form von CSS kann in den einzelnen Zeilen durch Verwendung des Style-Attributs in den HTML-Elementen oder intern auf Dokumentebene durch Verwendung des Style-Elements im Kopfbereich definiert werden. Abbildungen können in den HTML-Dokumenten selbst auf verschiedene Arten integriert werden.

Ein Beispiel für eine eingebettete Abbildung finden Sie in der HTML-Standardvorlage in LN. Die Vorlage kann aus dem Programm "Besuchsberichtsvorlagen" (tsmdm5100m000) importiert und heruntergeladen oder aus dem Programm "Zusätzliche Dateien" (ttadv2570m000, zusätzliche Datei tssocLN_Mobile_Service_Visit_Report_Template.html)" heruntergeladen werden.