Per rappresentare i dati da docu tools in un Report in formato pdf o excel, utilizziamo i segnaposto. Questi segnaposto fungono da marcatori all'interno del vostro Modello e indicano dove inserire i dati provenienti da docu tools. Ad esempio, potete creare un segnaposto come {{project-name}} nel Modello, che verrà riempito dinamicamente con il nome effettivo del progetto in docu tools quando si genera il Report.
Ci sono diversi gruppi di segnaposto per Excel e per Word, poiché alcuni sono disponibili solo in uno o nell'altro. Utilizzando efficacemente questi segnaposto, potete creare Modelli dinamici e flessibili che rappresentano accuratamente i dati dai vostri progetti, Report e Mansione.
Sintassi e formattazione dei segnaposto
Tutti i segnaposto sono racchiusi tra doppie parentesi graffe {{}} e devono seguire esattamente la sintassi specificata, indipendentemente dalla lingua utilizzata nel testo del Modello: Ad esempio, {{pin-number}} è un segnaposto valido che recupera il Numero del Pin selezionato. Tuttavia, segnaposto come {pin-number}, {{pinnummer}} o {{pinnumber}} sono invalidi a causa di una sintassi errata e non funzioneranno.
I segnaposto non funzionano se contengono spazi. Per creare un segnaposto per un Titolo di più parole, sostituire lo spazio con un trattino -, ad esempio utilizzare {{dataset-room-info}} invece di {{dataset-Room info}}.
L'aspetto dell'output è definito dalla formattazione del segnaposto nel Modello. Quindi, se il vostro Report non appare come desiderate, dovete modificare il Modello. D'altra parte, i dati dinamici vengono visualizzati così come sono inseriti in docu tools. Se quindi c'è un errore di battitura nel Titolo del Pin visualizzato, questo deve essere corretto nel Pin corrispondente in docu tools.
Aree dei segnaposto
Quando si lavora con segnaposto di Mansione e Pin, è importante considerare una struttura specifica. Poiché i Pin e le Mansione si ripetono spesso in un Report, è cruciale definire la sezione specifica in cui questi segnaposto appaiono. Questa area limitata sarà riempita con dati da un Pin o una Mansione, ripetendosi tante volte quanti sono presenti nel Report.
Queste sezioni iniziano sempre con {{pins}} o {{tasks}} e terminano con {/pins}} o {{/tasks}}. Tutti i contenuti tra questi segnaposto vengono visualizzati ripetutamente a seconda del numero di Pin o Mansione. È importante notare che l'ulteriore / è incluso solo nel tag di chiusura.
Altre aree includono:
{{pin-sort}}e{{/pin-sort}}- Area per i segnaposto di ordinamento dei Pin.{{pin-medias}}e{{/pin-medias}}- Spazio per{{pin-media-file-name}}nei Report Excel.{{comments}}e{{/comments}}- Area per i commenti delle Mansione.{{attendees}}e{{/attendees}}- Sezione per i segnaposto dei contatti.
Ci sono anche sezioni in cui il testo viene visualizzato solo se è soddisfatta una condizione. Normalmente, i segnaposto nel Report non vengono visualizzati se non ci sono dati da riempire. Ad esempio, se non ci sono Mansione in un determinato Pin, i segnaposto delle Mansione non verranno mostrati. Tuttavia, per aggiungere un'intestazione che appare quando il contenuto corrispondente è presente, sono stati introdotti i segnaposto If. Queste sezioni sono posizionate al di fuori dei segnaposto di apertura e chiusura e verificano la presenza di contenuti. Le intestazioni vengono visualizzate solo se c'è effettivamente un contenuto che soddisfa la condizione specificata.
Abbiamo definito le seguenti sezioni if:
{{if-tasks}}e{{end-if-tasks}}- Le intestazioni vengono visualizzate solo se c'è almeno una Mansione attiva nel Pin.{{if-media}}e{{end-if-media}}- Le intestazioni vengono visualizzate solo se ci sono effettivamente contenuti Media.{{if-task-comment}}e{{/if-task-comment}}- Le intestazioni vengono visualizzate solo se la Mansione contiene commenti.
Questi segnaposto possono essere utilizzati ad esempio nel seguente modo:
```
{{pins}}
{{if-media}}
Foto del Pin
{{end-if-media}}
{{picture-table-small}}
{{/pins}}
```
L'intestazione "Foto del Pin" non verrà visualizzata nel Report se il Pin non contiene foto.
Contenuti inattivi nei Report
Nei Report, le Mansione e i Media inattivi sono esclusi. Tuttavia, i Pin inattivi sono inclusi nel Report.
Segnaposto per i Report
{{today}}- La data di creazione del Report per una facile identificazione dell'attualità del Report, facilitando il monitoraggio e la gestione degli errori nel tempo.{{weeknumber}}- Mostra il Numero della settimana in cui è stato creato il Report.{{author}}- Indica il nome dell'utente che ha creato il Report.{{author-email}}- Mostra l'Indirizzo e-mail del creatore del Report.{{author-number}}- Mostra il Numero di telefono dell'utente che ha creato il Report.{{author-company}}- Mostra l'azienda del creatore del Report.{{report-title}}- Mostra il Titolo dato al Report durante la creazione nell'app.{{report-filter}}- Mostra il Filtro utilizzato per la creazione del Report. Funziona quando il Report è creato nella Vista elenco dei Report.{{pagebreak}}- Aggiunge un'interruzione di pagina nei Report Word.
Suggerimento: Le interruzioni di pagina generali possono essere inserite direttamente nel Modello Word come elementi statici. Se desiderate inserire un'interruzione di pagina dopo ogni Pin o ogni Mansione, inserite semplicemente il segnaposto {{pagebreak}}.
Segnaposto per la creazione di un campo di firma
Questi segnaposto consentono la firma diretta all'interno dell'app iPad e contribuiscono all'output finale del Report:
{{signature-NAME}}- Mostra un campo di firma durante la creazione del Report, che poi viene visualizzato nel Report finale.{{signaturename-NAME}}- Crea un campo di testo per il nome del firmatario durante la creazione del Report su un iPad, che poi viene incluso nel Report.
NOTA: Poiché questi segnaposto possono essere utilizzati più volte all'interno di un Modello di Report, è importante distinguerli tra loro. Il segmento "NAME" del segnaposto dovrebbe essere sostituito con una descrizione significativa che indichi la posizione nel Report dove desiderate mostrare la firma specifica e il nome.
Ad esempio, configurate un Report con due campi di firma e nome utilizzando la seguente sintassi nel Modello:
Il Report visualizzerà i risultati come mostrato di seguito:
Questi segnaposto sono inclusi nel nostro Modello di Report Standard "Report giornaliero di costruzione".
Segnaposto per le informazioni meteorologiche
I segnaposto forniscono dati meteorologici basati sulla località specificata nelle impostazioni del vostro progetto. Per garantire la loro funzionalità, considerate la validazione sul lato destro dell'indirizzo.
{{weather-icon-info}}- Mostra le previsioni meteorologiche per l'indirizzo del progetto specificato con un piccolo simbolo meteorologico. Il segnaposto è formattato come una tabella che nella prima colonna mostra il simbolo meteorologico e nella seconda colonna la descrizione delle previsioni e le informazioni sulla temperatura.{{weather}}- Quando questo segnaposto è utilizzato in un Modello di Report, appare una nuova sezione nella finestra di creazione del Report che seleziona automaticamente i dati meteorologici per il giorno corrente. Cliccando sul pulsante "Modificare" potete selezionare o cambiare la data. Con il tasto di cancellazione, la data viene resettata al giorno corrente. Questo segnaposto non include un simbolo meteorologico.{{pin-weather}}Questo segnaposto fornisce il meteo del giorno in cui è stato creato il Pin.
Segnaposto per l'ordinamento dei Pin
Con questi segnaposto, potete organizzare i Report per Piani e Categorie e aggiungere un Titolo per garantire il corretto ordinamento nell'indice.
Se non esiste un segnaposto di ordinamento specifico, l'app utilizza l'ordinamento Standard dalla Elenco delle cose da fare dei Pin/Mansione. Tuttavia, i segnaposto di ordinamento sovrascrivono l'ordinamento Standard dell'app. NOTA: Questi segnaposto sono solo per i Report Word.
NOTA: I segnaposto di ordinamento dovrebbero includere l'area dei Pin all'interno dell'area di ordinamento. L'uso corretto è:
```
{{pin-sort}}
...Segnaposto di ordinamento...
{{pin}}
...Segnaposto del Pin...
{{/pin}}
{{/pin-sort}}
```
{{pin-sort}}- Apre l'area di ordinamento dei Pin.{{/pin-sort}}- Chiude l'area di ordinamento dei Pin.{{sort-by-plan}}- Questa funzione ordina i Pin in base al nome del Piano a cui sono associati, e li ordina successivamente per i loro Numeri di Pin.{{sort-by-category}}- Con questa funzione, i Pin sono ordinati in base alle loro rispettive Categorie, con le Categorie ordinate alfabeticamente da Z a A.{{pin-sort-title}}- Questo segnaposto viene utilizzato in combinazione con uno dei due segnaposto precedenti. Serve a mostrare il nome del Piano o della Categoria ordinata.