Déployer Workforce—ArcGIS Workforce

Vous pouvez aider les utilisateurs mobiles et les superviseurs à démarrer avec ArcGIS Workforce en procédant de l’une des manières suivantes :

Fournissez aux utilisateurs mobiles un lien qui permet d’installer l’application, de définir l’URL du portail, de télécharger la carte, d’ouvrir une affectation et de définir le statut d’une affectation.
Fournissez aux superviseurs un lien qui permet de rationaliser la création des affectations.
Utiliser un logiciel de gestion des périphériques mobiles (GPM) pour déployer et configurer l’application mobile, y compris l’URL du portail.

Ouvrir l’application mobile Workforce à partir d’un lien

Les utilisateurs mobiles peuvent indiquer l’URL de leur portail dans Workforce, ou vous pouvez leur fournir directement une URL qui correspond à l’URL de portail correcte. Autorisez l’accès au portail approprié par les utilisateurs mobiles en partageant un lien via un e-mail, un message texte, une page Web, un QR Code ou une autre application. Une fois que le lien est activé, Workforce ouvre l’URL du portail que l’utilisateur mobile doit utiliser.

Structure du lien

Les liens vers l’application mobile Workforce ont le format suivant : https://workforce.arcgis.app?parameter=value. Les paires parameter et value sont remplacées par les valeurs à utiliser pour déployer l’application. Par exemple, le lien https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis utilise le paramètre portalURL pour diriger les utilisateurs mobiles directement vers l’écran de connexion de votre organisation où ils sont invités à se connecter.

Paramètres

Les paramètres suivants sont pris en charge avec les liens d’accès à Workforce. Si aucun paramètres n’est transmis, l’appui sur les liens ouvre Workforce (ou vous invite à télécharger l’application).


Paramètre	Valeurs	Remarques
portalURL	L’URL du portail de votre organisation	Si une valeur est spécifiée et que l’utilisateur mobile est déconnecté ou connecté à un portail différent (y compris ArcGIS Online), il est invité à se déconnecter, est orienté directement vers l’écran de connexion de votre organisation et invité à se connecter. Fournissez une URL identique à celle que vous saisissez dans le navigateur pour accéder au portail ; par exemple https://myportal.mycompany.com/arcgis.
mapID	L’ID d’élément de la carte à télécharger et à ouvrir dans Workforce	L’ID d’élément figure dans l’URL de la page de l’élément de la carte des opérateurs. Par exemple, si l’URL de la page de l’élément de la carte des opérateurs est https://www.arcgis.com/home/item.html?id=fc60dfd46b234fbeaa74e76e6b17fb7b, l’ID d’élément de la carte est fc60dfd46b234fbeaa74e76e6b17fb7b.
assignmentID	La valeur GlobalID de l’affectation à ouvrir dans Workforce	Nécessite une valeur mapID. La valeur GlobalID d’une affectation se trouve sous l’onglet Data (Données) de la page de l’élément correspondant à la couche Assignments. Dans la table, cliquez sur le menu Options et sur Show/Hide Columns (Afficher/Masquer les colonnes). Sélectionnez GlobalID pour afficher cette valeur pour chaque affectation.
assignmentStatus	Le statut attribué à une affectation lorsqu’elle est ouverte dans Workforce.	Nécessite des valeurs mapID et assignmentID. Les valeurs entières suivantes sont prises en charge : 1 (Affected (Attribuée)) 2 (In Progress (En cours)) 3 (Completed (Terminée)) 4 (Declined (Refusée)) 5 (Paused (Interrompue))

Vous trouverez ci-dessous des exemples d’utilisation de ces paramètres pour obtenir un comportement spécifique avec un lien Workforce.

Se connecter à un portail spécifique

Indiquez l’URL du portail auquel l’opérateur de terrain doit être connecté.

En voici un exemple :

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

Télécharger et ouvrir une carte

Utilisez le paramètre mapID pour télécharger et ouvrir une carte. Si la carte spécifiée est téléchargée sur l’appareil de l’opérateur de terrain, elle est ouverte dans Workforce sans téléchargement.

Voici quelques exemples :

Ouvrez la carte comme l’opérateur de terrain actuellement identifié ; en cas de non-identification, offrez-lui la possibilité de s’identifier :
```
https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d
```

Connectez-vous à un portail spécifique et ouvrez la carte :

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

Ouvrir une affectation

Utilisez le paramètre assignmentID pour ouvrir une affectation dans la carte.

En voici un exemple :

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

Définir le statut d’une affectation

Utilisez le paramètre assignmentStatus pour définir le statut d’une affectation.

En voici un exemple :

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

Remarque :

Il est possible, mais déconseillé, d’utiliser ce paramètre pour définir le statut de l’affectation selon des méthodes incompatibles avec l’application mobile. Par exemple, dans le cas d’une affectation dont le statut est Assigned (Attribuée), il est possible d’utiliser un lien Workforce pour redéfinir son statut sur Paused (Interrompue), et ainsi ignorer le statut In Progress (En cours) qui serait défini par l’opérateur de terrain. Il n’est pas possible d’ignorer ce statut dans l’application mobile.

Ouvrir l’application Web Workforce à partir d’un lien

Vous pouvez rationaliser le déploiement de l’application Web Workforce en partageant un lien par courrier électronique, message texte, page Web, QR Code ou une autre application. Il est possible de personnaliser les liens avec des paramètres d’URL pour ouvrir une affectation nouvelle ou existante avec des informations d’affectation déjà remplies.

Le fait de fournir un lien aux superviseurs leur permet de créer des affectations dont les informations essentielles sont remplies. Par exemple, pour créer des affectations à partir d’une application tierce, vous pouvez inclure un lien indiquant automatiquement la localisation, la description et la date d’échéance d’une nouvelle affectation.

Structure du lien

Les liens vers l’application Web Workforce commencent toujours par le format suivant : http://<portal-url>/apps/workforce/projects/<project-id>.

Pour ouvrir une affectation spécifique, ajoutez /dispatch/assignments/<assignment-id> au lien :http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/<assignment-id>.

Pour lancer la création d’une affectation, ajoutez /dispatch/assignments/new? au lien et indiquez un ou plusieurs paramètres séparés par une esperluette (&) :

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

Remarque :

La valeur project-id figure dans l’URL lorsque le projet Workforce est ouvert. Par exemple, si l’URL correspond à http://arcgis.com/apps/workforce/projects/a0f297f949f549f0ade07eee562d9934, la valeur project-id est a0f297f949f549f0ade07eee562d9934.

Encoder les paramètres

Tous les paramètres figurant dans les liens menant vers l’application Web Workforce doivent être encodés. Le codage remplace les caractères non valides par le signe de pourcentage (%) suivi de leur équivalent hexadécimal.

Par exemple, le lien suivant comporte des paramètres non encodés :

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

Voici le même lien avec des paramètres encodés :

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

De nombreux sites Web ou outils gratuits permettent de générer des URL encodées. Par exemple, Albion Research Ltd. offre une page URLEncode et URLDecode.

Créer une affectation

Créez un lien qui lance l’application Web Workforce dans laquelle les nouvelles affectations sont déjà préremplies avec des informations. Par exemple, si vous possédez une application personnalisée pour la création d’inspections d’arbres, vous pouvez créer un lien qui ouvre Workforce, où une nouvelle affectation d’inspection d’arbres comporte le type d’affectation et les informations de localisation.

Paramètres

Les paramètres indiqués ci-dessous sont pris en charge pour la création d’affectations avec les liens Workforce.


Paramètre	Valeurs	Remarques
assignmentType	Type d’affectation donné à une affectation	Vous pouvez utiliser la valeur GlobalID ou le nom du type d’affectation. Remarque : Si vous créez un lien pour un projet Classic, le domaine de valeurs précodées ou le nom du type d’affectation peut être utilisé. Les valeurs ne respectent pas la casse.
lat	Coordonnée y de l’affectation au format WGS84 (WKID : 4326)	Nécessite une valeur lon.
lon	Coordonnée x de l’affectation au format WGS84 (WKID : 4326)	Nécessite une valeur lat.
location	Texte de la localisation de l’affectation	Ce paramètre est ignoré si lat et lon ne sont pas renseignés.
priority	Priorité donnée à une affectation	Les valeurs entières suivantes sont prises en charge : 0 (None (Aucune)) 1 (Low (Faible)) 2 (Medium (Moyenne)) 3 (High (Élevée)) 4 (Critical (Critique))
dueDateTime	Date et heure d’échéance de l’affectation	En millisecondes numériques depuis l’epoch Unix.
workOrderId	Clé référençant un bon de travail provenant d’un système externe ou tiers	Une valeur issue de votre système externe.
description	Informations concernant l’affectation	Texte d’explication.
assignee	Utilisateur attribué à l’affectation	Vous pouvez utiliser la valeur GlobalID de l’opérateur ou son nom d’utilisateur. Remarque : Si vous créez un lien pour un projet Classic, la valeur objectid ou le nom d’utilisateur peut être employé. Les valeurs ne respectent pas la casse.

Remarque :

Tous les paramètres sont facultatifs ; cependant, les champs assignmentType, lat, lon et location doivent être renseignés pour que l’affectation puisse être créée.

Si vous utilisez ArcGIS Enterprise, lat et lon sont les seuls paramètres pris en charge lors de la création d’une affectation à partir d’un lien. L’application Web Workforce sur ArcGIS Enterprise utilise le géocodage inverse pour renseigner le paramètre location.

Exemples

Voici des exemples d’utilisation des paramètres dans le lien d’une application permettant d’indiquer des informations lors de la création d’une affectation Workforce :

Créez une affectation à l’aide des coordonnées :

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

Créez une affectation d’inspection des arbres avec un niveau de priorité moyen et affectez-la à un opérateur de terrain :

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

Créez une affectation de réparation canalisations dont l’échéance est le 23 mai à 15 h 00 :

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

Créez une affectation de réparation avec une description du problème :

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.

Gestion des périphériques mobiles

La gestion des appareils mobiles désigne un logiciel employé pour l’administration des appareils mobiles au sein d’une organisation. Un logiciel de gestion des périphériques mobiles permet d’améliorer la sécurité des données et du réseau, ainsi que de définir et d’appliquer des stratégies liées aux appareils mobiles. Le recours à un logiciel de gestion des périphériques mobiles accroît en outre l’efficacité des déploiements d’applications et facilite la gestion des appareils mobiles, en permettant notamment de contrôler comment et quand une application est mise à jour. Pour connaître l’approche de Esri concernant la solution de gestion des périphériques mobiles, consultez le livre blanc Modèles d’implémentation de sécurité mobile pour ArcGISs sur le site Web ArcGIS Trust Center.

Lorsque vous vous préparez à déployer Workforce sur les appareils mobiles de votre organisation via une solution de gestion des périphériques mobiles, il existe certains paramètres d’application et de profil que vous pouvez configurer. Ces paramètres incluent l’URL du portail et les paramètres de réseau VPN par application.

Attention :

Si vous utilisez un appareil Android, Chrome ou un autre navigateur doit être installé et activé pour afficher l’écran de connexion au portail.

Configuration de l’application Workforce

La configuration d’application (également appelée AppConfig) désigne un format permettant de fournir des paramètres d’application, comme l’URL du portail. Au lieu de configurer ces paramètres manuellement à chaque installation d’une application mobile, vous pouvez utiliser un logiciel de gestion des périphériques mobiles (GPM) pour spécifier et appliquer automatiquement les configurations d’application. Ces paramètres sont définis sous la forme d’un dictionnaire de paires clé-valeur dans un fichier .xml. Le mode de création du dictionnaire dépend du logiciel GPM que vous utilisez. Pour en savoir plus sur la configuration d’application, consultez la page Web AppConfig Community.

Les paramètres suivants de Workforce peuvent être implémentés avec la configuration d’application dans une solution de gestion des appareils mobiles :


Clé	Valeur	Remarques
portalURL	L’URL du portail de votre organisation	À son lancement, Workforce affiche directement l’écran de connexion du portail de votre organisation. Par exemple, https://myportal.mycompany.com/gis. Le type de valeur est chaîne.

Réseau privé virtuel (VPN) par application

Le fait de configurer un réseau privé virtuel par application (VPN par application) au sein d’un GPM vous permet de restreindre l’accès aux ressources internes à des applications spécialement gérées. Workforce peut être déployé avec cette configuration. Pour configurer un VPN par application afin de l’utiliser avec Workforce reportez-vous à la documentation du logiciel GPM que vous employez.

Attention :

Sous iOS, Safari est utilisé pour afficher l’écran de connexion au portail dans Workforce. Pour que cela fonctionne correctement avec un VPN par application activé, le domaine de votre portail (par exemple, mycompany.com) doit être spécifié dans le paramètre Safari Domains (Domaines Safari) dans le profil VPN par application que vous utilisez. Si le paramètre Safari Domains (Domaines Safari) n’est pas correctement défini, les appareils mobiles attribués ne peuvent pas accéder à l’écran de connexion au portail Workforce.

Lorsque vous définissez une valeur Safari Domains (Domaines Safari) dans le profil VPN par application comme décrit ci-dessus, le navigateur Safari peut également accéder au domaine de portail que vous avez spécifié dans Safari Domains (Domaines Safari). Pour bloquer cet accès, configurez iOS (iOS Restriction) (si votre logiciel GPM le permet) afin d’utiliser l’option Block Safari Browser App (Bloquer l’application de navigateur Safari) sur les appareils concernés.

Une fois que vous avez défini les paramètres du VPN par application pour Workforce dans votre logiciel de gestion des périphériques mobiles, l’application se connecte automatiquement au VPN par application spécifié à l’ouverture de l’application sur un appareil géré. Lorsque Workforce fonctionne en arrière-plan, le VPN par application est connecté uniquement à Workforce. Lorsque Workforce est fermé, l’appareil mobile se déconnecte automatiquement du VPN par application.

Vous avez un commentaire à formuler concernant cette rubrique ?