Automatizar Field Maps

Puede automatizar ArcGIS Field Maps para agilizar la preparación de los mapas y su implementación sobre el terreno. Puede utilizar webhooks y scripts para automatizar una serie de tareas, como copiar un formulario entre mapas y generar automáticamente una notificación por correo electrónico cada vez que se inspeccione un activo. A continuación, se indican dos formas de automatizar tareas para Field Maps:

  • Configurar un webhook en Integromat: reciba automáticamente notificaciones casi en tiempo real cuando los trabajadores móviles creen, editen o eliminen entidades sobre el terreno.
  • Usar ArcGIS API for Python: utilice scripts de Python y notebooks para configurar e implementar mapas y administrar y analizar los datos recopilados en Field Maps.

Configurar un webhook en Integromat

Un webhook permite que una aplicación proporcione información basada en eventos a otras aplicaciones. Entre los usos habituales de webhooks se encuentran: el envío de notificaciones por correo electrónico o SMS, la publicación de mensajes en redes sociales, la escritura automática de registros en una hoja de cálculo y la actualización de bases de datos corporativas. Field Maps admite los webhooks a través de Integromat, un servicio de automatización de flujos de trabajo de terceros. Integromat presenta una aplicación de Field Maps que le permite integrar Field Maps en un flujo de trabajo de webhook. Puede integrar la aplicación Field Maps de las siguientes maneras:

  • Desencadenar un webhook: el desencadenador Vigilar entidades detecta entidades agregadas, editadas o eliminadas en la aplicación móvil Field Maps.
  • Hacer una llamada de API: la acción Hacer una llamada de API le permite realizar solicitudes de API a los servicios web de ArcGIS.
Nota:

La aplicación de Field Maps de Integromat solo admite los servicios de entidades alojados y actualmente no es compatible con ArcGIS Enterprise.

Agregar la aplicación Field Maps

Para agregar la aplicación Field Maps a un webhook de Integromat, siga estos pasos:

  1. Vaya a https://www.integromat.com/ e inicie sesión.

    Si no tiene aún ninguna cuenta, regístrese gratis para empezar.

  2. Haga clic en Crear un nuevo escenario.
  3. Busque ArcGIS Field Maps, selecciónelo y haga clic en Continuar.

    La aplicación ArcGIS Field Maps aparece como favorito en su escenario.

  4. Haga clic en el botón de módulo situado en el centro de la pantalla y seleccione ArcGIS Field Maps en el menú.

    Se agrega la aplicación ArcGIS Field Maps. Puede utilizar la aplicación para desencadenar un webhook o realizar una llamada a la API de los servicios web de ArcGIS.

Conectar con su organización de ArcGIS

Si es la primera vez que utiliza la aplicación Field Maps en Integromat, establezca una conexión a su organización de ArcGIS. La forma de conectarse a su organización depende del módulo que utilice y de los servicios a los que acceda.

Conectar el desencadenador Vigilar entidades a su organización de ArcGIS

Para conectar el desencadenador Vigilar entidades a su organización de ArcGIS, siga estos pasos:

  1. Agregue la aplicación Field Maps a un webhook de Integromat.
  2. Seleccione el desencadenador Vigilar entidades.
  3. En Webhook, haga clic en Agregar.
  4. En Conexión, haga clic en Agregar y asigne a la conexión el nombre ArcGIS.

    Para conectarse a ArcGIS Online, haga clic en Continuar para iniciar sesión en su organización de ArcGIS.

Puede ver y editar las conexiones que realice en la pestaña Conexiones de Integromat. Para conectarse a varios servicios web en ArcGIS, es posible que tenga que crear varias conexiones. Por ejemplo, si utiliza un módulo Hacer una llamada de API para consultar una capa de entidades y otro módulo Hacer una llamada de API para acceder a la API de uso compartido, necesitará una conexión distinta para cada servicio.

Nota:

Si no utiliza una conexión durante 90 días, el token de actualización caduca y debe volver a conectarse a su organización de ArcGIS. Si maxTokenExpirationMinutes está configurado para su organización y es inferior a 90 días, el token de actualización caduca en función de ese valor.

Conectar la acción Hacer una llamada de API a su organización de ArcGIS

Para conectar la acción Hacer una llamada de API a su organización de ArcGIS, siga estos pasos:

  1. Agregue la aplicación Field Maps a un webhook de Integromat.
  2. Seleccione la acción Hacer una llamada de API.
  3. En Conexión, haga clic en Agregar y proporcione lo siguiente:
    1. Nombre de conexión: proporcione un nombre para la conexión, por ejemplo, ArcGIS.
      Nota:

      Si está accediendo a la API de uso compartido, haga clic en Continuar para iniciar sesión en su organización de ArcGIS en lugar de completar los pasos secundarios siguientes.

    2. Subdominio: especifique los servicios a los que desee conectarse. Por ejemplo, si se conecta a servicios de entidades, escriba servicios.

      Nota:

      Si se está conectando a servicios de entidades, revise la página de elementos de su capa de entidades para conocer el subdominio que debe utilizar. En URL, el vínculo mostrado comienza con https://<services>.arcgis.com. Utilice el texto en <services> como subdominio para conectar el módulo con los servicios de entidades.

    3. URL de ArcGIS Online: haga clic en Mostrar configuración avanzada e indique la URL de su organización de ArcGIS.

      Para conectarse a ArcGIS Online, haga clic en Continuar para iniciar sesión en su organización de ArcGIS.

Puede ver y editar las conexiones que realice en la pestaña Conexiones de Integromat. Para conectarse a varios servicios web en ArcGIS, es posible que tenga que crear varias conexiones. Por ejemplo, si utiliza un módulo Hacer una llamada de API para consultar una capa de entidades y otro módulo Hacer una llamada de API para acceder a la API de uso compartido, necesitará una conexión distinta para cada servicio.

Nota:

Si no utiliza una conexión durante 90 días, el token de actualización caduca y debe volver a conectarse a su organización de ArcGIS. Si maxTokenExpirationMinutes está configurado para su organización y es inferior a 90 días, el token de actualización caduca en función de ese valor.

Desencadenar un webhook con la aplicación Field Maps

Los webhooks pueden configurarse y activarse cuando se crea, actualiza o elimina una entidad en Field Maps u otras aplicaciones, tales como Map Viewer. Por ejemplo, después de recopilar una nueva entidad en Field Maps, un webhook puede desencadenar otra acción, como el envío de una notificación por correo electrónico. Siga estos pasos en Integromat para crear un webhook que envíe una notificación por correo electrónico cada vez que se cree, actualice o elimine una entidad en la aplicación móvil Field Maps:

Nota:

Para ver un tutorial paso a paso con capturas de pantalla, consulte la entrada del blog Automatizar las notificaciones por correo electrónico para las actualizaciones de campos.

  1. Agregue la aplicación Field Maps a un webhook de Integromat.
  2. Seleccione el módulo desencadenador Vigilar entidades.

    Este módulo ejecuta el escenario cada vez que se crea, actualiza o elimina una entidad.

    El icono de escenario cambia de color y aparece una ventana para ayudarle a configurar el módulo de Field Maps.

  3. Haga clic en Agregar y proporcione un nombre para el webhook.
    El nombre único del proyecto o mapa que utilizará el webhook.
  4. Si esta es la primera vez que utiliza este módulo en Integromat, establezca una conexión a su organización de ArcGIS.
    Nota:

    Si ha creado una conexión para el módulo Hacer una llamada a API, puede reutilizar esa conexión para el módulo Vigilar entidades.

  5. En Capa de entidades, elija una capa de entidades editable de su organización de ArcGIS a la que conectarse.
  6. Seleccione uno o varios de los siguientes eventos desencadenadores para incluirlos en el webhook:
    • Entidades creadas: desencadena el escenario cuando se crea una entidad.
    • Entidades actualizadas: desencadena el escenario cuando se actualiza una entidad.
    • Entidades eliminadas: desencadena el escenario cuando se elimina una entidad.
  7. Haga clic en Guardar.
  8. Haga clic en Aceptar.

    El módulo Field Maps está configurado.

  9. En la sección Herramientas, haga clic en Control de flujo.
  10. En la lista de opciones, seleccione Iterador.

    El módulo Iterador se conecta automáticamente al módulo Field Maps. Permite al webhook iterar por una matriz de entidades si se devuelven varias entidades al mismo tiempo.

  11. Seleccione el módulo Iterador y haga clic en el cuadro de texto Matriz.
  12. En el menú desplegable de ArcGIS Field Maps - Servicio Vigilar entidades, busque y seleccione una de las siguientes matrices:
    • Adiciones []: para entidades creadas
    • Actualizaciones []: para entidades actualizadas
    • IDs eliminadas [] : para entidades eliminadas
  13. Haga clic en Aceptar.
  14. Haga clic en el botón Agregar otro módulo junto al módulo Iterador.
  15. Busque el servicio de correo electrónico que desea utilizar, por ejemplo, Microsoft 365 Email, y seleccione la aplicación.
  16. Seleccione la acción Crear y enviar un mensaje.
  17. Si es la primera vez que utiliza el módulo en Integromat, haga clic en Agregar para configurar una conexión a su cuenta de correo electrónico. Seleccione un tipo de conexión e inicie sesión en su cuenta.

    Solo tiene que hacerlo una vez. Integromat guarda la conexión para su uso futuro.

  18. Agregue el texto de Asunto y Contenido del cuerpo al correo electrónico.

    Puede utilizar la asignación para incluir atributos de su capa y dar formato a los cuadros de texto. Si utiliza la asignación, agregue los atributos de capa del módulo Iterador.

  19. Agregue una dirección de correo electrónico de destinatario.

    Esta es la dirección de correo electrónico a la que se enviará el correo electrónico generado por el desencadenador.

  20. Haga clic en Aceptar.
  21. Haga clic en Guardar para guardar su escenario.

    Opcionalmente, haga clic en Ejecutar una vez para probar el webhook. Después de hacer clic en Ejecutar una vez, abra Field Maps y recopile, actualice o elimine una entidad. Confirme que el destinatario recibe el correo electrónico.

  22. Utilice el botón de alternancia Programación para activar su escenario. Cambie la programación a Inmediatamente para asegurarse de que el escenario se ejecute cada vez que se actualice una entidad.
Nota:

Para obtener asistencia relativa a Integromat, consulte la documentación de Integromat.

Realizar una llamada a la API con la aplicación Field Maps

La aplicación Field Maps puede utilizarse para realizar solicitudes de API a los servicios web de ArcGIS. Por ejemplo, si un usuario recopila una nueva entidad en Field Maps, puede utilizar el módulo Hacer una llamada a API para recuperar la dirección de correo electrónico de ese usuario y enviarle un correo electrónico. También puede utilizar el módulo para consultar una capa de entidades y crear características, por ejemplo, una asignación de Workforce. A continuación, se muestran ejemplos de cómo puede utilizar la aplicación Field Maps para realizar solicitudes de la API:

Realizar una solicitud a la API de uso compartido

La API de uso compartido le permite solicitar información acerca de los usuarios, grupos y contenidos de una organización. Puede utilizarlo para consultar información de los usuarios, buscar en los mapas, ver el contenido y otras funciones. Puede utilizar la aplicación Field Maps en un webhook para recuperar información de la API de uso compartido. Por ejemplo, para enviar un correo electrónico a un usuario que acaba de realizar una inspección, puede utilizar la aplicación Field Maps para recuperar su dirección de correo electrónico. Para configurar la aplicación Field Maps para que recupere la información de un usuario desde la API de uso compartido, siga estos pasos:

  1. Agregue la aplicación Field Maps a un webhook de Integromat.
  2. Seleccione el módulo de acción Hacer una llamada de API.

    El icono de escenario cambia de color y aparece una ventana para ayudarle a configurar el módulo de Field Maps.

  3. Si esta es la primera vez que utiliza este módulo en Integromat, establezca una conexión a su organización de ArcGIS.
    Nota:

    Si creó una conexión para el módulo Vigilar entidades, puede reutilizar esa conexión para conectarse a la API de uso compartido en el módulo Realizar una llamada a API.

  4. En URL, indique la ruta de acceso a la API de uso compartido.

    Para este ejemplo, utilice la siguiente ruta para acceder a la información de un usuario:

    /sharing/rest/community/<username>
    Para más información, consulte Introducción a la API de uso compartido.

  5. En Método, seleccione GET.
  6. En Cadena de consulta, haga clic en Agregar elemento.
  7. Proporcione las siguientes entradas:
    1. Clave: f
    2. Valor: json
  8. Haga clic en Aceptar.
  9. Haga clic en Guardar para guardar su escenario.

Cuando se desencadena, el módulo Field Maps recupera la información del usuario desde la API de uso compartido.

Nota:

Para obtener asistencia relativa a Integromat, consulte la documentación de Integromat.

Hacer una solicitud para consultar una capa de entidades

Puede realizar una solicitud de API para consultar una capa de entidades. Por ejemplo, quiere que se le envíe un resumen al final del día por correo electrónico. Puede configurar la aplicación Field Maps para consultar las estadísticas de las inspecciones de un día e incluirlas en un correo electrónico. Para configurar la aplicación Field Maps para consultar una capa de entidades, siga estos pasos:

  1. Agregue la aplicación Field Maps a un webhook de Integromat.
  2. Seleccione el módulo de acción Hacer una llamada de API.

    El icono de escenario cambia de color y aparece una ventana para ayudarle a configurar el módulo de Field Maps.

  3. Si esta es la primera vez que utiliza este módulo en Integromat, establezca una conexión a su organización de ArcGIS.
  4. En URL, indique la ruta del servicio de entidades que desea consultar:

    /<org-id>/arcgis/rest/services/<layer-name>/FeatureServer/<layer-id>/query

    Para obtener más información, consulte Consulta (servicio/capa de entidades).
  5. En Método, seleccione GET.
  6. Agregue los elementos Cadena de consulta.
    1. En Cadena de consulta, haga clic en Agregar elemento y proporcione los siguientes datos:

      1. Clave: f
      2. Valor: json

    2. Haga clic en Agregar.
    3. Haga clic en Agregar elemento y proporcione los siguientes datos:

      1. Clave: where
      2. Valor: 1=1

    4. Haga clic en Agregar.
    5. Haga clic en Agregar elemento y proporcione los siguientes datos:

      1. Clave: outFields
      2. Valor: *

    6. Haga clic en Agregar.
  7. Haga clic en Aceptar.
  8. Haga clic en Guardar para guardar su escenario.

Cuando se desencadene, el módulo Field Maps consultará la capa de entidades en función de los parámetros que haya proporcionado.

Nota:

Para obtener asistencia relativa a Integromat, consulte la documentación de Integromat.

Hacer una solicitud para crear una entidad

Puede realizar una solicitud de API para crear una entidad. Por ejemplo, si se completa una inspección de hidrantes en Field Maps, eso puede desencadenar la creación de una entidad de asignación en ArcGIS Workforce. Para configurar la aplicación Field Maps para agregar a una capa de entidades, siga estos pasos:

  1. Agregue la aplicación Field Maps a un webhook de Integromat.
  2. Seleccione el módulo de acción Hacer una llamada de API.

    El icono de escenario cambia de color y aparece una ventana para ayudarle a configurar el módulo de Field Maps.

  3. Si esta es la primera vez que utiliza este módulo en Integromat, establezca una conexión a su organización de ArcGIS.
  4. En URL, indique la ruta del servicio de entidades a la que desea agregar entidades:

    /<org-id>/arcgis/rest/services/<layer-name>/FeatureServer/<layer-id>/applyEdits

    Para obtener más información, consulte Aplicar ediciones (servicio/capa de entidades).
  5. En Método, seleccione POST.
  6. En Encabezados, haga clic en Editar.
  7. Cambie Valor a application/x-www-form-urlencoded.
  8. Haga clic en Guardar.
  9. En Cuerpo, escriba f=json&adds=[<json-object>].

    El valor de <json-object> debe ser una cadena JSON que represente una entidad. La especificación exacta que debe utilizar depende de su capa. Para obtener más información, consulte Objeto de entidad.

  10. Haga clic en Aceptar.
  11. Haga clic en Guardar para guardar su escenario.

Cuando se desencadena, el módulo Field Maps agrega una entidad a la capa.

Nota:

Para obtener asistencia relativa a Integromat, consulte la documentación de Integromat.

Usar ArcGIS API for Python

Utilice ArcGIS API for Python para automatizar tareas y crear scripts de tareas para Field Maps. Puede utilizar el módulo Formularios para crear y editar los formularios utilizados para la recopilación de datos, y puede acceder al repositorio de scripts de Field Maps en GitHub, por ejemplo, scripts y notebooks. Los scripts y notebooks le permiten automatizar tareas, como la copia de formularios entre mapas y la descarga de archivos adjuntos de una capa de entidades.

Nota:

Para utilizar el módulo de formularios, debe utilizar la versión ArcGIS API for Python 1.9.0 o posterior.