Vue d’ensemble de la structure

Un projet Workforce se compose de quatre couches d’entités et de quatre domaines de valeurs précodées avec une structure prédéfinie. Le nom de chaque couche d’entités est une combinaison d’un nom, qui décrit l’objectif de la couche d’entités, et du GUID de l’élément de projet Workforce. Par exemple, la couche des opérateurs (Workers) associée au projet avec le GUID 5dd018fcd88c4d33814cf3da9c44061e se nommerait workers_5dd018fcd88c4d33814cf3da9c44061e. Ceci garantit l’unicité de chaque couche d’entités.

Les quatre couches d’entités sont les suivantes :

1. Opérateurs
   • Une couche d’entités ponctuelles contenant un enregistrement pour chaque opérateur de terrain inclus dans le projet.
   • Inclut des informations sur l’opérateur de terrain, notamment son numéro de contact et son titre de tâche.
   • Le nom d’utilisateur de l’organisation ArcGIS de l’opérateur de terrain est stocké dans le champ userId.
   • La couche effectue le suivi de la personne qui a créé et mis à jour en dernier chaque opérateur de terrain.
   • Il existe une relation clé primaire-clé étrangère (PK-FK) entre OBJECTID et Assignments.workerId. L’utilisation de la valeur OBJECTID de la couche Workers (Opérateurs) comme valeur de champ Assignments.workerId permet d’associer l’opérateur de terrain à toutes ses affectations.
   • La couche dispose des associations de domaines de valeurs précodées suivantes :
     • Le champ de statut est associé au domaine de valeurs précodées Worker_Status pour suivre le statut de l’opérateur de terrain.
2. Affectations
   • Une couche d’entités ponctuelles contenant un enregistrement pour chaque affectation.
   • Inclut des informations sur l’affectation, notamment son statut, son emplacement et sa description.
   • La couche effectue le suivi de la personne qui a créé et mis à jour en dernier chaque affectation.
   • Les pièces jointes sont activées sur la couche d’entités.
   • La couche contient des clés étrangères pour certains champs, ce qui permet d’associer les valeurs d’une autre couche à cette couche :
     • Assignments.workerId vers Workers.OBJECTID.
     • Assignments.dispatcherId vers Dispatchers.OBJECTID.
     • Assignments.workOrderId peut servir de clé étrangère pour un système externe, tel qu’un système de gestion des ressources ou de maintenance, en fournissant les valeurs de l’autre système.
   • La couche dispose des associations de domaines de valeurs précodées suivantes :
     • Le champ status est associé au domaine de valeurs précodées Assign_Status pour suivre le statut de l’affectation.
     • Le champ priority est associé au domaine de valeurs précodées Priority pour gérer la priorité des affectations de travail.
     • Le champ assignmentType est associé au domaine de valeurs précodées Assign_Type pour stocker les types d’affectation du projet.
3. Superviseurs
   • Une couche d’entités ponctuelles contenant un enregistrement pour chaque superviseur au sein du projet.
   • Inclut des informations sur le superviseur, notamment son nom et son numéro de contact.
   • Le nom d’utilisateur de l’organisation ArcGIS du superviseur est stocké dans le champ userId.
   • La couche effectue le suivi de la personne qui a créé et mis à jour en dernier chaque superviseur.
   • Il existe une relation clé primaire-clé étrangère (PK-FK) entre OBJECTID et Assignments.dispatcherId. L’utilisation de la valeur OBJECTID de la couche Dispatchers (Superviseurs) comme valeur de champ Assignments.dispatcherId permet d’associer le superviseur à toutes les affectations qu’il a attribuées.
4. Suivi de la localisation
   • Une couche d’entités ponctuelles contenant un enregistrement pour chaque emplacement de point consigné alors que le suivi de l’emplacement est activé.
   • La couche effectue le suivi de la personne qui a créé et mis à jour en dernier chaque suivi d’emplacement.

Les quatre domaines de valeurs précodées sont les suivantes :

1. Assign_Status : stocke les six valeurs valides pour le statut d’une affectation.
2. Priority : stocke les quatre valeurs valides pour la priorité d’une affectation.
3. Assign_Type : stocke les types d’affectation du projet. Ce domaine de valeurs précodées est vide lors de la création initiale du projet. Il contient des valeurs une fois les types d’affectation ajoutés au cours de la configuration du projet.
4. Worker_Status : stocke les trois valeurs valides pour le statut de l’opérateur de terrain.

Pour les valeurs des domaines de valeurs précodées, consultez le diagramme de la structure de Workforce.

Champs de date et d’heure du statut de l’affectation

Au statut de chaque affectation, défini dans le domaine Assign_Status, correspond un champ de date et d’heure dans la couche d’entités des affectations. Ces champs contiennent les dernières date et heure auxquelles une affectation se trouvait dans l’état correspondant. Lorsqu’un statut est utilisé pour la première fois pour une affectation en particulier, le champ de date et d’heure associé est d’abord renseigné. Lorsqu’une affectation se trouve de nouveau plus tard dans le même état, le champ de date et d’heure est mis à jour avec la nouvelle date et la nouvelle heure. Par exemple, lorsqu’une affectation est d’abord attribuée, sa date d’attribution est la date et l’heure actuelles. Si elle est réattribuée trois heures plus tard, le champ assignedDate est mis à jour avec la nouvelle heure. L’heure d’attribution d’origine est perdue.

Pour mieux comprendre les valeurs et le moment où elles sont définies, examinez les scénarios suivants :

• Réattribution d’une tâche déjà attribuée
  • Vous avez attribué une affectation à l’heure t1, donc la valeur de assignedDate est t1.
  • Ensuite, à l’heure t2, l’affectation a été réattribuée à un autre opérateur de terrain, donc la valeur de assignedDate est t2.
• Réattribution d’une tâche refusée
  • Vous avez attribué une affectation à l’heure t1, donc la valeur de assignedDate est t1.
  • l’opérateur de terrain refuse l’affectation à l’heure t2, donc la valeur de declinedDate est t2. La valeur de assignedDate reste t1.
  • Vous attribuez l’affectation à un autre opérateur de terrain à l’heure t3, donc la valeur de assignedDate est t3.
• Interruption et reprise d’une tâche
  • Vous avez attribué une affectation à l’heure t1, donc la valeur de assignedDate est t1.
  • l’opérateur de terrain commence l’affectation à l’heure t2, donc la valeur de inProgressDate est t2. La valeur de assignedDate reste t1.
  • l’opérateur de terrain met en pause l’affectation à l’heure t3, donc la valeur de pausedDate est t3. La valeur de assignedDate reste t1 et la valeur de inProgressDate reste t2.
  • l’opérateur de terrain reprend l’affectation à l’heure t4, donc la valeur de inProgressDate est t4. La valeur de assignedDate reste t1 et la valeur de pausedDate reste t3.

Utiliser ArcGIS API for Python (recommandé)

Utilisez ArcGIS API for Python et son module Workforce pour automatiser Workforce et écrire des scripts. Workforce peut interpréter les affectations créées avec le module Workforce étant donné qu’elles suivront la même structure. Pour obtenir des exemples et connaître les pratiques conseillées, consultez les exemples de scripts disponibles sur GitHub. Les scripts indiquent comment utiliser Python pour effectuer de nombreuses tâches, notamment charger des affectations par programmation à partir de sources de données externes, importer et gérer des opérateurs, supprimer des affectations terminées, etc. Vous pouvez par ailleurs utiliser cet environnement Jupyter Notebook pour voir certaines opérations typiques.

Le module Workforce a été mis en service avec ArcGIS API for Python 1.4.1. S’il est vrai que vous pouviez déjà utiliser Python avant la mise en service de ce module, il présente l’avantage de simplifier l’automation des tâches Workforce. Le module Workforce encapsule la structure et les règles des projets Workforce. Il comprend également des mesures de protection qui assurent l’intégrité du projet Workforce.

Utiliser l’API REST pour les couches d’entités

Vous pouvez automatiser Workforce via l’API REST pour les couches d’entités. Lorsque vous utilisez l’API REST, vous devez utiliser le format Feature object (Objet entité) pour créer et mettre à jour les affectations. Reportez-vous aux sections suivantes pour plus d’informations sur la création et la mise à jour, ainsi que l’attribution, d’affectations via l’API REST.