Om gegevens uit docu tools weer te geven in een pdf- of excel-Rapport, gebruiken we placeholders. Deze placeholders dienen als markeringen binnen uw Sjabloon en geven aan waar de gegevens uit docu tools moeten worden ingevoegd. U kunt bijvoorbeeld een placeholder zoals {{project-name}} in het Sjabloon maken, die bij het genereren van het Rapport dynamisch wordt gevuld met de daadwerkelijke projectnaam in docu tools.
Er zijn verschillende groepen placeholders voor Excel en voor Word, aangezien sommige alleen in de ene of de andere beschikbaar zijn. Door deze placeholders effectief te gebruiken, kunt u dynamische en flexibele Sjablonen maken die de gegevens uit uw projecten, Rapporten en Taken nauwkeurig weergeven.
Syntax en vormgeving van placeholders
Alle placeholders zijn ingesloten in dubbele accolades {{ }} en moeten de opgegeven syntax nauwkeurig volgen, ongeacht de taal die in de Sjabloontekst wordt gebruikt: Bijvoorbeeld, {{pin-number}} is een geldige placeholder die het Nummer van de geselecteerde Pin ophaalt. Placeholders zoals {pin-number}, {{pinnummer}} of {{pinnumber}} zijn echter ongeldig vanwege een verkeerde syntax en werken niet.
Placeholders werken niet als ze spaties bevatten. Om een placeholder voor een meerwoordige Titel te maken, vervangt u de spatie door een koppelteken -, bijvoorbeeld gebruik {{dataset-room-info}} in plaats van {{dataset-Room info}}.
Het uiterlijk van de output wordt gedefinieerd op basis van de opmaak van de placeholder in het Sjabloon. Als uw Rapport er dus niet uitziet zoals u wilt, moet u het Sjabloon wijzigen. Anderzijds worden de dynamische gegevens weergegeven zoals ze in docu tools zijn ingevoerd. Als er bijvoorbeeld een typfout is in de weergegeven Pin-Titel, moet deze in de betreffende Pin in docu tools worden gewijzigd.
Bereiken van placeholders
Bij het werken met Taak- en Pin-placeholders moet een specifieke structuur worden gevolgd. Omdat Pins en Taken vaak worden herhaald in een Rapport, is het belangrijk om het specifieke gedeelte te definiëren waarin deze placeholders verschijnen. Dit beperkte gebied wordt gevuld met gegevens van een Pin of Taak, die zo vaak worden herhaald als ze in het Rapport voorkomen.
Deze secties beginnen altijd met {{pins}} of {{tasks}} en eindigen met {/pins}} of {{/tasks}}. Alle inhoud tussen deze placeholders wordt herhaaldelijk weergegeven, afhankelijk van het aantal Pins of Taken. Het is belangrijk op te merken dat de extra / uitsluitend in de sluitende tag is opgenomen.
Andere bereiken omvatten:
{{pin-sort}}en{{/pin-sort}}- Gebied voor placeholders voor Pin-sortering.{{pin-medias}}en{{/pin-medias}}- Ruimte voor{{pin-media-file-name}}in Excel-Rapporten.{{comments}}en{{/comments}}- Gebied voor Taakcommentaren.{{attendees}}en{{/attendees}}- Sectie voor contactplaceholders.
Er zijn ook secties waarin de tekst alleen wordt weergegeven als aan een voorwaarde is voldaan. Normaal gesproken worden de placeholders in het Rapport niet weergegeven als er geen gegevens zijn om ze te vullen. Als er bijvoorbeeld geen Taken in een bepaalde Pin zijn, worden de Taakplaceholders niet weergegeven. Om echter een kop toe te voegen die wordt weergegeven wanneer de betreffende inhoud aanwezig is, zijn If-placeholders geïntroduceerd. Deze secties worden buiten de openende en sluitende placeholders geplaatst en verifiëren de aanwezigheid van inhoud. Koppen worden alleen weergegeven als er daadwerkelijk inhoud is die aan de opgegeven voorwaarde voldoet.
We hebben de volgende if-secties gedefinieerd:
{{if-tasks}}en{{end-if-tasks}}- Koppen worden alleen weergegeven als er minstens één actieve Taak in de Pin is.{{if-media}}en{{end-if-media}}- Koppen worden alleen weergegeven als er daadwerkelijk Media-inhoud aanwezig is.{{if-task-comment}}en{{/if-task-comment}}- Koppen worden alleen weergegeven als de Taak commentaren bevat.
Deze placeholders kunnen bijvoorbeeld als volgt worden gebruikt:
{{pins}}{{if-media}}Pin Foto's{{end-if-media}}{{picture-table-small}}{{/pins}}
De kop "Pin Foto's" wordt in het Rapport niet weergegeven als de Pin geen foto's bevat.
Inactieve inhoud in Rapporten
In Rapporten worden inactieve Taken en Media uitgesloten. Inactieve Pins worden echter in het Rapport opgenomen.
Placeholders voor Rapporten
{{today}}- De datum van het opstellen van het protocol voor eenvoudige identificatie van de actualiteit van het Rapport, wat een geschikte tracking en monitoring van de voortgang bij het oplossen van problemen in de loop van de tijd mogelijk maakt.{{weeknumber}}- Geeft het Nummer van de week weer waarin het Rapport is opgesteld.{{author}}- Geeft de naam van de gebruiker weer die het Rapport heeft gemaakt.{{author-email}}- Geeft het E-mailadres van de maker van het Rapport weer.{{author-number}}- Geeft het telefoonnummer van de gebruiker weer die het Rapport heeft gemaakt.{{author-company}}- Geeft het bedrijf van de Rapportmaker weer.{{report-title}}- Geeft de Titel weer die aan het Rapport is gegeven bij het maken in de app.{{report-filter}}- Geeft de Filter weer die is gebruikt voor het maken van het Rapport. Het werkt wanneer het Rapport in de Lijstweergave van de Rapporten wordt gemaakt.{{pagebreak}}- Voegt een paginaonderbreking toe in Word-Rapporten.
Tip: Algemene paginaonderbrekingen kunnen rechtstreeks in het Word-Sjabloon als statische elementen worden ingevoegd. Als u na elke Pin of elke Taak een paginaonderbreking wilt invoegen, voegt u gewoon de placeholder {{pagebreak}} in.
Placeholders voor het maken van een handtekeningveld
Deze placeholders maken het mogelijk om rechtstreeks te ondertekenen binnen de iPad-app en dragen bij aan de uiteindelijke output van het Rapport:
{{signature-NAME}}- Toont een handtekeningveld tijdens het maken van het Rapport, dat vervolgens in het uiteindelijke Rapport wordt weergegeven.{{signaturename-NAME}}- Genereert een tekstveld voor de naam van de ondertekenaar tijdens het maken van een Rapport op een iPad, dat vervolgens in het Rapport wordt opgenomen.
OPMERKING: Omdat deze placeholders meerdere keren binnen een RapportSjabloon kunnen worden gebruikt, is het belangrijk om ze van elkaar te onderscheiden. Het "NAME"-segment van de placeholder moet worden vervangen door een betekenisvolle Beschrijving die de plaats in het Rapport aangeeft waar u de specifieke handtekening en naam wilt weergeven.
Stel bijvoorbeeld een Rapport in met twee handtekening- en naamvelden door de volgende syntax in het Sjabloon te gebruiken:
Het Rapport zal de resultaten weergeven zoals hieronder getoond:
Deze placeholders zijn opgenomen in onze Standaard-RapportSjabloon "Bouwdagboek".
Placeholders voor weersinformatie
De placeholders bieden weergerelateerde gegevens die zijn gebaseerd op de locatie die in uw projectinstellingen is opgegeven. Om hun functionaliteit te waarborgen, let op de validatie aan de rechterkant van het adres.
{{weather-icon-info}}- Toont de weersvoorspelling voor het opgegeven projectadres met een klein weersymbool. De placeholder is als een tabel geformatteerd, waarbij in de eerste kolom het weersymbool en in de tweede kolom de Beschrijving van de voorspelling en de temperatuurgegevens staan.{{weather}}- Wanneer deze placeholder in een RapportSjabloon wordt gebruikt, verschijnt er een nieuw gedeelte in het venster voor het maken van Rapporten dat automatisch de weerdata voor de huidige dag selecteert. Door op de knop "Bewerken" te Clicken, kunt u de datum selecteren of wijzigen. Met de verwijderknop wordt de datum gereset naar de huidige dag. Deze placeholder bevat geen weersymbool.{{pin-weather}}Deze placeholder geeft het weer weer van de dag waarop de Pin is gemaakt.
Placeholders voor Pinsortering
Met deze placeholders kunt u Rapporten organiseren volgens Plannen en Categorieën en een Titel toevoegen om de juiste sortering in de inhoudsopgave te waarborgen.
Als er geen specifieke sorteerplaceholder is, gebruikt de app de Standaard sortering uit de Pin-/Takenlijst. De sorteerplaceholders heffen echter de Standaard sortering van de app op. OPMERKING: Deze placeholders zijn alleen voor Word-Rapporten beschikbaar.
OPMERKING: De sorteerplaceholders moeten het Pin-bereik binnen het sorteerbereik omvatten. Het juiste gebruik is:
{{pin-sort}}...Sorteerplaceholder...{{pin}}...Pin-placeholder...{{/pin}}{{/pin-sort}}
{{pin-sort}}- Opent het Pinsorteerbereik.{{/pin-sort}}- Sluit het Pinsorteerbereik.{{sort-by-plan}}- Deze functie ordent de Pins volgens de naam van het Plan waaraan ze zijn toegewezen en sorteert ze vervolgens op hun Pin-Nummers.{{sort-by-category}}- Met deze functie worden Pins geordend volgens hun respectievelijke Categorieën, waarbij de Categorieën in alfabetische volgorde van Z naar A worden gesorteerd.{{pin-sort-title}}- Deze placeholder wordt gebruikt in combinatie met een van de twee voorgaande placeholders. Het dient om de naam van het gesorteerde Plan of de Categorie weer te geven.