Espressioni di immagine e altri allegati

Sono forniti di seguito degli esempi di espressioni del report per le domande di immagine e allegati.

Per le domande relative all'immagine, è possibile impostare le dimensioni in modo che nei report le immagini abbiano dimensioni coerenti. Il formato di queste espressioni è il seguente:

${image1 | size:width:height:max_width:max_height}

I valori larghezza e altezza determinano le dimensioni dell'immagine in pixel. Questi valori sono necessari per l'espressione, ma inserendo il valore 0 non si impongono limitazioni alle dimensioni dell'immagine. Ad esempio, la seguente espressione determina una larghezza di 300 pixel, conservando le proporzioni dell'immagine:

${image1 | size:300:0}

I valori massimi di altezza e larghezza limitano le dimensioni massime dell'immagine e sono opzionali. L'esempio che segue impone una larghezza di 300 pixel e limita l'altezza a non oltre 200 pixel:

${image1 | size:300:0:0:200}

L'esempio seguente utilizza il metodo rotate per definire la rotazione in senso orario dell'immagine. Accetta valori da 0 a 360.

${image1 | size:300:0:0:200 | rotate:90}

Le domande relative alle immagini possono anche presentare dettagli delle immagini estratti e visualizzati in una risposta di un rilevamento. Può essere usata per visualizzare il nome del file e le dimensioni dell'immagine, come segue:

${image1 | getValue:"name"}

${image1 | getValue:"size"}

${image1 | getValue:"width"}

${image1 | getValue:"height"}

È possibile usare lo stesso metodo per visualizzare dati EXIF dall'immagine, mostrando anche il luogo e il momento di scatto della foto, come segue:

${image1 | getValue:"x"}

${image1 | getValue:"y"}

${image1 | getValue:"date"}

${image1 | getValue:"time"}

${image1 | getValue:"direction"}

Per visualizzare l'immagine originale a schermo intero e con la sua qualità, utilizzare l'espressione senza alcun metodo o utilizzare l'espressione getValue senza alcun valore, come segue:

${image1} o ${image1 | getValue:""}

Il seguente esempio visualizzar l'immagine originale a qualità piena, ma a una dimensione impostata, utilizzando insieme le espressioni getValue e size.

${image1 | getValue:"" | size:300:0}

Nota:

Se si imposta la dimensione di un'immagine mentre si usa qualsiasi altro parametro di espressione, size deve essere posizionato per ultimo nell'espressione.

Data e ora sono memorizzate come stringhe nei dati EXIF, quindi questi valori non possono essere formattati in un report utilizzando l'espressione format per le domande su data e ora. Se la formattazione di questi valori è importante, è possibile eseguire l'estrazione EXIF come parte del rilevamento utilizzando la funzione pulldata("@exif"). Per ulteriori informazioni, consultare Immagini.

Le espressioni getValue di cui sopra possono essere utilizzate anche per estrarre dati da qualsiasi proprietà valida in qualsiasi tipo di allegato, compresi i risultati di domande su immagini, audio e file. Le proprietà che possono essere estratte da tutti gli allegati sono le seguenti:

${file1 | getValue:"name"}

${file1 | getValue:"size"}

${file1 | getValue:"globalId"}

${file1 | getValue:"id"}

${file1 | getValue:"contentType"}

${file1 | getValue:"keywords"}

Per visualizzare un'immagine online, fornire il suo URL di origine con l'espressione src quando ci si riferisce alla parola chiave $image invece del nome di una domanda:

${$image |
src:"https://upload.wikimedia.org/wikipedia/commons/1/13/Esri_Headquarters%2C_Building_Q.jpg"
| size:400:0}

Per restituire più immagini inviate alla stessa domanda in una risposta, utilizzare i seguenti segnaposto, posizionando ciascuno su una riga dedicata:

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

La parola chiave $attachment può essere utilizzata per iterare tutti gli allegati della feature corrente:

${#attachment}
${$file}
${/}

Questo metodo è utile per visualizzare immagini in ArcGIS Enterprise versioni precedenti alla 10.8.1, o per visualizzare immagini che sono state aggiunte a una funzione al di fuori di Survey123 in cui gli allegati non dispongono di un valore per la proprietà delle parole chiave. Il seguente esempio visualizza i nomi file di tutti gli allegati associati a una feature:

${#$attachment}
${$file|getValue:"name"}
${/}

Per visualizzare degli allegati specifici, includere il metodo attachmentsDefExp per identificare l'allegato:

${#image1 | attachmentsDefExp:"DATA_SIZE > "+1*1024*1024}...${$file}...${/}

${#$attachment | attachmentsDefExp:"Keywords = 'image1'"}...${$file}...${/}

${#$attachment | attachmentsDefExp:"CONTENT_TYPE like '%image%'"}...${$file}...${/}

Nota:
Il metodo attachmentsDefExp si comporta allo stesso modo della proprietà attachmentsDefinitionExpression degli Allegati dell'interrogazione. Esaminare l'oggetto attachmentProperties nel JSON del layer per vedere quali campi possono essere utilizzati nell'interrogazione degli allegati.