Skip To Content

Déployer 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 :

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. Facilitez l’accès de vos utilisateurs mobiles au portail approprié 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 suivant 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 :
  • https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis

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ètreValeursRemarques

portalURL

L’URL du portail de votre organisation

  • Si ce paramètre est spécifié et que l’utilisateur mobile est déconnecté ou connecté à un autre portail (y compris ArcGIS Online), l’utilisateur mobile est invité à se déconnecter, puis amené directement sur 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

Le GlobalID de l’affectation à ouvrir dans Workforce

  • Nécessite mapID.
  • Le GlobalID de l’affectation se trouve sous l’onglet Data (Données) de la page de l’élément correspondant à la couche Assignments. Alors que la table est affichée, cliquez sur le menu Options puis 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 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))

Les exemples suivants indiquent comment utiliser ces paramètres pour obtenir le comportement voulu avec le 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 déjà 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 particulier, puis ouvrez la carte :
    https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis&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 déjà remplies. Par exemple, si vous souhaitez créer des affectations à partir d’une application tierce, vous pouvez inclure un lien qui alimente automatiquement l’emplacement, 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 nouvelle 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 :

Le paramètre project-id figure dans l’URL lorsque le projet Workforce est ouvert. Par exemple, si l’URL est http://arcgis.com/apps/workforce/projects/a0f297f949f549f0ade07eee562d9934, le paramètre 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 %, suivis 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 non 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 déjà 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ètreValeursRemarques

assignmentType

Type d’affectation donné à une affectation.

  • Vous pouvez utiliser 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 dans WGS84 (WKID : 4326).

  • Nécessite lon.

lon

Coordonnée x de l’affectation dans WGS84 (WKID : 4326).

  • Nécessite lat.

location

Texte de l’emplacement 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 l’élément GlobalID de l’opérateur ou son nom d’utilisateur.
    Remarque :

    Si vous créez un lien pour un projet Classic, l’élément 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.

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 nouvelle 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 périphériques mobiles (GPM) 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 en savoir plus sur la manière dont Esri aborde la gestion des périphériques mobiles, consultez le livre blanc sur les modèles d’implémentation de sécurité mobile pour ArcGIS du ArcGIS Trust Center.

Lorsque vous préparez le déploiement de Workforce sur les appareils mobiles de votre organisation via une solution de gestion des appareils mobiles, il est conseillé de configurer certains paramètres d’application et de profil. 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 votre 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 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 plus d'informations sur la configuration de l’application, consultez la page AppConfig Community.

Workforce présente les paramètres suivants qui peuvent être implémentés avec la configuration des applications dans votre solution de gestion des appareils mobiles :

CléValeurRemarques

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 de votre 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 un domaine Safari (Safari Domain) dans le profil du 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 le paramètre Safari Domains (Domaines Safari). Si vous voulez bloquer cet accès, configurez une restriction iOS (iOS Restriction) (si votre logiciel GPM le permet) en utilisant l’option Block Safari Browser App (Bloquer l’application de navigateur Safari) sur les appareils souhaité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, au lancement de l’application sur un appareil mobile géré, elle se connecte automatiquement au VPN par application spécifié. Lorsque Workforce fonctionne en arrière-plan, le VPN par application reste connecté, mais uniquement à Workforce. Lorsque Workforce est fermé, l’appareil mobile se déconnecte automatiquement du VPN par application.