Skip To Content

Conceptos básicos de XLSForm

Existen numerosas opciones para crear hojas de cálculo compatibles con XLSForm. Microsoft Excel es la más común, pero hay otras opciones, como Kingsoft Spreadsheets, Google Sheets u OpenOffice Calc. También hay builders de XForms en línea que exportan hojas de cálculo XLSForm que se pueden usar con Survey123 for ArcGIS.

Para ayudarle a crear sus formularios, Survey123 for ArcGIS incluye una herramienta de escritorio llamada Survey123 Connect, que funciona en combinación con la herramienta de creación de XLSForm empleada para crear archivos XLS. Survey123 Connect le permite obtener una vista previa de los archivos XLSForm durante la creación o la edición, y publica también los formularios en ArcGIS Online y en ArcGIS Enterprise y crea servicios de entidades basados en la especificación del formulario para la captura de datos. Survey123 Connect for ArcGIS está disponible para Windows, OSX y Ubuntu.

Una vez que los formularios se han publicado en ArcGIS, puede usar el sitio web de Survey123 para compartir los formularios con los miembros de sus organizaciones de ArcGIS. También puede analizar los mapas y las tablas para los datos capturados a través de la aplicación de campo Survey123, además de exportar los resultados de la encuesta. Si no está familiarizado con el flujo de trabajo entre Survey123 Connect y el sitio web, consulte estos tutoriales en vídeo.

Para los fines de este tema, supondremos que va a usar Survey123 Connect for ArcGIS y Microsoft Excel para crear los formularios.

Normalmente, cada libro de Excel tiene dos hojas de cálculo: survey y choices. Más adelante se describe también una tercera hoja de cálculo denominada settings. Las hojas de cálculo tienen un conjunto de columnas obligatorias que deben estar presentes para que el formulario funcione. Además, cada hoja de cálculo tiene un conjunto de columnas opcionales que ofrecen un mayor control sobre el comportamiento de cada entrada en el formulario. Todas las entradas deben tener valores en las columnas obligatorias, pero las columnas opcionales se pueden dejar en blanco. Las columnas que se agregan al libro de Excel, ya sean obligatorias u opcionales, pueden aparecer en cualquier orden. Las columnas opcionales se pueden omitir. Se puede dejar en blanco cualquier número de filas. Todo el formato del archivo .xls se pasa por alto, así que puede usar líneas divisorias, sombreados y otros formatos de fuentes para que el formulario resulte más legible.

Hoja de cálculo survey

Esta hoja de cálculo define la estructura general del formulario. Contiene la lista completa de preguntas e información sobre cómo deben aparecer en el formulario. Normalmente, cada fila representa una pregunta; sin embargo, hay otras características que se describen a continuación y que se pueden agregar al formulario para mejorar la experiencia del usuario.

La hoja de cálculo survey tiene tres columnas obligatorias: type, name y label.

  • La columna type especifica el tipo de pregunta de XLSForm que se va a agregar. Hay una lista bien definida de tipos de preguntas posibles para esta columna.
  • La columna name determina el nombre de la columna del servicio de entidades de ArcGIS en la que se almacenará la respuesta a la pregunta. No se admiten espacios ni caracteres especiales en esta columna. No puede haber dos filas con el mismo contenido.
  • La columna label contiene el texto para las preguntas. Este es el texto que verá en el formulario. Se admiten espacios y caracteres especiales en esta columna. Como alternativa, se pueden usar columnas de traducción de etiquetas. Las etiquetas también admiten el uso de variables que se reemplazarán en su encuesta con la respuesta a otra pregunta, así como una cantidad limitada de código HTML; para obtener más información, consulte Notas.

Hoja de cálculo choices

Esta hoja de cálculo se usa para especificar las opciones de respuesta para las preguntas con varias respuestas. Cada fila representa una opción de respuesta. Las opciones de respuesta con el mismo nombre de lista se consideran parte de un conjunto relacionado de opciones y aparecen juntas para una pregunta. Esto también permite reutilizar un conjunto de opciones para varias preguntas (por ejemplo, preguntas sí/no).

La hoja de cálculo choices tiene tres columnas obligatorias: list name, name y label.

  • La columna list name permite agrupar un conjunto de opciones de respuesta relacionadas. Las opciones con el mismo nombre de lista se presentarán como el conjunto de respuestas para una pregunta.
  • La columna name especifica el valor que se conservará en ArcGIS cuando se elija esa opción. Los valores de la columna name no aceptan caracteres especiales.
  • La columna label muestra la opción de respuesta tal y como se desea que aparezca en el formulario. Como alternativa, se pueden usar columnas de traducción de etiquetas.

Al crear formularios en Excel, es importante recordar que la sintaxis utilizada debe ser precisa. Por ejemplo, si escribe Choices o choice en lugar de choices, el formulario no funcionará.

Hoja de cálculo settings

La hoja de cálculo settings es opcional y le permite personalizar más el formulario. La personalización disponible incluye un título que se mostrará mientras se edita el formulario, un nombre de instancia para identificar de forma única cada formulario completado, un identificador de versión único para la encuesta y otras funciones. Para obtener más información, consulte Settings.

Hoja de cálculo types

Esta hoja de cálculo se incluye en las plantillas de Survey123 y funciona como un glosario. Se puede usar como referencia para buscar la definición de las propiedades y los operadores que se pueden utilizar en el formulario. Esta hoja de cálculo también se usa para rellenar las listas desplegables de las propiedades admitidas en las plantillas.

Tipos de preguntas

XLSForm admite diversos tipos de preguntas. La siguiente tabla muestra algunas de las opciones que se pueden introducir en la columna type de la hoja de cálculo survey del formulario XLSForm:

Tipo de preguntaEntrada de respuesta

integer

Entrada de número entero.

decimal

Entrada decimal.

text

Respuesta de texto libre.

select_one [opciones]

Pregunta con varias opciones; solo se puede seleccionar una respuesta. Reemplace [opciones] con el nombre de su lista de opciones.

select_multiple [opciones]

Pregunta con varias opciones; se pueden seleccionar varias respuestas. Reemplace [opciones] con el nombre de su lista de opciones.

note

Muestra una nota en la pantalla; no acepta entradas. También puede visualizar cálculos ocultos.

geopoint

Captura una coordenada GPS dada.

date

Entrada de fecha.

tiempo

Entrada de hora.

dateTime

Acepta una entrada de fecha y hora.

image

Tome una foto.

begin group

Inicie un grupo de preguntas.

end group

Finalice un grupo de preguntas.

begin repeat

Inicie un conjunto de preguntas que se repiten.

end repeat

Finalice un conjunto de preguntas que se repiten.

calculate

Realiza un cálculo con los valores del formulario. Este tipo de pregunta está oculto y no aparece en el formulario.

username

Cuando se inicia sesión en ArcGIS Online o ArcGIS Enterprise, este campo se rellena automáticamente con el nombre de usuario de la cuenta. Este tipo de pregunta está oculto y no aparece en el formulario.

email

Cuando se inicia sesión en ArcGIS Online o ArcGIS Enterprise, este campo se rellena automáticamente con la dirección de correo electrónico de la cuenta. Este tipo de pregunta está oculto y no aparece en el formulario.

hidden

Un campo que no se muestra en el formulario. Use las columnas bind::esri:fieldType y bind::esri:fieldLength para especificar el esquema de datos.

barcode

Escanea un código de barras.

start

Fecha y hora de inicio de la encuesta.

final

Fecha y hora de finalización de la encuesta.

deviceid

El UUID que representa al dispositivo específico con el que se respondió a la encuesta.

audio

Grabación de muestras de audio.

Por ejemplo, para capturar el nombre y las coordenadas GPS de una tienda, debe escribir lo siguiente:

encuesta

type

name

label

text

store_name

¿Cómo se llama esta tienda?

geopoint

store_gps

Capture las coordenadas GPS de esta tienda.

El formulario de muestra Question Types incluye todos los tipos de preguntas admitidos por Survey123 for ArcGIS.

Preguntas con varias opciones

XLSForm admite tanto preguntas select_one (para seleccionar una sola respuesta) como preguntas select_multiple (para seleccionar varias respuestas). Para escribir una pregunta con varias opciones de respuesta, es necesario agregar una hoja de trabajo choices al libro de Excel. El siguiente ejemplo muestra una pregunta select_one:

encuesta

type

name

label

select_one yes_no

likes_pizza

¿Le gusta la pizza?

opciones

list name

name

label

yes_no

yes

yes_no

no

No

La entrada yes_no de la hoja de cálculo survey debe coincidir con la entrada yes_no de la columna list name de la hoja de cálculo choices. Esto garantiza que el formulario muestra la lista correcta de opciones de respuesta para una pregunta concreta.

Cuando se publican las encuestas en ArcGIS con Survey123 Connect, las opciones de las preguntas select_one se convierten en dominios de geodatabase para el servicio de entidades de ArcGIS.

También puede agregar preguntas con varias respuestas que permitan seleccionar varias respuestas, como las siguientes:

encuesta

type

name

label

select_multiple pizza_toppings

favorite_toppings

¿Cuál es su ingrediente favorito para la pizza?

opciones

list name

name

label

pizza_toppings

cheese

Queso

pizza_toppings

pepperoni

Salchichón

pizza_toppings

sausage

Salchicha

Precaución:

Todos los valores capturados en una pregunta select_multiple se guardan como una lista separada por comas, de modo que evite el uso de comas en la columna de nombre de su lista de opciones. También tenga en cuenta que las preguntas select_multiple envían solo el nombre de una opción al servicio de entidades, en lugar del nombre y la etiqueta enviados por las preguntas select_one.

Una respuesta individual para una pregunta select_multiple se puede devolver con la función selected-at. Lo siguiente devolverá el valor de nombre de la primera respuesta obtenida para una pregunta select_multiple:

selected-at(${species}, 0)

Para enviar la etiqueta de una respuesta, puede usar la función jr:choice-name. Para obtener el valor de etiqueta de la segunda respuesta obtenida de la misma pregunta select_multiple, use lo siguiente:

jr:choice-name(selected-at(${species}, 1), '${species}')

Especificar otros

A menudo, para las preguntas con varias opciones, las encuestas incluyen una opción para que los encuestados marquen Otros cuando una opción de respuesta no aparece en la lista. A continuación, se suele pedir al encuestado que especifique la otra opción. En XLSForm, esto es posible incluyendo or_other tras el nombre de lista de la opción de respuesta en la hoja de cálculo survey. La hoja de cálculo choices no se modifica. Vea lo siguiente:

encuesta

type

name

label

select_multiple pizza_toppings or_other

favorite_toppings

¿Cuáles son sus ingredientes favorito para la pizza?

opciones

list name

name

label

pizza_toppings

cheese

Queso

pizza_toppings

pepperoni

Salchichón

pizza_toppings

sausage

Salchicha

Metadatos

XLSForm tiene las siguientes opciones de tipos de datos disponibles para la captura de metadatos:

Tipo de metadatosDescripción

start

Fecha y hora de inicio de la encuesta.

final

Fecha y hora de finalización de la encuesta.

username

Registra el nombre de usuario del usuario que tiene iniciada una sesión actualmente en ArcGIS Online o ArcGIS Enterprise. No acepta entradas.

email

Registra la dirección de correo electrónico del usuario que tiene iniciada una sesión actualmente en ArcGIS Online o ArcGIS Enterprise. No acepta entradas.

Nota:

No hay planes de incorporar la compatibilidad con los siguientes elementos de metadatos de XLSForm: deviceid, subscriberid, simserial y phonenumber.

Para capturar todos estos metadatos, agregue lo siguiente al principio de la encuesta:

encuesta

type

name

label

start

start_time

final

end_time

username

username

username

email

email

email

Survey123 for ArcGIS captura automáticamente las entradas de metadatos descritas anteriormente. No se representarán como preguntas en el formulario, pero verá los valores una vez que se haya enviado la encuesta.

Cuando agregue los tipos start o end, Survey123 for ArcGIS habilitará automáticamente el tiempo en el servicio de entidades para la encuesta. De esta forma, podrá filtrar el contenido de la encuesta en función de la fecha en la que se enviaron los datos. Agregar las entradas start y end también resulta útil si se desea determinar con exactitud el tiempo que ha transcurrido desde que se abrió el formulario hasta que se marcó como completado.

Sugerencias

En ocasiones, se desea agregar una sugerencia breve a una pregunta del cuestionario para aclarar al usuario cómo se debe responder a la pregunta, pero no se quiere que la sugerencia forme parte de la pregunta. Es fácil agregar sugerencias a las preguntas en XLSForm. Solo tiene que agregar una columna hint e incluir el mensaje de sugerencia. Vea el siguiente ejemplo:

encuesta

type

name

label

hint

text

store_name

¿Cómo se llama esta tienda?

Mire el letrero de la tienda, si lo hay.

geopoint

store_gps

Capture las coordenadas GPS de esta tienda.