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 durante la generazione del 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 usare {{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 i segnaposto di Mansione e Pin, è importante seguire una struttura specifica. Poiché Pins e Mansione si ripetono spesso in un Report, è cruciale definire la sezione specifica in cui questi segnaposto appaiono. Questa area limitata viene riempita con dati da un Pin o una Mansione e si ripete tante volte quanti sono i Pins o le Mansione 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 Pins o Mansione. È importante notare che l'aggiunta / è presente 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 una condizione è soddisfatta. 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 i seguenti segmenti 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 vengono esclusi le Mansione e i Media inattivi. 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 il tracciamento dei progressi nella risoluzione dei problemi 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 la compagnia 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 firma
Questi segnaposto consentono la firma diretta all'interno dell'app iPad e contribuiscono all'output finale del Report:
{{signature-NAME}}- Mostra un campo 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 l'uno dall'altro. Il segmento "NAME" del segnaposto dovrebbe essere sostituito con una descrizione significativa che indica il punto nel Report dove desiderate mostrare la firma specifica e il nome.
Ad esempio, configurate un Report con due campi 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 è formato come una tabella con il simbolo meteorologico nella prima colonna e la Descrizione delle previsioni e le informazioni sulla temperatura nella seconda colonna.{{weather}}- Quando questo segnaposto viene utilizzato in un Modello di Report, nella finestra di creazione del Report appare una nuova sezione che seleziona automaticamente i dati meteorologici per il giorno corrente. Cliccando sul pulsante "Modificare", è possibile selezionare o cambiare la data. Con il pulsante di cancellazione, la data viene reimpostata al giorno corrente. Questo segnaposto non include un simbolo meteorologico.{{pin-weather}}Questo segnaposto fornisce il meteo del giorno in cui il Pin è stato creato.
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. I segnaposto di ordinamento, tuttavia, 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 in base ai loro Numeri di Pin.{{sort-by-category}}- Con questa funzione, i Pin vengono 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 per mostrare il nome del Piano o della Categoria ordinata.