Puede incluir preguntas sobre elementos multimedia (imagen, audio y archivo) en sus encuestas para que los usuarios puedan enviar adjuntos con las respuestas de la encuesta.
Sugerencia:
También se puede agregar audio e imágenes a otras preguntas de una encuesta a modo de referencia y por razones de estilo. Para obtener más información, consulte Agregar contenido multimedia a una encuesta.
De forma predeterminada, las preguntas sobre elementos multimedia permiten un adjunto. Para permitir varios archivos adjuntos, configure su apariencia.
De forma predeterminada, Survey123 genera automáticamente un nombre de archivo para los elementos multimedia enviados en una pregunta. El nombre de archivo incluye el nombre de pregunta como prefijo, seguido de un número único. Puede personalizar los nombres de archivo para que sean más representativos. Para obtener más información, consulte Personalizar nombres de archivo. Si los datos de la encuesta se exportan y publican como una capa de entidades para su reutilización en Survey123, se recomienda que no personalice los nombres de los archivos. Para obtener más información, consulte Palabras clave.
Audio
El tipo de pregunta de audio permite a los usuarios grabar audio en Survey123. Una barra de progreso indica el tiempo restante de la grabación. Los usuarios pueden detener o poner en pausa la grabación en cualquier momento. Una vez finalizada la grabación, pueden editar el nombre del archivo.
Nota:
En la aplicación de campo Survey123, no se puede poner el audio en pausa mientras se está grabando en Android.
De forma predeterminada, las grabaciones de audio tienen un tamaño máximo de archivo de 10 MB en Survey123 Mobile y en la aplicación de campo Survey123, y una duración máxima de 10 minutos en la aplicación web Survey123.
Puede establecer un límite de tamaño diferente en megabytes mediante el parámetro max-size de la columna bind::esri:parameters. La grabación se detiene automáticamente cuando se alcanza el tamaño máximo de archivo. Por ejemplo, max-size=5 permite a los usuarios grabar hasta 5 MB de audio.
Como alternativa, puede especificar un límite de tiempo en segundos mediante el parámetro max-duration de la columna bind::esri:parameters. La grabación se detiene automáticamente cuando se alcanza la duración máxima. Por ejemplo, max-duration=30 permite a los usuarios grabar hasta 30 segundos de audio.
Precaución:
En la aplicación de campo Survey123, el tamaño máximo de archivo de cada archivo adjunto enviado es de 10 MB. Asegúrese de que el valor de max-duration o max-size que establezca no haga que el archivo de audio supere este tamaño máximo de archivo.
Puede especificar los códecs de audio que prefiera mediante el parámetro codec de la columna bind::esri:parameters. Se pueden proporcionar varios códecs separados por comas; por ejemplo, codec=amr-nb,aac. Se utiliza el primer códec compatible con el dispositivo.
Nota:
En Survey123 Mobile, los archivos de audio se codifican de forma predeterminada con el códec Codificación de audio avanzada (AAC), si el dispositivo lo permite. A continuación se indican los códecs compatibles con cada sistema operativo:
- Android: AAC, MP3
- iOS: AAC, ALAC, FLAC, MP3, PCM, Vorbis
- Windows: AAC, ALAC, MP3, PCM, Vorbis, WMAudioLossless, WMAudioV8, WMAudioV9
Nota:
En la aplicación de campo Survey123, se captura un archivo de audio mediante el formato de captura de audio predeterminado de su dispositivo. Los códecs admitidos por el dispositivo se muestran en la página Acerca de de la aplicación. Pulse y mantenga pulsado el título Acerca de ArcGIS Survey123 de la parte superior de la página Acerca de para mostrar información adicional sobre el dispositivo, incluidos los códecs de audio que admite. En dispositivos Windows, los archivos de audio siempre se graban en formato WAV sin comprimir.
Es posible que no pueda reproducir algunos archivos de audio en un determinado navegador web porque los navegadores no admiten todos los códecs. Para obtener más información sobre los códecs de audio en la web, consulte la documentación de Mozilla Developer Network.
Las preguntas de audio solo permiten cargar un archivo de audio existente en la aplicación web. También puede enviar un archivo de audio almacenado en su dispositivo utilizando una pregunta de archivo. Para obtener una lista de los tipos de archivos de audio admitidos, consulte Archivos.
Archivos
Nota:
Esta sección describe funciones que solo están disponibles en Survey123 Connect y en la aplicación de campo Survey123. Estas funciones no están disponibles en Survey123 Studio ni en Survey123 Mobile.
El tipo de pregunta de archivo permite a los usuarios enviar una variedad de tipos de archivos.
El tamaño máximo predeterminado de un archivo individual es de 10 MB. Para preguntas de archivo en la aplicación web Survey123, puede especificar el tamaño máximo de archivo en megabytes utilizando max-size en la columna bind::esri:parameters. Por ejemplo, max-size=5 permite a los usuarios adjuntar un archivo de hasta 5 MB.
Nota:
El tamaño máximo de archivo para un adjunto individual enviado desde la aplicación de campo Survey123 es de 10 MB.
Cuando se aplica a las preguntas de archivo, el parámetro max-size solo se admite en la aplicación web de Survey123. El tamaño máximo no puede superar los 500 MB para ArcGIS Online y los 20 MB para ArcGIS Enterprise.
El tipo de pregunta de archivo acepta todos los tipos de archivo adjunto admitidos por ArcGIS Online y ArcGIS Enterprise. Los tipos de archivos compatibles son los siguientes:
| Categoría | Tipo de archivo |
|---|---|
Archivar | 7Z, GTAR, GZ, TAR, TGZ, ZIP |
Audio | AIF, M4A, MID, MP2, MP3, MPA, RA, RAM, RMI, WAV, WMA |
Datos | CSV, GEODATABASE, GEOJSON, GML, GPKG*, JSON, MDB, PBF*, SD*, VRML, XML |
Documento | DOC, DOCX, DOT, PDF, PPT, PPTX, TXT, WPS, XLS, XLSX, XLT |
Imagen | BMP, ECW, EMF, EPS, GIF, IMG, J2K, JP2, JPC, JPE, JPEG, JPF, JPG, PNG, PS, PSD, RAW, SID, TIF, TIFF, WMF |
Vídeo | AVI, MOV, MP4, MPE, MPEG, MPG, MPV2, QT, WMV |
*Este tipo de adjunto no se admite en ArcGIS Enterprise.
Puede limitar los tipos de archivo que se pueden enviar a una pregunta de archivo con la columna body::accept. Esta columna acepta tanto extensiones de archivo (por ejemplo, .wav) como tipos MIME (por ejemplo, audio/*). Es posible establecer varias extensiones de archivo o tipos MIME separándolos con comas.
Para obtener información sobre formatos aceptados para tipos MIME, consulte la Lista de Mozilla de tipos MIME comunes.
Imágenes
El tipo de pregunta de imagen permite a los usuarios enviar imágenes guardadas en su dispositivo o fotos tomadas con la cámara de su dispositivo.
Las fotos tomadas en Survey123 se guardan como archivos .jpg, con un nivel de calidad que depende de la cámara del dispositivo. El tamaño de la imagen, medido en píxeles en el borde más largo, se puede configurar mediante Opciones en Survey123 Studio o Survey123 Connect. Este tamaño se aplica a todas las preguntas de imagen de la encuesta. Las siguientes opciones están disponibles:
- 320 píxeles
- 640 píxeles
- 1280 píxeles
- 1920 píxeles
- Sin restricción: (se pueden adjuntar a la encuesta fotos de cualquier tamaño).
El tamaño de imagen predeterminado es 1280 píxeles. Las imágenes enviadas que estaban guardadas en el dispositivo conservan su tipo de archivo, resolución y calidad originales.
Estos tamaños de imagen no afectan a la vista previa de la imagen proporcionada en Survey123 Mobile o en la aplicación de campo Survey123.
El tamaño máximo predeterminado de una imagen individual es de 10 MB. Para preguntas de imagen en la aplicación web Survey123, puede especificar el tamaño máximo de archivo en megabytes utilizando max-size en la columna bind::esri:parameters. Por ejemplo, max-size=5 permite a los usuarios adjuntar una imagen de hasta 5 MB.
Nota:
El tamaño máximo de archivo para un adjunto individual enviado desde la aplicación de campo Survey123 es de 10 MB.
Cuando se aplica a las preguntas de imagen, el parámetro max-size solo se admite en la aplicación web de Survey123. El tamaño máximo no puede superar los 100 MB para ArcGIS Online y los 20 MB para ArcGIS Enterprise.
Personalizar el tamaño de la imagen y el método de captura
Nota:
Esta sección describe funciones que solo están disponibles en la aplicación de campo Survey123. Estas funciones no están disponibles en Survey123 Mobile.
Puede controlar el tamaño de la vista previa de la imagen que se proporciona en la aplicación de campo Survey123 mediante el parámetro previewHeight. Este parámetro admite todos los tipos de unidades admitidos por el parámetro height, pero la altura de la imagen de vista previa está limitada en último término por la anchura de la pantalla del dispositivo y por la relación de aspecto de la imagen. Utilice previewHeight=0 para establecer la vista previa de la imagen en el tamaño máximo sin espacios en blanco innecesarios.
Puede definir el tamaño máximo permitido de una imagen para cada pregunta de imagen individual de una encuesta. Especifique max-pixels en la columna parameters del XLSForm para la pregunta que desee limitar. Por ejemplo, max-pixels=100 reduce la escala de la imagen proporcionalmente a 100 píxeles en el borde más largo. Si no se especifica el parámetro max-pixels, se utiliza el tamaño de imagen establecido en Survey123 Connect.
Puede limitar una pregunta de imagen a un método de captura determinado especificando method=camera o method=browse en la columna body::esri:style del XLSForm. También puede definir la apariencia como new-front o new-rear para que una pregunta de imagen esté limitada a usar solamente imágenes de la cámara del dispositivo, usando la cámara de frontal o posterior, respectivamente, como predeterminada. Cuando se utiliza la apariencia annotate, también puede especificar method=map.
Apariencia
Puede cambiar el comportamiento de las preguntas y la forma en que se presentan configurando la apariencia. Para confirmar qué aplicaciones de envío admiten una apariencia determinada, consulte la tabla Apariencias.
Al establecer la columna de apariencia en multiline, una pregunta de archivo o imagen permite adjuntar varios archivos en una sola pregunta.
Esta apariencia se puede combinar con otras estableciendo ambas apariencias separadas por un espacio, como multiline annotate en una pregunta de imagen.
Puede controlar el número de imágenes o archivos que se pueden enviar utilizando la función count-selected en la columna restricción. A continuación se exponen algunos ejemplos:
- count-selected(${file_question}) <= 5 limita el número de archivos que se pueden enviar a un máximo de cinco.
- count-selected(${image_question}) <= 3 limita el número de imágenes que se pueden enviar a un máximo de tres.
Al establecer la apariencia en signature, se puede utilizar una pregunta de imagen para abrir una firma.
Nota:
En Survey123 Connect, también puede establecer las siguientes apariencias para las preguntas de imagen de las encuestas utilizadas con la aplicación de campo Survey123:
- Al establecer la apariencia en new-front o new-rear, puede limitar las preguntas de imagen para que utilicen únicamente la cámara del dispositivo, con la cámara frontal o trasera como opción predeterminada, respectivamente. Esta apariencia se pueden combinar con annotate definiendo ambas apariencias separadas por un espacio, como new-front annotate.
- Al establecer la apariencia en draw o annotate, puede permitir que los usuarios dibujen sobre las fotos o las anoten.
- Al establecer la apariencia en spike, una pregunta de imagen muestra un botón para abrir la aplicación móvil Spike e integrar Survey123 con Spike. Para obtener más información, consulte Apariencia de las imágenes de Spike.
Apariencia signature
Si la apariencia se define como signature, se presenta una pregunta de imagen como un elemento emergente para capturar una firma.
Una firma se guarda como un archivo adjunto de imagen .jpg con el mismo tamaño que el elemento emergente. De forma predeterminada, el ancho del elemento emergente se extiende al ancho de la pantalla del dispositivo, con una altura fija de 200 píxeles. Para establecer la anchura máxima de esta ventana emergente mediante el parámetro max-pixels, consulte Personalizar el tamaño de la imagen y el método de captura.
También puede proporcionar una imagen en la columna predeterminado para establecer un fondo personalizado para la firma. El tamaño de la imagen predeterminada determina la relación de aspecto del elemento emergente.
El ancho del elemento emergente será el más pequeño de los siguientes:
- El valor max-pixels
- El ancho de la imagen predeterminada
- El ancho de la pantalla del dispositivo
La altura será de 200 píxeles, a menos que se proporcione una imagen predeterminada.
Al diseñar una encuesta con la apariencia signature, asegúrese de tener en cuenta el tamaño de pantalla de todos los dispositivos de destino.
Se puede proporcionar el texto del pie de página correspondiente a un elemento emergente de pregunta de firma utilizando el parámetro footerText en la columna body::esri:style. Al utilizar solo el parámetro footerText sin ningún valor, las sugerencias de orientación de la pregunta aparecerán debajo de la firma. Esto se puede cambiar a las sugerencias de la pregunta utilizando footerText=@[hint]. Las sugerencias o las sugerencias de orientación del texto del pie de página no aparecerán en la ubicación predeterminada debajo del nombre de la pregunta. Para obtener más información sobre las sugerencias, consulte Sugerencias.
Nota:
La aplicación web Survey123 no admite el multiline, el parámetro max-pixels o valores predeterminados cuando se aplica a la apariencia signature.
Apariencia draw y annotate
Nota:
Esta sección describe funciones que solo están disponibles en Survey123 Connect y en la aplicación de campo Survey123. Estas funciones no están disponibles en Survey123 Studio ni en Survey123 Mobile.
Si la apariencia se define como draw, las preguntas de imagen muestran un botón para cargar un lienzo en el que dibujar. En la paleta de herramientas de dibujo, puede alternar entre las herramientas de dibujo, así como controlar la configuración de cada herramienta, como el tamaño del texto, el ancho de línea, el color, etc. Para obtener más información sobre la interfaz de lienzo, consulte Dibujar y anotar. Puede crear paletas personalizadas que le permitan configurar las herramientas de dibujo y anotación con arreglo a sus necesidades. Para obtener más información, consulte Paletas de dibujo y anotación.
Si la apariencia se define como annotate, una pregunta de imagen muestra un botón para abrir la cámara del dispositivo para tomar una foto que, a continuación, admite anotaciones con gráficos y texto. En la paleta de herramientas de dibujo, puede alternar entre las herramientas de dibujo, así como controlar la configuración de cada herramienta, como el tamaño del texto, el ancho de línea, el color, etc. Para obtener más información sobre la interfaz de lienzo, consulte Dibujar y anotar. Puede crear paletas personalizadas que le permitan configurar las herramientas de dibujo y anotación con arreglo a sus necesidades. Para obtener más información, consulte Paletas de dibujo y anotación.
Sugerencia:
A partir de Survey123 3.13, los datos EXIF se copian de la imagen de origen a la imagen anotada.
Alternativamente, puede permitir que el usuario anote una imagen existente desde el almacenamiento del dispositivo o una instantánea de un mapa. Para esto, establezca body::esri:style para esa pregunta en method=browse, method=camera o method=map. El comportamiento predeterminado de la apariencia annotate es idéntico a proporcionar method=camera. Puede establecer la pregunta para proporcionar una serie de opciones para la imagen de origen suministrado varias opciones separadas por comas, por ejemplo, method=camera,browse.
Precaución:
La aplicación web Survey123 solo muestra un navegador para la opción de archivo con independencia del método establecido.
Los valores predeterminados y los cálculos se comportan de manera diferente con las preguntas de imagen en función de si se utiliza draw o annotate. Si se utiliza como valor predeterminado el nombre de archivo de una imagen de la carpeta "contenido multimedia" de la encuesta o es resultado de un cálculo, la imagen se utiliza como un fondo inicial para el lienzo. Con annotate, esta imagen se reemplaza por una imagen proporcionada y solo se muestra si el usuario rechaza específicamente proporcionar una imagen o restablece la imagen una vez que se ha proporcionado.
Nota:
Puede establecer la resolución de una imagen definiendo un valor max-pixels en la columna parameters. Para una pregunta draw, al definir max-pixels=1000 el lienzo se establecerá en una imagen cuadrada de 1000x1000 píxeles. Para una pregunta annotate, al definir max-pixels=1000 se establecerá el lado más largo de la imagen en 1000 píxeles y se conservará la relación de aspecto de la imagen proporcionada. Si max-pixels no está definido, el tamaño de la imagen se establecerá en el ajuste de tamaño de imagen de la configuración de Opciones para su encuesta en Survey123 Connect.
Estas dos maneras de establecer la resolución de imagen se sobrescriben proporcionando una imagen predeterminada para la pregunta, en cuyo caso se aplicará la resolución de la imagen predeterminada. De esta manera se puede garantizar una resolución estándar para todas las imágenes enviadas. Proporcionar una instantánea de un mapa para anotación también sobrescribirá cualquier otra configuración de resolución de imagen, estableciéndose la imagen en el tamaño del área del lienzo visible.
Apariencia Spike de las imágenes
Nota:
Esta sección describe funciones que solo están disponibles en Survey123 Connect y en la aplicación de campo Survey123. Estas funciones no están disponibles en Survey123 Studio ni en Survey123 Mobile.
Nota:
La integración de Spike no es compatible con la aplicación web Survey123.
Las preguntas de imagen también permiten que las apariencias integren Survey123 con Spike, una solución de medición láser desarrollada por ikeGPS que le permite capturar las mediciones y la ubicación de un objeto a partir de una fotografía. Si la apariencia se establece como spike, spike-full-measure o spike-point-to-point, la pregunta de imagen muestra un botón para abrir la aplicación móvil Spike en dispositivos iOS y Android.
Una foto tomada con la aplicación Spike y el dispositivo láser le permite registrar las coordenadas del objeto y la distancia que hay hasta él. También le permite medir las dimensiones de objetos de la foto a través de áreas y líneas de dibujo. La foto con marcas de medición se adjuntará a su encuesta, y los metadatos de la foto, por ejemplo, coordenadas y mediciones, estarán disponibles para su registro. Los metadatos asociados de mediciones y de Spike se registran en el archivo de imagen mediante etiquetas estándar de archivo de imagen intercambiable (EXIF). La información de EXIF luego se puede extraer y utilizar para rellenar otros campos.
La diferencia entre las apariencias Spike es la extensión de los valores almacenados en la imagen. La apariencia spike solo mide la distancia y la ubicación, mientras que la apariencia spike-full-measure mide la distancia, la ubicación, el área y la longitud. La apariencia spike-point-to-point captura una serie de valores exclusivos para ella y que se denotan por los nombres de propiedad que comienzan por P2P.
Para obtener más información sobre estas etiquetas de EXIF, consulte Integración de Spike. Para obtener más información sobre Spike, consulte el sitio web de Spike.
Extraer metadatos de la imagen
Puede usar la función pulldata("@exif") para extraer etiquetas de metadatos estándar de archivo de imagen intercambiable (EXIF) de la respuesta a una pregunta de imagen. Al introducir el siguiente ejemplo en una pregunta decimal, se extrae el valor de latitud del dispositivo de una imagen:
pulldata("@exif", ${image}, "GpsLatitude")
En la siguiente tabla se enumeran las etiquetas EXIF de ubicación habituales que puede utilizar con la función pulldata("@exif"):
| Etiqueta EXIF | Descripción |
|---|---|
| GpsLatitude | La latitud de la ubicación del dispositivo como una cadena de caracteres |
| GpsLongitude | La longitud de la ubicación del dispositivo como una cadena de caracteres |
| GpsAltitude | La altitud de la ubicación del dispositivo como una cadena de caracteres |
| GpsLatitudeRef | La referencia de latitud (es decir, N,E,S,O) de la ubicación del dispositivo como cadena de caracteres |
| GpsLongitudeRef | La referencia de longitud (es decir, N,E,S,O) de la ubicación del dispositivo como cadena de caracteres |
| GpsDestDistance | La distancia entre el dispositivo y las ubicaciones de destino, en kilómetros, como un entero |
| GpsImgDirection | La dirección hacia la ubicación de destino desde la ubicación del dispositivo como una cadena de caracteres |
| GpsDestLatitude | La latitud de la ubicación del destino como una cadena de caracteres |
| GpsDestLongitude | La longitud de la ubicación del destino como una cadena de caracteres |
| GpsDestLatitudeRef | La referencia de latitud (es decir, N,E,S,O) de la ubicación de destino como cadena de caracteres |
| GpsDestLongitudeRef | La referencia de longitud (es decir, N,E,S,O) de la ubicación de destino como cadena de caracteres |
El siguiente ejemplo se puede usar para mostrar los valores de latitud y longitud en un solo campo que, a su vez, se puede usar para rellenar una pregunta geopoint:
string(pulldata("@exif", ${image}, "GpsLatitude")) + " " + string(pulldata("@exif", ${image}, "GpsLongitude"))
A continuación, se enumeran otras etiquetas EXIF de imagen que Survey123 puede extraer. En función del hardware utilizado, no todas estas etiquetas estarán disponibles.
| Etiqueta 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 | |
Para ver estas etiquetas en detalle, consulte la muestra EXIF en Survey123 Connect.
Precaución:
Si una pregunta de imagen contiene varias imágenes, los datos EXIF no se pueden extraer de las imágenes utilizando la función pulldata("@exif"). Para extraer datos EXIF de varias imágenes enviadas a la misma pregunta, plantéese utilizar una repetición.
Integración de Spike
Nota:
Esta sección describe funciones que solo están disponibles en Survey123 Connect. Estas funciones no están disponibles en Survey123 Studio.
Las preguntas de imagen también admiten la integración con la solución de medición láser Spike desarrollada por ikeGPS, que le permite capturar las mediciones y la ubicación de un objeto a partir de una foto. Para obtener información sobre cómo utilizar Spike con Survey123, consulte Apariencia spike de las imágenes.
Spike registra un número de etiquetas personalizadas adicionales escribiendo un objeto JSON a la etiqueta EXIF ImageDescription que contiene propiedades no estándares relacionadas con el dispositivo Spike y las mediciones que ha tomado. Estas etiquetas se describen en la siguiente tabla:
| Etiqueta Spike | Descripción |
|---|---|
| device_id | El Id. del dispositivo Spike como una cadena de caracteres |
| local_accuracy | La precisión del dispositivo Spike como un decimal |
| destination_altitude | La altitud de la ubicación de destino como un valor racional |
| declination | La declinación del dispositivo Spike como un valor racional |
| pitch | La inclinación del dispositivo Spike como un valor racional |
| rotation | La rotación del dispositivo Spike como una cadena de caracteres |
| objects | Una matriz JSON de los objetos medidos (área y longitudes) como una cadena de caracteres |
| P2P.capture_id | El Id. de las dos imágenes del proceso de punto a punto como una cadena de caracteres |
| P2P.horizontal_distance | La distancia horizontal entre los dos puntos en metros |
| P2P.distance | La distancia entre los dos puntos en metros |
| P2P.gradient | El gradiente entre los dos puntos en grados |
| P2P.vertical_distance | La distancia vertical entre los dos puntos en metros |
| P2P.azimuth | El acimut de los dos puntos en grados |
Para acceder a estas etiquetas de Spike, primero extraiga el objeto JSON almacenado en EXIF mediante pulldata("@exif") en la propiedad objects, como se muestra a continuación:
pulldata("@exif", ${image}, "objects")
Una vez que este objeto JSON está en otro campo, puede usar la ruta de nombre del objeto Spike. en una función pulldata("@json") para extraer un valor específico de la matriz JSON. Para obtener más información sobre la función pulldata("@json"), consulte Recuperar un valor a partir de un JSON. El siguiente ejemplo extrae la inclinación del dispositivo Spike desde la pregunta con la matriz incluida:
pulldata("@json", ${spikedata}, "Spike.pitch")
La matriz objects también contiene las áreas y las longitudes capturadas por el dispositivo Spike. Este conjunto contiene los objetos medidos de la imagen, incluidas las formas y líneas, así como una forma de alineación utilizada para la transformación de imágenes. Los objetos del conjunto se pueden extraer haciendo referencia a su posición en el conjunto, un orden que corresponde al orden en que se capturaron. El siguiente ejemplo devuelve la primera línea o área de la matriz:
pulldata("@json", ${spikedata}, "Spike.objects[1].type")
Nota:
La posición 0 del conjunto siempre contiene la forma de alineación.
Para devolver la cantidad de objetos presentes en la matriz, use la propiedad length de este modo:
pulldata("@json", ${spikedata}, "Spike.objects.length")
Para ver ejemplos de estas etiquetas en uso, consulte la encuesta de muestra de Spike en Survey123 Connect. Para obtener más información sobre Spike, consulte la página de productos de ikeGPS.
Palabras clave
Survey123 utiliza palabras clave de archivos adjuntos para asociar archivos adjuntos con preguntas específicas en las encuestas. Cuando crea una pregunta de imagen, audio o archivo en una encuesta y la publica, el nombre de la pregunta se usa como palabra clave en la tabla de archivos adjuntos. Por ejemplo, si una encuesta contiene preguntas de imágenes denominadas image_closeup e image_wideview, el valor almacenado en la columna KEYWORDS de la tabla de archivos adjuntos será image_closeup o image_wideview para cada foto. Survey123 hace coincidir automáticamente la palabra clave del archivo adjunto con el nombre de la pregunta para asociar los archivos adjuntos a las preguntas.
El propósito de la asociación de palabras clave es más evidente cuando se imprimen informes; Survey123 garantizará que se imprima la foto correcta como respuesta a la pregunta correcta de la encuesta. La asociación de palabras clave también se utiliza para permitir la edición de imágenes en la bandeja de entrada.
Si cambia el nombre de una pregunta de imagen y vuelve a publicar la encuesta, también debe cambiar la palabra clave para cualquier registro adjunto existente.
Precaución:
Cuando se exportan datos Survey123, la columna KEYWORDS de la tabla de archivos adjuntos no se conservará.
Si estos datos se vuelven a publicar como un servicio de entidades alojado, tiene una pregunta de imagen y se han usado nombres de archivo predeterminados para los archivos adjuntos, puede usar el cuaderno de Actualizar palabras clave de archivos adjuntos Python para volver a rellenar la columna KEYWORDS. Si tiene más de una pregunta con imágenes en su encuesta, no puede usar el cuaderno y debe determinar manualmente qué archivo está asociado con qué pregunta e introducir el nombre de la pregunta en la columna KEYWORDS para cada registro adjunto. Para obtener más información, consulte este artículo de Soporte técnico.
Si los datos se vuelven a publicar como un servicio de entidades de ArcGIS Server, primero debe agregar la columna KEYWORDS a la tabla de datos adjuntos. Puede usar la herramienta Actualizar archivos adjuntos para agregar esta columna. Si tiene una pregunta de imagen y se han usado nombres de archivo predeterminados para los archivos adjuntos, puede usar el cuaderno de Actualizar palabras clave de archivos adjuntos Python para volver a rellenar la columna KEYWORDS. Si tiene más de una pregunta con imágenes en su encuesta, no puede usar el cuaderno y debe determinar manualmente qué archivo está asociado con qué pregunta e introducir el nombre de la pregunta en la columna KEYWORDS para cada registro adjunto. Para obtener más información, consulte este artículo de Soporte técnico.
En cualquier entorno, la próxima vez que vea estos registros en Survey123, el valor de la palabra clave de la tabla adjunta coincidirá con el nombre de la pregunta y la asociación se realizará automáticamente.
Personalizar nombres de archivo
Nota:
Esta sección describe funciones que solo están disponibles en Survey123 Connect y en la aplicación de campo Survey123. Estas funciones no están disponibles en Survey123 Studio ni en Survey123 Mobile.
De forma predeterminada, Survey123 genera automáticamente un nombre de archivo para los elementos multimedia enviados en una pregunta. Puede personalizar los nombres de archivo de algunas preguntas para que sean más representativos. Por ejemplo, puede incluir el nombre y los apellidos del firmante en un nombre de archivo de firma. Para una foto, puede incluir la fecha o un descriptor del objeto que está fotografiando.
Precaución:
En la aplicación web, se admiten nombres de archivo personalizados para las preguntas de imagen, audio y archivo. En la aplicación de campo, los nombres de archivo personalizados solo se admiten para las preguntas de imagen.
Los nombres de archivo personalizados se establecen a medida que el archivo se agrega a una pregunta de medios y no se actualizan automáticamente para reflejar cambios posteriores en la encuesta. Por ejemplo, si un nombre de archivo hace referencia a una pregunta de texto y el valor de esa pregunta cambia después de agregar el archivo, el nombre del archivo no se actualizará para reflejar el cambio.
Puede utilizar el parámetro fileName de la columna bind::esri:parameters para establecer dinámicamente el nombre del archivo que se va a crear. En el siguiente ejemplo, se crea un nombre de archivo de imagen similar a ASSET406-20221018145109.jpg a partir de la pregunta asset_id y de la fecha y hora actuales:
Consulte más ejemplos de sintaxis en la muestra de Imágenes y Anotación en Survey123 Connect.
Los nombres de archivos deben cumplir los siguientes requisitos:
- Los nombres de archivo de todas las preguntas de todas las encuestas del dispositivo deben ser únicos. La carpeta My Survey Attachments almacena todas las imágenes de todas las encuestas del dispositivo y no puede contener nombres de archivo duplicados. Para asegurarse de que los nombres de archivo son únicos, plantéese utilizar una función como now() en la expresión fileName.
- Los nombres de archivo no pueden tener más de 140 caracteres.
- Los nombres de archivo no pueden contener espacios ni los siguientes caracteres especiales: \ / : * ? < > ; | . , ". Los espacios y los caracteres especiales se sustituirán por un guion bajo.
Precaución:
En la aplicación web, si la expresión para el parámetro fileName o una edición manual del nombre de archivo genera un duplicado, se incorporará un número incrementado al nuevo nombre de archivo.
En la aplicación de campo, si la expresión del parámetro fileName da como resultado un nombre de archivo duplicado o que supera la longitud máxima, se utilizará el nombre de archivo generado automáticamente para la imagen. De forma similar, si los usuarios editan manualmente el nombre de archivo en la encuesta, el nombre de archivo no se aceptará si está duplicado o supera la longitud máxima.
Para controlar más los nombres de los archivos, se pueden aplicar los siguientes parámetros en la columna body::esri:style correspondiente a una pregunta:
- fileNameVisible: especifica si el nombre del archivo será visible en la encuesta. El valor predeterminado es true. Para ocultar el nombre de archivo, escriba fileNameVisible=false.
- allowRename: especifica si los usuarios pueden editar el nombre del archivo manualmente. El valor predeterminado es true. Los usuarios no pueden editar el nombre de archivo si fileNameVisible=false, incluso si allowRename=true.