A continuación se proporcionan ejemplos de expresiones de informe para preguntas de imágenes y archivos adjuntos.
En las preguntas de imagen, es posible definir tamaños para asegurarse de que sus informes presenten imágenes de un tamaño uniforme. El formato de estas expresiones es el siguiente:
${image1 | size:width:height:max_width:max_height}
Los valores de ancho y alto controlan el tamaño definido para la imagen, medido en píxeles. Aunque estos valores son obligatorios en la expresión, si indica el valor 0 en una dimensión de su imagen, no hay restricción en esa dimensión. Por ejemplo, la siguiente expresión hace que la anchura de su imagen sea de 300 píxeles, conservando al mismo tiempo la relación de aspecto de la imagen:
${image1 | size:300:0}
Los valores de altura y anchura máximas limitan el tamaño máximo de una imagen y son valores opcionales. El siguiente ejemplo hace que la anchura de la imagen sea de 300 píxeles, pero restringe la altura de la imagen a no más de 200 píxeles:
${image1 | size:300:0:0:200}
El siguiente ejemplo utiliza el método rotate para definir la rotación en sentido horario de la imagen. Acepta valores del 0 al 360.
${image1 | size:300:0:0:200 | rotate:90}
A las preguntas de imagen también se les pueden extraer detalles de imagen, los cuales se pueden mostrar en una respuesta de encuesta. Esto se puede utilizar para visualizar el nombre de archivo y el tamaño de la imagen, como se indica a continuación:
${image1 | getValue:"name"}
${image1 | getValue:"size"}
${image1 | getValue:"width"}
${image1 | getValue:"height"}
Puede aplicar el mismo método para visualizar los datos EXIF de la imagen, que muestran la información sobre la fecha y el lugar en que se tomó la foto, como se indica a continuación:
${image1 | getValue:"x"}
${image1 | getValue:"y"}
${image1 | getValue:"date"}
${image1 | getValue:"time"}
${image1 | getValue:"direction"}
Para mostrar la imagen original en calidad y tamaño completos, use la expresión sin ningún método, o use la expresión getValue sin ningún valor, como se indica a continuación:
${image1} o ${image1 | getValue:""}
El siguiente ejemplo muestra la imagen original en calidad completa, pero con un tamaño definido, utilizando las expresiones getValue y size juntas.
${image1 | getValue:"" | size:300:0}
Nota:
Si va a configurar el tamaño de imagen y va a utilizar cualquier otro parámetro de expresión, size debe estar situado en último lugar en la expresión.
Las fechas y las horas se almacenan como cadenas de caracteres en los datos EXIF, por lo que estos valores no se pueden formatear en un informe utilizando la expresión format para las preguntas de fecha y hora. Si es importante formatear estos valores, puede realizar la extracción EXIF como parte del estudio utilizando la función pulldata("@exif"). Para obtener más información, consulte Imágenes.
Las expresiones getValue anteriores también se pueden utilizar para extraer datos de cualquier propiedad válida de cualquier tipo de adjunto, incluidos los resultados de las preguntas de imagen, audio y archivo. Las propiedades que se pueden extraer de todos los adjuntos son las siguientes:
${file1 | getValue:"name"}
${file1 | getValue:"size"}
${file1 | getValue:"globalId"}
${file1 | getValue:"id"}
${file1 | getValue:"contentType"}
${file1 | getValue:"keywords"}
Para mostrar una imagen en línea, proporcione su dirección URL de origen con la expresión src al hacer referencia a la palabra clave $image en lugar de un nombre de pregunta:
${$image |
src:"https://upload.wikimedia.org/wikipedia/commons/1/13/Esri_Headquarters%2C_Building_Q.jpg"
| size:400:0}Para devolver varias imágenes enviadas a la misma pregunta en una respuesta, utilice los siguientes marcadores de posición, situando cada uno en una línea dedicada:
${#image1}
${$file}
${/}La palabra clave $attachment se puede utilizar para iterar todos los archivos adjuntos de la entidad actual:
${#attachment}
${$file}
${/}Este método resulta útil a la hora de mostrar imágenes en versiones de ArcGIS Enterprise anteriores a la 10.8.1 o para visualizar imágenes agregadas a una entidad fuera de Survey123 en la que los archivos adjuntos no tienen un valor para la propiedad de palabras clave. El siguiente ejemplo muestra los nombres de archivo de todos los adjuntos de una entidad:
${#$attachment}
${$file|getValue:"name"}
${/}Para mostrar archivos adjuntos específicos, incluya attachmentsDefExp, el método para identificar el archivo adjunto:
${#image1 | attachmentsDefExp:"DATA_SIZE > "+1*1024*1024}...${$file}...${/}
${#$attachment | attachmentsDefExp:"Keywords = 'image1'"}...${$file}...${/}
${#$attachment | attachmentsDefExp:"CONTENT_TYPE like '%image%'"}...${$file}...${/}