RTF-sjabloon Verslag van bezoek aanmaken

De sjabloon wordt opgeslagen als RTF-document (.rtf). U kunt de sjabloon aanmaken of wijzigen met een tekstverwerker die RTF-bestanden ondersteunt.
In alle voorbeelden en afbeeldingen in deze gebruikershandleiding wordt de lay-out van de standaardsjabloon gebruikt. De volledige default sjabloon is toegevoegd in de bijlage Default sjabloon voor verslag van bezoek. De default sjabloon is ook in LN beschikbaar in de sessie Sjablonen verslag van bezoek (tsmdm5100m000).
NB

De RTF-sjablonen worden gebruikt voor LN Mobile Service voor Windows, en dus niet voor de Android/iOS-versie. In de Android/iOS-versie worden HTML-sjablonen gebruikt.

Tijdelijke aanduidingen in RTF-documenten

In RTF-sjablonen voor bezoekverslagen worden tijdelijke aanduidingen gedefinieerd door middel van tekst binnen markeringen. Er zijn vier typen tijdelijke aanduidingen. Deze worden alle gedefinieerd door tekst te gebruiken binnen markeringen.

Notatie Typen tijdelijke aanduiding
<<label name>> Label
##naam tijdelijke aanduiding## Gegevenselement uit een gegevensset
%%naam tijdelijke aanduiding%% Afbeelding uit een gegevensset
[[ID gegevensset]] ID gegevensset
Tabel 1. Voorbeeld van tijdelijke aanduidingen:
##DepartmentName## <<Order>> ##ServiceOrder##

##DepartmentAddress##

<<OrderReference>>

<<StartTime>>

<<ServiceEngineer>>

##ReferenceA##

##StartTime##

##Engineer##

In dit voorbeeld zijn <<Order>>, <<OrderReference>> enzovoort labels (te vertalen tijdelijke aanduidingen voor tekst). ##DepartmentName##, ##ServiceOrder## enzovoort zijn gegevenselementen. In dit geval worden deze opgehaald uit de gegevensset op documentniveau. Doordat deze gegevensset voor documenten algemeen beschikbaar is, kunnen deze tijdelijke aanduidingen overal in het document worden gebruikt. Zie de bijlage Tijdelijke aanduidingen voor Sjabloon verslag van bezoek voor een lijst met alle tijdelijke aanduidingen.

Het bovenstaande voorbeeld kan tot het volgende resultaat leiden wanneer het verslag wordt gegenereerd en de tijdelijke aanduidingen worden vervangen door specifieke gegevens.
Serviceafdeling NL Serviceorder SOO001407

Het Torentje

Binnenhof 19

2513 AA Den Haag, Zuid Holland

Nederland

Referentie

Starttijd

Servicemedewerker

CUST_B_00012

15-8-2016 10:28

Jan Jansen

Lay-out

Tijdelijke aanduidingen kunnen overal in het RTF-document worden opgenomen. Daarom is een constructie zoals Serviceordernummer ##ServiceOrder## heeft als startdatum ##StartDate## volledig geldig.

Om elementen uit te lijnen, kunt u gebruikmaken van tabs en tabellen. Tabellen kunnen worden ingevoegd. Kolommen en/of rijen kunnen worden samengevoegd. Zo is bijvoorbeeld een tabel met twee rijen, met in de eerste rij één cel en in de tweede rij drie cellen, geldig.

<<VertaaldeTekst>>
##FieldA## ##FieldB## ##FieldC##

Met de hierboven getoonde lay-out worden de velden A, B en C opgehaald uit de gegevensset voor documenten.

Om gegevens uit een andere gegevensset weer te geven, dient een lay-outconventie te worden gevolgd. Alle tijdelijke aanduidingen die onderdeel uitmaken van een specifieke gegevensset, moeten in een tabel staan. De ID van de gegevensset is belangrijk voor de lay-outconventie. De ID moet in de eerste rij, in de eerste cel, als eerste tekst in de tabel worden ingevoerd.

Lay-outconventie voor gegevenssets:

[[DataSetIdentifier]]
<<HeaderTextA>> <<HeaderTextB>> <<HeaderTextC>>
##FieldA## ##FieldB## ##FieldC##

De gegevenssetconventie definieert drie of meer rijen.

  • De eerste rij moet de ID van de gegevensset bevatten (met de markering [[ ]]). Zie ook de definities voor gegevenssets die eerder in deze handleiding zijn beschreven. Als de ID van de gegevensset niet kan worden gevonden, wordt de tabel gezien als een lay-outtabel. Zie hierboven. De rij met gegevensset-ID's wordt verwijderd na het samenvoegen.
  • De laatste rij wordt zo vaak herhaald als de gegevensset records bevat. De tijdelijke aanduiding van elke herhaalde rij wordt vervangen door de waarde van de record in de gegevensset. Als de lay-outrij tijdelijke aanduidingen 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.
  • Alle overige rijen zijn koprijen (nul, één of meer). De koprijen bevatten meestal tijdelijke aanduidingen die at runtime (in het daadwerkelijke verslag van bezoek) worden vervangen door vertaalde tekst (<< >>). Als de koprijen tijdelijke aanduidingen bevatten die at runtime worden vervangen door gegevens, dan worden die gegevens vervangen op basis van de parent-gegevensset. Indien niet van toepassing, worden tijdelijke aanduidingen vervangen door gegevens uit de gegevensset voor documenten.

Het minimum aantal rijen voor een gegevenssettabel is twee. Koprijen zijn optioneel.

Voorbeeld met twee koprijen:

[[MaterialCost]]
<<Materials>>
<<Quantity>> <<ItemCode>> <<ItemDescription>> <<Amount>>
##Quantity## ##Item## ##Description## ##AmountOrCoverage##

Voorbeeld zonder koprijen:

[[MaterialCost]]
##Quantity## ##Item## ##Description## ##AmountOrCoverage##

Geneste lay-out

Om parent/child-relaties weer te geven, is er een extra conventie gedefinieerd. Bij activiteiten en materialen geldt dat, als materialen per activiteit moeten worden weergegeven, de materiaaltabel genest moet zijn in de activiteittabel. Gegevenssets hebben een structuur waarmee kan worden aangetoond of ze als child-set worden gebruikt. In plaats van al het materiaal voor een bezoek weer te geven, wordt alleen het materiaal voor de huidige activiteit weergegeven in de geneste materiaaltabellen.

NB

Wees voorzichtig als u de geneste tabellen in de laatste rij invoegt. Als er meer dan één tabel nodig is (u wilt bijvoorbeeld materiaalkosten, loonkosten en overige kosten weergeven), kunnen de tabellen worden ingevoegd in dezelfde cel. U kunt dit doen door achter elke tabel op Enter te drukken en de volgende tabel in te voeren. Zie ook de lay-out van Materials - LaborCost - OtherCost in bijlage Default sjabloon voor verslag van bezoek.

In Microsoft Word is dit eenvoudig. Plaats de cursor in een tabelcel. Ga vervolgens naar het tabblad Invoegen en selecteer dan Tabel toevoegen.

Conventie voor de lay-out van geneste gegevenssets:

[[DataSetIdentifier]]
<<HeaderTextA>> <<HeaderTextB>> <<HeaderTextC>>
##FieldA## ##FieldB## ##FieldC##
[[DataSetIdentifier]]
<<HeaderTextX>> <<HeaderTextY>> <<HeaderTextZ>>
##FieldX## ##FieldY## ##FieldZ##

Voorbeeld van de lay-out van een geneste gegevensset:

[[Activities]]
<<Activity>> ##Description##
[[MaterialCost]]
<<Materials>>
<<Quantity>> <<ItemCode>> <<Description>>
##Quantity## ##Item## ##ItemDescription##

In het bovenstaande voorbeeld is een gegevensset met materiaalkosten [[MaterialCost]] genest in een gegevensset voor activiteiten [[Activities]]. ##Description## wordt opgehaald uit de gegevensset voor activiteiten. ##Quantity##, ##Item## en ##ItemDescription## worden opgehaald uit de gegevensset voor materiaalkosten.

Voorbeeld van het resultaat van een lay-out van geneste gegevensset:

Vak Activiteitenreparatie
Materialen
Hoeveelheid Artikelcode Omschrijving
6 stuks AVDK17 Spaanplaat
3 dozen AVDK1501 Spijkers

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 waarden 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.

U kunt dus kiezen of u alleen de totalen wilt weergeven zonder details, of dat u de details wilt weergeven en vervolgens de totalen van die details.

De sjabloon bewerken

De sjabloon moet zijn opgeslagen als .rtf-bestand. Microsoft Word kan dit bestandstype verwerken, maar er zijn ook andere tekstverwerkingsprogramma's die deze mogelijkheid bieden. Na het aanmaken van de sjabloon moet hij worden opgeslagen als .rtf-bestand.

NB

Hoewel de lay-out op het scherm er hetzelfde uit kan zien in alle tekstverwerkers (en de applicatie), zal het bestand in afgedrukte vorm verschillen bevatten. Als u voorbedrukt papier gebruikt, is het dan ook belangrijk de sjabloon eerst met echte gegevens te testen, opgeslagen als PDF-bestand.

De sjabloon bewerken

De sjabloon moet zijn opgeslagen als .rtf-bestand. Microsoft Word kan dit bestandstype verwerken, maar er zijn ook andere tekstverwerkingsprogramma's die deze mogelijkheid bieden. Na het aanmaken van de sjabloon moet hij worden opgeslagen als .rtf-bestand.

NB

Hoewel de lay-out op het scherm er hetzelfde uit kan zien in alle tekstverwerkers (en de applicatie), zal het bestand in afgedrukte vorm verschillen bevatten. Als u voorbedrukt papier gebruikt, is het dan ook belangrijk de sjabloon eerst met echte gegevens te testen, opgeslagen als PDF-bestand.

Tip: Tijdelijke aanduidingen bewerken

Typ bij het toevoegen of wijzigen van tijdelijke aanduidingen de volledige tijdelijke aanduiding in één handeling en wijzig niet alleen afzonderlijke tekens. Dit is nodig omdat Word soms onzichtbare markeringen toevoegt in het RTF-document. Wanneer dit gebeurt, kan de samenvoegfunctionaliteit de sjabloon niet goed interpreteren en wordt de tijdelijke aanduiding niet vervangen in het verslag van bezoek. Als er sprake is van tijdelijke aanduidingen die correct zijn gespeld maar niet de samengevoegde waarde tonen, bewerkt u het sjabloondocument en typt u de tijdelijke aanduiding opnieuw van begin tot eind, inclusief de begin- en eindmarkeringen.

Tip: Weblay-out-weergave in MS Word-instellingen

Als u Microsoft Word als tekstverwerkingsprogramma gebruikt, wordt het aanbevolen om de Weblay-out-weergave te gebruiken. Selecteer in de menubalk het tabblad BEELD en klik op Weblay-out-weergave. De tabelranden buiten de rechtermarge van het papier zijn zichtbaar en kunnen worden bewerkt.

Tip: rasterlijnen weergeven

De rasterlijnen van cellen kunnen ook worden weergegeven. Default is dit echter niet ingeschakeld. Ga voor het inschakelen van deze functie naar het tabblad Start, klik op het pijltje bij de optie Randen en klik op Rasterlijnen weergeven. De randen zonder zichtbare lijn worden nu weergegeven als een stippellijn.