Service sur site Composants de gestion des capacités et des réservations
Plusieurs types de composants sont installés avec la fonctionnalité Gestion de la capacité et des réservations, notamment les tables, les règles métier, les travaux planifiés et les Service sur site includes de script.
Installez le module d’extension Service sur site Gestion des entrepreneurs (com.snc.fsm_contractor_management) pour prendre en compte les groupes externes lors de la réservation, de la définition et de l’affectation de la capacité de travail. Pour plus d'informations, consultez Activer Service sur site Contractor Management.
L’activation de Gestion de la capacité et des Service sur site réservations ajoute le menu Gestion de la capacité au navigateur d’application et les modules suivants :
- Réservations de capacité : réservez un pourcentage de capacité de la disponibilité d’un groupe ou d’agents pour répondre à des demandes spécifiques. Par exemple, 60 % pour les types de travaux de réparation et 40 % pour les types de travaux d’installation.
- Définitions de capacité : allouez la bonne quantité de travail aux groupes de travail internes ou externes en fonction des heures définies, du nombre de tâches ou des calendriers de travail des agents. Vous pouvez définir la capacité pour un jour, une semaine, un mois ou une année.
- Affectations de capacité : affectez la capacité et les réservations de capacité à des groupes de travail internes et à des groupes externes d’entreprises contractantes.
- Utilisations de la capacité : affichez l’enregistrement de la capacité utilisée par différents groupes et agents.
Remarque :
Vous devez sélectionner l’utilisation de la planification dynamique dans l’option de configuration Méthode d’affectation des tâches pour permettre à votre application de distribuer le travail en fonction des règles de gestion de capacité.
Tables
La gestion de la capacité ajoute les tables suivantes.
| Table | Description |
|---|---|
| Affectation de capacité [wm_capacity_assignment] |
Stocke les affectations de définition de capacité à des groupes dans une période spécifique pour éviter les conflits de capacité dans une période donnée en validant les dates de début d’effet et d’effet jusqu’à . |
| Définition de capacité [wm_capacity_definition] |
Stocke les détails tels que la source de capacité, le calendrier d’allocation, la fréquence des définitions de capacité d’un groupe ou d’un agent de service sur site interne et les règles de réservation à utiliser lors de l’affectation des tâches. |
| Canal de demande [wm_demand_channel] |
Stocke les détails tels que le nom, les conditions et l’ordre d’exécution d’un canal de demande. |
| Mesures de la demande de capacité [wm_capacity_for_demand] |
Stocke les données de mesures pour toutes les affectations de capacité. |
| Réservation de capacité [wm_capacity_reservation] |
Stocke la définition de la réservation et les conditions d’exclusion. |
| Règle de réservation de capacité [wm_capacity_reservation_rule] |
Stocke les règles de réservation et les conditions pour lesquelles les réservations doivent être utilisées. |
| Utilisation de la capacité [wm_capacity_usage] |
Stocke la capacité utilisée par un agent de service sur site interne ou un groupe au cours d’une période spécifique. |
Règles métier
La gestion de la capacité ajoute les règles métier suivantes.
| Business Rule | Table | Description |
|---|---|---|
| Éviter les conflits de capacité | Affectation de capacité [wm_capacity_assignment] |
Surveillez la période définie pour l’affectation de capacité afin d’éviter qu’un groupe n’ait plusieurs affectations de capacité au cours de la même période ou des intervalles qui se chevauchent. |
| Mettre à jour la capacité lors du changement de tâche | Tâche d'ordre de travail [wm_task] |
Ajoutez ou mettez à jour la capacité lorsqu’une tâche est affectée ou non affectée. Vous pouvez mettre à jour la capacité lorsque la durée de travail ou de déplacement estimée change. |
| Mettre à jour la capacité à la suppression de la tâche | Tâche d'ordre de travail [wm_task] |
Mettez à jour la capacité utilisée chaque fois qu’une tâche ouverte est supprimée dans la fenêtre donnée. |
| Valider la valeur de capacité | Définition de capacité [wm_capacity_definition] |
Valide la valeur de la capacité fournie pour la définition de capacité. La capacité doit être une valeur entière positive non nulle. |
| Valider Effectif jusqu’à et Effectif à partir de | Affectation de capacité [wm_capacity_assignment] |
Valide les dates saisies dans les champs Date de fin d’effet et Date d’effet de la table d’affectation de capacité. Le système calcule la valeur Date d’effet en fonction de la valeur saisie dans le champ Répéter pour si la valeur Capacité par n’est pas sélectionnée comme pour le programme de l’agent. La valeur Effectif à partir de doit toujours être égale ou postérieure à la date actuelle, et antérieure ou égale à la date Effet jusqu’à . Lors de la mise à jour de l’affectation de capacité, la valeurEffectif jusqu’à ne peut pas être définie à une date antérieure à l’utilisation de la capacité. |
| Valider le pourcentage de valeur allouée | Règle de réservation de capacité [wm_capacity_reservation_rule] |
Valide la valeur en pourcentage allouée dans la table Règle de réservation de capacité. Cette valeur doit être un nombre entier positif non nul inférieur ou égal à 100. |
| Mettre à jour le domaine pour l’affectation de capacité | Affectation de capacité [wm_capacity_assignment] |
Le système affecte des domaines aux enregistrements en fonction des informations contenues dans le champ Type . Si le type est « Agents internes du territoire » ou « Groupe de prestataires du territoire », le domaine est défini à l’aide du champ Territoire . Pour tout autre type, le domaine est déterminé par le champ Groupe . |
| Mettre à jour la table des mesures de demande de capacité | Remplacement de l'affectation de capacité [wm_capacity_override] |
Met à jour la table Mesures de la demande de capacité lorsque la date ou les jours limites du calendrier de l’agent agrégé sont mis à jour pour un territoire. |
| Mettre à jour la capacité lors du changement de tâche | Tâche de commande de travaux [wm_task] |
Vous permet de personnaliser le calcul de la capacité en définissant des conditions pour déduire la capacité de l’utilisation de la capacité. |
| Interdire les changements de définition de capacité | Définition de capacité [wm_capacity_definition] |
Empêche les modifications des définitions de capacité lorsqu’elles sont utilisées. |
| Interdire le remplacement pour le calendrier de l’agent | Remplacement de l'affectation de capacité [wm_capacity_override] |
Empêche les remplacements des calendriers gérés par le système de planification des agents. |
| Masquer la mise à jour sur l’utilisation de la capacité | Catégories de capacités [wm_capacity_bucket] |
Empêche la mise à jour des valeurs de capacité et de temps lorsqu’il existe des enregistrements d’utilisation de capacité. |
| Limite d’un canal de demande par réservation | Règle de réservation de capacité [wm_capacity_reservation_rule] |
Garantit que chaque règle de réservation de capacité est associée à un seul canal de demande. |
| Empêcher le nom et la condition en double | Canal de demande [wm_demand_channel] |
Garantit que les canaux de demande n’ont pas de noms et de conditions en double. |
| Empêcher la mise à jour de l’enregistrement sur inactif | Canal de demande [wm_demand_channel] |
Empêche de changer l’état du canal de demande sur Inactif lorsque le canal de demande est toujours utilisé. |
| Supprimer la capacité pour la tâche non prise en charge | Tâche de commande de travaux [wm_task] |
Supprime les allocations de capacité des tâches qui ne prennent pas en charge la gestion de la capacité. |
| Restreindre les changements de définition | Définition de capacité [wm_capacity_definition] |
Empêche de changer la capacité par valeur de la définition de capacité en Agent Schedule lorsqu’il existe des enregistrements de remplacement d’affectation de capacité. |
| Pour vérifier l’utilisation au moins 0 | Utilisation de la capacité [wm_capacity_usage] |
Valide que les valeurs d’utilisation de la capacité sont supérieures ou égales à 0. |
| Valider les différents types de remplacements | Remplacement de l'affectation de capacité [wm_capacity_override] |
Valide que les différents types de remplacements respectent les contraintes métier. |
| Valider les champs | Remplacement de l'affectation de capacité [wm_capacity_override] |
Garantit que les champs requis sont renseignés pour le remplacement de capacité. |
| Valider les champs en fonction du type | Affectation de capacité [wm_capacity_assignment] |
Veille à ce que les champs requis soient renseignés en fonction du type d’affectation de capacité. |
| Valider lors de la suppression de la définition | Définition de capacité [wm_capacity_definition] |
Garantit que les définitions de capacité ne sont pas utilisées avant leur suppression. |
| Valider la définition globale | Définition de capacité [wm_capacity_definition] |
Valide la définition de capacité avant de l’ajouter ou de la mettre à jour. |
| Valider les compartiments de capacité qui se chevauchent | Catégories de capacités [wm_capacity_bucket] |
Empêche de définir des plages horaires de chevauchement dans les catégories de capacité. |
| Valider le pourcentage alloué | Calendrier d'allocation [wm_allocation_schedule] |
Valide la valeur de pourcentage allouée. La valeur doit être un nombre entier positif inférieur ou égal à 100. |
| Valider le pourcentage alloué | Détails du calendrier d'allocation [wm_allocation_schedule_detail] |
Valide la valeur de pourcentage allouée. La valeur doit être un nombre entier positif inférieur ou égal à 100. |
| Valider la plage | Détails du calendrier d'allocation [wm_allocation_schedule_detail] |
Valide que les plages horaires ne se chevauchent pas. |
| Valider la récurrence | Remplacement de l'affectation de capacité [wm_capacity_override] |
Valide que les règles de récurrence dans Remplacement de capacité sont correctement configurées. |
| Valider le pourcentage total | Catégories de capacités [wm_capacity_bucket] |
Garantit que le pourcentage total alloué dans toutes les catégories de capacité ne dépasse pas 100. |
| Validation du classement | Remplacement de l'affectation de capacité [wm_capacity_override] |
Valide l’ordre de classement des réservations de capacité afin de garantir une priorité appropriée. |
La gestion de la capacité ajoute les règles métier suivantes pour la planification des équipes pour le service sur site. Le module d’extension com.snc.sn_fsm_shift_schdlng doit être installé pour activer ces règles métier.
| Business Rule | Table | Description |
|---|---|---|
| Mettre à jour la capacité pour la demande | Agent Schedule [sn_shift_planning_agent_schedule] |
Met à jour la capacité lorsque les mesures de la demande sont mises à jour. |
| Mettre à jour la table des mesures de demande de capacité | Demande de congés du programme de l'agent [sn_shift_planning_agent_schedule_request] |
Met à jour la table des mesures de demande pour la planification des territoires. |
La gestion de la capacité ajoute les règles métier suivantes pour Field Service Territory Planning. Vous devez installer le module d’extension com.snc.fsm_territory_planning pour activer ces règles métier.
| Business Rule | Table | Description |
|---|---|---|
| Mettre à jour la table des mesures de demande de capacité | Remplacement de l'affectation de capacité [wm_capacity_override] |
Met à jour la table Mesures de la demande de capacité (wm_capacity_for_demand) lors de la mise à jour des valeurs pour les champs Date limite du calendrier de l’agent agrégé ou Date limite du calendrier de l’agent agrégé pour un territoire de service sur site. |
| Mettre à jour la table des mesures de demande de capacité | Entrée de calendrier cmn_schedule_span |
|
| Mettre à jour la table des mesures de demande de capacité | Affectation de capacité [wm_capacity_assignment] |
|
| Mettre à jour la table des mesures de demande de capacité | Territoire [sn_tp_territory] |
|
| Mettre à jour la table des mesures de demande de capacité | Catégories de capacités [wm_capacity_bucket] |
|
| Mettre à jour la table des mesures de demande de capacité | Calendrier de travail de l'agent [agent_work_schedule] |
|
| Mettre à jour le canal de demande sur WOT | Tâche de commande de travaux [wm_task] |
|
| Mettre à jour la table des mesures de demande de capacité | Calendrier personnel de l'agent [agent_events] |
|
| Mettre à jour la table des mesures de demande de capacité | Règle de réservation de capacité [wm_capacity_reservation_rule] |
|
| Mettre à jour la table des mesures de la demande pour 1 jour | Remplacement de l'affectation de capacité [wm_capacity_override] |
|
| Mettre à jour la table des mesures de demande de capacité | Calendrier d'allocation [wm_allocation_schedule] |
|
| Mettre à jour la table des mesures de demande de capacité | Définition de capacité [wm_capacity_definition] | |
| Mettre à jour la table des mesures de demande de capacité | Planifier [cmn_schedule] |
|
| Mettre à jour la table des mesures de demande de capacité | Détails du calendrier d'allocation [wm_allocation_schedule_detail] |
|
| Mettre à jour la table des mesures de demande de capacité | Groupe de territoires [sn_tp_territory_group] |
|
| Valider la section Calendrier de l’agent agrégé | Territoire [sn_tp_territory] |
Valide la valeur Jours limites du calendrier de l’agent agrégé ou champ Date dans la table Territoire. Les jours limites du calendrier de l’agent doivent être un nombre entier non nul, supérieur ou égal à 0 et inférieur ou égal à 30. |
Remarque :
Vous devez sélectionner l’utilisation de la planification dynamique dans l’option de configuration Méthode d’affectation des tâches pour permettre à votre application de distribuer le travail en fonction des règles de gestion de capacité.
Tâche planifiée
La gestion de la capacité et des réservations ajoute la tâche planifiée suivante. Pour les trouver, accédez à .
| Tâche planifiée | Description |
|---|---|
| Calculer les données de mesures de la demande de capacité | Calcule et génère des données pour le tableau de bord d’analyse des capacités du territoire du service sur site. |
Includes de script
Gestion de la capacité et des réservations ajoute les includes de script suivants. Pour les trouver, accédez à .
| Include de script | Description |
|---|---|
| FSMCapacityAjax | Fournit des points de terminaison AJAX qui permettent aux scripts clients de vérifier la capacité de l’agent pour les tâches et de récupérer dynamiquement les détails d’affectation à partir du serveur. |
| FSMCapacityAppnmtBookingUtil | Méthodes d’utilitaire pour prendre en charge la prise de rendez-vous dans FSM. Cette méthode utilitaire récupère les groupes de répartition pour un emplacement et filtre les groupes en fonction de la configuration. Il détermine également les groupes éligibles pour l’affectation de tâches lors de la planification des rendez-vous. |
| FSMCapacityBaseUtil | Classe utilitaire personnalisable qui étend FSMCapacityBaseUtilSNC. Cette classe d’utilitaire fournit des méthodes pour valider et calculer la capacité. |
| FSMCapacityBaseUtilSNC | Fournit des scripts utilitaires en lecture seule pour valider et calculer la capacité. |
| FSMCapacityBucketApi | Gère les catégories de capacité, y compris les opérations CRUD et l’allocation de catégories. |
| FSMCapacityBucketApiSNC | Contient des méthodes utilitaires pour récupérer et mapper les compartiments de capacité utilisés par une tâche, en fonction des détails d’affectation et de calendrier. Il prend en charge les calculs avancés de capacité basés sur des catégories et s’intègre aux API d’utilisation, de réservation et de définition. |
| FSMCapacityConstants | Contient des constantes personnalisables. Il étend la classe des constantes de base (FSMCapacityConstantsSNC) et vous permet de remplacer ou d’ajouter de nouvelles valeurs constantes spécifiques aux exigences, sans modifier les constantes de base. |
| FSMCapacityConstantsSNC | Contient des constantes en lecture seule comme les noms de table, les valeurs par défaut et les options de configuration. Il centralise les valeurs statiques importantes utilisées tout au long du workflow. |
| FSMCapacityCoreApi | Fournit des méthodes pour récupérer et calculer les détails de capacité pour les tâches, prenant en charge la planification avancée de la capacité et le suivi de l’utilisation. |
| FSMCapacityDefinitionApi | Fournit la classe API pour les définitions de capacité. Elle étend l’API de base (FSMCapacityDefinitionApiSNC) et vous permet de gérer et de remplacer la définition de capacité en fonction des besoins de l’entreprise. |
| FSMCapacityDefinitionApiSNC | Fournit des méthodes d’API pour calculer la capacité totale, gérer les remplacements et prendre en charge différentes stratégies de calcul de capacité en fonction de l’affectation, du calendrier de l’agent ou des heures. |
| Gestion de la comptabilité FSMC | S’intègre à diverses API de gestion de la capacité et des réservations pour orchestrer les vérifications de capacité, les calculs et les mises à jour. Il fournit des méthodes de gestion de la capacité en déterminant la capacité pour les tâches et la disponibilité des agents. |
| FSMCapacityQueryUtil | Classe d’utilitaire qui fournit une requête pour trouver des affectations de programme d’agent dans une fenêtre de temps et récupérer toutes les affectations pertinentes en fonction des qualificateurs et des plages de dates. |
| FSMCapacityReservationAllocationApi | Fournit une classe utilitaire personnalisable pour gérer la capacité, les réservations et les allocations. Il étend FSMCapacityReservationAllocationApiSNC. |
| FSMCapacityReservationAllocationApiSNC | Classe utilitaire en lecture seule qui gère la capacité, les réservations et les allocations. Il fournit des méthodes pour calculer les pourcentages d’allocation et les capacités de réservation, prenant en charge la planification avancée et la planification de la capacité. |
| FSMCapacityUsageApi | Classe API personnalisable qui gère les enregistrements d’utilisation de capacité. Il étend FSMCapacityUsageApiSNC et fournit des méthodes personnalisables pour gérer les calculs d’utilisation de capacité. |
| FSMCapacityUsageApiSNC | Fournit des méthodes pour calculer et récupérer l’utilisation totale et réservée de la capacité. Il exploite la mise en cache et s’intègre aux API de définition de capacité et de réservation pour valider et suivre efficacement l’utilisation. |
| FSMCapacityUtil | Fournit des fonctions utilitaires pour garantir les vérifications d’intégrité et supprimer en toute sécurité les entités de gestion de la capacité et des réservations. Il vérifie si les définitions de capacité, les réservations ou les règles de réservation sont référencées dans les enregistrements d’utilisation. |
| ScheduleOptimizationCapacityResponse | Contient une classe d’utilitaire qui fournit des méthodes pour calculer les horizons de capacité pour les groupes ou les territoires, afin de déterminer la capacité disponible et allouée pour l’optimisation des tâches dans une plage de dates spécifiée. Remarque : Le module d’extension Optimisation du calendrier (com.snc_schedule_optimization) pour Gestion des services sur site doit être installé pour activer cet include de script. |
Gestion de la capacité et des réservations ajoute les includes de script suivants pour la planification du territoire de service sur site. Vous devez activer le module d’extension Service sur site Territory Planning (com.snc.fsm_territory_planning) pour Gestion des services sur site activer ces includes de script.
| Include de script | Description |
|---|---|
| FSMDemandManagementConstants | Étend la classe des constantes FSMDemandManagementConstantsSNC. Il vous permet de remplacer ou d’ajouter de nouvelles valeurs constantes spécifiques à vos besoins sans modifier les constantes en lecture seule de base. |
| FSMDemandManagementConstantsSNC | Définit les constantes en lecture seule telles que les noms de files d’attente, les clés de calcul des mesures et les valeurs de configuration. Il centralise les constantes chaîne et numérique importantes pour les réutiliser dans l’application. |
| FSMDemandManagementUtilSNC | Fournit des fonctions utilitaires de base en lecture seule, y compris des méthodes de calcul et de mise à jour des données de mesures pour les affectations de territoires et de capacité. |
| FSMDemandManagementUtil | Classe personnalisable qui étend FSMDemandManagementUtilSNC. Il vous permet de remplacer ou d’ajouter des méthodes utilitaires de gestion de la demande spécifiques à vos besoins. |
| FSMDemandManagementExtPoint | Fournit une méthode pour récupérer le canal de demande par défaut. Implémente le point d’extension FSMDemandManagementExtPoint, ce qui vous permet de personnaliser la gestion de la demande. |
| FSMDemandManagementQueryUtil | Classe personnalisable qui étend la classe FSMDemandManagementQueryUtilSNC en lecture seule. Vous pouvez remplacer ou ajouter de nouvelles méthodes dans FSMDemandManagementQueryUtil pour personnaliser la gestion de la demande en fonction de vos besoins. |
| FSMDemandManagementQueryUtilSNC | Définit des fonctions d’utilitaire telles que l’extraction du canal de demande par défaut, la récupération des tâches de commande de travaux futures et la suppression des enregistrements de mesures. Il fournit une logique réutilisable pour prendre en charge les fonctionnalités de gestion de la demande. |
Rôles
La gestion de la capacité et des réservations ajoute les rôles suivants. Pour les trouver, accédez à .
| Rôles | Description |
|---|---|
| sn_fsm_capacity_mg.wm_capacity_write | Autorise l’accès CRUD à toutes les tables liées à la capacité |
| sn_fsm_capacity_mg.wm_capacity_read | Autorise un accès en lecture à toutes les tables liées à la capacité et à l’espace de travail de la console de capacité |