Um Daten aus docu tools in einem pdf- oder excel-Bericht darzustellen, verwenden wir Platzhalter.
Diese Platzhalter dienen als Markierungen innerhalb Ihrer Vorlage und zeigen an, wo die Daten aus docu tools eingefügt werden sollen. Sie können z.B. einen Platzhalter wie {{project-name}} in der Vorlage erstellen, der beim Generieren des Berichts dynamisch mit dem tatsächlichen Projektnamen in docu tools gefüllt wird.
Es gibt unterschiedliche Gruppen von Platzhaltern für Excel und für Word, da einige nur in der einen oder der anderen verfügbar sind. Durch den effektiven Einsatz dieser Platzhalter können Sie dynamische und flexible Vorlagen erstellen, die die Daten aus Ihren Projekten, Berichten und Aufgaben genau darstellen.
Syntax und Gestaltung von Platzhaltern
Alle Platzhalter sind in doppelte geschweifte Klammern {{ }} eingeschlossen und müssen genau der vorgegebenen Syntax folgen, unabhängig von der im Vorlagentext verwendeten Sprache:
So ist z. B. {{pin-number}} ein gültiger Platzhalter, der die Nummer des ausgewählten Pins abruft. Platzhalter wie {pin-number}, {{pinnummer}} oder {{pinnumber}} sind jedoch aufgrund einer falschen Syntax ungültig und funktionieren nicht.
Platzhalter funktionieren nicht, wenn sie Leerzeichen enthalten. Um einen Platzhalter für einen Mehrworttitel zu erstellen, ersetzen Sie das Leerzeichen durch einen Bindestrich -, z. B. z. B. verwenden Sie {{dataset-room-info}} statt {{dataset-Room info}}.
Das Erscheinungsbild der Ausgabe wird auf der Grundlage der Formatierung des Platzhalters in der Vorlage definiert. Sieht Ihr Bericht also nicht so aus, wie Sie wollen, müssen Sie dafür die Vorlage ändern. Andererseits werden die dynamischen Daten so dargestellt, wie sie in docu tools eingegenben sind. Wenn also im dargestellten Pin-Titel ein Tippfehler ist, muss der im entsprechenden Pin in docu tools geändert werden.
Platzhalterbereiche
Bei der Arbeit mit Aufgaben- und Pin-Platzhaltern ist eine bestimmte Struktur zu beachten. Da sich Pins und Aufgaben in einem Bericht häufig wiederholen, ist es wichtig, den spezifischen Abschnitt zu definieren, in dem diese Platzhalter erscheinen. Dieser begrenzte Bereich wird mit Daten aus einem Pin oder einer Aufgabe gefüllt, die sich so oft wiederholen, wie sie im Bericht vorkommen.
Diese Abschnitte beginnen immer mit {{pins}} oder {{tasks}} und schließen mit {/pins}} oder {{/tasks}}. Alle Inhalte zwischen diesen Platzhaltern werden je nach Anzahl der Pins oder Aufgaben wiederholt angezeigt. Es ist wichtig zu beachten, dass das zusätzliche / ausschließlich im schließenden Tag enthalten ist.
Andere Bereiche betreffen:
{{pin-sort}}und{{/pin-sort}}- Bereich für Platzhalter für die Pin-Sortierung.{{pin-medias}}und{{/pin-medias}}- Platz für{{pin-media-file-name}}in Excel-Berichten.{{comments}}und{{/comments}}- Bereich für Aufgabenkommentare.{{attendees}}und{{/attendees}}- Abschnitt für Kontaktplatzhalter.
Es gibt auch Abschnitte, in denen der Text nur angezeigt wird, wenn eine Bedingung erfüllt ist. Normalerweise werden die Platzhalter im Bericht nicht angezeigt, wenn es keine Daten gibt, mit denen sie gefüllt werden können. Wenn es beispielsweise keine Aufgaben in einem bestimmten Pin gibt, werden die Aufgabenplatzhalter nicht angezeigt. Um jedoch eine Überschrift hinzuzufügen, der angezeigt wird, wenn der entsprechende Inhalt vorhanden ist, wurden If-Platzhalter eingeführt. Diese Abschnitte werden außerhalb der öffnenden und schließenden Platzhalter positioniert und verifizieren das Vorhandensein von Inhalten. Überschriften werden nur angezeigt, wenn tatsächlich ein Inhalt vorhanden ist, der der angegebenen Bedingung entspricht.
Wir haben die folgenden if-Abschnitte definiert:
{{if-tasks}}und{{end-if-tasks}}- Überschriften werden nur angezeigt, wenn es mindestens eine aktive Aufgabe im Pin gibt.{{if-media}}und{{end-if-media}}- Überschriften werden nur angezeigt, wenn tatsächlich Medieninhalte vorhanden sind.{{if-task-comment}}und{{/if-task-comment}}- Überschriften werden nur angezeigt, wenn die Aufgabe Kommentare enthält.
Diese Platzhalter können zum Beispiel wie folgt verwendet werden:
```
{{pins}}
{{if-media}}
Pin Fotos
{{end-if-media}}
{{picture-table-small}}
{{/pins}}
```
Die Überschrift "Pin Fotos" wird im Bericht nicht angezeigt, wenn der Pin keine Fotos enthält.
Inaktive Inhalte in Berichten
In Berichten werden inaktive Aufgaben und Medien ausgeschlossen. Inaktive Pins werden jedoch in den Bericht aufgenommen.
Platzhalter für Berichte
{{today}}- Das Datum der Protokollerstellung zur einfachen Identifizierung der Aktualität des Berichts, was eine angemessene Verfolgung und Überwachung des Fortschritts bei der Fehlerbehebung im Laufe der Zeit ermöglicht.{{weeknumber}}- Zeigt die Nummer der Woche an, in der der Bericht erstellt wurde.{{author}}- Gibt den Namen des Benutzers an, der den Bericht erstellt hat.{{author-email}}- Zeigt die E-Mail-Adresse des Erstellers des Berichts an.{{author-number}}- Zeigt die Telefonnummer des Benutzers an, der den Bericht erstellt hat.{{author-company}}- Zeigt die Firma des Berichtserstellers an.{{report-title}}- Zeigt den Titel an, der dem Bericht bei der Erstellung in der App gegeben wurde.{{report-filter}}- Zeigt den Filter an, der für die Erstellung des Berichts verwendet wurde. Er funktioniert, wenn der Bericht in der Listenansicht der Berichte erstellt wird.{{pagebreak}}- Fügt einen Seitenumbruch in Word-Berichten hinzu.
Tipp: Allgemeine Seitenumbrüche können direkt in der Word-Vorlage als statische Elemente eingefügt werden. Wenn Sie nach jedem Pin oder jeder Aufgabe einen Seitenumbruch einfügen möchten, fügen Sie einfach den Platzhalter
{{pagebreak}}ein.
Platzhalter für die Erstellung eines Signaturfeldes
Diese Platzhalter ermöglichen das direkte Signieren innerhalb der iPad-App und tragen zur endgültigen Ausgabe des Berichts bei:
{{signature-NAME}}- Zeigt ein Unterschriftsfeld während der Berichtserstellung an, das dann im endgültigen Bericht ausgegeben wird.{{signaturename-NAME}}- Erzeugt bei der Berichtserstellung auf einem iPad ein Textfeld für den Namen des Unterzeichners, der dann in den Bericht aufgenommen wird.
HINWEIS: Da diese Platzhalter innerhalb einer Berichtsvorlage mehrfach verwendet werden können, ist es wichtig, sie voneinander zu unterscheiden. Das "NAME"-Segment des Platzhalters sollte durch eine aussagekräftige Beschreibung ersetzt werden, die die Stelle im Bericht angibt, an der Sie die spezifische Signatur und den Namen anzeigen möchten.
Richten Sie beispielsweise einen Bericht mit zwei Signatur- und Namensfeldern ein, indem Sie die folgende Syntax in der Vorlage verwenden:
Der Bericht wird die Ergebnisse wie unten dargestellt wiedergeben:
Diese Platzhalter sind in unserer Standard-Berichtsvorlage "Bautagesbericht" enthalten.
Platzhalter für die Wetterinformationen
Die Platzhalter bieten wetterbezogene Daten, die auf dem in Ihren Projekteinstellungen angegebenen Ort basieren. Um ihre Funktionalität zu gewährleisten, beachten Sie die Validierung auf der rechten Seite der Adresse.
-
{{weather-icon-info}}- Zeigt die Wettervorhersage für die angegebene Projektadresse mit einem kleinen Wettersymbol an. Der Platzhalter ist als Tabelle formatiert, die in der ersten Spalte das Wettersymbol und in der zweiten Spalte die Beschreibung der Vorhersage sowie die Temperaturangaben enthält. -
{{weather}}- Wenn dieser Platzhalter in einer Berichtsvorlage verwendet wird, erscheint im Fenster zur Berichterstellung ein neuer Abschnitt, der automatisch die Wetterdaten für den aktuellen Tag vorwählt. Durch Klicken auf die Taste "Bearbeiten" können Sie das Datum auswählen oder ändern. Mit der Löschtaste wird das Datum auf den aktuellen Tag zurückgesetzt. Dieser Platzhalter enthält kein Wettersymbol. -
{{pin-weather}}Dieser Platzhalter gibt das Wetter aus von dem Tag, an dem der Pin erstellt wurde.
Platzhalter für die Pinsortierung
Mit diesen Platzhaltern können Sie Berichte nach Plänen und Kategorien organisieren und einen Titel anhängen, um die richtige Sortierung im Inhaltsverzeichnis zu gewährleisten.
Wenn es keinen spezifischen Sortierplatzhalter gibt, verwendet die App die Standardsortierung aus der Pin-/Aufgabenliste. Die Sortierplatzhalter setzen jedoch die Standardsortierung der App außer Kraft. HINWEIS: Diese Platzhalter sind nur für Word-Berichte verfügbar.
HINWEIS: Die Sortierplatzhalter sollten den Pin-Bereich innerhalb des Sortierbereichs umfassen. Die korrekte Verwendung ist:
```
{{pin-sort}}
...Sortierplatzhalter...
{{pin}}
...Pin-Platzhalter...
{{/pin}}
{{/pin-sort}}
```
{{pin-sort}}- Öffnet den Pinsortierbereich.{{/pin-sort}}- Schließt den Pinsortierbereich.{{sort-by-plan}}- Diese Funktion ordnet die Pins nach dem Namen des Plans an, dem sie zugeordnet sind, und sortiert sie anschließend nach ihren Pin-Nummern.{{sort-by-category}}- Mit dieser Funktion werden Pins nach ihren jeweiligen Kategorien geordnet, wobei die Kategorien in alphabetischer Reihenfolge von Z bis A sortiert werden.{{pin-sort-title}}- Dieser Platzhalter wird in Verbindung mit einem der beiden vorangegangenen Platzhalter verwendet. Er dient dazu, den Namen des sortierten Plans oder der Kategorie anzuzeigen.