ArcGIS Survey123 se puede integrar con otras aplicaciones utilizando vínculos para abrir la aplicación del componente específico. Por ejemplo, puede crear vínculos de aplicaciones para iniciar y abrir Survey123 Mobile 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.
Sugerencia:
Survey123 Mobile abre los vínculos de tres aplicaciones: Survey123 Mobile, la aplicación de campo Survey123 y QuickCapture. Cuando cualquiera de estos vínculos se inicia desde Survey123 Mobile (mediante Usar un vínculo, Escanear un código QR o desde un vínculo incluido en una encuesta o un proyecto QuickCapture), se abre dentro de Survey123 Mobile. Para obtener más información, consulte Abrir contenido.
Utilice los patrones de URL de la tabla para crear vínculos para acceder desde un navegador web u otra aplicación. Los ejemplos incluidos muestran cómo abrir una encuesta específica mediante estos patrones de URL.
| Qué iniciar | Desde dónde vincular | Patrón de URL que se va a utilizar |
|---|---|---|
| Survey123 Mobile | Android iOS | Vínculo de aplicación de Survey1231: Ejemplo: |
Windows Android iOS2 | Esquema de URL personalizado3: Ejemplo: | |
Aplicación web | Navegador web | Formulario de encuesta por Id.: Ejemplo: |
Aplicación de campo | Android iOS | Vínculo de aplicación de Survey1231: Ejemplo: |
Windows Android iOS2 | Esquema de URL personalizado3: Ejemplo: | |
| Survey123 Studio | Windows | Esquema de URL personalizado3: Ejemplo: |
Survey123 Connect | Windows | Esquema de URL personalizado3: Ejemplo: |
Otra aplicación | Formulario de encuesta | Vínculo desde Survey123: varía por aplicación |
1—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.
2—En los dispositivos iOS, los esquemas de URL personalizados solo están aprobados para un grupo reducido de aplicaciones.
3—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-mobile://?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-mobile://?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 Survey123 Mobile, Funciones de entidades | ArcGIS Arcade | Esri Developer, Iniciar la aplicación web, Iniciar la aplicación de campo, Iniciar Survey123 Connect e Iniciar otra aplicación desde Survey123.
Nota:
Antes de usar un vínculo que contenga parámetros para iniciar una encuesta en Survey123 Mobile o 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 ArcGIS 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-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43La siguiente es la misma URL con parámetros codificados:
https://survey123-mobile.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.