HTML-sjabloon Verslag van bezoek aanmaken

Tijdelijke aanduidingen voor HTML

In HTML-sjablonen voor bezoekverslagen worden tijdelijke aanduidingen ofwel gedefinieerd door middel van tekst tussen markeringen binnen de inhoud van HTML-tags, ofwel als attributen van HTML-elementen. Er zijn vijf typen tijdelijke aanduidingen. Drie van deze typen gedefinieerd door middel van tekst binnen markeringen. Twee typen worden gedefinieerd door attributen van HTML-elementen.

Lay-out

Tijdelijke aanduidingen kunnen overal worden opgenomen als onderdeel van de inhoud van HTML-tags in het document. De volgende constructie is dan ook volledig geldig.

<span>Service order number ##ServiceOrder## heeft als startdatum ##StartDate##</span>.

De tijdelijke aanduidingen ##ServiceOrder## en ##StartDate## worden vervangen door de bijbehorende waarden van het bezoek in het specifieke verslag van bezoek.

Voor het definiëren van een sectie met een gegevensset worden de twee attributen 'data-dataset' en 'data-datasetrow' gebruikt.

Het attribuut 'data-dataset' duidt het element aan dat aanwezig is als de gegevensset een of meer records bevat. Als de gegevensset geen records bevat, wordt het element niet weergegeven. Als kop- en voettekstinhoud alleen moet worden weergegeven als er records aanwezig zijn, moet deze worden opgenomen in dit element. Als een kop- en voettekstinhoud altijd moet worden weergegeven, zelfs als er geen records aanwezig zijn, moet deze buiten dit element staan.

Het attribuut 'data-datasetrow' duidt het element aan dat voor elk record in de gegevensset wordt herhaald. Elke herhaalde sectie wordt gevuld met de gegevenswaarden van één record uit de gegevensset. Een element met het attribuut 'data-datasetrow' wordt vaak gedefinieerd binnen een element met een bijbehorend 'data-dataset'-attribuut.

Om parent/child-relaties te kunnen weergeven, moet het element van de gegevensset van de child zijn genest in het rij-element van de gegevensset van de parent. Deze parent/child-relaties zijn aanwezig tussen activiteiten en bijvoorbeeld loonkosten.

Bij activiteiten en loonkosten geldt dat, als de loonkosten moeten worden weergegeven per activiteit, het element van de gegevensset voor de loonkosten moet zijn genest in het rij-element van de gegevensset voor de activiteit. Gegevenssets hebben een structuur waarmee kan worden aangetoond of ze als child-set worden gebruikt. In plaats van alle loonkosten voor een bezoek weer te geven, worden alleen de loonkosten voor de huidige activiteit weergegeven in de sectie met geneste loonkosten.

Geen elementen van Document-gegevensset

De Document-gegevensset is de basisgegevensset en bevat slechts één record. Het dataset-element en datasetrow-element hoeven en mogen niet worden toegewezen voor de Document-gegevensset.

Optioneel element van gegevensset

Het toewijzen van een element van een gegevensset met het attribuut 'data-dataset' dat de datasetrow-elementen bevat, is optioneel. Als alleen een herhalend element van de gegevensset hoeft te worden weergegeven, kan alleen een element met het attribuut 'data-datasetrow' worden toegewezen. Dit wordt getoond in voorbeeld 2. Voor de Activities-gegevensset wordt geen 'data-dataset'-attribuut gebruikt. Alleen een 'data-datasetrow'-attribuut duidt het element aan dat moet worden herhaald voor elke record in de Activities-gegevensset.

Waarden van parent-gegevens in child

Als een gegevensset of datasetrow-element tijdelijke aanduidingen met gegevens bevat die niet overeenkomen met de eigenschappen van de gegevensset, vindt er vervanging plaats door de parent-gegevensset te gebruiken. Wordt er geen match gevonden in de parent-gegevensset, dan wordt de tijdelijke aanduiding gematcht en mogelijk vervangen met/door de waarden in de gegevensset voor documenten. Dit wordt getoond in voorbeeld 2. Voor de Activities-datasetrow wordt de code van de serviceorder in combinatie met activiteitregel afgedrukt met behulp van de tijdelijke aanduiding ##ServiceOrderCode## in de Document-gegevensset.

Totalen

Voor elke gegevensset met kosten worden totalen berekend. In de defaultsjabloon worden deze totalen weergegeven in de overzichtsalinea.

De tijdelijke aanduidingen Totalxxx en GrandTotal geven de totaalwaarden weer van alle kosten van de geselecteerde activiteiten. De detailregels van deze kosten hoeven niet per se worden opgenomen in het verslag. De tijdelijke aanduidingen TotalDetailxxx en GrandDetailTotal bevatten alleen waarden van de detailkostenregels.

De sjabloon bewerken

Het bewerken van een HTML-sjabloon voor bezoekverslagen vereist enige basiskennis van HTML. Een HTML-bestand kan worden bewerkt door het te openen in een teksteditor, maar er zijn ook tal van andere geavanceerde tools beschikbaar voor het aanmaken en bewerken van HTML-bestanden.

Opmaak en afbeeldingen

De sjabloon ondersteunt geen externe bestanden. De opmaak en afbeeldingen moeten worden ingesloten in het sjabloonbestand. Opmaak in de vorm van CSS kan inline worden gedefinieerd door het stijlkenmerk in HTML-elementen te gebruiken, of intern op documentniveau door een stijlelement in de kopsectie te gebruiken. Afbeeldingen kunnen op verschillende manieren direct in het HTML-document worden ingesloten.

Zie de default HTML-sjabloon in LN voor een voorbeeld van het insluiten van een afbeelding. Deze sjabloon kan worden geïmporteerd en gedownload vanuit de sessie Sjablonen verslag van bezoek (tsmdm5100m000) of worden gedownload vanuit de sessie Extra bestanden (ttadv2570m000, extra bestand tssocLN_Mobile_Service_Visit_Report_Template.html).