Iniciar la aplicación web

La aplicación web Survey123 puede aceptar parámetros en el mismo formato que la aplicación de campo. Una diferencia que debe tenerse en cuenta es que el Id. de elemento de la encuesta forma parte de la ruta URL en lugar de ser parte de un parámetro de la URL como usan los demás vínculos para abrir encuestas. Cuando agrega parámetros a esta URL, debe utilizar un signo de interrogación para separar el Id. de elemento de la encuesta de la ruta del primer parámetro y emplear el carácter & para separar parámetros posteriores. La siguiente URL de ejemplo entrega los parámetros de apellidos y coordenadas a una encuesta en la aplicación web Survey123:

https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19?field:surname=Klauser&center=37.8199,-122.4783

La aplicación web Survey123 también admite distintos parámetros que la aplicación de campo Survey123 no admite. Estos parámetros están relacionados con la presentación de la encuesta en un navegador. Consulte los parámetros de la URL y los ejemplos que personalizan la forma en que se abre la aplicación web en la tabla siguiente.

Nota:

Si un valor de parámetro incluye espacios, signos más (+) u otros caracteres especiales, estos caracteres deben estar codificados por porcentaje. Para obtener más información, consulte Codificación URL.

Parámetros de la URL para iniciar la aplicación web

ParámetroDescripciónTipo

isOrgSignIn

Utiliza la página de inicio de sesión específica de la organización. De forma predeterminada, Survey123 utiliza la página de inicio de sesión específica de la organización, pero cuando se comparten encuestas con más de una organización, es posible que se prefiera utilizar la página de inicio de sesión de ArcGIS Online. Establezca este parámetro como false para usar la página de inicio de sesión ArcGIS Online.

Ejemplo:

isOrgSignIn=false

Booleano

center

Centra el mapa en una latitud, longitud y altitud opcional conocidas.

Ejemplo:

center=37.8199,-122.4783,20

Cadena de caracteres

field:fieldname

Rellena las preguntas de la encuesta con valores de campo.

Ejemplo:

 field:surname=Klauser

Cadena de caracteres

portalUrl

Especifica la dirección URL del portal donde está alojado el elemento de la encuesta.

Ejemplo:

portalUrl=https://myorg.arcgis.com

Cadena de caracteres

open

Especifica qué aplicación se utiliza para abrir la encuesta. Los valores válidos son web, que abre la encuesta en la aplicación web (el valor predeterminado), native, que abre la encuesta en la aplicación de campo si la aplicación de campo está instalada y menu, que abre una página web para determinar la aplicación que abrirá la encuesta.

Ejemplo:

open=web

Cadena de caracteres

hide

Oculta los elementos de la encuesta en la aplicación web. Este parámetro puede aceptar varios valores separados por comas. Los valores válidos son navbar (la barra en la parte superior de la encuesta con opciones para iniciar sesión, cerrar sesión y cambiar de idioma), header, description, footer, submit, theme y leaveDialog (el mensaje de advertencia que aparece al cambiar de página o cerrarla). También puede utilizar el parámetro field:fieldName para ocultar una pregunta, grupo, página o repetición en concreto, indicando su nombre en lugar de fieldName. No es posible ocultar de manera individual las preguntas de repeticiones.

Ejemplo:

hide=header,description,footer,theme

Cadena de caracteres

locale

Cambia el idioma de la encuesta. Solo funciona si la encuesta incluye varios idiomas.

Ejemplo:

locale=zh-cn

Cadena de caracteres

mode

Define el modo de la aplicación web. Los valores válidos son: edit, que configura la encuesta para editar una entrada existente en lugar de crear una; view, que abre una entrada existente en modo de solo lectura; y copy, que crea una encuesta que se rellena con el contenido de la entrada especificada. Al utilizar este parámetro, también se debe proporcionar el parámetro globalId.

Ejemplo:

mode=edit&globalId=1d392670-33e2-456d-8435-7fad3abd8bb9

Cadena de caracteres

globalId

Especifica el registro de la encuesta cargado en el formulario. Los valores válidos son los Id. globales de los registros existentes de la encuesta. El nombre de este parámetro distingue entre mayúsculas y minúsculas.

Ejemplo:

globalId=1d392670-33e2-456d-8435-7fad3abd8bb9

Cadena de caracteres

recalculate

Solo se puede utilizar con mode=edit. Esto obliga a recalcular las preguntas especificadas cuando se carga la encuesta, sin utilizar el botón Recalcular.

Ejemplo:

recalculate=field:question1,field:question2

Cadena de caracteres

version

Establece la versión de la aplicación web que se utilizará. El único valor válido es latest, que utiliza la última versión de la aplicación web, incluso si la encuesta tiene la versión bloqueada.

Ejemplo:

version=latest

Cadena de caracteres

token

Envía un token válido para una encuesta. Se puede utilizar para que los encuestados que responden a una encuesta que requiere una cuenta de ArcGIS accedan sin tener que iniciar sesión.

Ejemplo:

token=E60M4Gsc-h4Q8plqQ...

Cadena de caracteres

autoReload

Vuelve a cargar la encuesta después del envío. Especifique el retraso (en segundos) antes de volver a cargar la encuesta. Anteriormente se denominaba autoRefresh. El parámetro autoRefresh se admite para la compatibilidad con versiones anteriores.

Ejemplo:

autoReload=3

Entero

encodeUrlParams

Oculta los parámetros de la dirección URL. En su lugar, la dirección URL resultante incluirá un parámetro code que representa todos los parámetros codificados; los parámetros incluidos fuera de este parámetro code se ignorarán.

Ejemplo:

encodeUrlParams=true

Booleano

width

Define el ancho de la encuesta, en píxeles. También afecta a otros controles de la encuesta, como los cuadros de texto.

Ejemplo:

width=1000

Entero

Nota:

El parámetro field:fieldname admite preguntas geopoint, geotrace y geoshape en la aplicación web. En las preguntas geopoint, especifique la latitud, la longitud y la altitud (opcional) separados por espacios. Para geotrace y geoshape, especifique la latitud y longitud de cada vértice separadas por un espacio, con cada par de coordenadas separadas por un punto y coma. Este ejemplo funcionaría para una pregunta geoshape:

field:geoshape=-37.842156723211474 144.95942945338243;-37.83554486071995 144.9726235713864;-37.85681405373047 144.98240735651922;-37.85954045531896 144.97715349053766