Integrar con otras aplicaciones

Puede integrar ArcGIS QuickCapture 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 empiezan por https://quickcapture.arcgis.app y se pueden abrir desde (o pueden abrir) otras aplicaciones de ArcGIS que admitan la vinculación de aplicaciones, y únicamente están disponibles en iOS y Android. 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 empiezan por arcgis-quickcapture:// y se pueden abrir desde (o pueden abrir) otras aplicaciones de ArcGIS en Android y Windows. Para usar un esquema de URL personalizado en iOS, la otra aplicación debe tener QuickCapture autorizado para permitir la vinculación. Las aplicaciones de ArcGIS que puede abrir con un esquema de URL de QuickCapture son, entre otras, ArcGIS Survey123 y ArcGIS Collector en Windows.

Usar un esquema de URL personalizado en Windows es una buena forma de crear y probar el vínculo y sus parámetros antes de enviarlo a sus trabajadores móviles como esquema de URL personalizado o vínculo de QuickCapture.

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.

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ámetroDescripciónEjemploTipo
portalUrl

Especifica la dirección URL del portal donde está alojado el elemento del proyecto QuickCapture.

portalUrl=https://myorg.arcgis.com

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

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.

  1. 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.

  2. 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.

  3. 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.

  4. Si lo desea, puede incluir una variable de entrada de usuario del proyecto predeterminada.
  5. 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.

    Id. de entrada de usuario que se muestra en el JSON.

    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

  6. También puede entregar contenido de los campos a QuickCapture desde un elemento emergente de un mapa web de ArcGIS, lo que permite la integración con las aplicaciones de Esri que usan elementos emergentes en un mapa web.
  7. 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}.

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.

  1. Seleccione Configurar ventana emergente para una capa existente en un mapa web que se visualizará en el dispositivo.
  2. 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.
  3. Introduzca https://quickcapture.arcgis.app para el parámetro URL, introduzca Iniciar QuickCapture como Texto de vínculo y haga clic en Aceptar.
    1. Abra su mapa web en un dispositivo móvil desde un navegador o una aplicación de ArcGIS.
    2. Seleccione una entidad y haga clic en el vínculo Iniciar QuickCapture en la ventana emergente para iniciar QuickCapture.
  4. 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=aabda4a5e36d42c2bcf1c479fe01e5e3

    Si 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á.

  5. Si lo desea, puede incluir una variable de entrada de usuario del proyecto predeterminada.
  6. 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.

  7. También puede pasar contenido de los campos a una variable de entrada de usuario del proyecto desde una aplicación de ArcGIS.
  8. 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.

Para configurar un botón que inicie una URL a un cuadro de mandos, complete los siguientes pasos:

  1. Haga clic en el botón y vaya a la pestaña Vínculo.
  2. Haga clic en URL.
  3. Introduzca https://www.arcgis.com/apps/opsdashboard/index.html#/4114d69f00c749f4b88d449e02d20ad7 como URL.

Esto crea un botón de vínculo que inicia el Cuadro de mando de BioBlitz 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

Para configurar un botón que inicie una aplicación de campo ArcGIS Survey123, siga estos pasos:

  1. Haga clic en el botón y vaya a la pestaña Vínculo.
  2. Haga clic en aplicación de campo Survey123.
  3. Seleccione una encuesta para vincularla al botón.

    Así se define el parámetro itemID en el vínculo de Survey123.

  4. 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.

  5. 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.

  6. 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