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¢er=37.8199,-122.4783La 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ámetro | Descripción | Tipo |
|---|---|---|
signIn | Para las encuestas públicas, muestra el botón de inicio de sesión o requiere que los usuarios inicien sesión. De forma predeterminada, la aplicación web no proporciona ningún método para que los usuarios inicien sesión en encuestas públicas, pero las encuestas públicas pueden incluir funciones que solo se activan cuando los usuarios inician sesión. Un ejemplo de ello es utilizar un cálculo para extraer la dirección de correo electrónico de un usuario que ha iniciado sesión. Los valores válidos son show, que muestra el botón de inicio de sesión en la barra de navegación en la parte superior de la aplicación web, y require, que requiere que los usuarios inicien sesión redirigiéndolos a la página de inicio de sesión. Ejemplo: | Cadena de caracteres |
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: | Booleano |
center | Centra el mapa en una latitud, longitud y altitud opcional conocidas. Ejemplo: | Cadena de caracteres |
field:fieldname | Rellena las preguntas de la encuesta con valores de campo. Ejemplo: | Cadena de caracteres |
portalUrl | Especifica la dirección URL del portal donde está alojado el elemento de la encuesta. Ejemplo: | 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: | 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: | Cadena de caracteres |
| locale | Cambia el idioma de la encuesta. Solo funciona si la encuesta incluye varios idiomas. Ejemplo: | 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: | 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: | 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: | 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: | 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: | 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: | 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: | Booleano |
width | Define el ancho de la encuesta en píxeles o como una fracción del ancho de la pantalla. Un valor mayor que 1 establece el ancho en píxeles. Si el valor de píxel es menor que el ancho de la pantalla, se utiliza el ancho de la pantalla. Un valor entre 0 y 1 establecerá el ancho del formulario como una fracción del ancho de la pantalla. Esto también afecta a otros controles de la encuesta, como los cuadros de texto, y puede ayudar a mejorar la forma en que la aplicación web muestra una cuadrícula fija o dinámica. Ejemplos: | Cadena de caracteres |
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