Referencia rápida

ArcGIS Survey123 admite una buena parte de la especificación XLSForm. Esta guía de referencia proporciona un resumen de las características de XLSForm que puede usar en Survey123. Las encuestas se pueden crear en Survey123 Connect o en el sitio web de Survey123; algunas características solo están disponibles en uno y otras están disponibles en ambos.

Tipos de preguntas

La tabla siguiente describe los tipos de preguntas que están disponibles en Survey123 Connect, la aplicación de campo Survey123, el diseñador web de Survey123 y la aplicación web Survey123. En algunas preguntas, hay diferencias de comportamiento e implementación según la plataforma; para conocerlas, consulte las notas que encontrará después de la tabla.

Tipo de pregunta de Survey123 Connect	Tipo de pregunta del diseñador web de Survey123	Descripción	Se admite en la aplicación de campo Survey123	Se admite en la aplicación web Survey123
audio⁴	Audio⁴ ⁶	Registra un clip de audio en la aplicación de campo. Registra un clip de audio o acepta un archivo de audio cargado en la aplicación web.	Sí	Sí
barcode	N/A	Escanea un código de barras o un código QR.	Sí	Sí
grupo de inicio	Grupo, Página	Inicia un grupo de preguntas.	Sí	Sí
begin repeat	N/A	Inicia un grupo de preguntas que se repiten.	Sí	Sí
calcular	N/A	Realiza un cálculo con los valores del formulario. El campo calculate contiene el resultado del cálculo.	Sí	Sí
decimal¹	Número¹ ⁶	Entrada decimal.	Sí	Sí
fecha	Fecha⁶	Entrada de fecha.	Sí	Sí
dateTime	Fecha y hora⁶	Entrada de fecha y hora.	Sí	Sí
deviceid	N/A	El UUID que representa al dispositivo específico con el que se respondió a la encuesta.	Sí	No
correo electrónico²	N/A	Cuando se inicia sesión con una cuenta de organización, esta pregunta se rellena automáticamente con la dirección de correo electrónico de la cuenta.	Sí	Sí
final	N/A	Fecha y hora de finalización de la encuesta.	Sí	Sí
grupo de fin	Grupo, Página	Finaliza un grupo de preguntas.	Sí	Sí
repetición de fin	N/A	Finaliza un grupo de preguntas que se repiten.	Sí	Sí
archivo	Carga de archivo	Acepta un archivo en el dispositivo.	Sí	Sí
geopunto³	Mapa³ ⁶	Captura una coordenada GPS dada. Se establece de forma predeterminada en la ubicación actual.	Sí	Sí
geoshape³		Captura un polígono de un mapa.	Sí	Sí
geotrace³		Captura una línea de un mapa.	Sí	Sí
oculto	N/A	Crea un campo en la capa de entidades que no se muestra en el formulario. Use las columnas bind::esri:fieldType y bind::esri:fieldLength para especificar el esquema de datos de este campo.	Sí	Sí
entero¹	Número¹ ⁶	Entrada de número entero.	Sí	Sí
imagen	Imagen, Firma	Acepta una imagen de los archivos del dispositivo o una fotografía hecha por el usuario.	Sí	Sí
nota	Nota⁶	Muestra texto en la pantalla. Tenga en cuenta que también puede manejar cálculos ocultos.	Sí	Sí
rango	Control deslizante⁶	Entrada de un rango determinado de números.	Sí	Sí
rank list_name	Clasificación⁶	Pregunta de clasificación; ordena una lista de opciones. Reemplace list_name con el nombre de su lista de opciones.	Sí	Sí
select_one list_name	Desplegable⁵ ⁶, Escala de Likert⁵ ⁶, Calificación⁶, Selección única⁶, Cuadrícula de selección única⁶	Pregunta con varias opciones; solo se puede seleccionar una respuesta. Reemplace list_name con el nombre de su lista de opciones.	Sí	Sí
select_one_from_file file_name.csv	N/A	Pregunta con varias opciones; solo se puede seleccionar una respuesta. Sustituya file_name.csv con el nombre del archivo ubicado en la carpeta multimedia de la encuesta que contiene la lista de opciones.	Sí	Sí
select_multiple list_name	Selección múltiple⁶	Pregunta con varias opciones; se pueden seleccionar varias respuestas. Reemplace list_name con el nombre de su lista de opciones.	Sí	Sí
select_multiple_from_file file_name.csv	N/A	Pregunta con varias opciones; se pueden seleccionar varias respuestas. Sustituya file_name.csv con el nombre del archivo ubicado en la carpeta multimedia de la encuesta que contiene la lista de opciones.	Sí	Sí
inicio	N/A	Fecha y hora de inicio de la encuesta.	Sí	Sí
texto	Dirección⁶, Correo electrónico⁶, Texto de varias líneas⁵ ⁶, Texto de una sola línea⁶, Sitio web⁶	Respuesta de texto libre. Se aplica una expresión regular al correo electrónico y el sitio web. La apariencia geocode se aplica a Dirección.	Sí	Sí
hora	Tiempo⁶	Entrada de hora.	Sí	Sí
nombre de usuario	N/A	Cuando se inicia sesión con una cuenta de organización, esta pregunta se rellena automáticamente con el nombre de usuario de la cuenta.	Sí	Sí

¹El diseñador web combina preguntas de tipo entero o decimal en un único tipo de pregunta denominado Número. La casilla de verificación de las propiedades de la pregunta permite al diseñador de la encuesta definir la entrada necesaria.

²Las preguntas de tipo correo electrónico proporcionadas en Survey123 Connect y en el diseñador web de Survey123 se implementan de forma distinta. La implementación en Survey123 Connect se rellena automáticamente con la dirección de correo electrónico de la cuenta de organización con la que el usuario tiene sesión iniciada. Por el contrario, la implementación en el diseñador web de Survey123 es un campo de texto que solo acepta la concordancia con el formato de direcciones de correo electrónico.

³Se han combinado las preguntas de geopunto, geotrace y geoshape en un único tipo de pregunta denominado Mapa. La casilla de verificación de las propiedades de la pregunta permite al diseñador de la encuesta definir la entrada necesaria. Un tipo de pregunta adicional denominado Dirección permite enviar puntos geocodificados.

⁴Las preguntas de audio no permiten la carga en la aplicación de campo Survey123 del mismo modo que en la aplicación web. Para permitir la carga de audio en la aplicación de campo, utilice una pregunta de archivo.

⁵Varias apariencias disponibles en Survey123 Connect están disponibles como tipos de preguntas individuales en el diseñador web de Survey123. Esto incluye Texto de varias líneas, Desplegable y Escala de Likert.

⁶Para cada pregunta, el diseñador web ofrece una opción para almacenar en caché la respuesta. En la aplicación web, después de enviar un registro de encuesta, la respuesta a la pregunta se almacenará en caché en el navegador y se cargará previamente en el siguiente envío realizado para esta encuesta en ese dispositivo. El almacenamiento en caché de una respuesta se puede definir para todos los tipos de preguntas, excepto para Audio, Imagen, Carga de archivo y Firma.

Columnas de la hoja de cálculo survey

La tabla siguiente contiene todas las columnas admitidas por Survey123. Estas columnas se incluyen en la hoja de cálculo survey de la plantilla Advanced y se enumeran en esta tabla en el orden en que aparecen en la hoja de cálculo.

Columna	Descripción
tipo	Seleccione un tipo de pregunta de la lista proporcionada. Introduzca un nombre de lista válido si utiliza una pregunta select_one o select_multiple.
name	Nombre de campo en la capa de entidades.
etiqueta	La etiqueta de pregunta que aparece en su encuesta.
pista	Información que puede ayudar a resolver la pregunta de la encuesta.
guidance_hint	Información adicional, solo mostrada después de pulsar un icono.
apariencia	Seleccione el aspecto de este campo de la encuesta.
requerido	Seleccione yes para exigir un valor en este campo antes de completar la encuesta.
required_message	Si un campo obligatorio no tiene respuesta, aparecerá el mensaje de esta columna para pedir una respuesta.
readonly	Seleccione yes para definir los valores de este campo a solo lectura. Estos valores no se pueden editar en la encuesta.
predeterminado	Establezca el valor predeterminado para este campo. Con ello se rellenará previamente la encuesta con el valor predeterminado. Puede utilizarlo para ahorrar tiempo, bien proporcionando una respuesta utilizada habitualmente o mostrando el tipo de respuesta esperado.
cálculo	Realice cálculos con los valores de preguntas anteriores (por ejemplo, ${number} * 100). Haga referencia al campo calculate para mostrar el resultado (por ejemplo, The answer is ${calc}).
restricción	Limite el rango de números que pueden introducirse (por ejemplo, .>0 y .<100). Se puede usar con todos los tipos de preguntas.
constraint_message	Si no se cumplen las condiciones de restricción, aparecerá este mensaje para pedir una respuesta válida.
relevante	Le permite omitir preguntas o hacer que aparezcan preguntas adicionales en función de la respuesta a una pregunta anterior. Una pregunta pasa a estar visible si cumple las condiciones de la columna relevant (por ejemplo, ${name} = 'value'). Una pregunta oculta por esta columna solo envía valores nulos.
choice_filter	Si utiliza selecciones en cascada, este campo alberga la expresión para asignar las columnas de atributos adicionales de la pestaña choices (por ejemplo, attribute = ${value}).
repeat_count	Este valor especifica el número de registros disponibles en una repetición. Una vez especificado el recuento de repeticiones, no puede agregar ni eliminar registros de la repetición.
media::audio	Copie un archivo de audio a la subcarpeta de contenido multimedia de su proyecto y escriba el nombre de su archivo de audio (por ejemplo, audio.mp3) para que su pregunta incluya audio.
media::image	Copie un archivo de imagen a la subcarpeta de contenido multimedia de su proyecto y escriba el nombre de su archivo de imagen (por ejemplo, image.jpg) para que su pregunta incluya una imagen.
bind::type	Un tipo de campo que sobrescribe el tipo de campo predeterminado para la pregunta.
bind::esri:fieldType	Defina el tipo de campo de destino en la capa de entidades. Se puede usar para sobrescribir el tipo de campo predeterminado (por ejemplo, los campos calculate y select_one son cadenas de forma predeterminada. Para guardar los valores en la capa de entidades como enteros, seleccione esriFieldTypeInteger).
bind::esri:fieldLength	Defina la longitud del campo de destino en la capa de entidades. Se puede usar para sobrescribir la longitud de campo predeterminada.
bind::esri:fieldAlias	Proporcione valores para el alias de campo en la capa de entidades. Se puede usar para sobrescribir los valores de alias de campo predeterminados, obtenidos de la etiqueta de la pregunta.
body::esri:style	Proporcione expresiones para definir el estilo y el comportamiento de una pregunta (por ejemplo, el color de fondo de los grupos y repeticiones).
bind::esri:parameters	Proporcione parámetros para una pregunta que sea específica de Survey123 (por ejemplo, parámetros para controlar el comportamiento de las repeticiones al editar la encuesta).
bind::esri:workflow	Proporciona parámetros para permitir que una encuesta esté disponible para un modo de medición de telémetro.
parámetros	Proporcione parámetros estándar de XLSForm para una pregunta (por ejemplo, los parámetros start, end y step de una pregunta de rango).
body::accept	Defina los tipos de archivo aceptados para la pregunta de archivo. Acepta extensiones de archivo, con varias extensiones de archivo separadas por comas (por ejemplo, .jpg, .png).
body::esri:visible	Le permite omitir preguntas o hacer que aparezcan preguntas adicionales en función de la respuesta a una pregunta anterior. Una pregunta pasa a estar visible si cumple las condiciones de la columna body::esri:visible (por ejemplo, ${name} = 'value'). Una pregunta oculta por esta columna todavía contiene y envía valores.
body::esri:inputMask	Proporcione una expresión para usar una máscara de entrada y así ofrecer un formato definido para la entrada de datos mediante el uso de caracteres y símbolos.
label::language (xx)	Proporcione traducciones para las etiquetas de sus preguntas. El idioma se debe especificar por su nombre y código (por ejemplo, label::Español (es)). Agregue una nueva columna para cada idioma. La lista de idiomas aparecerá en un menú desplegable de la encuesta.
hint::language (xx)	Proporcione traducciones para las sugerencias de sus preguntas. El idioma se debe especificar por su nombre y código (por ejemplo, hint::Español (es)). Agregue una nueva columna para cada idioma. La lista de idiomas aparecerá en un menú desplegable de la encuesta.
guidance_hint::language (xx)	Proporcione traducciones para sus sugerencias de orientación. Debe especificar el idioma por su nombre y código (por ejemplo, guidance_hint::Español (es)). Agregue una nueva columna para cada idioma. La lista de idiomas aparecerá en un menú desplegable de la encuesta.
required_message::language (xx)	Proporcione traducciones para el mensaje que aparece si no se responde a una pregunta obligatoria. El idioma se debe especificar por su nombre y código (por ejemplo, required_message::Español (es)). Agregue una nueva columna para cada idioma. La lista de idiomas aparecerá en un menú desplegable de la encuesta.
body::accuracyThreshold	Proporcione un valor numérico para el umbral (en metros), pasado el cual no se aceptarán valores de posición. Se aplica al geopunto y los vértices de las preguntas de geoshape y geotrace.
bind::esri:warning	Aplique una expresión que muestre advertencias si no se cumplen las condiciones.
bind::esri:warning_message	El mensaje que aparece si no se cumplen las condiciones de bind::esri:warning.
bind::saveIncomplete	Establézcalo en true si la aplicación debe guardar automáticamente la respuesta tras la pregunta.

Apariencias

Puede introducir los siguientes valores en la columna de apariencia para algunos tipos de preguntas con el fin de alterar su apariencia o su comportamiento. Para obtener más información sobre cada opción, consulte Apariencia.

Apariencia	Tipo de pregunta relacionado	Descripción	Se admite en la aplicación de campo Survey123	Se admite en la aplicación web Survey123
anotar	imagen	Permite al usuario abrir una ventana de lienzo en el que puede dibujar y que también admite la anotación en las imágenes.	Sí	Sí
autocomplete	select_one	Las opciones de respuesta aparecen en un menú desplegable con entrada de texto para reducir las opciones.	Sí	Sí
calculadora	entero, decimal	Muestra un widget de calculadora personalizado para esta pregunta.	Sí	No
compacto	select_one, select_multiple, begin group, begin repeat	Para las preguntas select_one y select_multiple, presenta opciones horizontalmente de manera eficiente en el espacio. Para los grupos y las repeticiones, presenta las preguntas con un estado contraído al principio y luego el usuario puede expandirlas.	Sí	Sí
compact-n	select_one, select_multiple	Presenta las opciones horizontalmente de manera eficiente en el espacio, con una cantidad máxima de columnas especificada por n. Por ejemplo, compact-3 limita la pregunta a un máximo de tres columnas.	Sí	Sí
distress	entero	Muestra la pregunta como una escala deslizante con colores.	Sí	No
dibujar	imagen	Permite al usuario abrir una ventana de lienzo en el que puede dibujar.	Sí	Sí
field-list	grupo de inicio, repetición de inicio	Muestra el grupo de preguntas en una página separada si el estilo de la encuesta se define como páginas.	Sí	Sí
geocodificación	texto	Busque y envíe una dirección geocodificada.	Sí	Sí
getinframarkerid	texto	Recupere y almacene un Id. de etiqueta de InfraMarker de 24 caracteres.	Sí	No
oculto	Todo	Oculta la pregunta de la vista mientras que sigue aceptando valores predeterminados y cálculos.	Sí	Sí
hide-input	geopunto	Contrae la sección de introducción de coordenadas si la encuesta se abre en la aplicación web.	No	Sí
horizontal	select_one, select_multiple	Muestra opciones de respuesta en dirección horizontal y en columnas.	Sí	Sí
horizontal-compact	select_one, select_multiple	Igual que la apariencia compact.	Sí	Sí
image-map	select_one, select_multiple	Muestra una imagen .svg adjunta con regiones seleccionables.	Sí	No
inframarker	texto	Proporcione la información que se va a escribir en una etiqueta de InfraMaker.	Sí	No
likert	select_one	Hace que las opciones de respuesta aparezcan como una escala de Likert.	Sí	Sí
minimal	select_one, select_multiple, barcode, begin repeat	Presenta respuestas múltiples (select_one, select_multiple), preguntas múltiples (repeticiones) y un cuadro de texto (código de barras) con un estilo oculto o minimizado.	Sí	Sí
compacto mínimo	begin repeat	Presenta preguntas dentro de una repetición tanto de forma contraída (compact) como oculta (minimal).	Sí	Sí
month-year	fecha	Selecciona únicamente un mes y un año para la fecha.	Sí	Sí
multilínea	texto, imagen, archivo	Presenta una pregunta de texto como un cuadro de texto multilínea. Permite varios adjuntos para una pregunta de imagen o archivo.	Sí	Sí
new-front	imagen	Limita la pregunta a tomar solo una foto de forma predeterminada con la cámara frontal.	Sí	No
new-rear	imagen	Limita la pregunta a tomar solo una foto, utilizando de forma predeterminada a cámara posterior.	Sí	No
no-ticks	rango	Muestra el control deslizante de rango sin posiciones, valores mínimos o valores máximos.	Sí	Sí
nopredictivetext	texto	Deshabilita el texto predictivo para dispositivos móviles.	Sí	No
números	entero, decimal	Muestra un widget de teclado numérico para esta pregunta.	Sí	No
predictivetext	texto	Habilita el texto predictivo para los dispositivos móviles.	Sí	No
pulsar para ubicar	geopunto, geotrace, geoshape	En las preguntas geopunto, solo acepta una ubicación después de que el usuario interactúe con la pregunta. En el caso de geotrace y geoshape, centra la ubicación del usuario sin capturar un punto al interactuar por primera vez con la pregunta.	Solo para geopunto	Sí
telémetro	texto	Acepta el objeto JSON completo o un valor específico devuelto desde un telémetro.	Sí	No
buscar	texto	Rellene la lista de opciones con valores desde una tabla CSV en la carpeta media de la encuesta o una capa de entidades o tabla existente.	Sí	No
firma	imagen	Presenta una interfaz de usuario para capturar una firma. La firma se agrega a la entidad como adjunto.	Sí	Sí
pico	imagen	Requiere un dispositivo Spike y la aplicación de Spike. Utiliza la integración de Spike para medir la distancia y la ubicación de una foto.	Sí	No
spike-full-measure	imagen	Requiere un dispositivo Spike y la aplicación de Spike. Utiliza la integración de Spike para medir la distancia, la ubicación, el área y las longitudes de una foto.	Sí	No
spike-point-to-point	imagen	Requiere un dispositivo Spike y la aplicación de Spike. Utiliza la integración de Spike para medir la distancia entre dos puntos fotografiados.	Sí	No
spinner	entero, decimal	Agrega botones para aumentar y reducir el valor.	Sí	No
table-list	grupo de inicio	Presenta un conjunto de preguntas select_one dentro de un grupo con una lista de opciones común en un formato de tabla.	Sí	Sí
thousands-sep	decimal	Muestra respuestas con separadores de miles. Solo se aplica a las respuestas rellenadas previamente.	Sí	No
week-number	fecha	Selecciona un número de semana.	Sí	No
año	fecha	Selecciona únicamente un año para la fecha.	Sí	Sí

Parámetros

Ciertos tipos de preguntas de XLSForm presentan parámetros adicionales que le permiten controlar el estilo o el comportamiento de las preguntas de una encuesta. En algunos casos, estos parámetros complementan las apariencias que admite un tipo de pregunta. Para ver un resumen de los parámetros admitidos en cada tipo de pregunta, consulte Parámetros de XLSForm.

Valores predeterminados

Al introducir today() en la columna default de una pregunta con fecha, el valor cambia de forma predeterminada a la fecha actual.

Introduzca el nombre que elija (en lugar de la etiqueta de su elección) para los valores predeterminados de las preguntas select_one.

Las respuestas del tipo de pregunta select_multiple funcionan de un modo distinto a otras, ya que cada respuesta activada se introduce en el orden en el que se seleccionó, separada de las demás por comas. Para definir varios valores como predeterminados en una pregunta select_multiple, sepárelos con comas, por ejemplo, item1,item2,item3.

Validación de datos

Introducir yes como valor en la columna required , la pregunta de la encuesta requiere la introducción de un valor para poder completar el formulario.

Operadores

Los operadores que se enumeran en la siguiente tabla se pueden usar en las columnas XLSForm compatibles con expresiones, incluidas las columnas constraint, calculation y relevant.

Para obtener más información sobre los cálculos y las restricciones, consulte Fórmulas; para obtener más información sobre el uso de la columna relevant, consulte Formar expresiones.

Operador	Descripción	Ejemplo
.	La respuesta actual	.=1
+	Adición	${question_one} + 4
-	Resta	${question_one} - 4
*	Multiplicación	${question_one} * 4
div	División	${question_one} div 4
=	Igual	${price}=9.80
!=	No es igual	${price}!=9.80
<	Menor que	${price}<9.80
<=	Menor o igual que	${price}<=9.80
>	Mayor que	${price}>9.80
>=	Mayor o igual que	${price}>=9.80
and	Y	${price}>9.00 and ${price}<9.90
mod	Módulo (resto de la división)	${question_one} mod ${question_two}
or	O	${price}=9.80 or ${price}=9.70

Funciones

Survey123 admite las siguientes funciones:

Función	Descripción	Ejemplo
boolean(question, expression, or value)	Devuelve el valor True si el valor proporcionado no es nulo. Se recomienda utilizar en su lugar boolean-from-string(). Precaución: Esta función siempre devuelve un valor true en la aplicación web Survey123. Para conocer las alternativas, consulte Valores vacíos.	boolean(${question_one})
boolean-from-string()	Devuelve el valor True si la cadena de caracteres proporcionada es "true" o "1". De lo contrario, devuelve False.	boolean-from-string(${question_one})
coalesce(value1, value2)	Devuelve el primer valor no vacío. Esta función solo admite dos valores.	coalesce(${question_one}, ${question_two})
concat(value1, value2, …)	Devuelve la concatenación de los valores de la cadena de caracteres.	concat(${question_one}, ' and ', ${question_two})
contains(string, substring)	Devuelve el valor True si la cadena de caracteres indicada contiene la subcadena.	contains(${question_one}, 'red')
count(repeat)	Devuelve la cantidad de respuestas a una pregunta dada en repeticiones. Para obtener más información, consulte Funciones de consolidación. Nota: Cuando se utiliza en la aplicación de campo Survey123, esta función se puede colocar dentro o fuera de la repetición. Si la función se va a utilizar en la aplicación web Survey123, debe colocarse fuera de la repetición. En un cálculo dentro de la repetición se puede hacer referencia a un valor de recuento de fuera de la repetición.	count(${question})
count-selected(question)	Devuelve el número de respuestas seleccionadas para las preguntas select_one y select_multiple. Esta función también devuelve el número de archivos adjuntos para las preguntas de imagen, audio y archivo utilizando la apariencia multiline.	count-selected(${question_one})
date(question, expression, or value)	Convierte un número o cadena de caracteres en un objeto de fecha, sin mantener la hora.	date('2017-05-28T04:39:02+10:00')
date-time(question, expression, or string)	Convierte un número o cadena de caracteres en un objeto de fecha.	date-time('2017-05-28T04:39:02+10:00')
decimal-date-time(question, expression, or string)	Convierte un objeto de fecha en un número de fecha-hora decimal.	decimal-date-time(${date_question})
decimal-time(question, expression, or string)	Convierte un objeto de hora en un número que representa una fracción de un día en la zona horaria del dispositivo.	decimal-time(${time_question})
ends-with(string, substring)	Devuelve el valor True si la cadena de caracteres indicada termina por la subcadena.	ends-with(${question_one}, 'hand.')
false()	False	false()
format-date()	Ajusta un valor de fecha u hora existente a un formato definido.	format-date(${previous_time}, '%H:%M')
if(condition, a, b)	Si la condición se evalúa como true, devuelve a; de lo contrario, devuelve b.	if(selected(${question_one}, 'yes') and selected(${question_two}, 'yes'), 'yes', 'no')
indexed-repeat(question, repeat, index number)	Devuelve el valor de una pregunta concreta de un registro de repetición. Para obtener más información, consulte Repeticiones.	indexed-repeat(${room_no}, ${floor}, 3)
int(question, expression, or value)	Convierte a entero. La conversión varía según el tipo de datos. Nota: Si esta función está vacía, devolverá NaN y la pregunta permanecerá vacía.	int(${question_one})
join(separator, question)	Concatena todas las respuestas de una pregunta determinada en una repetición, separadas por el separador indicado.	join(',', ${question_in_repeat})
jr:choice-name(choice_name, 'question')	Se utiliza en las preguntas select_one. Devuelve la etiqueta asociada al nombre de la opción de la pregunta indicada. Recuerde que la pregunta debe estar definida dentro de comillas.	jr:choice-name(${select_one}, '${select_one}')
	Se utiliza en las preguntas select_multiple. Devuelve la etiqueta asociada al nombre de la opción de la pregunta indicada. La función selected-at() se debe utilizar para extraer la etiqueta de las respuestas individuales. Recuerde que la pregunta debe estar definida dentro de comillas.	jr:choice-name(selected-at(${select_multiple}, 3), '${select_multiple}')
max(value1, value2, ...)	Devuelve el valor máximo de un rango dado o para una pregunta simple en repeticiones.	max(${question_one}, ${question_two})
min(value1, value2, ...)	Devuelve el valor mínimo de un rango dado o para una pregunta simple en repeticiones.	min(${question_one}, ${question_two})
not(expression)	Devuelve un valor false si la expresión devuelve true, y un valor true si la expresión devuelve false.	not(selected(., 'yes'))
now()	Devuelve una marca de hora para este instante. Esta función se utiliza en preguntas de hora y dateTime. Funciona igual que today() en las preguntas de fecha.	now()
number(question, expression, or value)	Convierte a número. La conversión varía según el tipo de datos. Nota: Si esta función está vacía, devolverá NaN y la pregunta permanecerá vacía.	number(${question_one})
once()	Si una pregunta ya tiene un valor, devuelve el valor existente. Esta función resulta útil cuando se utiliza random() o uuid() en una pregunta repetida para asegurarse de que el valor no va a cambiar cuando navegue por los registros repetidos del formulario.	once(uuid())
position(..)	Devuelve el índice del registro actual en una repetición. Para obtener más información, consulte Repeticiones.	position(..)
pulldata()	Devuelve un valor de un archivo CSV externo. Para obtener más información, consulte Recuperar un valor a partir de un CSV.	pulldata('users', 'email', 'name', ${respondent_name})
pulldata("@exif")	Devuelve un valor de los metadatos EXIF de una imagen. Para obtener más información, consulte Extraer metadatos de la imagen.	pulldata("@exif", ${photo}, "GpsLatitude")
pulldata("@geopoint")	Devuelve un valor de una pregunta de geopunto. Para obtener más información, consulte Extraer valores de geopuntos.	pulldata("@geopoint", ${location}, "horizontalAccuracy")
pulldata("@javascript")	Ejecuta una función de JavaScript en el formulario y devuelve el resultado. Para obtener más información, consulte Funciones JavaScript en formularios de encuesta.	pulldata("@javascript", "functions.js", "uniqueID", ${buildings})
pulldata("@json")	Devuelve un valor de un objeto JSON. Para obtener más información, consulte Recuperar un valor a partir de un JSON.	pulldata("@json", ${json_output}, "attributes.ZIP_CODE")
pulldata("@layer")	Consulta una capa de entidades, tabla de entidades o un servicio de mapas habilitado para consulta de ArcGIS y devuelve el resultado. Para obtener más información, consulte Consultar una capa de entidades.	pulldata("@layer", "getRecordAt", "https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/World_Time_Zones/FeatureServer/0", ${location})
pulldata("@property")	Devuelve información sobre el dispositivo o el usuario que ha iniciado sesión. Para obtener más información, consulte Propiedades del dispositivo y del usuario.	pulldata("@property", 'username')
random()	Devuelve un valor aleatorio entre 0 (incluido) y 1 (excluido).	random()
regex()	Aplica una expresión regular a la entrada de la pregunta. Devuelve el valor True si el patrón coincide. Para obtener más información, consulte Expresiones regulares.	regex(., '^\d{5}$')
selected(question, value)	Comprueba si se ha seleccionado una respuesta. Esta función se utiliza en las preguntas select_one y select_multiple.	selected(${question_one}, 'a')
selected-at(question, number)	Se utiliza en las preguntas select_multiple. Devuelve el nombre de la opción seleccionada para el número indicado, empezando a contar desde cero; por ejemplo, "2" devolverá la tercera opción seleccionada.	selected-at(${question_one}, 2)
starts-with(string, substring)	Devuelve el valor True si la cadena de caracteres indicada comienza por la subcadena.	starts-with(${question_one}, 'The')
string(question, expression, or value)	Convierte a cadena de caracteres. La conversión varía según el tipo de datos.	string(${question_one})
string-length(question, expression, or value)	Devuelve la longitud de una cadena no vacía.	string-length(${question_one})
substr(question, start, end)	Devuelve la subcadena empezando en el inicio especificado y se extiende al carácter que se encuentra en índice final -1, donde el inicio y el final empiezan en 0.	substr(${question_one}, 1, 2)
sum(repeat)	Devuelve la suma de todas las respuestas a una pregunta dada en repeticiones. Para obtener más información, consulte Funciones de consolidación. Nota: Cuando se utiliza en la aplicación de campo Survey123, esta función se puede colocar dentro o fuera de la repetición. Si la función se va a utilizar en la aplicación web Survey123, debe colocarse fuera de la repetición. En un cálculo dentro de la repetición se puede hacer referencia a un valor de suma de fuera de la repetición.	sum(${question})
today()	Devuelve la fecha de hoy, almacenada internamente como la hora del medio día local. Esta función se utiliza en preguntas de fecha.	today()
true()	True	true()
uuid()	Devuelve una cadena de caracteres de UUID aleatoria.	uuid()
version()	Devuelve la versión de la encuesta definida en la hoja de cálculo de configuración.	version()

Survey123 admite las siguientes funciones matemáticas:

Función	Descripción	Ejemplo
acos(value)	Devuelve el arcocoseno del valor.	acos(${question_one})
asin(value)	Devuelve el arcoseno del valor.	asin(${question_one})
atan(value)	Devuelve el arcotangente del valor.	atan(${question_one})
atan2(value1, value2)	Devuelve el arcotangente del cociente de los valores.	atan2(${question_one}, ${question_two})
cos(value)	Devuelve el coseno del valor como un ángulo en radianes.	cos(${question_one})
sin(value)	Devuelve el seno del valor como un ángulo en radianes.	sin(${question_one})
tan(value)	Devuelve la tangente del valor como un ángulo en radianes.	tan(${question_one})
exp(value)	Devuelve el exponente natural del valor.	exp(${question_one})
exp10(value)	Devuelve 10 a la potencia del valor.	exp10(${question_one})
log(value)	Devuelve el logaritmo natural del valor.	log(${question_one})
log10(value)	Devuelve el logaritmo en base 10 del valor.	log10(${question_one})
pi()	Devuelve pi.	pi()
pow(value, power)	Devuelve el valor a la potencia especificada.	pow(${question_one}, 3)
round(value, power)	Devuelve el valor redondeado.	round(${question_one}, 5)
sqrt(value)	Devuelve la raíz cuadrada del valor.	sqrt(${question_one})

Formato HTML

Puede usar el formato HTML en etiquetas de preguntas y sugerencias, así como en las etiquetas de las listas de opciones. El formato HTML permitido es el siguiente:

Etiqueta	Atributo
a	href, style
abbr	title
audio¹	autoplay, controls, loop, muted, preload
b, strong, i, em, u, ul, ol, li, tbody, br, hr
dd, dl, dt	style
div¹	style, align
figcaption	style
figure	style
font	size, color, style
h1, h2, h3, h4, h5, h6	style
img	src, width, height, border, alt, style
p	style
source¹	media, src, type
span	style
sub	style
sup	style
table	width, height, cellpadding, cellspacing, border, style
td, th	height, width, valign, align, colspan, rowspan, nowrap, style
tr	height, valign, align, style
video¹	autoplay, controls, height, loop, muted, poster, preload, width

*Solo se admite en la aplicación web Survey123.

Sugerencia:

De forma predeterminada, un hipervínculo creado con el formato HTML abierto en la aplicación web Survey123 abrirá el destino de la misma pestaña que la encuesta. Para abrir este vínculo en una pestaña nueva en su lugar, agregue target="_blank" a la etiqueta a href, por ejemplo:

<a href="https://www.esri.com" target="_blank">Link to Esri website</a>

Expresiones regulares

Las expresiones regulares son secuencias de caracteres que definen un patrón de búsqueda. Se pueden usar en una pregunta para determinar su valor en función de otras preguntas o para restringir la entrada de datos. Se puede generar una expresión regular a partir de las subexpresiones enumeradas en la siguiente tabla. Para obtener más información, consulte Fórmulas.

Subexpresión	Concordancia
^	Coincide con el inicio de la línea.
$	Coincide con el final de la línea.
.	Coincide con cualquier carácter excepto el de nueva línea.
[...]	Coincide con cualquier carácter entre corchetes.
[^...]	Coincide con cualquier carácter que no esté entre corchetes.
(re)	Agrupa las expresiones regulares y recuerda el texto coincidente.
(?: re)	Agrupa las expresiones regulares sin recordar el texto coincidente.
a| b	Coincide con a o con b.
\A	Inicio de la cadena de caracteres completa.
\b	Coincide con los límites de la palabra si está fuera de los corchetes y coincide con el retroceso (0x08) si está dentro de los corchetes.
\B	Coincide con los límites que no pertenecen a palabras.
\d	Coincide con dígitos. Es equivalente a [0 a 9].
\D	Coincide con caracteres que no son dígitos.
\E	Fin de las comillas abiertas con \Q.
\G	Coincide con el punto en el que terminaba la coincidencia anterior.
\n, \t, \e, etc.	Coincide con la nueva línea, pestaña, escape, etc.
\N	Referencia para capturar el número de grupo N.
\Q	Escape (comilla) de todos los caracteres hasta \E.
re*	Coincide con 0 o más instancias de la expresión precedente.
re+	Coincide con 1 o más instancias de la expresión precedente.
re?	Coincide con 0 o 1 instancias de la expresión precedente.
re{ n}	Coincide con el número exacto de instancias de la expresión anterior definida en lugar de n.
re{ n,}	Coincide con n o más instancias de la expresión precedente.
re{ n, m}	Coincide con al menos el número de instancias definido por n y, como máximo, con el definido por m en la expresión precedente.
\s	Coincide con un carácter de espacio en blanco, tabulación, salto de línea, salto de formulario, retorno de carro o espacio.
\S	Coincide con un espacio que no está en blanco.
\w	Coincide con caracteres de palabras.
\W	Coincide con caracteres que no pertenecen a palabras.
\z	Final de la cadena de caracteres completa.
\Z	Final de la cadena de caracteres completa, excepto el terminador de línea final permitido.

Por ejemplo, la expresión regular regex(.,'^[A-Za-z]*$') requiere que el usuario introduzca únicamente letras, sin números ni caracteres especiales, en una pregunta de cadena de caracteres.

Tipos de campo de Esri

La columna bind::esri:fieldType se puede usar para sobrescribir el tipo de campo predeterminado con uno de los valores indicados a continuación. Para obtener más información, consulte Columnas personalizadas de Esri.

Valor de campo	Resultado
esriFieldTypeDate	Valores de fecha y hora
esriFieldTypeDateOnly	Valores de fecha solamente, sin valores de tiempo
esriFieldTypeTimeOnly	Valores de hora solamente, sin valores de fecha
esriFieldTypeTimestampOffset	Fecha, hora y desfase con respecto al valor UTC
esriFieldTypeDouble	Números con punto flotante de doble precisión
esriFieldTypeGUID	Identificador único global
esriFieldTypeInteger	Número entero (32 bits)
esriFieldTypeBigInteger	Números enteros a partir de (64 bits)
esriFieldTypePointZ	Permite capturar la altitud en geopuntos
esriFieldTypeString	Una serie de símbolos alfanuméricos
nulo	Campo nulo; no almacena valores

Caracteres especiales

Los nombres de las preguntas y de las opciones no pueden incluir caracteres especiales, como espacios, comas, guiones, paréntesis, llaves o caracteres como $, % y #. Es importante que los nombres de opciones de las preguntas con select_multiple no contengan espacios ni comas.