Columnas personalizadas de Esri

Las columnas personalizadas de Esri para XLSForm ofrecen funciones adicionales para usuarios de Survey123.

Tipo de campo

Utilice la columna personalizada de bind::esri:fieldType para controlar el tipo y la longitud del campo que se va a crear en ArcGIS para las preguntas de la encuesta.

Para muchas preguntas, puede determinar el tipo automáticamente en el servicio de conversión de XLSForm. Las preguntas del tipo select_one se convierten de manera predeterminada en un campo de cadena de caracteres en ArcGIS. Si necesita que la lista de opciones almacene valores como enteros, debe definir explícitamente el tipo de campo como un entero.

Para controlar el tipo de campo, proporcione uno de los valores siguientes en la columna bind::esri:fieldType:

  • esriFieldTypeString
  • esriFieldTypeDate
  • esriFieldTypeInteger
  • esriFieldTypeSingle
  • esriFieldTypeDouble
  • esriFieldTypeSmallInteger
  • esriFieldTypePointZ
  • esriFieldTypeGUID

Recuerde que bind::esri:fieldType solo controla el tipo de campo creado en la capa de entidades. Para controlar el tipo de campo de una pregunta durante una encuesta, utilice la columna bind::type. Por ejemplo, al proporcionar el valor int en la columna bind::type para una pregunta calculate, el campo se trata como un entero, en lugar de su tipo de campo predeterminado, que es de cadena de caracteres. Los valores aceptados por la columna bind::type son los siguientes:

  • int
  • decimal
  • cadena de caracteres
  • fecha
  • dateTime
  • hora

La columna bind::esri:fieldType también acepta el valor nulo, lo que hace que la pregunta se omita de la capa de entidades creada. Aunque la pregunta siga presente en su encuesta y se comporte de forma normal, la respuesta no se remite a la capa de entidades ni está presente al revisar las respuestas. Esto resulta ideal para cálculos, restricciones u otras preguntas que necesitan estar presentes para fines de presentación, pero no se necesitan en los resultados.

Los siguientes tipos de preguntas no admiten el tipo de campo nulo:

  • select_one or other
  • select_multiple or other
  • image
  • hidden
Nota:

Las preguntas geopoint, geotrace y geoshape admiten un tipo de campo nulo solo si la encuesta incluye al menos otra pregunta geopoint, geotrace o geoshape que no tenga ningún tipo de campo nulo, o bien si el geopunto, geotrace o geoshape se repiten.

Longitud del campo

Utilice la columna personalizada de bind::esri:fieldLength para controlar la longitud de los campos de cadena de caracteres (de texto) que se van a crear en ArcGIS para las preguntas de la encuesta.

Nota:

No puede controlar las preguntas de enteros y decimales de esta forma. Las bases de datos no especifican una longitud de un campo numérico; el rango de valores válidos se rige por el tipo de campo numérico. Por ejemplo, un campo de tipo entero almacena cualquier valor entero de entre -2.147.483.648 y 2.147.483.647.

Alias de campos

De manera predeterminada, el alias del campo de una encuesta hereda el mismo valor que la etiqueta del campo, al que se hace referencia principalmente cuando se abre la encuesta en ArcGIS. Puede modificarlo proporcionando un valor en la columna bind::esri:fieldAlias, que se convierte en el nuevo alias del campo.

Puesto que las preguntas ocultas y calculadas no aparecen en el formulario, el contenido del campo de etiqueta no se conserva. Significa que cuando visualiza sus registros de encuesta en el sitio web de Survey123 o ArcGIS, ve que el nombre de la pregunta aparece en el encabezado de la columna para estos tipos de preguntas. Para obligar a que el encabezado de la columna de las preguntas hidden o calculate muestren una etiqueta, use la columna bind::esri:fieldAlias de su hoja de cálculo para especificar una etiqueta.

Máscara de entrada

Las máscaras de entrada proporcionan un formato definido para preguntas de texto mediante el uso de caracteres y símbolos. Cuando se aplica una máscara de entrada a una pregunta, todas las respuestas deben seguir el patrón definido por la máscara de entrada.

Para aplicar una máscara de entrada a su pregunta, defina la máscara en la columna body::esri:inputMask.

Sugerencia:

Las máscaras de entrada solo se pueden aplicar al tipo de pregunta text. Para los tipos de preguntas integer o decimal, utilice la columna constraint para limitar las respuestas.

En la aplicación web Survey123, las respuestas de la encuesta no se pueden enviar hasta que se cumplan todas las máscaras de entrada. La aplicación de campo Survey123 advierte a los usuarios cuando no se cumple una máscara de entrada, pero no evita que se envíen las respuestas. Una opción alternativa es usar una restricción en lugar de una máscara de entrada. Para obtener más información, consulte Restricciones.

En la aplicación web y la aplicación de campo, una restricción evitará que se envíen respuestas hasta que se cumplan las condiciones de la restricción. Para aplicar una restricción a una pregunta de texto, escriba una expresión regular en la columna restricción. Por ejemplo, puede usar una restricción regex(., '^[a-zA-z]{5}$') para garantizar que la respuesta contenga exactamente cinco letras. Esta restricción sería similar a una máscara de entrada AAAAA.

La tabla siguiente muestra los caracteres y los símbolos que se pueden usar en una máscara de entrada:

CarácterSignificado

A

Se requiere un carácter alfabético ASCII. Los caracteres pueden ser de A a Z y de a a z.

a

Se permite un carácter alfabético ASCII, pero no es obligatorio.

N

Se requiere un carácter alfanumérico ASCII. Los caracteres pueden ser de A a Z, de a a z y de 0 a 9.

n

Se permite un carácter alfanumérico ASCII, pero no es obligatorio.

X

Se requiere cualquier carácter que no esté en blanco.

x

Se permite cualquier carácter que no esté en blanco, pero no es obligatorio.

9

Se requiere un dígito ASCII. Los dígitos pueden ser de 0 a 9.

0

Se permite un dígito ASCII, pero no es obligatorio. Los dígitos pueden ser de 0 a 9.

D

Se requiere un dígito ASCII. Los dígitos pueden ser de 1 a 9.

d

Se permite un dígito ASCII, pero no es obligatorio. Los dígitos pueden ser de 1 a 9.

#

Se permite un dígito ASCII o un signo más o menos, pero no es obligatorio.

H

Se requiere un carácter hexadecimal. Los caracteres pueden ser de A a F, de a a f y de 0 a 9.

h

Se permite un carácter hexadecimal, pero no es obligatorio.

B

Se requiere un carácter binario. Los caracteres pueden ser de 0 a 1.

b

Se permite un carácter binario, pero no es obligatorio.

>

Todos los caracteres alfabéticos siguientes están en mayúsculas.

<

Todos los caracteres alfabéticos siguientes están en minúsculas.

!

Desactivar la conversión entre mayúsculas y minúsculas.

\

Como escape de los caracteres especiales que se han enumerado con el fin de usarlos como separadores.

La máscara se compone de una cadena de caracteres y separadores, seguidos opcionalmente por un signo de punto y coma para finalizar la máscara de entrada y por un carácter usado para los espacios en blanco. Los caracteres en blanco siempre se eliminan del texto después de la edición. La tabla siguiente muestra máscaras de ejemplo:

Máscara de ejemploDescripción

>A<xxxxxxxxxxxx

Texto que empieza con una letra mayúscula seguida de cualquier número de caracteres en minúsculas.

AAA-AAA-AAA;_

Identificador único que usa guiones como separadores, con un signo de punto y coma al final de la máscara de entrada seguido de un guion bajo para representar cada carácter que se debe completar.

B9.99;-

Representa un valor de pH. El número solo puede empezar con un 0 o un 1 y solo puede incluir dos posiciones decimales. Un signo de punto y coma finaliza la máscara de entrada, seguido de un guion utilizado para representar cada carácter que se debe completar.

999-99-9999

Número de la Seguridad Social en Estados Unidos.

(999) 999-9999

Número de teléfono de Estados Unidos.

900 kg

Peso en kilogramos entre 0 y 999.

99999

Código postal de 5 dígitos de Estados Unidos.

AAA

Código de aeropuerto de IATA.