Plantillas de informe

La funcionalidad de generación de informes del sitio web Survey123 permite diseñar sus propias plantillas personalizadas y producir varios informes a la vez.

Un informe puede contener lo siguiente:

  • Una sección de resumen
  • Un único registro de encuesta
  • Un único registro de encuesta y una sección de resumen
  • Varios registros de encuesta
  • Varios registros de encuesta y una sección de resumen
Nota:

La impresión de informes es un servicio Premium de ArcGIS Online y consume créditos. Para obtener más información, consulte Imprimir informes.

La impresión de informes en ArcGIS Enterprise no consume créditos, pero tiene limitaciones.

La plantilla de informe es un archivo de Microsoft Word (.docx) que proporciona texto de marcador de posición con una sintaxis específica. Al imprimir un informe, este texto marcador de posición se reemplaza con el contenido de los campos correspondientes de la respuesta a la encuesta. Este texto marcador de posición puede usarse con cualquier formato, tablas, imágenes u otras personalizaciones para crear una plantilla específica para sus necesidades.

Para crear una plantilla, haga clic en el botón Informe de la barra situada sobre el mapa, en la pestaña Datos y haga clic en Administrar plantillas. Aparece una nueva ventana que permite descargar un ejemplo, cargar una nueva plantilla o editar el nombre y el resumen de una plantilla existente. Haga clic en Nueva plantilla para cargar una nueva plantilla de informe y, a la vez, proporcione un nombre y un resumen para su plantilla una vez cargada. Como alternativa, puede usar el vínculo Descargar una plantilla de muestrapara descargar una plantilla de muestra basada en su encuesta.

Nota:

Solo el propietario de la encuesta y los administradores de la organización pueden cargar plantillas de informe.

Al compartir los resultados de una encuesta con todos, una organización o un grupo, también se compartirán las plantillas de informes asociadas con la encuesta.

Expresiones

La respuesta a una pregunta se puede mostrar en una plantilla de informe proporcionando su nombre entre llaves, como { y }, y precedido de un signo de dólar. La siguiente expresión mostraría la respuesta de una pregunta de texto llamada firstname.

${firstname}

Puede utilizar también expresiones para definir las respuestas que se deben mostrar en el informe y cómo se muestran. Una expresión puede ser un solo nombre de pregunta, un cálculo que incluya una o varias preguntas o un nombre de pregunta con métodos y parámetros para restringir o aplicar estilo a la respuesta. Una expresión utiliza la siguiente notación:

${questionname | method:parameter}

Una expresión puede incluir varios métodos y parámetros o ninguno. Los parámetros pueden ser valores de otras preguntas o un valor fijo.

La siguiente expresión mostraría el cálculo de una pregunta numérica denominada floweringtrees dividida entre una pregunta numérica denominada totaltrees. Cuando se hace referencia a varias preguntas en la misma expresión, los nombres de las preguntas individuales solo tienen que nombrarse directamente y no necesitan llaves adicionales.

${floweringtrees / totaltrees}

La siguiente expresión mostraría el valor de la coordenada x de la pregunta de ubicación, donde getValue es el método y x es el parámetro.

${location | getValue:"x"}

Las cadenas pueden concatenarse en una expresión uniéndolas mediante el signo más. Esta expresión utiliza la concatenación para pasar el contenido de una pregunta field_0 a un servicio de generación de códigos QR, con lo que se crea un código QR para la respuesta a la pregunta.

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

No todos los tipos de preguntas admiten expresiones y métodos. La siguiente tabla enumera qué métodos y parámetros puede utilizar con los diferentes tipos de preguntas.

MétodoParámetrosTipo de pregunta de ConnectTipo de pregunta del diseñador webDescripción

getValue

-

Todos los tipos de preguntas

Todos los tipos de preguntas

Recupera el valor de datos sin procesar de la capa de entidades o la imagen sin procesar de un adjunto.

getValue

x, y, z, wkid

geopunto

Mapa

Recupera las coordenadas x, y, z individualmente en una referencia espacial especificada. El parámetro wkid es opcional y será igual que la referencia espacial de la capa de entidades si se omite.

getValue

longitud, área, unidad, tipo de medición

geotrace, geoshape

Mapa

Devuelve la longitud de una polilínea, o el perímetro o área de un polígono, en unidades determinadas y si las mediciones son planares o geodésicas. El tipo de medición predeterminado es geodésico.

getValue

nombre, tamaño

imagen, audio, archivo

Imagen, Firma, Audio, Archivo

Devuelve el nombre o el tamaño de archivo de un adjunto.

getValue

ancho, altura, x, y, fecha, hora, dirección

imagen

Imagen, firma

Ancho y altura devuelven el valor entero del ancho y la altura de la imagen en píxeles, y x, y, fecha, hora y dirección devuelven valores leídos desde el EXIF de la imagen si están presentes.

getValue

recuento

iniciar repetición, imagen, audio, archivo

Repetir, Imagen, Firma, Audio, Archivo

Devuelve el número total de repeticiones o elementos adjuntos.

getValue

duración

audio, archivo

Audio, Archivo

Devuelve la duración de las grabaciones de audio en segundos.

Precaución:

La duración no se devolverá en las respuestas recopiladas en la aplicación web al usar Safari.

apariencia

multilínea

texto

Texto de varias líneas

Se utiliza para conservar los saltos de línea en la cadena de caracteres. Si no se especifica ninguna apariencia, la respuesta devuelve una cadena de una sola línea.

apariencia

viñetas

select_multiple

Selección múltiple

Devuelve la respuesta en formato viñeta.

verificado

valor de opción

select_one, select_multiple

Selección múltiple, Selección única, Cuadrícula de selección única, Desplegable, Escala de Likert, Calificación

Devuelve una casilla de verificación activada si el valor de campo es igual a choiceValue; de lo contrario, devuelve una casilla de verificación desactivada.

seleccionado

valor de opción

select_one, select_multiple

Selección múltiple, Selección única, Cuadrícula de selección única, Desplegable, Escala de Likert, Calificación

Si existe un dominio de valor codificado, devuelve true si el valor de campo es igual al valor de opción; de lo contrario, devuelve false.

countSelected

-

select_one, select_multiple

Selección múltiple, Selección única, Cuadrícula de selección única, Desplegable, Escala de Likert, Calificación

Devuelve el número de opciones seleccionadas.

selectedAt

índice

select_one, select_multiple

Selección múltiple, Selección única, Cuadrícula de selección única, Desplegable, Escala de Likert, Calificación

Devuelve la cadena de caracteres en la posición del índice en la lista de opciones. El índice comienza en cero.

regional

código de idioma

fecha, dateTime, comienzo, fin, decimal

Fecha, Fecha y hora, Número

Devuelve fecha, hora y número localizados.

formato

cadena de formato

fecha, dateTime, entero, decimal, comienzo, fin

Fecha, Fecha y hora

Devuelve una cadena de caracteres de fecha con formato.

utcOffset

valor de desplazamiento

fecha, dateTime, comienzo, fin

Fecha, Fecha y hora

Devuelve un valor de fecha o de fecha y hora que se desplaza por el valor de desplazamiento UTC.

mapSettings

Id. de elemento de mapa web, escala de mapa

geopunto, geotrace, geoshape

Mapa

Especifica el mapa base y la escala al imprimir la imagen de mapa.

Heredado:

Reemplazado por mapa y mapScale.

mapExtent

xmín, ymín, xmáx, ymáx, wkid

geopunto, geotrace, geoshape

Mapa

Especifica la extensión de mapa fija al imprimir la imagen de mapa. El parámetro wkid es opcional y se establecerá en 4326 (WGS 1984) si se omite.

mapa

Id. de elemento de mapa web

geopunto, geotrace, geoshape

Mapa

Especifica el mapa base al imprimir la imagen de mapa.

mapScale

escala de mapa

geopunto, geotrace, geoshape

Mapa

Especifica la escala del mapa al imprimir la imagen de mapa.

rotar

grados

geopoint, geotrace, geoshape, image

Mapa, imagen

Especifica el ángulo de rotación del mapa o la imagen.

drawingInfo

currentLayer, URL de capa de entidades

geopunto, geotrace, geoshape

Mapa

Especifica la información del dibujo al imprimir la imagen de mapa, incluidos el símbolo, la etiqueta y la transparencia.

src

URL de la imagen

-

-

Especifica la URL de origen de un elemento de imagen dinámico.

tamaño

ancho, altura, ancho máximo, altura máxima

imagen

Imagen

Especifica el tamaño de la imagen impresa.

redondear

lugares

decimal, geopoint, geoshape, geotrace

Número

Redondea un número decimal las posiciones decimales especificadas.

useGrouping

booleano

decimal

Número

Si es true, devuelve un número con separadores de agrupación determinados por la configuración regional; de lo contrario, si es false, no se utilizan separadores.

toFixed

lugares

decimal, geopoint, geoshape, geotrace

Número

Especifica una cantidad de dígitos fija después del separador decimal. Rellena con ceros si es necesario para tener un número fijo de dígitos.

En la ventana Administrar plantillas, seleccione Referencia rápida para abrir una página que contiene una sintaxis de ejemplo para que las expresiones modifiquen la respuesta que se muestra en un informe para cada pregunta de la encuesta. Para copiar esta sintaxis, haga clic en el botón Copiar al portapapeles y pegue la sintaxis en un documento de plantilla. Una vez cargada una plantilla, utilice las opciones del panel Informe para generar el informe. Para obtener más información, consulte Imprimir informes.

Referencia rápida de informe con ejemplos de sintaxis

En las secciones siguientes se describen escenarios de uso común de expresiones para cada tipo de pregunta y se proporcionan ejemplos.

Texto

Las preguntas de texto de varias líneas, ya sean creadas al agregar una pregunta Texto de varias líneas en el diseñador web de Survey123 o al utilizar la apariencia multiline para una pregunta de texto en Survey123 Connect, ignorarán los retornos de carro de forma predeterminada y mostrarán la respuesta en un solo bloque de texto. Puede usar expresiones para mostrar la respuesta a la pregunta con retornos de carro de la siguiente forma:

${multilinetext1 | appearance:"multiline"}

Coloque esta expresión en una línea dedicada; de lo contrario, se producirán errores.

Números

Es posible utilizar operadores matemáticos básicos con preguntas numéricas para realizar sumas, restas, multiplicaciones o divisiones, o bien para hallar el módulo de las respuestas a estas preguntas. A continuación, se muestran algunos ejemplos:

${number1 - 15}

${number1 * 6}

${number1 / number2}

${number1 % number2}

Sugerencia:

Si la expresión contiene una expresión matemática compleja, plantéese utilizar corchetes para asegurarse de que la generación del informe produzca el resultado esperado.

En las preguntas de decimales, la expresión round se puede utilizar para establecer un número máximo de posiciones decimales a las que redondear el valor. En el siguiente ejemplo se redondea el número 3,141592 a las cuatro posiciones decimales de 3,1416:

${decimal1 | round:4}

La expresión toFixed se puede utilizar para establecer un número máximo de posiciones decimales a las que redondear el valor. En el siguiente ejemplo se corrige el número de posiciones decimales de 3,14 a 3,140:

${decimal1 | toFixed:3}

Puede utilizar la expresión de formato para mostrar la respuesta a una pregunta numérica de una forma específica utilizando caracteres de marcador de posición. Se admiten los siguientes caracteres de marcador de posición.

CarácterDescripción

.

Separador decimal.

,

Si se coloca en el formato, agrega separadores de grupo con el tamaño del grupo determinado por el número de dígitos que hay entre el primer marcador de posición del separador de grupo y el marcador de posición de punto decimal o el final de la expresión. Si no se agrega, no se utilizan separadores de grupo.

0

Dígitos requeridos. Si la respuesta tiene menos dígitos que el número requerido de dígitos, se rellenará con ceros.

#

Dígitos opcionales. Si la respuesta tiene más dígitos que la cantidad de dígitos proporcionada, el número se redondeará.

Sugerencia:

Los separadores decimal y de miles se mostrarán en el resultado impreso en función de la configuración regional elegida.

El siguiente ejemplo devuelve la respuesta a un máximo de tres posiciones decimales con separadores de miles, si es necesario.

${decimal1 | format:"#,##0.###"}

Imágenes y otros 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 su 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 habrá restricción en esa dimensión. Por ejemplo, la siguiente expresión obliga a 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 obliga a 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}

Puede utilizar el método rotate para definir la rotación en el sentido de las agujas del reloj 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:

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

Para mostrar la imagen original en calidad completa pero con un tamaño definido, utilice 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 dar formato a estos valores, considere la posibilidad de realizar la extracción EXIF como parte de la encuesta 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"}

Si todos los adjuntos de la entidad son imágenes, utilice los siguientes marcadores de posición, situando cada uno en una línea dedicada:

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

Para devolver varias imágenes enviadas a la misma pregunta en una respuesta, utilice el nombre de la pregunta de imagen en lugar de $attachment:

${#image1}
${$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. El siguiente ejemplo muestra los nombres de archivo de todos los adjuntos de una entidad:

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

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}

Preguntas de mapa

Todas las preguntas que utilizan un mapa (incluidas geopoint, geotrace y geoshape) tienen métodos y parámetros comunes que puede utilizar para modificar su presentación en informes.

De forma predeterminada, un mapa de un informe utilizará el mapa web definido para la pregunta. Si la escala del mapa se establece en 0 o se omite el parámetro, la escala del mapa está determinada por las entidades del mapa de la siguiente manera:

  • Si solo hay una entidad de puntos en el mapa, la escala de mapa coincide con la escala definida para la pregunta.
  • Si solo hay una entidad poligonal o de línea en el mapa, la escala de mapa viene determinada por la extensión de la entidad.
  • Si hay varias entidades en el mapa, la escala viene determinada por la extensión de todas las entidades.

Las preguntas de mapa admiten la definición del Id. de elemento del mapa web y la escala de mapa como parámetros opcionales. En el siguiente ejemplo, se utiliza una escala de mapa de 1:100.000:

${location | map:"7e2b9be8a9c94e45b7f87857d8d168d6" | mapScale:100000}

Para todas las preguntas de mapa, puede utilizar el método rotate para definir la rotación en el sentido de las agujas del reloj rumbo norte en relación con la vista. Acepta valores del 0 al 360.

${location | map:"7e2b9be8a9c94e45b7f87857d8d168d6" | mapScale:100000 | rotate:90}

Si deja el Id. de elemento de mapa web como una cadena vacía, se utiliza el mapa base predeterminado de la pregunta. Si establece la escala del mapa en 0 u omite este parámetro, el mapa utilizará la extensión predeterminada establecida para la pregunta.

El método mapExtent se puede utilizar para establecer explícitamente la extensión de un mapa en un informe. En el siguiente ejemplo, se muestra una extensión de mapa fija de Tokio (Japón):

${location | mapExtent:139.7:35.6:139.9:35.8:4326}

Las preguntas de mapa también admiten la expresión de tamaño disponible para las preguntas de imagen. Puede utilizar esta expresión para controlar la resolución del mapa mostrado en el informe, como se puede ver en el siguiente ejemplo:

${location | size:400:400}

Puede utilizar las expresiones map, mapScale y size juntas para proporcionar un Id. de mapa web y una escala de mapa, así como una resolución de imagen de mapa, como se muestra en el siguiente ejemplo:

${location | map:"7e2b9be8a9c94e45b7f87857d8d168d6" | mapScale:100000 | size:400:400}

Nota:

Si va a configurar el tamaño de mapa y va a utilizar cualquier otro método de expresión, size debe estar situado en último lugar en la expresión.

De forma predeterminada, una pregunta de mapa se mostrará utilizando un símbolo de mapa predeterminado, independientemente de la simbología definida en la capa de entidades. Puede utilizar el método drawingInfo para extraer y utilizar la información de dibujo almacenada en una capa de entidades específica, incluidos el símbolo, la etiqueta y la transparencia utilizados. Puede especificar esta información desde la capa actual o desde una capa de entidades concreta a través de una dirección URL proporcionada.

${location | drawingInfo:"currentLayer"}

${location | drawingInfo:"https://.../FeatureServer/0"}

Si su encuesta no contiene preguntas de mapa, o si está creando informes para capas de entidades sin una encuesta asociada, se puede seguir devolviendo la geometría de un registro con el marcador de posición ${$shape}.

En una sección de resumen, una expresión para una pregunta de mapa muestra varias geometrías en la entrada de la pregunta. Si desea incluir otras respuestas para un informe individual, proporcione una expresión where con la etiqueta !important. Para obtener más información, consulte Sintaxis adicional. La siguiente expresión muestra todas las geometrías de la capa donde el valor de campo de estado es igual a 'broken':

${location | where:"status='broken' !important" | map:"<itemID>" | size:400:300}

Nota:

En el ejemplo anterior, se omite la escala del mapa. Si establece la escala del mapa en 0 u omite el parámetro, y el mapa contiene varios registros, el mapa utilizará la extensión combinada para todos los registros.

Puede establecer la expresión where para que sea siempre una sentencia true a fin de garantizar que todas las geometrías de la capa se muestren:

${location | where:"1=1 !important"}

Esto también puede utilizarse para mostrar todos los puntos de una repetición:

${repeat1.repeatLocation | where:"inspectionId=123 !important" | size:400:300}

El marcador de posición ${$shape} también se puede utilizar para devolver varias geometrías de mapa.

${$shape | where:"1=1 !important" | drawingInfo:"currentLayer" | size:400:300}

Geopuntos

En las preguntas geopoint, puede utilizar expresiones para visualizar los valores de latitud o longitud de la pregunta, como se indica a continuación:

${location | getValue:"x"}

${location | getValue:"y"}

No puede mostrar ambos valores con una expresión; si ambos valores son necesarios, debe utilizar ambas expresiones.

Sugerencia:

También puede mostrar el valor de altitud con una expresión similar, pero solo si la capa de entidades subyacente admite valores z:

${location | getValue:"z"}

De forma predeterminada, los valores de latitud, longitud y altitud devuelven el valor original proporcionado en la respuesta de la encuesta, sin truncar. Dado que estos valores suelen ser mucho más largos de lo necesario en un informe, plantéese utilizar las expresiones round o toFixed para redondear el valor a una posición decimal específica.

${location | getValue:"x" | round:3}

${location | getValue:"x" | toFixed:3}

De forma predeterminada, estos valores son la salida de la misma referencia espacial utilizada por la capa de entidades de la encuesta. Puede establecer una referencia espacial diferente como parámetro adicional proporcionando su WKID:

${location | getValue:"x":4326}

Geotrace y geoshape

En preguntas geotrace y geoshape, puede utilizar la expresión getValue para visualizar la longitud de la línea o el perímetro del polígono, respectivamente:

${polyline1 | getValue:"length":"meters":"planar"}

En las preguntas de geoshape, también puede utilizar la expresión getValue para visualizar el área del polígono:

${polygon1 | getValue:"area":"hectares":"geodesic"}

Las unidades y el método de cálculo son parámetros opcionales. Se admiten las siguientes unidades para la longitud:

  • feet
  • kilometers
  • meters
  • miles
  • nautical-miles
  • yards

Se admiten las siguientes unidades para el área:

  • acres
  • hectares
  • square-miles
  • square-kilometers
  • square-meters
  • square-feet
  • square-yards

Como alternativa, puede utilizar cualquiera de las Constantes esriSRUnitType o Constantes esriSRUnit2Type compatibles con API REST de ArcGIS. En su expresión, utilice el código numérico para la constante sin comillas de la siguiente forma:

${polyline1 | getValue:"length":109002:"geodesic"}

Si no se especifican las unidades, el valor predeterminado es kilometers para la longitud o square-kilometers para el área.

El método puede ser geodesic o planar. Si no se especifica el método, se utiliza geodesic de forma predeterminada.

Fecha, hora y fecha-hora

Para garantizar que las preguntas de fecha y fecha y hora se presentan de forma que sean precisas según el formato de su región, puede usar una expresión para dar formato a la pregunta de manera que coincida con una configuración regional proporcionada. Coloque el parámetro locale primero en una expresión y el código de configuración regional debe estar en minúscula.

${datetime | locale:"pt-br"}

Nota:

Para obtener información sobre el código de configuración regional de un idioma concreto, consulte la Lista de códigos ISO 639-1 de la Wikipedia. No obstante, recuerde que Survey123 no admite todos estos idiomas.

Todos los valores de fecha y de fecha y hora en una capa de entidades se almacenan en formato de hora universal coordinada (UTC). De forma predeterminada, todos los valores de fecha y de fecha y hora devueltos en un informe están en la misma zona horaria que el navegador web que solicitó la generación del informe. Puede usar el método utcOffset para alterar la visualización de estos valores en un informe y referirlos a una zona horaria específica. La siguiente expresión muestra la respuesta a una pregunta de fecha y hora con una diferencia de una hora respecto de la hora UTC:

${datetime | utcOffset:"+01:00"}

El método utcOffset admite los formatos +01:00, +0100 y +01, y devuelve el mismo resultado. También puede utilizar este método para modificar la visualización de la hora de envío de la respuesta. Tenga en cuenta que utcOffset no trabaja con preguntas de hora.

Para las preguntas de fecha y fecha-hora, puede usar una expresión para formatear la fecha con los marcadores de posición DD, MM y YYYY para el día, el mes y el año, respectivamente. La siguiente expresión solo muestra el día y el mes, omitiendo el año:

${date | format:"DD/MM"}

También puede formatear la hora en las preguntas de fecha y hora, usando HH, mm y SS como marcadores de posición para las horas, los minutos y los segundos, respectivamente. La siguiente expresión visualiza el día, el mes, las horas y los minutos:

${datetime | format:"DD/MM HH:mm"}

Nota:

Debe colocar el método format al final de la expresión.

La siguiente tabla enumera los marcadores de posición de fecha y hora más comunes:

Marcador de posiciónDescripción

AA

Los dos últimos dígitos del año.

Por ejemplo: 2023 se representaría como 23.

AAAA

Cuatro dígitos del año.

Por ejemplo: 2023 se representaría como 2023.

M

Número de mes entre 1 y 12.

Por ejemplo: enero se representaría como 1.

MM

Número de mes en dos dígitos.

Por ejemplo: enero se representaría como 01.

MMM

Mes en tres letras.

Por ejemplo: enero se representaría como Ene.

MMMM

Mes escrito con su nombre completo.

Por ejemplo: enero se representaría como Enero.

D

Número de día entre 1 y 31.

Por ejemplo: el primer día del mes se representa como 1.

DD

Número de día en dos dígitos.

Por ejemplo: el primer día del mes se representa como 01.

Permitido

Número de día con sufijos ordinales.

Por ejemplo: el primer día del mes se representa como 1.º.

H

Número de hora en formato de 24 horas.

Por ejemplo: 11 p. m. se representaría como 23.

HH

Número de hora en formato de 24 horas con dos dígitos.

Por ejemplo: 2 a.m. se representaría como 02.

h

Número de hora en formato de 12 horas.

Por ejemplo: 11 p. m. se representaría como 11.

hh

Número de hora en formato de 12 horas con dos dígitos.

Por ejemplo: 2 a.m. se representaría como 02.

m

Número de minutos entre 0 y 59.

Ejemplo: 8 minutos se representarían como 8.

mm

Número de minutos en dos dígitos.

Ejemplo: 8 minutos se representarían como 08.

Z

Desplazamiento de zona horaria en horas usando separador.

Ejemplos: -07:00, +13:00

ZZ

Desplazamiento de zona horaria en horas sin separador.

Ejemplos: -0700, +1300

x

Marca de tiempo con milisegundos Unix.

Ejemplos: las 9 p.m. del 4 de mayo de 2023 GMT se representarían como 1683234000000.

X

Marca de tiempo Unix.

Ejemplos: las 9 p.m. del 4 de mayo de 2023 GMT se representarían como 1683234000.

a

Notación de la mañana o de la tarde en minúscula.

Ejemplo: a.m. se representaría como am y p.m. se representaría como pm.

A

Notación de la mañana o de la tarde en mayúscula.

Ejemplo: a.m. se representaría como AM y p.m. se representaría como PM.

Varias opciones

Si se hace referencia a una pregunta de selección única en un marcador de posición, por ejemplo, ${select_one}, devolverá la etiqueta seleccionada. Si se utiliza una pregunta de selección única dentro de una expresión, o si la pregunta utiliza una selección externa, una preguntas de selección única devolverán el valor de un elemento seleccionado. El siguiente ejemplo utiliza un valor de opción, en lugar de una etiqueta, en una declaración condicional:

${if select_one=="choice1Value"}The user selected the first choice.${/}

Para mostrar intencionadamente el valor de una opción, en lugar de la etiqueta, utilice la expresión getValue:

${select_one | getValue:""}

Tanto para las preguntas de selección única como de selección múltiple, puede usar una expresión para colocar una casilla de verificación junto a un elemento de opción, que se rellena en función de la respuesta a la pregunta. La siguiente expresión se muestra si se ha seleccionado la opción yes en una pregunta:

${select_one | checked:"yes"} Yes

Las preguntas de selección múltiple admiten expresiones para generar la cantidad total de opciones seleccionadas, así como para generar una opción seleccionada concreta:

${select_multiple | countSelected}

${choiceQuestion1 | selectedAt:2}

Nota:

La expresión selectedAt empieza a contar las opciones seleccionadas a partir de 0. Significa que ${choiceQuestion1 | selectedAt:2} devolverá la tercera opción seleccionada.

Las preguntas de selección múltiple también cuentan con una expresión compatible para devolver todos los elementos de opción seleccionados en forma de una lista con viñetas, como se indica a continuación:

${select_multiple | appearance:"bullets"}

Nota:

Si la etiqueta del elemento elegido contiene comillas dobles, deben estar precedidas por una barra inversa; de lo contrario, el informe no se imprimirá. No se necesita la barra inversa para las comillas simples. A continuación, encontrará un ejemplo:

${select_one | checked:"Service provided by \"Greg's Plumbing\""} Service provided by "Greg's Plumbing"

Repeticiones

Para acceder a preguntas de una repetición, agregue una sección de repetición a su plantilla. En una repetición denominada "defects", el marcador de posición ${#defects} denota el inicio de una sección de repetición, mientras que ${/} denota el final. Los marcadores de posición que apuntan a preguntas de la repetición deben estar entre los marcadores de posición de inicio y final de la sección de repetición.

Nota:

Para imprimir el contenido de una repetición dentro de una tabla, asegúrese de que tanto las etiquetas de inicio como las de fin se encuentren dentro de la tabla o fuera de ella. No puede generar un informe si una de estas etiquetas está dentro de la tabla y otra está fuera. En la mayoría de los casos, si se colocan una etiqueta de inicio y de fin dentro de una tabla, la etiqueta de inicio debería estar en la primera celda y la de fin en la última.

Para acceder a preguntas dentro de una repetición anidada, coloque sus etiquetas entre las etiquetas de cada capa de repetición sobre la sección de repetición prevista. A continuación, encontrará un ejemplo:

${#repeat1}
${#repeat2}
${#repeat3}
${field1InRepeat3}, ${repeat2.field1}, ${repeat1.field1}, ${mainLayer.field1} 
${/}
${/}
${/}

Las expresiones de informe no pueden leer caracteres especiales, como guiones, al hacer referencia a nombres de capa utilizando la sintaxis ${layername}. Cuando se referencie una capa con un carácter especial en su nombre, utilice un guion bajo en lugar de caracteres especiales. También puede hacer referencia a la capa a través de la palabra clave $layers y el nombre de capa o el Id. de capa, por ejemplo, ${$layers["my layer name"]} o ${$layers[0]}. Esto puede ser útil con nombres de capa duplicados.

Para hacer referencia a un campo en su repetición que tenga el mismo nombre que su repetición principal, utilice la sintaxis de ruta completa, incluidos el nombre de campo y repetición, por ejemplo, ${sharedName.sharedName}.

Para visualizar el índice de un registro repetido, utilice la expresión getValue con la palabra clave reservada $feature. En este ejemplo se producirá 1 para el primer registro de una repetición, 2 para el segundo y así sucesivamente:

${#defects}
${$feature | getValue: "position"}
${/}

Consultas de informes

Puede utilizar funciones de agregación para producir consultas de los valores de las respuestas impresas. Estas consultas son más adecuadas en una sección de resumen, que solo aparecerá una vez en un informe, independientemente de la cantidad de respuestas impresas. Para obtener más información, consulte Consultas de informes.

Para limitar la impresión del informe a un número específico de repeticiones, en lugar de cada repetición asociada a la respuesta, utilice el método resultRecordCount para establecer un número específico de repeticiones que se desea imprimir:

${#defects | resultRecordCount:20}...${/}

Puede usar el método orderByFields para determinar el orden en el que se imprimirán las repeticiones. Declare un nombre de campo, seguido de ASC o DESC, y las repeticiones se imprimirán de acuerdo con la entrada de ese campo en orden ascendente o descendente, respectivamente:

${#defects | orderByFields:"state_name ASC, pop2000 DESC"}...${/}

Elementos de informe condicionales

Puede mostrar u ocultar elementos de un informe condicionalmente mediante sentencias if. Puede utilizar la sentencia if escribiendo una expresión en el marcador de posición ${if expression} de inicio, en la que ${/} denota el final del segmento condicional. Estos son algunos ejemplos de sentencias if que puede utilizar para mostrar u ocultar partes de un informe:

  • ${if photo1} muestra la sección únicamente si la pregunta photo1 se ha respondido.
  • ${if integer1>0} muestra la sección únicamente si la respuesta a la pregunta integer1 es un número positivo.
  • ${if ((geopoint1 | getValue:"y")>0)} muestra la sección únicamente si el geopunto está en el hemisferio norte.
  • ${if multiple_choice1 | selected:"A"} muestra la sección únicamente si la pregunta con varias opciones tenía la opción "A" seleccionada.
  • ${if (repeat1 | getValue:"count")>=3} muestra la sección solo si repeat1 contiene tres o más registros.

En el siguiente ejemplo, el texto de la segunda línea solo aparecerá en el informe si high está seleccionado para una pregunta de selección única prioritaria:

${if priority | selected:"high"}
High priority issues must be addressed within seven days.
${/}

Para comprobar si una respuesta contiene un valor para una pregunta, utilice únicamente una sentencia if que haga referencia al nombre de campo directamente sin ningún otro operador, por ejemplo, ${if photo1}. Este formato garantiza que las cadenas vacías, los valores nulos y los valores no definidos se consideren valores vacíos. Este formato se aplica a tipos de campo de cadena de caracteres, número, fecha y adjunto. Al utilizar este formato con repeticiones, la sección aparecerá siempre y cuando haya al menos una instancia en la repetición.

Para utilizar declaraciones condicionales con preguntas de fecha y hora, realice cálculos utilizando el tiempo Epoch (milisegundos transcurridos desde el 1 de enero de 1970). Por ejemplo, ${if (date1|getValue:"") < 1602735375000} muestra la sección únicamente si el valor del campo de fecha es anterior al 14 de octubre de 2020. Tenga en cuenta que la sintaxis del informe no tiene un equivalente a las funciones today() o now() del XLSForm, por lo que es imposible crear una declaración condicional para las horas en que se imprimió el informe.

Las sentencias if admiten los siguientes operadores lógicos:

OperadorDescripción

||

True si una de las dos sentencias devuelve el valor True

&&

True si las dos sentencias proporcionadas devuelven el valor True

!

True si la sentencia no devuelve el valor True

==

True si los dos valores proporcionados son equivalentes

!=

True si los dos valores proporcionados no son equivalentes

>

Evalúa si el primer valor es mayor que el segundo valor

>=

Evalúa si el primer valor es mayor o igual que el segundo valor

<

Evalúa si el primer valor es menor que el segundo valor

<=

Evalúa si el primer valor es menor o igual que el segundo valor

Limitaciones

Existen las siguientes limitaciones al utilizar plantillas de informe:

  • Los filtros aplicados a repeticiones en el sitio web Survey123 no se aplicarán a informes. Solo pueden filtrarse repeticiones de un informe mediante el uso de expresiones.
  • El mapa no aparecerá en su informe si el mapa utiliza una versión de mapa web anterior a la 2.0, publicada en julio de 2014.
  • El mapa no aparecerá en su informe si su portal de ArcGIS Enterprise no tiene un certificado SSL válido.
  • La impresión con plantillas de informe no funciona con implementaciones de ArcGIS Enterprise que no estén orientadas al público. Intentar hacerlo presentará un error getaddrinfo ENOTFOUND.
  • La impresión con plantillas de informe no funciona con implementaciones de ArcGIS Enterprise que utilicen la Autenticación integrada de Windows (IWA).
  • Puede incluirse un máximo de 2000 registros por solicitud de informe.
  • Cuando se instala el sitio web de Survey123 en su infraestructura, no se puede utilizar la API de informes. Solo se pueden generar informes al utilizar https://survey123.arcgis.com/.