ArcGIS QuickCapture se puede integrar con otras aplicaciones por medio de un vínculo de QuickCapture o un esquema de URL personalizado. Ambos métodos admiten los mismos parámetros, pero hay diferencias entre ellos que dependen de la plataforma.
Los vínculos de QuickCapture comienzan con https://quickcapture.arcgis.app y funcionan solo en iOS y Android. Los vínculos de QuickCapture 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. Las aplicaciones de ArcGIS que puede abrir con un vínculo de QuickCapture son, entre otras, ArcGIS Survey123, ArcGIS Field Maps, ArcGIS Workforce y ArcGIS Navigator.
Los vínculos de esquema de URL personalizado comienzan por arcgis-quickcapture:// y funcionan en Windows, Android y con un grupo seleccionado de aplicaciones de iOS. Las aplicaciones de ArcGIS que puede abrir con un esquema de URL de QuickCapture son, entre otras, ArcGIS Survey123 y ArcGIS Collector en Windows. 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-quickcapture://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open project</a>
Los vínculos de QuickCapture son el método de vinculación preferido entre aplicaciones y los esquemas URL personalizados son el método preferido para compartir proyectos.
Antes de usar un vínculo que contenga parámetros para iniciar un proyecto en la aplicación móvil, es recomendable que la aplicación ya esté instalada en el dispositivo.
Parámetros para la aplicación móvil
Puede utilizar los siguientes parámetros para personalizar cómo se abre la aplicación móvil:
| Parámetro | Descripción | Ejemplo | Tipo |
|---|---|---|---|
action | Especifica cómo se abre un proyecto. Los valores admitidos son press (para pulsar un botón identificado) y field (para completar un campo para pulsar un botón). Los botones se identifican mediante un GUID, que se muestra en la parte inferior de la pestaña Apariencia de los botones en el diseñador de QuickCapture. | Para capturar una entidad de punto o iniciar o detener la captura de una entidad de línea o polígono: action=press:0c59c9d9-9b51-46b3-bb81-21149e6fddb4 Para capturar una entidad y completar el campo de diámetro de esa entidad con el valor de 20: action=press:0c59c9d9-9b51-46b3-bb81-21149e6fddb4&field:diameter=20 | Cadena de caracteres |
callback | Especifica la URL de regreso cuando se pulsa un botón. | callback=https://survey123.arcgis.app | URL |
center | Centra el mapa en una latitud, longitud y altitud opcional conocidas. | center=37.8199,-122.4783,20 | Cadena de caracteres |
| externalBrowserSignIn | Especifica el uso de un navegador externo para iniciar sesión | externalBrowserSignIn=true | Booleano |
| itemID | Especifica el proyecto a abrir. | itemID=aabda4a5e36d42c2bcf1c479fe01e5e3 | UUID |
| portalUrl | Especifica la dirección URL del portal donde está alojado el elemento del proyecto QuickCapture. | portalUrl=https://myorg.arcgis.com | Cadena de caracteres |
| userInput | Especifica el Id. y el valor con el que se rellena la variable de entrada de usuario del proyecto. | userInput:001=Alice | Cadena de caracteres |
Vincular con QuickCapture desde un navegador web de escritorio
Puede crear un vínculo para abrir la aplicación móvil QuickCapture que puede integrar en otra aplicación. Puede introducir el mismo vínculo en un navegador web para probarlo. En los siguientes pasos se describe la creación de un esquema de URL personalizado y su uso en un navegador web de escritorio:
Nota:
Una vez que haya creado el vínculo, puede sustituir arcgis-quickcapture:// por https://quickcapture.arcgis.app y funcionará como vínculo de QuickCapture para utilizarlo en iOS o Android.
- Escriba arcgis-quickcapture:// en el navegador.Se abre la aplicación móvil de QuickCapture (o se le pide que la abra).
Nota:
Para iniciar y descargar un proyecto de un portal específico, incluya el parámetro de URL del portal, por ejemplo, arcgis-quickcapture://?portalUrl=host.domain.com/webadaptor (donde host, domain y webadaptor se reemplazan por su información del portal). Para utilizar un navegador externo para iniciar sesión, incluya el parámetro externalBrowserSignIn y defínalo como true, por ejemplo, arcgis-quickcapture://?portalUrl=host.domain.com/webadaptor&externalBrowserSignIn=true.
- Para incluir su proyecto en la URL que está creando, agregue ?itemID= y el Id. de elemento del proyecto a la URL.La dirección URL tendrá un aspecto similar al siguiente:
arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3
Si prueba su dirección URL, ahora abre la aplicación móvil QuickCapture e inmediatamente abre el proyecto.
Nota:
Si aún no está en su dispositivo, el proyecto se descarga.
- Para rellenar la variable de entrada de usuario de proyecto, escriba &userInput: y el Id. de entrada de usuario y el valor separado por un signo igual (=).
Nota:
El símbolo et (&) actúa como separador de parámetros.
Cada entrada de usuario de proyecto tiene un Id. único. Para ver el Id., cambie a la vista de JSON de su proyecto y busque userInputs. Cada entrada de usuario de proyecto aparece como una matriz de propiedades; la primera es el Id.
La dirección URL tendrá un aspecto similar al siguiente:
arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001=Alice
Esta URL abre la aplicación móvil QuickCapture y su proyecto, y el valor de entrada de usuario del proyecto de Alice se utiliza en todos los campos configurados para aceptarlo. Puede agregar hasta tres valores de entrada de usuario de proyecto a un proyecto. Una dirección URL que contenga más de un valor de entrada de usuario de proyecto tendrá un aspecto similar al siguiente:
arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001=Alice&userInput:002=Zone5
- Seleccione Configurar ventana emergente para una capa existente de su mapa web. En el menú desplegable de visualización, seleccione Una visualización personalizada de atributos y haga clic en Configurar para insertar un vínculo a su proyecto.
Para rellenar una variable de entrada de usuario del proyecto con el valor del campo de observador de la entidad desde la que se inició el vínculo, escriba &userInput:001={observer}; el símbolo et (&) actúa como separador de parámetros y las llaves ({}) denotan un nombre de campo.
La dirección URL tendrá un aspecto similar al siguiente:
arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001={observer}.
También puede agregar una referencia única a un proyecto y agregarla a la dirección URL. En primer lugar, debe identificar el Id. del elemento del proyecto que desea abrir. Es la cadena de caracteres que ArcGIS Online utiliza para identificar exclusivamente su proyecto y se puede encontrar en la URL del elemento de su proyecto en ArcGIS Online. Por ejemplo, si la URL de su proyecto es https://exampleurl.maps.arcgis.com/home/item.html?id=aabda4a5e36d42c2bcf1c479fe01e5e3, el Id. de elemento del proyecto será aabda4a5e36d42c2bcf1c479fe01e5e3.
Vincular con QuickCapture desde otra aplicación
Puede crear un vínculo para utilizarlo en otras aplicaciones para iniciar QuickCapture y capturar un registro. En los pasos siguientes se describe cómo crear un vínculo de QuickCapture y utilizarlo en un elemento emergente de 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.
- Seleccione Configurar ventana emergente para una capa existente en un mapa web que se visualizará en el dispositivo.
- En el menú desplegable de visualización, seleccione Una visualización personalizada de atributos y haga clic en Configurar para insertar un vínculo a su proyecto.
- Introduzca https://quickcapture.arcgis.app para el parámetro URL, introduzca Iniciar QuickCapture como Texto de vínculo y haga clic en Aceptar.
- Abra su 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 QuickCapture en la ventana emergente para iniciar QuickCapture.
- Para incluir su proyecto en la URL que está creando, agregue ?itemID= y el Id. de elemento del proyecto a la URL.La dirección URL tendrá un aspecto similar al siguiente:
https://quickcapture.arcgis.app/?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3Si prueba su dirección URL, debería abrirse la aplicación móvil QuickCapture e inmediatamente el proyecto.
Nota:
Si todavía no está en su dispositivo, el proyecto se descargará.
- Para rellenar la variable de entrada de usuario del proyecto, escriba &userInput:id= y el valor que desee introducir; el símbolo et (&) actúa como separador de parámetros.
La dirección URL tendrá un aspecto similar al siguiente:
https://quickcapture.arcgis.app/?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001=Alice
Esta URL abre la aplicación móvil QuickCapture y su proyecto, y el valor de entrada de usuario del proyecto de Area7 se utiliza en todos los campos configurados para aceptarlo.
- Para rellenar una variable de entrada de usuario del proyecto con el valor del campo workArea para la entidad desde la que se inició el vínculo, escriba &userInput:001={observer}; el símbolo et (&) actúa como separador de parámetros y las llaves ({}) denotan un nombre de campo.
La dirección URL tendrá un aspecto similar al siguiente:
https://quickcapture.arcgis.app/?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001={observer}
Vincular con otra aplicación desde QuickCapture
Puede configurar un proyecto de QuickCapture para abrir otra aplicación seleccionando un botón que abre una URL, lo que proporciona una experiencia flexible e ininterrumpida para que los trabajadores móviles trabajen con QuickCapture y otras aplicaciones.
Para vincular con otra aplicación desde QuickCapture, debe configurar un proyecto agregando un botón de vínculo y configurando la URL del botón de vínculo. En el diseñador, puede configurar el botón para abrir una URL dedicada, por ejemplo, una URL personalizada o un vínculo a una aplicación que abra otra aplicación de Esri. En el caso de la aplicación de campo ArcGIS Survey123, puede además navegar y seleccionar un formulario de encuesta y predefinir los valores de las preguntas de la encuesta.
Configurar un botón de vínculo
Para configurar un botón que inicie una URL a un cuadro de mandos, complete los siguientes pasos:
- Haga clic en el botón y vaya a la pestaña Vínculo.
- Haga clic en URL.
- Introduzca https://www.arcgis.com/apps/dashboards/747e7365d1894db4bbadf100f65cf991 como URL.
Esto crea un botón de vínculo que inicia el Cuadro de mando de QuickCapture cuando se selecciona en la aplicación móvil. En el editor de texto, puede introducir cualquier URL basada en HTTPS, o un esquema de URL personalizado de otra aplicación que haya permitido QuickCapture.
Nota:
Puede crear vínculos para iniciar aplicaciones de comunicación como, por ejemplo, correo electrónico, SMS y teléfono. Esto proporciona a los usuarios un acceso rápido a la ayuda desde el interior del proyecto. A continuación, se muestran algunos ejemplos de vínculos de aplicaciones de comunicación:
- Correo electrónico: mailto:sample@esri.com?subject=Fix%20the%20pipe&body=We%20really%20need%20to%20fix%20the%20pipe
- SMS: sms:0291920995 (En Android, también se puede incluir un cuerpo de mensaje: sms:0291920995?body=We%20really%20need%20to%20fix%20the%20pipe)
- Teléfono: tel:0291920995
Configurar un botón de ArcGIS Survey123
Para configurar un botón que inicie una aplicación de campo ArcGIS Survey123, siga estos pasos:
- Haga clic en el botón y vaya a la pestaña Vínculo.
- Haga clic en aplicación de campo Survey123.
- Seleccione una encuesta para vincularla al botón.
Así se define el parámetro itemID en el vínculo de Survey123.
- Haga clic en Agregar para agregar una pregunta de encuesta y buscar correspondencia con un valor fijo, una variable del dispositivo o una entrada del usuario del proyecto para la pregunta.
Así se define el valor del parámetro especificado field:fieldname en el vínculo de Survey123. Repita este paso para agregar todas las preguntas de encuesta necesarias. Para eliminar una pregunta de la encuesta que ha sido configurada, haga clic en el botón eliminar. Esto elimina el parámetro especificado field:fieldname en el vínculo de Survey123.
- Opcionalmente, habilite Ubicación de paso a Survey123 para incluir el parámetro center con valores de latitud y longitud en el vínculo de Survey123.
Si se incluye una pregunta de geopunto en la encuesta, el mapa se centra en la ubicación que le pasó desde QuickCapture.
- Opcionalmente, habilite Volver a QuickCapture para redirigir al usuario a QuickCapture cuando se envíe una encuesta.
Así se agrega un parámetro callback:submit en el vínculo de Survey123.
El diseñador crea el vínculo de Survey123 automáticamente.
La dirección URL tendrá un aspecto similar al siguiente. Este ejemplo incluye un valor fijo para condición, una variable de dispositivo para capturetime y una entrada del usuario del proyecto para username.
arcgis-survey123://?itemID=2a41c332e24644ee895bbbd9b929773f&field:condition=damaged&field:capturetime=${captureTime}&field:username=${userInput:001}Como alternativa, puede crear manualmente el vínculo de Survey123 con la opción URL. En el editor de texto, construya el URL manualmente, o use la barra de herramientas para agregar un valor predefinido para los parámetros de URL. Puede seleccionar un valor fijo, variable de dispositivo o variable de entrada del usuario del proyecto para agregar a la URL. Las variables se indican con corchetes ({}) en su URL creada, la aplicación móvil rellena automáticamente el valor real de los corchetes cuando se pulsa el botón.
Al cambiar entre las opciones de URL y aplicación de campo Survey123, se descarta la URL existente.
Para obtener más información sobre los parámetros admitidos por Survey123, consulte Integrar Survey123 con otras aplicaciones.
Nota:
Al asignar variables a las preguntas de la encuesta, el tipo de campo debe coincidir.
Aunque los parámetros de URL que no están codificados funcionan en algunos entornos, se recomienda codificar los parámetros de URL al crear una URL manualmente. La codificación sustituye caracteres no válidos por el signo de porcentaje, %, seguido de su equivalente hexadecimal. Por ejemplo, para incluir el parámetro de devolución de llamada, la dirección URL tendrá un aspecto similar al siguiente:
arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback:submit=https%3A%2F%2Fquickcapture.arcgis.app%253FitemID%99c18758066b42e1a0f4027603070b34