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 del progetto reale in docu tools quando si genera il Report.
Esistono 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 composto da 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 stati 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 viene riempita con dati da un Pin o una Mansione e si ripete tante volte quanti sono i Pin 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 ripetuti a seconda del numero di Pin o Mansione. È importante notare che l'ulteriore / è 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 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 segnaposto possono essere utilizzati, ad esempio, nel seguente modo:
#{{pins}}#{{if-media}}Foto dei Pin#{{end-if-media}}#{{picture-table-small}}#{{/pins}}
L'intestazione "Foto dei Pin" non verrà mostrata nel Report se il Pin non contiene foto.
Contenuti inattivi nei Report
Nei Report, le Mansione e i Media inattivi vengono esclusi. Tuttavia, i Pin inattivi vengono inclusi nel Report.
Segnaposto 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 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 per la firma durante la creazione del Report, che poi viene incluso nel Report finale.#{{signaturename-NAME}}- Genera 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 indichi il punto nel Report dove desiderate mostrare la firma specifica e il nome.
Ad esempio, configurate un Report con due campi per 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 preseleziona automaticamente i dati meteorologici per il giorno corrente. Cliccando sul pulsante "Modificare", potete selezionare o cambiare la data. Con il pulsante 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 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 lista 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 dei 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 è utilizzato in combinazione con uno dei due segnaposto precedenti. Serve per mostrare il nome del Piano o della Categoria ordinata.