ArcGIS Survey123 se puede integrar con otras aplicaciones utilizando vínculos para abrir la aplicación web o aplicación de campo Survey123, Survey123 Connect u otra aplicación. Por ejemplo, puede crear vínculos de aplicaciones para iniciar y abrir la aplicación de campo Survey123 desde otra aplicación Esri, un elemento emergente de mapa web o un simple hipervínculo de un correo electrónico o sitio web. Puede utilizar una URL para descargar automáticamente y abrir una encuesta para edición en Survey123 Connect. También puede establecer un vínculo con otras aplicaciones desde Survey123, como ArcGIS QuickCapture y ArcGIS Field Maps.
Utilice los patrones de URL de la tabla para crear vínculos para acceder desde un navegador web u otra aplicación.
| Qué iniciar | Desde dónde vincular | Patrón de URL que se va a utilizar |
|---|---|---|
Aplicación web | Navegador web | Formulario de encuesta por Id.: |
Aplicación de campo | Android y iOS | Vínculo de aplicación Survey123: |
Windows, Android, un grupo selecto de aplicaciones en iOS | Esquema URL personalizado: | |
Survey123 Connect | Windows | Esquema URL personalizado: |
Otra aplicación | Formulario de encuesta | Vínculo desde Survey123: varía por aplicación |
En los ejemplos siguientes se muestra cómo abrir una encuesta concreta utilizando patrones de URL:
- https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19
- https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19
- arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19
- arcgis-survey123connect://?portalUrl=https://www.arcgis.com&itemID=36ff9e8c13e042a58cfce4ad87f55d19
Los vínculos de la aplicación Survey123 cumplen los requisitos establecidos por App Store y Google Play, permiten la vinculación a más aplicaciones y admiten vínculos abreviados que son más sencillos de compartir.
Los vínculos de esquema de URL personalizado no se pueden acortar y puede ser difícil abrirlos en Android. Plantéese presentar vínculos de esquema de URL personalizados en forma de hipervínculos, de forma similar a lo siguiente:
<a href="arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open survey</a>Parámetros de la URL
Puede agregar parámetros de la URL al final de los vínculos para personalizar más la forma en que se abre la aplicación. Por ejemplo, puede establecer la ubicación predeterminada de una pregunta de geopunto o rellenar una pregunta de texto.
Los parámetros de la URL empiezan por el carácter ? y se separan con el carácter &. En el siguiente ejemplo se muestra un esquema de URL personalizado, en el que el primer parámetro (itemID) empieza por el carácter ? y cada uno de los parámetros de campo subsiguientes (color_1 y color_2), con el carácter &.
arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:color_1=red&field:color_2=bluePara obtener más URL de ejemplo y los parámetros de la URL compatible, consulte Iniciar la aplicación web, Iniciar la aplicación de campo, Iniciar Survey123 Connect y Iniciar otra aplicación desde Survey123.
Nota:
Antes de usar un vínculo que contenga parámetros para iniciar una encuesta en la aplicación de campo, es recomendable que la aplicación ya esté instalada en el dispositivo. Para obtener más información, consulte Instalar la aplicación de campo Survey123.
Codificación de la URL
Aunque los parámetros de URL que no están codificados funcionan en algunos entornos, se recomienda codificar los parámetros de URL. La codificación sustituye caracteres no válidos por el signo de porcentaje, %, seguido de su equivalente hexadecimal.
Por ejemplo, a continuación, se muestra un vínculo de Survey123 que utiliza una devolución de llamada para volver a un proyecto específico en QuickCapture con parámetros que no están codificados:
https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43La siguiente es la misma URL con parámetros codificados:
https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https%3A%2F%2Fquickcapture.arcgis.app%3FitemID=867895a71a1840399476fc717e76bb43Un signo igual que especifica un corte entre una clave y su valor no se debe codificar.
Sugerencia:
Una forma de crear parámetros codificados es utilizar ArcGIS Arcade. La función UrlEncode le permite definir un conjunto de pares de valores clave que representan cada parámetro y producen una dirección URL con la codificación adecuada.
Es posible que el autor de una encuesta también desee ocultar los parámetros de la URL para que los datos confidenciales no estén visibles en la URL. En este caso, al crear una URL para utilizarla en la aplicación web, incluya encodeUrlParams=true. Para obtener más información, consulte Parámetros de URL para abrir la aplicación web.