Implementar Workforce—ArcGIS Workforce

Puede ayudar a usuarios móviles y distribuidores a empezar con ArcGIS Workforce de las siguientes formas:

Proporcionar un vínculo para usuarios móviles que pueda utilizarse para instalar la aplicación, establecer la URL del portal, descargar el mapa, abrir una asignación y establecer el estado de una asignación.
Proporcionar un vínculo para distribuidores que pueda utilizarse para simplificar la creación de asignaciones.
Utilizar un software de administración de dispositivos móviles (MDM) para implementar y configurar la aplicación móvil, incluida la URL del portal.

Abrir la aplicación móvil Workforce desde un vínculo

Los usuarios móviles pueden especificar su URL del portal en Workforce, o también usted puede proporcionarles una URL directamente a ellos que especifique la URL correcta del portal. Permita que sus usuarios móviles puedan acceder al portal adecuado compartiendo un vínculo mediante un correo electrónico, un mensaje de texto, una página web, un código QR u otra aplicación. Al tocar, Workforce abre la URL del portal que desea que utilice el trabajador móvil.

Estructura de vínculo

Los vínculos a la aplicación móvil Workforce tienen el siguiente formato: https://workforce.arcgis.app?parameter=value. Los pares de parámetro y valor se sustituyen por los valores que desea usar para implementar la aplicación. Por ejemplo, el vínculo https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis utiliza el parámetro portalURL para que los usuarios móviles lleguen directamente a la pantalla de inicio de sesión de su organización y les pide que inicien sesión.

Parámetros

Los siguientes parámetros son compatibles con vínculos de Workforce. Si no se transmite ningún parámetro, al tocar el vínculo se abre Workforce (o se le solicita que descargue la aplicación).


Parámetro	Valores	Notas
portalURL	La URL del portal de su organización	Si se especifica un valor y el usuario móvil ha cerrado sesión o se ha conectado a otro portal (incluido ArcGIS Online), se le pide que cierre su sesión y se le dirige directamente a la pantalla de inicio de sesión de su organización, donde se le pide que inicie sesión. Se proporciona la misma URL que se introduce en el navegador cuando se desea acceder al portal, por ejemplo, https://myportal.mycompany.com/arcgis.
mapID	El Id. de elemento del mapa para descargarlo y abrirlo en Workforce	El Id. del elemento se encuentra en la URL de la página del elemento del Mapa del trabajador. Por ejemplo, si la URL de la página de elemento del Mapa del trabajador es https://www.arcgis.com/home/item.html?id=fc60dfd46b234fbeaa74e76e6b17fb7b, el Id. de elemento del mapa es fc60dfd46b234fbeaa74e76e6b17fb7b.
assignmentID	Valor GlobalID de la asignación para abrir en Workforce	Requiere un valor mapID. El valor GlobalID de una asignación se encuentra en la pestaña Datos en la página de elemento de la capa Asignaciones. En la tabla, haga clic en el menú Opciones y haga clic en Mostrar/ocultar columnas. Seleccione GlobalID para mostrar este valor para cada asignación.
assignmentStatus	El estado dado a una asignación cuando se abre en Workforce	Requiere valores mapID y assignmentID. Se admiten los siguientes valores de entero: 1 (Asignado) 2 (En curso) 3 (Completado) 4 (Rechazado) 5 (En pausa)

A continuación se prorporcionan ejemplos de uso de estos parámetros para conseguir un comportamiento específico con un vínculo de Workforce.

Conectarse a un portal específico

Especifique la URL del portal al que debería estar conectado el trabajador móvil.

A continuación, encontrará un ejemplo:

https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis

Descargar y abrir un mapa

Descargue y abra un mapa con el parámetro mapID. Si el trabajador móvil ha descargado el mapa en su dispositivo, no se realiza ninguna descarga y el mapa especificado se abre en Workforce.

A continuación, se muestran algunos ejemplos:

Abra el mapa como el trabajador móvil que tiene una sesión iniciada actualmente o, si no ha iniciado sesión, deles la oportunidad de hacerlo:
```
https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d
```

Conéctese a un portal en concreto y abra el mapa:

https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis&amp;mapID=3ac4145c1ac44aea86e9ed42e00fbb0d

Abrir una asignación

Abra una asignación en el mapa con el parámetro assignmentID.

A continuación, encontrará un ejemplo:

https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d&assignmentID=948b2bf3-f866-4516-97e7-00418d3b567d

Definir el estado de una asignación

Defina el estado de una asignación con el parámetro assignmentStatus.

A continuación, encontrará un ejemplo:

https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d&assignmentID=948b2bf3-f866-4516-97e7-00418d3b567d&assignmentStatus=2

Nota:

Es posible, pero no recomendable, utilizar este parámetro para definir el estado de la asignación de formas que no son posibles en la aplicación móvil. Por ejemplo, si una asignación tiene el estado Asignada, se puede utilizar un vínculo de Workforce para establecerla en En pausa, omitiendo el estado En curso que establecería el trabajador móvil. Omitir este estado no es posible en la aplicación móvil.

Abrir la aplicación web Workforce desde un vínculo

Puede simplificar la implementación de la aplicación web Workforce compartiendo un vínculo a través de un correo electrónico, mensaje de texto, página web, código QR u otra aplicación. Los vínculos pueden personalizarse con parámetros de URL para abrir una asignación existente o una nueva asignación con información de asignación ya rellenada.

Al proporcionar un vínculo a distribuidores, les permitirá crear asignaciones que tienen información clave rellenada. Por ejemplo, para crear asignaciones desde una aplicación de terceros, puede incluir un vínculo que rellene automáticamente la ubicación, descripción y fecha de vencimiento de una nueva asignación.

Estructura de vínculo

Los vínculos a la aplicación web Workforce siempre comienzan con el siguiente formato: http://<portal-url>/apps/workforce/projects/<project-id>.

Para abrir una asignación específica, agregue /dispatch/assignments/<assignment-id> al vínculo: http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/<assignment-id>.

Para iniciar la creación de una nueva asignación, agregue /dispatch/assignments/new? al vínculo e incluya uno o más parámetros separados por un ampersand (&):

http://<your portal url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=repair&lat=34.057170&lon=-117.194150&location=Esri

Nota:

El valor project-id puede encontrarse en la URL cuando el proyecto Workforce está abierto. Por ejemplo, si la URL es http://arcgis.com/apps/workforce/projects/a0f297f949f549f0ade07eee562d9934, el valor project-id es a0f297f949f549f0ade07eee562d9934.

Codificar los parámetros

Todos los parámetros en los vínculos a la aplicación web Workforce deben codificarse. La codificación sustituye caracteres no válidos por el signo de porcentaje, %, seguido de su equivalente hexadecimal.

Por ejemplo, el siguiente vínculo contiene parámetros sin codificar:

http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=repair hydrant&lat=34.057170&lon=-117.194150&location=Esri Campus

La siguiente es el mismo vínculo con parámetros codificados:

http://<portal-url>/apps/workforce/<project-id>new?assignmentType=repair%20hydrant&lat=34.057170&lon=-117.194150&location=Esri%20Campus

Existen muchos sitios web y herramientas gratuitos para generar direcciones URL codificadas. Por ejemplo, Albion Research Ltd. tiene la página URLEncode y URLDecode.

Crear una asignación

Cree un vínculo que inicie la aplicación web Workforce con información sobre asignación ya rellenada para una nueva asignación. Por ejemplo, si tiene una aplicación personalizada para crear inspecciones de árbol, puede crear un vínculo que abra Workforce con el tipo de asignación e información de ubicación rellenados para una nueva asignación de inspección de árbol.

Parámetros

Los parámetros incluidos a continuación se admiten para crear asignaciones con vínculos de Workforce.


Parámetro	Valores	Notas
assignmentType	Tipo de asignación proporcionado a una asignación	Puede utilizar el valor GlobalID o el nombre del tipo de asignación. Nota: Si está creando un vínculo para un proyecto Classic, el dominio de valor codificado o nombre de tipo de asignación pueden utilizarse. Los valores no distinguen entre mayúsculas y minúsculas.
lat	Coordenada y de la asignación en WGS84 (WKID: 4326)	Requiere un valor lon.
lon	Coordenada x de la asignación en WGS84 (WKID: 4326)	Requiere un valor lat.
location	Texto de ubicación utilizado para la asignación	Este parámetro se ignora si lat y lon no se rellenan.
priority	Prioridad proporcionada a una asignación	Se admiten los siguientes valores de entero: 0 (Ninguno) 1 (Bajo) 2 (Medio) 3 (Alto) 4 (Crítico)
dueDateTime	Fecha y hora de vencimiento proporcionadas a una asignación	En milisegundos numéricos desde una época de Unix.
workOrderId	Clave que hace referencia a una orden de trabajo de un sistema externo o de terceros	Un valor del sistema externo.
description	Información sobre la asignación	Texto explicativo.
assignee	Usuario asignado a la asignación	Puede usar el valor GlobalID del trabajador o su nombre de usuario. Nota: Si está creando un vínculo para un proyecto Classic, el valor objectid o nombre de usuario pueden utilizarse. Los valores no distinguen entre mayúsculas y minúsculas.

Nota:

Todos los parámetros son opcionales, aunque los parámetros assignmentType, lat, lon y location deben rellenarse antes de que pueda crearse la nueva asignación.

Si está utilizando ArcGIS Enterprise, lat y lon son los únicos parámetros admitidos al crear una asignación desde un vínculo. La aplicación web Workforce de ArcGIS Enterprise utiliza geocodificación inversa para rellenar el parámetro location.

Ejemplos

A continuación se incluyen ejemplos de cómo pueden utilizarse los parámetros en un vínculo de aplicación para rellenar información al crear una asignación de Workforce:

Crear una asignación con coordenadas:

http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?lat=34.057170&lon=-117.194150

Crear una asignación de inspección de árbol con un nivel de prioridad medio y asignarla a un trabajador móvil:

http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=inspect%20tree&lat=34.057170&lon=-117.194150&location=esri&priority=2&assignee=mobile_worker

Crear una asignación de reparación de tubería que vence el 23 de mayo a las 3:00 p.m.:

http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=pipe%20repair&lat=34.057170&lon=-117.194150&location=esri&dueDateTime=1621782000000

Crear una asignación de reparación con una descripción del problema:

http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=repair&&lat=34.057170&lon=-117.194150&location=esri&description=Repair%20the%20valve.

Administración de dispositivos móviles

La Administración de dispositivos móviles hace referencia al software que se utiliza en la administración de dispositivos móviles en una organización. Se utiliza MDM para mejorar la seguridad de los datos y de la red, además de para establecer y aplicar políticas de dispositivos móviles. Además, utilizar la MDM aumenta la eficiencia de la administración y las implementaciones de aplicaciones para dispositivos móviles, incluido el control de cómo y cuándo se actualiza una aplicación. Para obtener más información sobre el enfoque de Esri frente a la MDM, consulte Patrones de implementación móviles y seguros de ArcGIS en el ArcGIS Trust Center.

Durante la preparación para implementar Workforce en los dispositivos móviles de su organización mediante MDM, puede configurar los ajustes de perfil y de la aplicación. Se incluye la URL del portal y la configuración de VPN por aplicación.

Precaución:

Si utiliza un dispositivo Android, debe tener instalado y habilitado Chrome u otro navegador para visualizar la pantalla de inicio de sesión del portal.

Configuración de la aplicación Workforce

La Configuración de la aplicación (a veces llamada AppConfig) hace referencia a un formato para proporcionar configuración de la aplicación, como la URL del portal. En lugar de configurar estos ajustes manualmente siempre que se instala una aplicación móvil, puede utilizar un MDM para especificar y aplicar configuraciones de la aplicación automáticamente. Esta configuración se define como un diccionario de pares de clave-valor en un archivo .xml. La forma en que se crea un diccionario depende de la MDM que esté utilizando. Para obtener más información sobre la configuración de la aplicación, visite la página web Comunidad AppConfig.

Workforce cuenta con la siguiente configuración, que se puede implementar con la configuración de la aplicación en un MDM:


Clave	Valor	Notas
portalURL	La URL del portal de su organización	Cuando se inicia Workforce, pasa directamente a la pantalla de inicio de sesión del portal de su organización. Por ejemplo, https://myportal.mycompany.com/gis. El tipo de valor es cadena de caracteres.

Red privada virtual por aplicación

Configurar una red privada virtual por aplicación (VPN por aplicación) en un MDM le permite restringir el acceso a recursos internos a aplicaciones administradas concretas. Workforce se puede implementar con esta configuración. Para configurar una VPN por aplicación y utilizarla en Workforce, consulte la documentación de software de la MDM que esté utilizando.

Precaución:

Si está en iOS, Safari se utiliza para mostrar la pantalla de inicio de sesión del portal en Workforce. Para que funcione correctamente con una VPN por aplicación habilitada, el dominio de su portal (por ejemplo, mycompany.com) se debe especificar en la configuración Dominios de Safari en el perfil de la VPN por aplicación que esté utilizando. Si Dominios de Safari no se configura correctamente, los dispositivos móviles asignados no pueden acceder a la pantalla de inicio de sesión del portal de Workforce.

Cuando define un Dominio de Safari en el perfil de la VPN por aplicación tal y como se describe anteriormente, el navegador Safari también puede acceder al dominio del portal que especificó en los Dominios de Safari. Para bloquear este acceso, configure una Restricción de iOS (si está disponible en el MDM) para Bloquear la aplicación del navegador Safari en los dispositivos que corresponda.

Una vez que se ajusta la configuración de la VPN por aplicación para Workforce en el MDM, la aplicación se conecta automáticamente a la VPN por aplicación designada cuando la aplicación se abre en un dispositivo móvil gestionado. Cuando se ejecuta Workforce en segundo plano, la VPN por aplicación solo se conecta a Workforce. Cuando se cierra Workforce, el dispositivo móvil se desconecta automáticamente de la VPN por aplicación.

¿Algún comentario sobre este tema?