Expresiones del informe

La respuesta a una pregunta se puede mostrar en una plantilla de informe proporcionando su nombre entre llaves {} y precedido de un signo de dólar. Cualquier valor de cadena de caracteres incluido en una expresión debe incluirse en comillas dobles.

Lo siguiente muestra la respuesta de una pregunta de texto llamada firstname:

${firstname}

Además de mostrar la respuesta a una pregunta en un informe, pueden utilizarse palabras clave para mostrar otros datos de utilidad. Lo siguiente muestra la fecha y hora actuales al imprimir un informe:

${$date}

Si el resultado es una matriz, la matriz se puede iterar utilizando # como etiqueta inicial y / como etiqueta final dentro de las llaves. Lo siguiente imprime todos los archivos de imagen en líneas separadas:

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

También puede utilizar expresiones para precisar cómo se muestran las respuestas. Una expresión puede ser un solo nombre de pregunta o una palabra clave (como en el caso anterior), un cálculo que incluya una o varias preguntas o palabras clave, o un nombre de pregunta o palabra clave con métodos y parámetros para restringir o aplicar estilo a la respuesta. Una expresión utiliza la siguiente notación:

${questionname or keyword | 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 muestra el cálculo de una pregunta numérica denominada floweringtrees dividida por 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 muestra 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"}

La siguiente expresión se evalúa como verdadera si la respuesta a una pregunta denominada fruitcolor no es igual a red:

${if fruitcolor!="red"}The fruit is not red.${/}

Las cadenas pueden concatenarse en una expresión uniéndolas mediante el signo más. La siguiente expresión utiliza la concatenación para pasar el contenido de una pregunta denominada 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}

En los siguientes temas se incluyen ejemplos de expresiones para cada tipo de pregunta:

• Expresiones de texto
• Expresiones numéricas
• Expresiones de imágenes y otros adjuntos
• Expresiones de mapa (incluye geopunto, geotrace y geoshape)
• Expresiones de fecha, hora y fecha y hora
• Expresiones de elección
• Repetir expresiones

Métodos de expresión

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

Método	Parámetro	Tipo de pregunta de Connect	Tipo de pregunta del diseñador web	Descripció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 su valor es 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 especifica 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	El ancho y la 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	posición	iniciar repetición, imagen, audio, archivo	Repetir, Imagen, Firma, Audio, Archivo	Devuelve un entero igual a la posición indexada 1 en la matriz.
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 devuelve en las respuestas recopiladas en la aplicación web al usar Safari.
apariencia	multilínea	texto	Texto de varias líneas	Conserva los saltos de línea en la cadena de caracteres. Si no se especifica ningún valor de apariencia, se 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	nombre 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 al nombre de opción; de lo contrario, devuelve una casilla de verificación desactivada.
seleccionado	nombre 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 nombre 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 la fecha, la hora y el 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: Este método se ha sido sustituido por map 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 (WGS84) 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.
mapFilters	Id. de capa en los parámetros de consulta, JSON del mapa web	geopunto, geotrace, geoshape	Mapa	Especifica uno o varios filtros de las capas de entidades de un mapa web al imprimir la imagen del 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; 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.
attachmentsDefExp	expresiones SQL	imagen, audio, archivo	Imagen, Firma, Audio, Archivo	Identifica los archivos adjuntos de una pregunta o de la entidad actual utilizando la palabra clave $attachment.

Palabras clave de la expresión

En la tabla siguiente se enumeran todas las palabras clave que pueden utilizarse en una expresión:

Palabra clave	Descripción
$date	Inserta la fecha y hora actuales al imprimir un informe. De forma predeterminada, muestra la fecha actual en el formato de la configuración regional actual. Ejemplos: ${$date | format:"MM/DD/YYYY"} $($date | utcOffset:"+08:00"} $($date | locale:"zh-cn"}
$image	Inserta un elemento de imagen en el informe. Utilice el método src para especificar la URL de la imagen. Ejemplo: ${$image | src:"https://upload.wikimedia.org/wikipedia/commons/1/13/Esri_Headquarters%2C_Building_Q.jpg"}
$map	Inserta un elemento de mapa en el informe sin hacer referencia a una pregunta de la encuesta. Ejemplo: ${$map | map:"10df2279f9684e4a9f6a7f08febac2a9" | mapScale:4000000 | size:200:100}
$shape	Imprime la geometría (punto, polilínea o polígono) de la entidad actual en un mapa. Ejemplos: ${$shape} ${$shape | map:"10df2279f9684e4a9f6a7f08febac2a9" | mapScale:4000000 | size:200:100}
$attachment	Representa el primer archivo adjunto, o todos los archivos adjuntos de la entidad actual. Ejemplos: ${$attachment | getValue:"name"} ${$attachment | getValue:"size"} ${$attachment | size:200:300} Para iterar todos los adjuntos, incluya etiquetas de inicio y fin: ${#$attachment} ${$file} ${/}
$file	Representa el archivo actual cuando se iteran varios archivos de una pregunta de encuesta adjunta o archivos adjuntos de una entidad. Ejemplos: ${#image1} ${$file | size:460:0} {/} ${#$attachment} ${$file | getValue:"position"}. ${$file | getValue:"name"} ${/}
$feature	Representa la entidad actual en una matriz de entidades. Ejemplo: {#repeat1} {$feature | getValue: "position"} {/}
$layers["<layername>"] o $layers[<layerId>]	Hace referencia a cualquier capa por nombre o ID en el mismo servicio de entidades que la capa de la encuesta. Ejemplos: ${$layers["cities"] | where:”1=1 !important” | stats:”count,objectid”} ${#$layers["states"]}...${/}