Per rappresentare i dati da docu tools in un Report in formato PDF o Excel, utilizziamo i placeholder. Questi placeholder servono come marcatori all'interno del vostro Modello e indicano dove inserire i dati provenienti da docu tools. Ad esempio, potete creare un placeholder come {{project-name}} nel Modello, che verrà riempito dinamicamente con il nome reale del progetto in docu tools quando si genera il Report.
Ci sono diversi gruppi di placeholder per Excel e per Word, poiché alcuni sono disponibili solo in uno o nell'altro. Utilizzando efficacemente questi placeholder, potete creare Modelli dinamici e flessibili che rappresentano accuratamente i dati dai vostri progetti, Report e Mansione.
Sintassi e formattazione dei placeholder
Tutti i placeholder 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 placeholder valido che recupera il Numero del Pin selezionato. Tuttavia, placeholder come {pin-number}, {{pinnummer}} o {{pinnumber}} sono invalidi a causa di una sintassi errata e non funzioneranno.
I placeholder non funzionano se contengono spazi. Per creare un placeholder 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 placeholder 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. Quindi, se c'è un errore di battitura nel Titolo del Pin visualizzato, questo deve essere corretto nel Pin corrispondente in docu tools.
Aree dei placeholder
Quando si lavora con i placeholder di Mansione e Pin, è importante considerare una struttura specifica. Poiché Pins e Mansione si ripetono spesso in un Report, è cruciale definire la sezione specifica in cui questi placeholder appaiono. Questa area limitata sarà riempita con dati da un Pin o una Mansione che si ripetono 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 placeholder vengono ripetuti a seconda del numero di Pins o Mansione presenti. È importante notare che l'ulteriore / è incluso solo nel tag di chiusura.
Altre aree includono:
{{pin-sort}}e{{/pin-sort}}- Area per i placeholder 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 placeholder dei contatti.
Ci sono anche sezioni in cui il testo viene visualizzato solo se è soddisfatta una condizione. Normalmente, i placeholder nel Report non vengono visualizzati se non ci sono dati con cui possono essere riempiti. Ad esempio, se non ci sono Mansione in un determinato Pin, i placeholder delle Mansione non verranno mostrati. Tuttavia, per aggiungere un'intestazione che appare quando il contenuto corrispondente è presente, sono stati introdotti i placeholder If. Queste sezioni sono posizionate al di fuori dei placeholder di apertura e chiusura e verificano la presenza di contenuti. Le intestazioni vengono mostrate 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 mostrate solo se c'è almeno una Mansione attiva nel Pin.{{if-media}}e{{end-if-media}}- Le intestazioni vengono mostrate solo se ci sono effettivamente contenuti Media.{{if-task-comment}}e{{/if-task-comment}}- Le intestazioni vengono mostrate solo se la Mansione contiene commenti.
Questi placeholder 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à mostrata nel Report se il Pin non contiene foto.
Contenuti inattivi nei Report
Nei Report vengono esclusi Mansione e Media inattivi. Tuttavia, i Pin inattivi vengono inclusi nel Report.
Placeholder per i Report
{{today}}- La data di creazione del Report per una facile identificazione dell'attualità del Report, consentendo un adeguato monitoraggio e 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 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 placeholder {{pagebreak}}.
Placeholder per la creazione di un campo firma
Questi placeholder 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 incluso 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 placeholder possono essere utilizzati più volte all'interno di un Modello di Report, è importante distinguerli tra loro. Il segmento "NAME" del placeholder dovrebbe essere sostituito con una descrizione significativa che indichi il punto nel Report dove desiderate mostrare la firma e il nome specifici.
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 placeholder sono inclusi nel nostro Modello di Report Standard "Report giornaliero di costruzione".
Placeholder per le informazioni meteorologiche
I placeholder forniscono dati meteorologici basati sulla località specificata nelle impostazioni del vostro progetto. Per garantire la loro funzionalità, tenete presente 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 placeholder è 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 placeholder è 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" potete scegliere o cambiare la data. Utilizzando il pulsante di cancellazione, la data viene resettata al giorno corrente. Questo placeholder non include un simbolo meteorologico.{{pin-weather}}Questo placeholder fornisce il meteo del giorno in cui è stato creato il Pin.
Placeholder per l'ordinamento dei Pin
Con questi placeholder, potete organizzare i Report per Piani e Categorie e aggiungere un Titolo per garantire il corretto ordinamento nell'indice.
Se non esiste un placeholder di ordinamento specifico, l'app utilizza l'ordinamento Standard dalla lista dei Pin/Mansione. Tuttavia, i placeholder di ordinamento sovrascrivono l'ordinamento Standard dell'app. NOTA: Questi placeholder sono solo per i Report Word.
NOTA: I placeholder di ordinamento dovrebbero includere l'area dei Pin all'interno dell'area di ordinamento. L'uso corretto è:
```
{{pin-sort}}
...Placeholder di ordinamento...
{{pin}}
...Placeholder 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 assegnati, e li ordina successivamente per i loro Numeri di Pin.{{sort-by-category}}- Con questa funzione, i Pin vengono ordinati in base alle loro rispettive Categorie, con le Categorie ordinate in ordine alfabetico da Z a A.{{pin-sort-title}}- Questo placeholder viene utilizzato in combinazione con uno dei due placeholder precedenti. Serve per mostrare il nome del Piano o della Categoria ordinati.