Puoi includere domande multimediali (audio, file e immagini) nei sondaggi per consentire agli utenti di inviare allegati con le risposte al sondaggio.
Suggerimento:
Immagini e audio possono anche essere aggiunti ad altre domande in un sondaggio a scopo di riferimento e di stile. Per maggiori informazioni, consultare Usare i media nel rilevamento.
Per impostazione predefinita, le domande multimediali consentono un allegato. Per consentire più allegati, impostane l'aspetto.
Per impostazione predefinita, Survey123 genera automaticamente un nome file per il contenuto multimediale inviato in una domanda. Il nome file include il nome della domanda come prefisso, seguito da un numero univoco. Puoi personalizzare i nomi dei file per renderli più significativi. Per maggiori informazioni, consultare Personalizzare gli elementi del modulo. Se i dati del rilevamento vengono esportati e pubblicati come un feature layer per l'uso in Survey123, si consiglia di non personalizzare i nomi dei file. Per maggiori informazioni, consultare Parole chiave.
Audio
Il tipo di domanda audio consente agli utenti di registrare audio in Survey123. Una barra di avanzamento indica il tempo rimanente per la registrazione. Gli utenti possono mettere in pausa la registrazione in qualsiasi momento. Una volta completata la registrazione, gli utenti possono modificare il nome del file.
Nota:
Nell'app di campo Survey123, la sospensione della registrazione audio durante la registrazione non è supportata in Android.
Per impostazione predefinita, le registrazioni audio sono limitate a una dimensione massima del file di 10 MB in Survey123 Mobile e nell'app di campo Survey123 e a una durata massima di 10 minuti nell'app Web Survey123.
Puoi impostare un limite di dimensione diverso, in megabyte, utilizzando il parametro max-size nella colonna bind::esri:parameters. La registrazione si interrompe automaticamente quando questa dimensione massima viene raggiunta. Ad esempio, max-size=5 consente agli utenti di registrare fino a 5 MB di audio.
Alternativamente, è possibile specificare un limite di tempo in secondi usando il parametro max-duration nella colonna bind::esri:parameters. La registrazione si interrompe automaticamente quando la durata massima viene raggiunta. Per esempio, max-duration=30consente agli utenti di registrare fino a 30 secondi di audio.
Attenzione:
Nell'app di campo Survey123, la dimensione massima del file per ogni singolo allegato inviato è di 10 MB. Assicurati che il valore max-duration o max-size impostato non faccia superare al file audio questa dimensione massima.
È possibile specificare i codec audio preferiti usando il parametro codec nella colonna bind::esri:parameters. Possono essere forniti più codec separati da virgole, ad esempio, codec=amr-nb,aac. Sarà utilizzato il primo codec compatibile con il dispositivo.
Nota:
In Survey123 Mobile, i file audio vengono codificati utilizzando il codec Advanced Audio Coding (AAC), se il dispositivo lo supporta. Di seguito sono riportati i codec supportati per ogni sistema operativo:
- Android - AAC, MP3
- iOS - AAC, ALAC, FLAC, MP3, PCM, Vorbis
- Windows - AAC, ALAC, MP3, PCM, Vorbis, WMAudioLossless, WMAudioV8, WMAudioV9
Nota:
Nell'app di campo Survey123, la registrazione acquisisce un file audio utilizzando il formato di acquisizione audio predefinito del dispositivo. I codec supportati dal dispositivo sono elencati nella pagina informazioni dell'app. Tieni premuto il titolo Informazioni su ArcGIS Survey123 nella parte superiore della pagina Informazioni per visualizzare ulteriori informazioni sul dispositivo, inclusi i codec audio supportati. Nei dispositivi Windows i file audio sono sempre registrati nel formato non compresso WAV.
Potrebbe non essere possibile riprodurre alcuni file audio in un browser Web perché non tutti i codec sono supportati dai browser. Per ulteriori informazioni sui Web, vedere la documentazione di Mozilla Developer Network.
Nell'app Web, le domande audio consentono solo di caricare un file audio esistente. È anche possibile inviare un file audio memorizzato sul proprio dispositivo usando una domanda di tipo file. Per un elenco dei tipi di file audio supportati, consultare File.
File
Nota:
Questa sezione descrive le funzionalità disponibili solo in Survey123 Connect e nell'app da campo Survey123. Queste funzionalità non sono disponibili in Survey123 Studio o Survey123 Mobile.
Il tipo di domanda file consente agli utenti di inviare una gamma di tipi di file.
La dimensione file massima predefinita per un unico file è 10 MB. Per le domande di file nell'app web Survey123, è possibile specificare la dimensione massima del file in megabyte utilizzando max-size nella colonna bind::esri:parameters. Ad esempio, max-size=5 consente agli utenti di allegare un file di dimensione massima di 5 MB.
Nota:
La dimensione di file massima per un allegato individuale inviato dall'app di campo Survey123 è 10 MB.
Quando viene applicato alle domande di file, il parametro max-size è supportato solo nell'app Web Survey123. La dimensione massima non può superare i 500 MB per ArcGIS Online e i 20 MB per ArcGIS Enterprise.
Il tipo di domanda file accetta tutti i tipi di allegati file supportati da ArcGIS Online e ArcGIS Enterprise. I tipi di file supportati sono i seguenti:
| Categoria | Tipo di file |
|---|---|
Archivio | 7Z, GTAR, GZ, TAR, TGZ, ZIP |
Audio | AIF, M4A, MID, MP2, MP3, MPA, RA, RAM, RMI, WAV, WMA |
Dati | CSV, GEODATABASE, GEOJSON, GML, GPKG*, JSON, MDB, PBF*, SD*, VRML, XML |
Documento | DOC, DOCX, DOT, PDF, PPT, PPTX, TXT, WPS, XLS, XLSX, XLT |
Immagine | BMP, ECW, EMF, EPS, GIF, IMG, J2K, JP2, JPC, JPE, JPEG, JPF, JPG, PNG, PS, PSD, RAW, SID, TIF, TIFF, WMF |
Video | AVI, MOV, MP4, MPE, MPEG, MPG, MPV2, QT, WMV |
*Questo tipo di allegato non è supportato in ArcGIS Enterprise.
È possibile limitare i tipi di file che possono essere inviati a una domanda di file utilizzando la colonna body::accept. Questa colonna accetta sia le estensioni dei file (ad esempio .wav) che i tipi MIME (ad esempio audio/*). Le estensioni file multiple o i MIME possono essere impostati separandoli con una virgola.
Per informazioni sui formati accettati per i tipi MIME, consultare l'elenco di Mozilla dei tipi MIME comuni.
Immagini
Il tipo di domanda immagine consente agli utenti di inviare immagini salvate sul proprio dispositivo o foto scattate con la fotocamera del proprio dispositivo.
Una foto scattata in Survey123 viene salvata come file .jpg, con un livello di qualità che varia a seconda della fotocamera del dispositivo. La dimensione dell'immagine, misurata in pixel sul lato più lungo, può essere impostata utilizzando Opzioni in Survey123 Studio o Survey123 Connect. Questa dimensione è fornita a tutte le domande di immagine nel rilevamento. Sono disponibili le seguenti opzioni:
- 320 pixel
- 640 pixel
- 1280 pixel
- 1920 pixel
- Non limitato (Al rilevamento può essere allegata qualsiasi dimensione di foto).
La dimensione predefinita dell'immagine è di 1280 pixel. Le immagini inviate che sono state salvate sul dispositivo mantengono il tipo di file, la risoluzione e la qualità originale.
Queste dimensioni dell'immagine non influiscono sull'anteprima dell'immagine fornita in Survey123 Mobile o nell'app di campo Survey123.
La dimensione massima predefinita del file per un'immagine singola è 10 MB. Per le domande di immagine nell'app web Survey123 è possibile specificare la dimensione file massima in megabyte utilizzando max-size nella colonna bind::esri:parameters. Ad esempio, max-size=5 consente agli utenti di allegare un'immagine di dimensione massima di 5 MB.
Nota:
La dimensione di file massima per un allegato individuale inviato dall'app di campo Survey123 è 10 MB.
Quando viene applicato alle domande di immagine, il parametro max-size è supportato solo nell'app Web Survey123. La dimensione massima non può eccedere i 100 MB per ArcGIS Online e i 20 MB per ArcGIS Enterprise.
Personalizza la dimensione dell'immagine e il metodo di acquisizione
Nota:
Questa sezione descrive le funzionalità disponibili solo e nell'app da campo Survey123. Queste funzionalità non sono disponibili in Survey123 Mobile.
Puoi controllare la dimensione dell'anteprima dell'immagine visualizzata nell'app di campo Survey123 utilizzando il parametro previewHeight. Questo parametro supporta tutti i tipi di unità supportati da il parametro height, ma l'altezza dell'immagine di anteprima è limitata dalla larghezza dello schermo del dispositivo e dal rapporto prospettico dell'immagine. Utilizza previewHeight=0 per impostare l'anteprima dell'immagine alla dimensione massima, senza spazio vuoto non necessario.
È possibile impostare la dimensione massima allocabile di un'immagine per ogni domanda di immagine individuale in un rilevamento. Specificare max-pixels nella colonna parametri di XSLForm per la domanda che si desidera limitare. Per esempio max-pixels=100 ridimensiona l'immagine in basso proporzionalmente a 100 pixel sul lato più lungo. Se il parametro max-pixels non è specificato, vengono utilizzate le dimensioni dell'immagine impostate in Survey123 Connect.
È possibile limitare una domanda immagine a un particolare metodo di acquisizione specificando method=camera o method=browse nella colona body::esri:style del XLSForm. È anche possibile impostare l'aspetto su new-front o new-rear per limitare una domanda di immagine in modo da usare solo le immagini della fotocamera del dispositivo, utilizzando rispettivamente la fotocamera anteriore o posteriore come impostazione predefinita. Quando viene utilizzato l'aspetto annotate, puoi anche specificare method=map.
Aspetto
Puoi modificare il comportamento delle domande e il modo in cui vengono presentate impostando l'aspetto. Per verificare quali app di invio supportano un determinato aspetto, vedi tabella Aspetti.
Impostando la colonna dell'aspetto su multiline, una domanda di tipo file o immagine accetta più allegati in un'unica domanda.
Questo aspetto può essere combinato con altri aspetti impostandoli entrambi separati da uno spazio, ad esempio multiline annotate per una domanda di tipo immagine.
Puoi controllare il numero di file o immagini che possono essere inviati utilizzando la funzione count-selected nella colonna constraint. Di seguito sono riportati alcuni esempi:
- count-selected(${file_question}) <= 5 limita il numero di file che possono essere inviati a un massimo di cinque.
- count-selected(${image_question}) <= 3 limita il numero di immagini che possono essere inviate a un massimo di tre.
Impostando l'aspetto su signature, una domanda di tipo immagine può essere utilizzata per acquisire una firma.
Nota:
In Survey123 Connect, puoi anche impostare i seguenti aspetti per le domande di tipo immagine nei sondaggi utilizzati con l'app di campo Survey123:
- Impostando l'aspetto su new-front o new-rear, puoi limitare le domande di tipo immagine all'utilizzo della fotocamera anteriore o posteriore del dispositivo, rispettivamente, come impostazione predefinita. Questi aspetti possono essere combinati con annotate impostando entrambi gli aspetti separati da uno spazio, ad esempio new-front annotate.
- Impostando l'aspetto su draw o annotate, puoi consentire agli utenti di disegnare o annotare le foto.
- Impostando l'aspetto su spike, una domanda di tipo immagine visualizza un pulsante per aprire l'app mobile Spike e integrare Survey123 con Spike. Per ulteriori informazioni, vedi Spike aspetto delle immagini.
Aspetto signature
Impostando l'aspetto su signature, le domande di immagine presentano un pop-up per catturare una firma.
Una firma viene salvata come allegato immagine .jpg con le stesse dimensioni della finestra popup. Per impostazione predefinita, la larghezza del pop-up si estende alla larghezza dello schermo del dispositivo, con un'altezza fissa di 200 pixel. Per impostare la larghezza massima di questa finestra popup utilizzando il parametro max-pixels vedi Personalizza la dimensione dell'immagine e il metodo di acquisizione.
Puoi anche fornire un'immagine nella colonna predefinita per impostare uno sfondo personalizzato per la firma. Le dimensioni dell'immagine predefinita determinano il rapporto prospettico della finestra popup.
La larghezza del pop-up sarà la più piccola delle seguenti:
- Il valore max-pixels
- Larghezza dell'immagine predefinita
- Larghezza dello schermo del dispositivo
L'altezza sarà di 200 pixel, a meno che non venga fornita un'immagine predefinita.
Quando si progetta un sondaggio utilizzando l'aspetto della firma, assicurarsi di prendere in considerazione le dimensioni dello schermo di tutti i dispositivi di destinazione.
Puoi specificare un testo a piè di pagina per la finestra popup di una domanda con aspetto signature utilizzando il parametro footerText nella colonna body::esri:style. Usando solo il parametro footerText senza alcun valore, il suggerimento di guida della domanda apparirà sotto la firma. Può essere sostituito con il suggerimento della domanda utilizzando footerText=@[hint]. Il suggerimento o la guida utilizzata per il testo a piè di pagina non apparirà nella posizione predefinita sotto il nome della domanda. Per ulteriori informazioni sui suggerimenti, vedi Suggerimenti.
Nota:
La web app Survey123 non supporta il multilinea, il parametro max-pixels o i valori predefiniti quando sono applicati all'aspetto signature.
Aspetto draw e annotate
Nota:
Questa sezione descrive le funzionalità disponibili solo in Survey123 Connect e nell'app da campo Survey123. Queste funzionalità non sono disponibili in Survey123 Studio o Survey123 Mobile.
Impostando l'aspetto su draw, le domande relative alle immagini vengono visualizzate con un pulsante che consente di caricare uno spazio su cui disegnare. Nella tavola degli strumenti di disegno è possibile scegliere fra gli strumenti e controllare le impostazioni per ogni strumento, come la dimensione del testo, larghezza della linea, ecc. Per informazioni sull'interfaccia della tela, vedere Draw e annotate È possibile creare tavolozze personalizzate che permettono di configurare gli strumenti di disegno e di annotazione in base alle proprie esigenze. Per maggiori informazioni, vedi Disegnare e annotare palette.
Impostando l'aspetto su annotate, le domande sull'immagine visualizzano un pulsante per aprire la fotocamera del dispositivo per scattare una foto che è possibile annotare con grafica e testo. Nella tavola degli strumenti di disegno è possibile scegliere fra gli strumenti e controllare le impostazioni per ogni strumento, come la dimensione del testo, larghezza della linea, ecc. Per informazioni sull'interfaccia della tela, vedere Draw e annotate È possibile creare tavolozze personalizzate che permettono di configurare gli strumenti di disegno e di annotazione in base alle proprie esigenze. Per maggiori informazioni, vedi Disegnare e annotare palette.
Suggerimento:
A partire dalla versione 3.13 di Survey123 i dati EXIF vengono copiati dall'immagine di origine all'immagine annotata.
In alternativa, puoi consentire all'utente di annotare un'immagine esistente presente nella memoria del dispositivo o un'istantanea di una mappa. Per farlo, imposta body::esri:style per quella domanda a method=browse, method=camera oppure method=map. Il comportamento predefinito per l'aspetto annota è identico al fornire method=camera. Puoi impostare la domanda per fornire un certo numero di opzioni per l'immagine di origine fornendo più opzioni separate da virgole, per esempio, method=camera,browse.
Attenzione:
A prescindere dal metodo impostato, l'app Web Survey123 visualizza solo un'opzione di ricerca file.
I valori predefiniti e i calcoli si comportano in modo diverso con le domande relative alle immagini in base alla scelta di draw o di annotate. Se il nome del file di un'immagine nella cartella delle risorse multimediali del rilevamento viene utilizzato come valore predefinito o risultato di un calcolo, l'immagine verrà utilizzata come sfondo iniziale dell'area di disegno. Con annotate, questa immagine viene sostituita da un'immagine fornita dall'utente e viene visualizzata solo se l'utente sceglie esplicitamente di non fornire un'immagine oppure reimposta un'immagine già fornita.
Nota:
È possibile impostare la risoluzione per un'immagine definendo un valore max-pixels nella colonna parameters. Per una domanda draw, l'impostazione max-pixels=1000 imposta l'area di disegno su un'immagine quadrata di 1000 × 1000 pixel. Per una domanda annotate, l'impostazione di max-pixels=1000 renderà il lato più lungo dell'immagine a 1000 pixel, mantenendo la proporzione dell'immagine. Se max-pixels non viene impostato, la dimensione dell'immagine verrà definita dall'impostazione di dimensione nelle impostazioni di Opzioni per il rilevamento in Survey123 Connect.
Entrambi questi metodi di impostazione della risoluzione dell'immagine vengono sostituiti se per la domanda viene fornita un'immagine predefinita; in tal caso, verrà applicata la risoluzione dell'immagine predefinita. Questo può essere utilizzato per garantire una risoluzione standard per tutte le immagini inviate. Fornire un'istantanea di una mappa per l'annotazione sovrascriverà anche qualsiasi altra impostazione di risoluzione dell'immagine, con l'immagine impostata sulla dimensione dell'area della tela visualizzabile.
Aspetto delle immagini Spike
Nota:
Questa sezione descrive le funzionalità disponibili solo in Survey123 Connect e nell'app da campo Survey123. Queste funzionalità non sono disponibili in Survey123 Studio o Survey123 Mobile.
Nota:
L'integrazione di Spike non è supportata nella web app Survey123.
Le domande di tipo immagine supportano aspetti per integrare Survey123 con Spike, una soluzione di misurazione laser sviluppata da ikeGPS che permette di acquisire le misurazioni e la posizione di un oggetto da una foto. Impostando il valore dell'aspetto su spike, spike-full-measure o spike-point-to-point, una domanda di tipo immagine mostra un pulsante che consente di aprire l'app mobile Spike su dispositivi iOS e Android.
Una foto scattata con l'app di Spike e il dispositivo laser, permette di registrare le coordinate e la distanza dell'oggetto, e di misurare le dimensioni degli oggetti nella foto tracciando aree e linee. La foto con il markup di misurazione viene poi allegata al rilevamento, ed i metadati provenienti dalla foto come le coordinate e le misurazioni sarà disponibile per essere registrato. I metadati associati delle misurazioni e di Spike sono registrati nel file di immagine tramite i tag Exchangeable Image File (EXIF) standard. Le informazioni EXIF possono poi essere estrapolate ed utilizzate per popolare altri campi.
La differenza tra i diversi aspetti Spike è la quantità di valori memorizzati nell'immagine. L'aspetto spike misura solo la distanza e la posizione, mentre l'aspetto spike-full-measure misura la distanza, la posizione, l'area e la lunghezza. L'aspetto spike-point-to-point acquisisce una serie di valori esclusivi, identificati da nomi delle proprietà che iniziano con P2P.
Per ulteriori informazioni su questi tag EXIF, vedere Spikel' integrazione. Per maggiori informazioni su Spike, vedere il sito web Spike.
Estrarre i metadati dell'immagine
È possibile usare la funzione pulldata("@exif") per estrarre tag di metadati Exchangeable Image File (EXIF) standard dalla risposta a una domanda di tipo immagine. Se si inserisce il seguente esempio in una domanda di tipo decimale, si estrapola il valore della latitudine del dispositivo da un'immagine:
pulldata("@exif", ${image}, "GpsLatitude")
I tag EXIF di posizione più comuni che puoi utilizzare con la funzione pulldata("@exif") sono elencati nella tabella seguente:
| Tag EXIF | Descrizione |
|---|---|
| GpsLatitude | Latitudine della posizione del dispositivo sotto forma di stringa |
| GpsLongitude | Longitudine della posizione del dispositivo sotto forma di stringa |
| GpsAltitude | Altitudine della posizione del dispositivo sotto forma di stringa |
| GpsLatitudeRef | La latitudine di riferimento (ad esempio, N,E,S,O) del dispositivo sotto forma di stringa |
| GpsLongitudeRef | La longitudine di riferimento (ad esempio, N,E,S,O) del dispositivo sotto forma di stringa |
| GpsDestDistance | La distanza tra un dispositivo e le posizioni di destinazione, in chilometri, sotto forma di numero intero |
| GpsImgDirection | La direzione della posizione di destinazione dalla posizione del dispositivo sotto forma di stringa |
| GpsDestLatitude | La latitudine della posizione di destinazione sotto forma di stringa |
| GpsDestLongitude | La longitudine della posizione di destinazione sotto forma di stringa |
| GpsDestLatitudeRef | La latitudine di riferimento (ad esempio, N,E,S,O) della posizione di destinazione sotto forma di stringa |
| GpsDestLongitudeRef | La longitudine di riferimento (ad esempio, N,E,S,O) della posizione di destinazione sotto forma di stringa |
È possibile utilizzare il seguente esempio per visualizzare sia la latitudine che la longitudine in un singolo campo, che può quindi essere utilizzato per compilare una domanda di geopunto:
string(pulldata("@exif", ${image}, "GpsLatitude")) + " " + string(pulldata("@exif", ${image}, "GpsLongitude"))
Di seguito sono elencati altri tag EXIF che possono essere estratti da Survey123. A seconda dell'hardware utilizzato, non sono disponibili tutti i tag.
| Tag EXIF | ||
|---|---|---|
GpsAltitudeRef | GpsTimeStamp | GpsSatellites |
GpsStatus | GpsMeasureMode | GpsDop |
GpsSpeedRef | GpsSpeed | GpsTrackRef |
GpsTrack | GpsImgDirectionRef | GpsMapDatum |
GpsDestBearingRef | GpsDestBearing | GpsDestDistanceRef |
GpsProcessingMethod | GpsAreaInformation | GpsDateStamp |
GpsVersionId | GpsDifferential | GpsHPositioningError |
ImageWidth | ImageLength | ImageBitsPerSample |
ImageCompression | ImagePhotometricInterpretation | ImageDescription |
ImageMake | ImageModel | ImageStripOffsets |
ImageOrientation | ImageSamplesPerPixel | ImageRowsPerStrip |
ImageStripByteCounts | ImageXResolution | ImageYResolution |
ImagePlanarConfiguration | ImageResolutionUnit | ImageTransferFunction |
ImageSoftware | ImageDateTime | ImageArtist |
ImageWhitePoint | ImagePrimaryChromaticities | ImageYCbCrCoefficients |
ImageYCbCrSubSampling | ImageYCbCrPosition | ImageReferenceBlackWhite |
ImageRating | ImageRatingPercent | ImageCopyright |
ImageXPTitle | ImageXPComment | ImageXPAuthor |
ImageXPKeywords | ImageXPSubject | ImageLensSpecification |
ImageLensModel | ImageLensMake | ImageLensSerialNumber |
ExtendedSubjectDistanceRange | ExtendedExposureTime | ExtendedFNumber |
ExtendedExposureProgram | ExtendedSpectralSensitivity | ExtendedISOSpeedRatings |
ExtendedOecf | ExtendedExifVersion | ExtendedDateTimeOriginal |
ExtendedDateTimeDigitized | ExtendedComponentsConfiguration | ExtendedCompressedBitsPerPixel |
ExtendedShutterSpeedValue | ExtendedApertureValue | ExtendedBrightnessValue |
ExtendedExposureBiasValue | ExtendedMaxApertureValue | ExtendedSubjectDistance |
ExtendedMeteringMode | ExtendedLightSource | ExtendedFlash |
ExtendedFocalLength | ExtendedSubjectArea | ExtendedMakerNote |
ExtendedUserComment | ExtendedSubSecTime | ExtendedSubSecTimeOriginal |
ExtendedSubSecTimeDigitized | ExtendedFlashPixVersion | ExtendedColorSpace |
ExtendedPixelXDimension | ExtendedPixelYDimension | ExtendedRelatedSoundFile |
ExtendedFlashEnergy | ExtendedSpatialFrequencyResponse | ExtendedFocalPlaneXResolution |
ExtendedFocalPlaneYResolution | ExtendedFocalPlaneResolutionUnit | ExtendedSubjectLocation |
ExtendedExposureIndex | ExtendedSensingMethod | ExtendedFileSource |
ExtendedSceneType | ExtendedCfaPattern | ExtendedCustomRendered |
ExtendedExposureMode | ExtendedWhiteBalance | ExtendedDigitalZoomRatio |
ExtendedFocalLengthIn35mmFilm | ExtendedSceneCaptureType | ExtendedGainControl |
ExtendedContrast | ExtendedSaturation | ExtendedSharpness |
ExtendedDeviceSettingDescription | ExtendedImageUniqueId | |
Per vedere questi tag in dettaglio, guarda l'esempio EXIF in Survey123 Connect.
Attenzione:
Se una domanda di immagine contiene immagini multiple, non è possibile estrarre dati EXIF dalle immagini usando la funzione pulldata("@exif"). Per estrarre dati EXIF da varie immagini inviate alla stessa domanda, prendere in considerazione la possibilità di usare una ripetizione.
Integrazione di Spike
Nota:
Questa sezione descrive le funzionalità disponibili solo in Survey123 Connect. Questa funzionalità non è disponibile in Survey123 Studio.
Le domande di tipo immagine supportano anche integrazioni con Spike, una soluzione di misurazione laser sviluppata da ikeGPS, che permette di acquisire le misurazioni e la posizione di un oggetto da una foto. Per informazioni su come utilizzare Spike con Survey123, vedi Aspetto delle immagini spike.
Spike registra un certo numero di tag personalizzati aggiuntivi scrivendo un oggetto JSON nel tag EXIF ImageDescription che contiene proprietà non standard riguardanti il dispositivo Spike e le misurazioni che ha acquisito. Le colonne nei tag sono descritte nella tabella di seguito:
| Tag Spike | Descrizione |
|---|---|
| device_id | L'ID del dispositivo Spike sotto forma di stringa |
| local_accuracy | La precisione del dispositivo Spike sotto forma di decimale |
| destination_altitude | L’altitudine della posizione di destinazione sotto forma di numero razionale |
| declination | La declinazione del dispositivo Spike sotto forma di numero razionale |
| pitch | Il pitch del dispositivo Spike sotto forma di numero razionale |
| rotation | La rotazione del dispositivo Spike sotto forma di stringa |
| objects | Un array JSON degli oggetti misurati (area e lunghezze) sotto forma di stringa |
| P2P.capture_id | L’ID delle due immagini del processo point-to-point sotto forma di stringa |
| P2P.horizontal_distance | La distanza orizzontale tra i due punti in metri |
| P2P.distance | La distanza tra i due punti in metri |
| P2P.gradient | Il gradiente tra i due punti in gradi |
| P2P.vertical_distance | La distanza verticale tra i due punti in metri |
| P2P.azimuth | L’azimut dei due punti in gradi |
Per accedere a questi tag Spike, estrai prima l'oggetto JSON memorizzato nell'EXIF tramite pulldata("@exif") sulla proprietà objects come segue:
pulldata("@exif", ${image}, "objects")
Quando l'oggetto JSON è in un altro campo, sarà possibile utilizzare il percorso del nome oggetto Spike. in una funzione pulldata("@json") per estrapolare un valore specifico dall'array JSON. Per ulteriori informazioni sulla funzione pulldata("@json"), consultare Recuperare un valore da JSON. Il seguente esempio estrapola il pitch del dispositivo Spike dalla domanda con l'array al suo interno:
pulldata("@json", ${spikedata}, "Spike.pitch")
L'array di objects contiene anche aree e lunghezze acquisite dal dispositivo Spike. Questo array contiene gli oggetti misurati nell'immagine, includendo forme, linee e la forma di allineamento utilizzata per la trasformazione dell'immagine. Gli oggetti nell'array possono essere estratti facendo riferimento alla loro posizione nell'array, un ordine che corrisponde all'ordine nel quale sono stati acquisiti. L'esempio seguente restituisce la prima area o linea nell'array.
pulldata("@json", ${spikedata}, "Spike.objects[1].type")
Nota:
La posizione 0 nell'array contiene sempre la forma di allineamento.
Per restituire la quantità di oggetti presenti nell'array, utilizzare la proprietà length come segue:
pulldata("@json", ${spikedata}, "Spike.objects.length")
Per visualizzare esempi dei tag in uso, consultare il rilevamento di esempio di Spike in Survey123 Connect. Per ulteriori informazioni su Spike, visitare la pagina dei prodotti di ikeGPS.
Parole chiave
Survey123 utilizza parole chiave negli allegati per associarli a domande specifiche in un rilevamento. Quando si crea una domanda di immagine, audio o file in un rilevamento e la si pubblica, il nome della domando viene utilizzato come parola chiave nella tabella degli allegati. Ad esempio, se un rilevamento contiene domande di immagine denominate image_closeup e image_wideview, il valore memorizzato nella colonna KEYWORDS della tabella degli allegati sarà image_closeup o image_wideview per ciascuna foto. Survey123 associa automaticamente la parola chiave dell'allegato con il nome della domanda per associare gli allegati alle domande.
Lo scopo dell'associazione della parola chiave è evidente quando si stampano i report. Survey123 assicurerà che la corretta foto venga stampata come risposta alla domanda corretta nel rilevamento. L'associazione di parole chiave è inoltre utilizzata per consentire la modifica di immagini nella casella In arrivo.
Se si modifica il nome di una domanda di immagine e si ripubblica il rilevamento, è necessario cambiare anche la parola chiave per tutti i record degli allegati esistenti.
Attenzione:
Quando vengono esportati dati di Survey123, la colonna KEYWORDS della tabella degli allegati non verrà mantenuta.
Se questi dati vengono poi ripubblicati come feature service ospitato, si ha una domanda di immagine e sono stati utilizzati i nomi file predefiniti per gli allegati, è possibile utilizzare il notebook Python Aggiorna parole chiave allegati per ricompilare la colonna KEYWORDS. Se si ha più di una domanda di immagine nel proprio rilevamento, non è possibile utilizzare il notebook ed è necessario determinare manualmente quale file è associato a quale domanda e inserire il nome della domanda nella colonna KEYWORDS per ogni record di allegato. Per ulteriori informazioni, consultare questo articolo dell'Assistenza tecnica.
Se i dati vengono ripubblicati come feature service di ArcGIS Server, è necessario aggiungere prima la colonna KEYWORDS alla tabella degli allegati. È possibile utilizzare lo strumento Aggiorna allegati per aggiungere questa colonna. Se si ha una domanda Immagine e sono stati utilizzati i nomi predefiniti per gli allegati, è possibile utilizzare il notebook Python Aggiorna parole chiave allegati per ricompilare la colonna KEYWORDS. Se si ha più di una domanda di immagine nel proprio rilevamento, non è possibile utilizzare il notebook ed è necessario determinare manualmente quale file è associato a quale domanda e inserire il nome della domanda nella colonna KEYWORDS per ogni record di allegato. Per ulteriori informazioni, consultare questo articolo dell'Assistenza tecnica.
In tutti gli ambienti, quando si visualizzano successivamente questi record in Survey123, il valore della parola chiave nella tabella degli allegati corrisponderà al nome della domanda e l'associazione verrà effettuata automaticamente.
Personalizzare i nomi file
Nota:
Questa sezione descrive le funzionalità disponibili solo in Survey123 Connect e nell'app da campo Survey123. Queste funzionalità non sono disponibili in Survey123 Studio o Survey123 Mobile.
Per impostazione predefinita, Survey123 genera automaticamente un nome file per il contenuto multimediale inviato in una domanda. È possibile personalizzare i nomi file per renderli più significativi. Ad esempio, è possibile includere il nome e cognome del firmatario nel nome file di una firma. Per una foto, è possibile includere la data o un descrittore dell'oggetto che si sta fotografando.
Attenzione:
Nell'app Web sono supportati nomi di file personalizzati per le domande di tipo immagine, audio e file. Nell'app di campo, i nomi di file personalizzati sono supportati solo per le domande di tipo immagine.
I nomi file personalizzati vengono impostati mentre il file viene aggiunto a una domanda multimediale e non vengono aggiornati automaticamente per riflettere le modifiche successive nel rilevamento. Ad esempio, se un nome file fa riferimento a una domanda di testo e il valore di tale domanda cambia dopo l'aggiunta del file, il nome file non verrà aggiornato per riflettere il cambiamento.
È possibile utilizzare il parametro fileName nella colonna bind::esri:parameters perimpostare dinamicamente il nome file per un file che deve essere creato. Nell'esempio seguente, viene creato un nome file per un'immagine simile a ASSET406-20221018145109.jpg utilizzando la domanda asset_id e la data e l'ora correnti:
Per consultare altri esempi di sintassi, vedere il campione Immagini e Annotazioni in Survey123 Connect.
I nomi file devono rispettare le seguenti proprietà:
- I nomi file devono essere univoci per tutte le domande in tutti i rilevamenti nel dispositivo. La cartella I miei allegati al rilevamento archivia tutte le immagini per tutti i rilevamenti nel dispositivo, quindi non può contenere nomi file duplicati. Per assicurarsi che i nomi file siano univoci, considerare l'uso di una funzione come now() nell'espressione fileName.
- I nomi file non possono essere più lunghi di 140 caratteri.
- I nomi file non possono contenere spazi o i seguenti caratteri speciali: \ / : * ? < > ; | . , ". Gli spazi e i caratteri speciali verranno sostituiti con un trattino basso.
Attenzione:
Nell'app Web, se l'espressione del parametro fileName, oppure una modifica manuale del nome del file, produce un duplicato, al nuovo nome file verrà aggiunto un numero incrementale.
Nell'app da campo, se l'espressione per il parametro fileName determina un nome file duplicato o che supera la lunghezza massima, sarà utilizzato il nome file dell'immagine generato automaticamente. Similmente, se gli utenti modificano manualmente il nome file nel rilevamento, esso non verrà accettato se è un duplicato o se supera la lunghezza massima.
I seguenti parametri possono essere applicati nella colonna body::esri:style in una domanda per controllare ulteriormente i nomi file.
- fileNameVisible: indica se il nome del file sarà visibile nel rilevamento. L'impostazione predefinita è true. Per nascondere il nome del file, digita fileNameVisible=false.
- allowRename: indica se agli utenti è concesso modificare il nome del file manualmente. L'impostazione predefinita è true. Gli utenti non possono modificare il nome del file quando fileNameVisible=false, anche seallowRename=true.