Puede crear vínculos para abrir Survey123 Mobile desde otra aplicación, un elemento emergente de mapa web o un hipervínculo de un correo electrónico o sitio web. Utilice un esquema URL personalizado para iniciar la aplicación desde un navegador web o un vínculo de la aplicación Survey123 para iniciarla desde una aplicación de Android o iOS. Utilice los parámetros de la URL para personalizar la forma en que se abre Survey123 Mobile, como para cargar una encuesta concreta, establecer las coordenadas de la ubicación de mapa predeterminada y rellenar las respuestas a las preguntas con valores predeterminados o pasando atributos de datos de un elemento emergente de mapa web.
Vincular desde un navegador web en Windows
Puede crear un vínculo para abrir Survey123 Mobile e integrarla en otra aplicación. El mismo vínculo se puede introducir también en un navegador web para realizar pruebas.
Nota:
Una vez creado el vínculo, puede reemplazar arcgis-survey123-mobile:// por https://survey123-mobile.arcgis.app como vínculo de Survey123 para utilizarlo en iOS o Android.
Para crear un esquema de URL personalizado y utilizarlo en un navegador web de escritorio, lleve a cabo los pasos siguientes:
- Escriba arcgis-survey123-mobile:// en el navegador.
Survey123 Mobile se abre (o se le pide que la abra).
Nota:
Para iniciar y descargar una encuesta de un portal específico, incluya el parámetro de URL del portal, por ejemplo, arcgis-survey123-mobile://?portalUrl=host.domain.com/webadaptor (donde host, domain y webadaptor se reemplazan por su información del portal).
- Agregue una referencia única a una encuesta y agréguela a la URL como sigue:
- Identifique el Id. de elemento de la encuesta que desea abrir.
Nota:
Es la cadena de caracteres que ArcGIS Online utiliza para identificar exclusivamente la encuesta y se puede encontrar en la URL del elemento de formulario en ArcGIS Online. Por ejemplo, si la dirección URL de la encuesta es https://exampleurl.maps.arcgis.com/home/item.html?id=36ff9e8c13e042a58cfce4ad87f55d19, el Id. de elemento del formulario es 36ff9e8c13e042a58cfce4ad87f55d19.
- Incluya la encuesta en la dirección URL agregando ?itemId= y el Id. de elemento del formulario al final de la URL.
La dirección URL debería tener un aspecto similar al siguiente:arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19Si prueba la dirección URL, debería abrir Survey123 Mobile y abrir inmediatamente la encuesta.
Nota:
Si todavía no está en su dispositivo, la encuesta se descarga en él.
- Identifique el Id. de elemento de la encuesta que desea abrir.
- Incluya respuestas a preguntas predeterminadas agregando una referencia en la URL a un campo mediante el uso del nombre que se le ha asignado en XLSForm (no su etiqueta).
Por ejemplo, para rellenar el campo Surname, escriba &field:surname= y el valor.
& actúa como separador de parámetro y field: hace referencia al nombre de la pregunta que se va a rellenar.
La dirección URL debería tener un aspecto similar al siguiente:arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=KlauserYa puede utilizar la URL para abrir Survey123 Mobile y la encuesta, así como rellenar la pregunta indicada con la respuesta que defina. Puede rellenar varias preguntas en la dirección URL de una encuesta. En los nombres de campo se distingue entre mayúsculas y minúsculas.
- Defina una ubicación para una pregunta de geopoint en la encuesta agregando coordenadas a la URL, como sigue:
- Escriba ¢er= e introduzca las coordenadas.
- Escriba las coordenadas de latitud y longitud en grados decimales, separadas por una única coma.
- Si lo desea, agregue la altitud en metros decimales como tercer valor, también separado por una sola coma.
La dirección URL final tendrá un aspecto similar al siguiente:
arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser¢er=37.8199,-122.4783,20Esta dirección URL abrirá ahora Survey123 Mobile y la encuesta elegida, rellenará una pregunta de texto y proporcionará una nueva ubicación predeterminada para la pregunta de geopoint.
Los atributos de campo también se pueden entregar a Survey123 Mobile desde un elemento emergente de un mapa web de ArcGIS, lo que permite la integración con las demás aplicaciones de Esri que utilicen elementos emergentes en un mapa web. Esta funcionalidad puede usarse para rellenar un campo en Survey123 Mobile con el valor de un atributo de entidad, en lugar de un valor establecido, indicando para ello el nombre del atributo entre llaves.
- Abra el mapa web, selecciones Elementos emergentes para una de las capas, elija Agregar contenido, seleccione Texto, proporcione el texto que se va a mostrar correspondiente al vínculo y haga clic en el botón Vínculo para introducir el valor de URL de vínculo.
Vincular desde otra aplicación en iOS o Android
Puede crear un vínculo para utilizarlo en aplicaciones de ArcGIS para abrir Survey123 Mobile y capturar datos en una encuesta. En los siguientes pasos se describe cómo crear un vínculo de aplicación Survey123 y utilizarlo en un elemento emergente de un mapa web. Este vínculo se introduce en la ventana emergente de un mapa web de su organización de ArcGIS. Puede probar este vínculo con un navegador web (usando pasos similares a los de la sección anterior) en un dispositivo iOS o Android.
- Abra el mapa web que se verá en el dispositivo y seleccione Elementos emergentes para una de las capas.
- Elija Agregar contenido y seleccione Texto.
- Escriba Iniciar Survey123, resalte este texto, haga clic en el botón Vínculo para introducir la URL del vínculo, escriba https://survey123-mobile.arcgis.app, haga clic en Aceptar y realice lo siguiente.
- Abra el mapa web en un dispositivo móvil desde un navegador o una aplicación de ArcGIS.
- Seleccione una entidad y haga clic en el vínculo Iniciar Survey123 de la ventana emergente para abrir Survey123.
- Para incluir la encuesta en la URL, agregue ?itemId= y el Id. de elemento del formulario al final de la URL. La dirección URL debería tener un aspecto similar al siguiente:
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19Si prueba la dirección URL, ahora debería abrir Survey123 Mobile y abrir inmediatamente la encuesta.
Nota:
Si todavía no está en su dispositivo, la encuesta se descarga en él.
- Incluya respuestas a preguntas predeterminadas agregando una referencia en la URL a un campo mediante el uso del nombre que se le ha asignado en XLSForm (no su etiqueta).
Por ejemplo, para rellenar el campo Surname, escriba &field:surname= y el valor.
& actúa como separador de parámetro y field: hace referencia al nombre de la pregunta que se va a rellenar.
La dirección URL debería tener un aspecto similar al siguiente:https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=KlauserYa puede utilizar la URL para abrir Survey123 Mobile y la encuesta, así como rellenar la pregunta indicada con la respuesta que defina. Puede rellenar varias preguntas en la dirección URL de una encuesta. En los nombres de campo se distingue entre mayúsculas y minúsculas.
- Defina una ubicación para una pregunta de geopoint en la encuesta agregando coordenadas a la URL, como sigue:
- Escriba ¢er= e introduzca las coordenadas.
- Escriba las coordenadas de latitud y longitud en grados decimales, separadas por una única coma.
- Si lo desea, agregue la altitud en metros decimales como tercer valor, también separado por una sola coma.
La dirección URL final tendrá un aspecto similar al siguiente:
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser¢er=37.8199,-122.4783,20Esta dirección URL completa ahora abre Survey123 Mobile y la encuesta elegida, rellena una pregunta de texto y proporciona una nueva ubicación predeterminada para la pregunta de geopoint.
Parámetros de la URL para iniciar Survey123 Mobile
Los siguientes parámetros se pueden usar para personalizar cómo se abre Survey123 Mobile:
| Parámetro | Descripción | Tipo |
|---|---|---|
center | Centra el mapa en valores de latitud, longitud y altitud opcional conocidos. Ejemplo: | Cadena de caracteres |
field:fieldname | Rellena las preguntas de la encuesta con valores de campo. Ejemplo: | Cadena de caracteres |
portalUrl | Dirección URL del portal donde está alojado el elemento de la encuesta. Ejemplo: | Cadena de caracteres |
itemID | Formulario que se debe abrir. Ejemplo: | UUID |
download | Descarga automáticamente la encuesta cuando el dispositivo está en línea. El valor predeterminado es true. Ejemplo: | Booleano |
callback | Dirección URL a la que volver cuando se completa una acción de formulario (por ejemplo, enviar, mover a borradores, cancelar o salir). Ejemplo: | URL |
callback:status | Ejemplo: | Cadena de caracteres |