Erstellen einer Besuchsberichtsvorlage im HTML-Format
HTML-Besuchsberichtsvorlagen werden ab der Version LN 10.5 und für die LN Cloud Edition unterstützt. Die HTML-Vorlagen können in LN Mobile Service für Windows, Android und iOS verwendet werden. Die RTF-Vorlagen können nur in der Windows-Version verwendet werden.
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.
Notation | Platzhalterarten |
---|---|
{{Labelname}} | Benennung |
##Name des Platzhalters## | Datenelement aus einem Datensatz |
%%Name des Platzhalters%% | Abbildung aus einem Datensatz |
data-dataset=”Datensatzname” (Attribut) | Datensatz-ID |
data-datasetrow=”Datensatzname” (Attribut) | Datensatzzeilen-ID |
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.
Rot: das Datensatzelement für Lohnkosten. Dieses Element und alles, was es enthält, wird angezeigt, wenn im dataset-Datensatz für die Lohnkosten (LaborCost) mindestens ein Einzeldatensatz vorhanden ist.
Orange: Das Datensatzzeilenelement wird für jeden Einzeldatensatz im dataset-Datensatz für die Lohnkosten wiederholt.
Blau: Elemente, die Teil des Dokumentdatensatzes (dataset) oder des übergeordneten Datensatzes sind.
Angenommen, Service-Auftrag ABC0001 mit Beginn am 01.08.2020 weist zwei Lohnkosten "Ausheben" und "Füllen" mit einer bzw. zwei Stunden Arbeitszeit auf. Die oben dargestellte Vorlage kann zu dem unten aufgeführten Besuchsbericht führen.
Service-Auftragsnummer ABC0001 hat Anfangsdatum 01.08.2020.
Lohnkosten | |
Stunden | Aufgabe |
1:00 | Ausheben |
2:00 | Füllen |
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.
Grün: Das Datensatzzeilenelement (datasetrow) wird für jeden Einzeldatensatz im dataset-Datensatz der Service-Leistungen wiederholt.
Rot: das Datensatzelement für Lohnkosten. Dieses Element wird mit allem angezeigt, wenn mindestens ein Einzeldatensatz im Datensatz für die Lohnkosten (LaborCost dataset) vorhanden ist.
Orange: Das Datensatzzeilenelement wird für jeden Einzeldatensatz im dataset-Datensatz für die Lohnkosten wiederholt.
Blau: Elemente, die Teil des Dokumentdatensatzes (document dataset) sind.
Angenommen, Service-Auftrag ABC0055 mit Beginn am 07.08.2021 weist zwei Service-Leistungen auf: Kabel prüfen und Zeichen korrigieren. Die erste Service-Leistung "Kabel prüfen" weist zwei Lohnkosten (Ausheben und Füllen) auf, für die eine bzw. zwei Stunden notiert sind. Die zweite Service-Leistung "Zeichen korrigieren" weist keine Lohnkosten auf. Die oben dargestellte Vorlage führt zu dem nachfolgenden Besuchsbericht.
Service-Auftragsnummer ABC0055 hat Anfangsdatum 07.08.2021.
Service-Leistung "Kabel prüfen"
ABC0055-1
Lohnkosten | |
Stunden | Aufgabe |
1:00 | Ausheben |
2:00 | Füllen |
Service-Leistung "Zeichen korrigieren"
ABC0055-2
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.