Espressioni report

La risposta a una domanda può essere visualizzata in un modello di report fornendo il nome racchiuso tra parentesi graffe {}, e preceduto dal simbolo del dollaro. Tutti i valori stringa inclusi in un'espressione devono essere racchiusi tra virgolette doppie.

Il seguente esempio mostra la risposta a una domanda di testo denominata firstname:

${firstname}

Oltre che per mostrare la risposta di una domanda in un report, le parole chiave possono essere utilizzate per visualizzare altre informazioni utili. Il seguente esempio mostra la data e ora attuale durante la stampa di un report:

${$date}

Se il risultato è un array, esso può essere iterato utilizzando # come tag iniziale e / come tag finale all'interno delle parentesi graffe. Il seguente esempio stampa tutti i file di immagine su linee separate:

${#image1}
${$file}
${/}

È anche possibile utilizzare le espressioni per definire il modo in cui le espressioni sono visualizzate. Un'espressione può essere un singolo nome di domanda o una parola chiave (come precedentemente), un calcolo che coinvolge una o più domande o parole chiave o un nome di domanda o parola chiave con metodi e parametri per vincolare o applicare uno stile alla risposta. Un'espressione utilizza la seguente notazione:

${questionname or keyword | method:parameter}

Un'espressione può includere più metodi e parametri o anche nessuno. I parametri possono essere valori di altre domande o valori fissi.

La seguente espressione mostra il calcolo di una domanda di tipo numerale denominata floweringtrees, diviso per una domanda di tipo numerale denominata totaltrees. Quando si fa riferimento a più domande nella stessa espressione, i nomi delle singole domande devono solo essere nominati direttamente e non necessitano di parentesi graffe aggiuntive:

${floweringtrees / totaltrees}

La seguente espressione mostra il valore di coordinata x della domanda di posizione in cui getValue è il metodo e x è il parametro:

${location | getValue:"x"}

La seguente espressione restituisce true se la risposta a una domanda denominata fruitcolor non è uguale a red:

${if fruitcolor!="red"}The fruit is not red.${/}

Le stringhe possono essere concatenate in un'espressione unendole con un segno più. La seguente espressione usa questa concatenazione per passare il contenuto di una domanda denominata field_0 a un servizio di generazione di codici QR, creando un codice QR per la risposta della domanda:

${$image | src:"https://barcode.tec-it.com/barcode.ashx?code=QRCode&data="+field_0}

Sono disponibili delle espressioni di esempio per ogni tipo di domanda nei seguenti argomenti:

• Espressioni di testo
• Espressioni numeriche
• Espressioni di immagine e altri allegati
• Espressioni di mappa (include geopoint, geoshape e geotrace)
• Espressioni di data, ora e data-ora
• Espressioni di scelta
• Espressioni di ripetizione

Metodi delle espressioni

Non tutti i tipi di domande supportano espressioni e metodi. La seguente tabella elenca i metodi e parametri correlati ai tipi di domanda che è possibile utilizzare:

Metodo	Parametro	Collegare il tipo di domanda	Domanda di tipo Web designer	Descrizione
getValue	-	Tutti i tipi di domande	Tutti i tipi di domande	Recupera il valore dei dati non elaborati dal feature layer o l'immagine non elaborata da un allegato.
getValue	x, y, z, wkid	geopoint	Mappa	Recupera singolarmente le coordinate x, y, z in un dato riferimento spaziale. Il parametro wkid è facoltativo e, se omesso, è uguale al riferimento spaziale del feature layer.
getValue	lunghezza, area, unità, tipo di misurazione	geotrace, geoshape	Mappa	Restituisce la lunghezza di una polilinea oppure il perimetro o l'area di un poligono in specifiche unità e indica se le misure sono planari o geodetiche. Il tipo di misura predefinito è geodetico.
getValue	nome, dimensione	immagine, audio, file	Immagine, Firma, Audio, File	Restituisce il nome del file o la dimensione di un allegato.
getValue	larghezza, altezza, x, y, data, ora, direzione	immagine	Immagine, Firma	Larghezza e altezza restituiscono il valore intero della larghezza e dell'altezza in pixel dell'immagine, mentre x, y, data, ora e direzione restituiscono i valori letti dall'immagine EXIF, se presenti.
getValue	conteggio	inizio, ripetizione, immagine, audio, file	Ripeti, immagine, firma, audio, file	Restituisce il conteggio totale delle ripetizioni o degli allegati.
getValue	posizione	inizio, ripetizione, immagine, audio, file	Ripeti, immagine, firma, audio, file	Restituisce un intero uguale alla posizione 1 nell'indice dell'array.
getValue	durata	audio, file	Audio, File	Restituisce la durata delle registrazioni audio in secondi. Attenzione: La durata non è restituita nelle risposte acquisite nell'app Web quando si usa Safari.
appearance	multiline	testo	Più righe di testo	Mantiene le interruzioni di riga nella stringa. Se non viene specificato alcun valore di aspetto, restituisce una stringa a riga singola.
appearance	punti elenco	select_multiple	Selezione multipla	Restituisce la risposta in formato a elenco puntato.
selezionata	nome selezione	select_one, select_multiple	Selezione multipla, Selezione singola, Griglia di selezione singola, Elenco a discesa, Scala Likert, Valutazione	Restituisce una casella di controllo spuntata se il valore del campo è uguale al nome della selezione; in caso contrario, restituisce una casella non spuntata.
selezionato	nome selezione	select_one, select_multiple	Selezione multipla, Selezione singola, Griglia di selezione singola, Elenco a discesa, Scala Likert, Valutazione	Se è presente un dominio valore codificato, restituisce true se il valore del campo è uguale al nome della selezione, altrimenti restituisce false.
countSelected	-	select_one, select_multiple	Selezione multipla, Selezione singola, Griglia di selezione singola, Elenco a discesa, Scala Likert, Valutazione	Restituisce il numero di scelte selezionate.
selectedAt	indice	select_one, select_multiple	Selezione multipla, Selezione singola, Griglia di selezione singola, Elenco a discesa, Scala Likert, Valutazione	Restituisce la stringa nella posizione dell'indice nella lista di scelta. L'indice inizia da zero.
impostazioni locali	codice lingua	data, data/ora, inizio, fine, decimale	Data, Data e ora, Numero	Restituisce la data, ora e numero localizzati.
formattare	stringa formato	data, data/ora, intero, decimale, inizio, fine	Data, Data e ora	Restituisce una stringa data formattata.
utcOffset	valore di offset	data, data/ora, inizio, fine	Data, Data e ora	Restituisce un valore di data o data-ora spostato del valore di offset UTC.
mapSettings	elemento ID mappa web, scala mappa	geopoint, geotrace, geoshape	Mappa	Specifica la mappa di base e la scala quando si stampa l'immagine della mappa. Legacy: Questo metodo è stato sostituito da map e mapScale.
mapExtent	xmin, ymin, xmax, ymax, wkid	geopoint, geotrace, geoshape	Mappa	Specifica l'estensione mappa fissata durante la stampa dell'immagine mappa. Il parametro wkid è facoltativo ed è impostato a 4326 (WGS84) se omesso.
mappa	ID elemento mappa Web	geopoint, geotrace, geoshape	Mappa	Specifica la mappa di base quando si stampa l'immagine della mappa.
mapScale	Scala mappa	geopoint, geotrace, geoshape	Mappa	Specifica la scala della mappa quando si stampa l'immagine della mappa.
mapFilters	ID layer nel JSON, interrogazione e parametri della mappa Web	geopoint, geotrace, geoshape	Mappa	Specifica uno o più filtri o feature layer in una mappa Web quando si stampa l'immagine della mappa.
ruota	gradi	geopoint, geotrace, geoshape, immagine	Mappa, immagine	Specifica l'angolo di rotazione della mappa o immagine.
drawingInfo	currentLayer, URL feature layer	geopoint, geotrace, geoshape	Mappa	Specifica le informazioni del disegno quando si stampa l'immagine della mappa, includendo simbolo, etichetta e trasparenza.
src	URL immagine	-	-	Specifica l'URL origine di un elemento immagine dinamico.
dimensioni	larghezza, altezza, larghezza max, altezza max	immagine	Immagine	Specifica la dimensione dell'immagine stampata.
rotondo	località	decimale, geopoint, geotrace, geoshape	Numero	Arrotonda un numero decimale a determinate posizioni decimali.
useGrouping	booleano	decimale	Numero	Se vero, restituisce un numero con i separatori di raggruppamento determinati dal locale; se falso, nessun separatore viene utilizzato.
toFixed	località	decimale, geopoint, geotrace, geoshape	Numero	Specifica un numero fisso di cifre dopo il separatore decimale. Metterà zero se richiesto per soddisfare un numero fisso di cifre.
attachmentsDefExp	Espressioni SQL	immagine, audio, file	Immagine, Firma, Audio, File	Identifica gli allegati di una domanda o la feature corrente utilizzando la parola chiave $attachment.

Parole chiave dell'espressione

La seguente tabella elenca tutte le parole chiave che possono essere utilizzate in un'espressione.

Parola chiave	Descrizione
$date	Inserisce la data e ora corrente quando si stampa un report. Per impostazione predefinita, restituisce la data corrente utilizzando il formato delle impostazioni locali dell'utente. Esempi: ${$date | format:"MM/DD/YYYY"} $($date | utcOffset:"+08:00"} $($date | locale:"zh-cn"}
$image	Inserisce un elemento di immagine nel report. Utilizzare il metodo src per specificare l'URL dell'immagine. Esempio: ${$image | src:"https://upload.wikimedia.org/wikipedia/commons/1/13/Esri_Headquarters%2C_Building_Q.jpg"}
$map	Inserisce un elemento mappa nel report senza fare riferimento a una domanda del rilevamento. Esempio: ${$map | map:"10df2279f9684e4a9f6a7f08febac2a9" | mapScale:4000000 | size:200:100}
$shape	Stampa la geometria (punto, polilinea o poligono) della feature corrente su una mappa. Esempi: ${$shape} ${$shape | map:"10df2279f9684e4a9f6a7f08febac2a9" | mapScale:4000000 | size:200:100}
$attachment	Rappresenta il primo allegato o tutti gli allegati della feature corrente. Esempi: ${$attachment | getValue:"name"} ${$attachment | getValue:"size"} ${$attachment | size:200:300} Per iterare tutti gli allegati, includere i tag iniziali e finali: ${#$attachment} ${$file} ${/}
$file	Rappresenta il file corrente quando si iterano più file di una domanda di allegato del rilevamento o allegati di una feature. Esempi: ${#image1} ${$file | size:460:0} {/} ${#$attachment} ${$file | getValue:"position"}. ${$file | getValue:"name"} ${/}
$feature	Rappresenta la feature corrente in un array di feature. Esempio: {#repeat1} {$feature | getValue: "position"} {/}
$layers["<layername>"] o $layers[<layerId>]	Fa riferimento a un layer qualsiasi per nome o ID nello stesso feature service del layer del rilevamento. Esempi: ${$layers["cities"] | where:”1=1 !important” | stats:”count,objectid”} ${#$layers["states"]}...${/}