Puede incluir preguntas de texto, enteros y decimales en las encuestas para que los usuarios introduzcan respuestas de texto y numéricas.
Las preguntas de texto permiten introducir respuestas de texto libre en la encuesta. De forma predeterminada, el formulario muestra un cuadro de texto con una sola línea de entrada. Si el texto sobrepasa el tamaño del cuadro de texto, conserva el mismo tamaño y se desplaza horizontalmente sin saltos de línea. Esto es idóneo para las respuestas cortas. Para obligar a que el texto introducido siga un formato determinado, puede aplicar una máscara de entrada. También puede aplicar una expresión regular para limitar el campo de texto y rechazar automáticamente las respuestas que no tengan un formato específico, como una dirección de correo electrónico o una URL de sitio web.
Los tipos de pregunta de entero y decimal limitan al usuario a la introducción de los valores numéricos correspondientes. En la columna de restricción de estos tipos de pregunta, puede especificar los valores mínimo y máximo para impedir que un usuario envíe la encuesta a menos que la respuesta se encuentre dentro del intervalo indicado.
Puede cambiar el comportamiento de estos tipos de pregunta y la forma en que se presentan mediante la configuración de la apariencia. Para confirmar qué aplicaciones de envío admiten una apariencia determinada, consulte Apariencia.
Apariencia de texto
Nota:
En Survey123 Mobile, solo se admite la apariencia multiline para las preguntas de texto.
Las apariencias predictivetext y nopredictivetext no se admiten en la aplicación web de Survey123.
Si la columna de apariencia se define como multiline, se presenta una pregunta de texto como un cuadro de texto de varias líneas. Este cuadro de texto de mayor tamaño es ideal para respuestas largas. El texto pasa automáticamente a una nueva línea a medida que se escribe y admite retornos de carro.
Nota:
En los formularios utilizados en la aplicación de campo Survey123, puede establecer la altura predeterminada del cuadro de texto multilínea mediante un parámetro defaultHeight en la columna body::esri:style. Por ejemplo, al introducir defaultHeight=5 en la columna body::esri:style, se mostrarán cinco líneas en un cuadro de texto multilínea cuando se abra la encuesta. Si no está definido, el cuadro de texto multilínea muestra tres líneas cuando se abre la encuesta.
En función de si la apariencia se define como predictivetext o nopredictivetext, una pregunta de texto hace que el texto predictivo se habilite o se deshabilite, respectivamente, en los dispositivos móviles. De forma predeterminada, Android tiene desactivado el texto predictivo para las preguntas de texto, lo que puede desactivar la función de voz a texto en algunos teclados. Aplique la apariencia predictivetext a una pregunta de texto para habilitar la conversión de voz en texto en esa pregunta. El texto predictivo está activado de forma predeterminada en iOS.
Si la apariencia se define como geocode, se utiliza una pregunta de texto para buscar y enviar una dirección geocodificada.
También hay apariencias disponibles para obtener el ID de una etiqueta InfraMarker y un valor de un telémetro.
Buscar y enviar una dirección geocodificada
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.
Si la columna de apariencia se define como geocode, se utiliza una pregunta de texto para buscar y enviar una dirección geocodificada. Cuando los usuarios empiecen a escribir una dirección, aparecerán una serie de opciones de autocompletar que sugieren ubicaciones en función de los localizadores disponibles predeterminados para su organización. Si el usuario no ha iniciado sesión, se utilizará ArcGIS World Geocoder. La apariencia geocode requiere una conexión a Internet y no funcionará en un entorno sin conexión.
La dirección final seleccionada se enviará a la capa de entidades como una cadena de caracteres: sin embargo, los datos geocodificados completos se almacenan temporalmente como un objeto JSON antes de enviarlos, lo que permite extraer propiedades individuales en otros campos.
Para extraer propiedades específicas del objeto JSON, utilice la función pulldata("@json") en la columna calculation de otra pregunta.
pulldata("@json", ${address}, "location.x")
pulldata("@json", ${address}, "searchCandidate")
Todo el objeto JSON se puede devolver en un único campo de texto si no se define una propiedad individual.
pulldata("@json", ${address})
Para obtener más información sobre la función pulldata("@json"), consulte Recuperar un valor a partir de un JSON.
Nota:
Geocodificar con ArcGIS World Geocoding Service consumirá créditos. Para obtener más información, consulte Comprender los créditos.Para que un localizador específico devuelva resultados, proporciona el ID de elemento del localizador en la columna bind::esri:parameters, por ejemplo, geocode=36ff9e8c13e042a58cfce4ad87f55d19. El localizador utilizado en una encuesta de ArcGIS Online debe ser un elemento de ArcGIS Online. El localizador utilizado en una encuesta de ArcGIS Enterprise debe ser un elemento del mismo portal que la encuesta.
Las propiedades disponibles difieren en función del localizador utilizado. La excepción es la propiedad searchText, que está disponible independientemente del localizador utilizado y devuelve la cadena de caracteres exacta utilizada para buscar la dirección o la opción seleccionada en una lista de resultados.
Puede controlar aún más la presentación de una pregunta de apariencia geocode definiendo uno de los siguientes parámetros en la columna body::esri:style:
Nota:
Los parámetros indicator, proximity, maxResults y suggestions no son compatibles con la aplicación web Survey123.
- indicator: permite que los resultados geocodificados muestren la dirección y la distancia desde la ubicación actual del dispositivo. Puede establecer este parámetro en distance, direction, ambos valores separados por una coma o none. De forma predeterminada, este parámetro está configurado para mostrar solo la distancia.
- proximity: controla si los resultados geocodificados solo muestran resultados dentro de un determinado radio de la ubicación del dispositivo. Este parámetro acepta un número, seguido de cualquiera de las siguientes unidades estándar: m (metros), km (kilómetros), ft (pies), mi (millas) o yd (yardas). Si no se proporciona ninguna unidad, se utilizarán metros de forma predeterminada. Si se establece en 0, no se tendrá en cuenta la proximidad en los resultados de búsqueda. De forma predeterminada, este parámetro está establecido en on, lo que permite ordenar las sugerencias por proximidad sin filtrar ninguna ubicación debido a la distancia.
- maxResults: controla el número máximo de resultados proporcionados. Por ejemplo, maxResults=10 devolverá un máximo de 10 resultados posibles. De forma predeterminada, este parámetro está configurado para mostrar 6 resultados como máximo.
- suggestions: funciona como una interfaz para la operación suggest en la API REST de ArcGIS. Cuando este parámetro se configura en yes, la lista desplegable de posibles ubicaciones se rellena mediante la operación suggest. Cuando este parámetro se configura en no o si el servicio de geocodificación no admite la operación suggest, la lista de posibles ubicaciones se rellena mediante la operación findAddressCandidates. De forma predeterminada, este parámetro está establecido en yes.
Obtener un ID de etiqueta InfraMarker
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.
Utilice las apariencias que se describen abajo para leer datos de una etiqueta RFID de InfraMarker o escribir datos en ella.
Si la columna de apariencia de una pregunta de texto se define como inframarker, puede definir la información para escribir en una etiqueta. Esta información puede incluir assetOwner, assetName, latitude y longitude, y los valores se pueden derivar de otras preguntas de la encuesta. Por ejemplo, la expresión siguiente de la columna Cálculo escribe las respuestas de las preguntas asset_name, asset_owner, lat y long en la etiqueta:
concat("assetName=", ${asset_name}, "&assetOwner=", ${asset_owner}, "&latitude=", ${lat}, "&longitude=", ${long})
Si la apariencia de otra pregunta de texto en la misma encuesta se define como getinframarkerid, la identificación única de la etiqueta de 24 caracteres InfraMarker se recupera y se almacena en el registro de la encuesta.
Para obtener más información, consulte la documentación de InfraMarker.
Obtener un valor de un telémetro
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.
Si la columna de apariencia se define como telémetro, una pregunta de texto puede aceptar el objeto JSON completo o un valor específico devuelto desde un telémetro. Cuando se usa para aceptar el objeto JSON completo, esta pregunta debe tener bind::esri:fieldLength establecido en 1000 para garantizar que se ajuste el valor completo.
Cuando se establece la apariencia rangefinder de una pregunta de entero o decimal, puede aceptar un valor específico devuelto desde un telémetro. Especifique qué medida almacenar usando uno de los siguientes valores en la columna bind::esri:parameters: height, azimuth, horizontalDistance, slopeDistance o inclination. Por ejemplo, measurement=height almacenará solo el valor de altura devuelto desde el telémetro.
Apariencia integer
Nota:
En Survey123 Mobile, solo se admite la apariencia spinner para las preguntas de entero.
En la aplicación web de Survey123 no se admite ninguna de estas apariencias para preguntas de entero.
Al establecer la columna de apariencia en spinner, la pregunta de entero se muestra con botones para aumentar o disminuir el valor de uno en uno. Al seleccionar el botón, se repite la progresión hasta que se suelte el botón.
Si la apariencia se define como numbers, se muestra una pregunta de entero resaltada acompañada de un teclado numérico personalizado que permite introducir un valor. El teclado también incluye un botón para hacer que el valor sea positivo o negativo.
Si la apariencia se define como calculator, se muestra una pregunta de entero resaltada acompañada de un teclado de calculadora personalizado que permite introducir y modificar un valor.
Si la apariencia se define como distress, se presenta una pregunta de entero como una escala de malestar. Una escala de malestar es una escala de diez puntos que mide sentimientos como el estrés, el dolor y la felicidad.
Apariencia decimal
Nota:
En Survey123 Mobile, solo se admite la apariencia spinner para las preguntas de decimal.
En la aplicación web de Survey123 no se admite ninguna de estas apariencias decimal.
Si la columna de apariencia se define como spinner, se visualiza una pregunta de decimal con botones para aumentar o reducir el último dígito del valor en uno. Al seleccionar un botón, se repite la progresión hasta que se suelte el botón.
Cuando utiliza un valor predeterminado para definir el número de posiciones decimales de una pregunta, y el control lo aplica. Los siguientes ejemplos muestran cómo el spinner trata diversos valores decimales:
- 1,0 se incrementa a 1,1, 1,2, 1,3, 1,4
- 3,07 se incrementa a 3,08, 3,09, 3,10, 3,11
- 2,000000 se incrementa a 2,000001, 2,000002, 2,000003
Si la apariencia se define como numbers, se muestra una pregunta de decimal acompañada de un teclado numérico personalizado que permite introducir un valor. El teclado también incluye un botón para hacer que el valor sea positivo o negativo.
Si la apariencia se define como calculator, se muestra una pregunta de decimal resaltada acompañada de un teclado de calculadora personalizado que permite introducir y modificar un valor.
Si la apariencia se define como thousands-sep, aparecerá la respuesta a una pregunta de decimal con separadores decimales. No afecta al valor enviado como parte de la respuesta a la encuesta, solamente a su visualización en la aplicación. Los separadores se definen según la configuración regional del dispositivo y se aplican únicamente al abrir una encuesta desde las carpetas Borradores, Bandeja de salida, Bandeja de entrada o Enviado, o bien cuando la respuesta se rellena con un valor predeterminado o un cálculo. Los separadores de miles no aparecen al introducir manualmente un valor.
