Creazione di un modello di report intervento HTML

Segnaposto nei modelli in formato HTML

Nei modelli di report intervento i segnaposto sono definiti utilizzando testo racchiuso tra marcatori all'interno dei contenuto dei tag HTML oppure sono definiti come attributi degli elementi HTML. Esistono cinque tipi di segnaposto. Tre di questi sono definiti mediante testo all'interno di marcatori. Gli altri due sono definiti in base agli attributi negli elementi HTML.

Layout

È possibile inserire segnaposto in qualsiasi punto nell'ambito del contenuto dei tag HTML del documento. Di conseguenza, la struttura indicata di seguito è del tutto valida.

<span>L'ordine di assistenza numero ##ServiceOrder## inizia in data ##StartDate##</span>

I segnaposto ##ServiceOrder## e ##StartDate## vengono sostituiti con i valori corrispondenti dell'intervento nel report intervento effettivo.

Per definire una sezione di set di dati vengono utilizzati due attributi di tipo "data-dataset" e "data-datasetrow".

L'attributo "data-dataset" designa l'elemento presente se nel set di dati sono inclusi record. In caso contrario, l'elemento non viene visualizzato. Se qualsiasi contenuto di intestazione e piè di pagina deve essere visualizzato solo se sono presenti dei record, è necessario includerlo in questo elemento. Se invece tale contenuto deve essere visualizzato anche se non presenti dei record, è necessario inserirlo al di fuori di questo elemento.

L'attributo "data-datasetrow" designa l'elemento che viene ripetuto per ogni record del set di dati. In ogni sezione ripetuta vengono inseriti i valori di dati relativi a un record del set di dati. Un elemento con l'attributo "data-datasetrow" viene spesso definito in un elemento con un attributo "data-dataset" corrispondente.

Per poter rappresentare le relazioni padre/figlio, l'elemento dataset del figlio deve essere nidificato nell'elemento datasetrow del padre. Queste relazioni padre/figlio sono presenti tra le attività e, ad esempio, i costi della manodopera.

Nel caso di attività e di costo della manodopera, se è necessario presentare il costo della manodopera per attività, l'elemento dataset del costo della manodopera deve essere nidificato nell'elemento datasetrow dell'attività. I set di dati hanno una struttura che permette di identificare se sono utilizzati come set figlio. Anziché presentare tutto il costo della manodopera di un intervento, nella sezione nidificata relativa al costo della manodopera viene presentato solo il costo della manodopera per l'attività corrente.

Nessun elemento nel set di dati del documento

Il set di dati del documento è il set di dati di base e ha un solo record. Per questo set di dati non devono essere designati gli elementi dataset e datasetrow.

Elemento dataset facoltativo

La designazione di un elemento dataset con l'attributo "data-dataset" contenente elementi datasetrow è facoltativa. Se per il set di dati deve essere visualizzato solo un elemento ripetuto, è sufficiente designare un elemento con l'attributo "data-datasetrow". Questo caso è illustrato nell'esempio 2. Per il set di dati Activities non viene utilizzato alcun attributo "data-dataset". Solo un attributo "data-datasetrow" designa l'elemento che deve essere ripetuto per ciascun record del set di dati Activities.

Valori dei dati padre nell'elemento figlio

Se un elemento dataset o datasetrow contiene segnaposto di dati che non corrispondono a nessuna delle proprietà del set di dati, per la sostituzione viene utilizzato il set di dati padre. Se non vengono trovate corrispondenze nel set di dati padre, il segnaposto viene associato e potenzialmente sostituito con i valori del set di dati a livello di documento. Questo caso è illustrato nell'esempio 2. Per quanto riguarda il datasetrow Activities, il codice dell'ordine di assistenza viene stampato insieme alla riga dell'attività utilizzando il segnaposto ##ServiceOrderCode## del set di dati del documento.

Totali

Per ogni set di dati che rappresenta un costo, viene calcolato il totale. Nel modello predefinito i totali sono presentati nel paragrafo riepilogativo.

I segnaposto Totalxxx e GrandTotal visualizzano i valori di tutti i costi delle attività selezionate. Le righe di dettaglio di tali costi non devono essere necessariamente visibili nel report. I segnaposto TotalDetailxxx e GrandDetailTotal contengono soltanto i valori delle righe di dettaglio dei costi.

Modifica del modello

Per modificare un modello di report intervento in formato HTML, è necessario avere nozioni di base sul linguaggio HTML. È possibile modificare un file HTML mediante un editor di testo, ma sono disponibili anche molti strumenti più sofisticati per creare e modificare i file HTML.

Stili e immagini

Nel modello non è supportato alcun file esterno. Gli stili e le immagini devono essere incorporati nel file di modello. Gli stili nel formato CSS possono essere definiti in linea, mediante l'attributo style negli elementi HTML, oppure internamente a livello di documento, mediante un elemento style nella sezione di intestazione. Le immagini possono essere incorporate direttamente nel documento HTML in diversi modi.

Un esempio di immagine incorporata è presente nel modello HTML predefinito in LN. Questo modello può essere importato e scaricato dalla sessione Modelli report intervento (tsmdm5100m000) oppure scaricato dalla sessione File aggiuntivi (ttadv2570m000, file aggiuntivo tssocLN_Service_Visit_Report_Template.html).