Affichage du tableau de bord de gestionnaire

La solution

La section suivante décrit les API, les exits utilisateur, les services ainsi que d'autres composants.

La Vue Tableau de bord de gestionnaire peut être lancée à partir de la page d'accueil de l'application à l'aide de l'icône représentant un oeil. Le tableau de bord de gestionnaire fournit notamment le nombre total de commandes, le graphique d'état des commandes et le graphique de SLA. Les aspects techniques du remplissage du tableau de bord sont les suivants :

Des applications composites sont appelées pour remplir les données destinées à chaque portlet du tableau de bord. Plusieurs applications composites sont agrégées en un seul appel de service vers le serveur. Cette action remplit le graphique de SLA et le graphique d'état des commandes, affichés côte à côte. En fonction des paramètres d'entrée de l'application composite, le service interroge la base de données pour les commandes Expédition depuis le magasin ou Prélèvement depuis le magasin et les statuts de commande demandés.
Un magasin peut gérer uniquement les commandes Ramassage en magasin ou Expédition depuis le magasin . Dans ce cas, le droit d'accès aux ressources requis peut être activé pour que le groupe d'utilisateurs du magasin accède au portlet approprié. Selon le droit d'accès aux ressources activé, le portlet correspondant s'affiche avec le graphique d'état des commandes et le graphique de SLA côte à côte dans la version de bureau de l'application. Dans la version mobile de l'application, un lien s'affiche pour basculer entre les graphiques. Le portlet est masqué dans les cas où il serait redondant avec le portlet principal.

Le fichier manager-dashboard.json présent dans le dossier <WAR>/ngstore/store/views/home/manager-dashboard/ contient la configuration de la fonction. Il est utilisé par le service pour interroger la base de données et renvoyer le nombre de commandes correspondant à un état ou à un SLA particulier. Le fichier de configuration JSON permet d'agréger les états d'expédition et les SLA pour faciliter leur affichage dans l'interface utilisateur. Vous pouvez le configurer pour ajouter ou modifier des états en fonction de vos besoins métier.

Tableau 1. Mashups et services
Application composite	Fonction
`mgrdb_getCommonCodeListForSLA`	Extrait la liste de codes communs correspondant aux seuils de temps applicables à chaque catégorie de SLA. Appelle l'API `getCommonCodeList`.
`mgrdb_getDashboardPollingIntervalRuleDetails`	Cette application composite appelle l'API `getRuleDetails` et extrait l'intervalle d'actualisation du tableau de bord configuré dans Sterling Business Center.
`sfs_sla_getShipmentCountForGivenStatuses`	Extrait le nombre d'expéditions sous chaque catégorie de SLA définie dans le fichier `manager-dashboard.json` pour les commandes "Expédition depuis le magasin". Appelle le service `YCD_GetShipmentCountForStatusList`.
`sfs_orderstatus_getShipmentCountForGivenStatuses`	Extrait le nombre d'expéditions sous chaque catégorie d'état de commande définie dans le fichier `manager-dashboard.json` pour les commandes "Expédition depuis le magasin". Appelle le service `YCD_GetShipmentCountForStatusList`.
`bopus_sla_getShipmentCountForGivenStatuses`	Extrait le nombre d'expéditions sous chaque catégorie de SLA incluse dans le fichier `manager-dashboard.json` pour les commandes "Enlèvement en magasin". Appelle le service `YCD_GetShipmentCountForStatusList`.
`bopus_orderstatus_getShipmentCountForGivenStatuses`	Extrait le nombre d'expéditions sous chaque catégorie d'état de commande définie dans le fichier `manager-dashboard.json` pour les commandes "Enlèvement en magasin". Appelle le service `YCD_GetShipmentCountForStatusList`.

La logique suivante est exécutée pour afficher des informations sur le tableau de bord de gestionnaire.

Lorsque le tableau de bord de gestionnaire est lancé, les applications composites mgrdb_getCommonCodeListForSLA et mgrdb_getDashboardPollingIntervalRuleDetails sont agrégées et appelées ensemble. Cet appel n'est effectué qu'une fois par session et bloque l'interface utilisateur. Tant que le navigateur n'est pas actualisé, toute navigation ultérieure vers le tableau de bord de gestionnaire extrait la réponse mise en cache. Les données extraites pour les seuils SLA sont utilisées par les applications composites sfs_sla_getShipmentCountForGivenStatuses et bopus_sla_getShipmentCountForGivenStatuses pour appeler le service YCD_GetShipmentCountForStatusList en vue d'obtenir les données relatives au SLA.
Les applications composites sfs_sla_getShipmentCountForGivenStatuses et sfs_orderstatus_getShipmentCountForGivenStatuses sont agrégées et appelées par le portlet "Expédition depuis le magasin". Simultanément, les applications composites bopus_sla_getShipmentCountForGivenStatuses et bopus_orderstatus_getShipmentCountForGivenStatuses sont appelées à partir du portlet "Enlèvement en magasin". Ces deux appels ne bloquent pas l'interface utilisateur.
Lorsque le gestionnaire de magasin bascule entre le graphique de SLA et le graphique d'état des commandes, l'application composite appropriée est appelée.

Configuration JSON

Le fichier manager-dashboard.json contient la configuration utilisée par le tableau de bord de gestionnaire. Il contient la configuration des graphiques SLA et de statut des commandes séparés en fonction des méthodes d'exécution de commande Ramassage en magasin et Expédition depuis le magasin . Il fournit la configuration nécessaire aux objectifs suivants :

Regroupement des états d'expédition en trois états d'affichage pour une représentation visuelle conviviale.
Étiquettes et styles appliqués à l'interface utilisateur.

Tableau 2. Détails de la configuration
Attribut	Descriptif
`statusName`	Nom d'état.
`combinedStatusArray`	États à regrouper et à afficher sous `statusName`
`ui_chartConfig`	Configuration utilisée dans l'interface utilisateur pour afficher l'étiquette (`labelKey`) et la classe CSS (`cssClass`). `unitValueInnerPadding` et `radiusInnerPadding` sont utilisés par le graphique dans l'interface utilisateur.
`ui_chartId`	Cette valeur doit correspondre à l'identificateur DOM (Document Object Model) du graphique. Elle est utilisée pour définir la configuration du fichier JSON sur le graphique approprié.

La configuration du regroupement des commandes en fonction des SLA présente les différences suivantes

Tableau 3. Différences de configuration
Attribut	Descriptif
`combinedStatusArray`	Cet attribut contient la liste de descriptions (`shortDescription`) des SLA configurés dans Business Center. Les valeurs doivent rester inchangées et ne peuvent pas être globalisées.
`statusUIDefaults`	Si plusieurs états de SLA sont regroupés sous `combinedStatusArray`, les icônes et les styles applicables sont ceux configurés pour l'état mentionné dans le fichier.
`cssClass`	Cet attribut est facultatif. Sa valeur est automatiquement extraite de `statusUIDefaults`.
`shipmentStatusToExclude`	État d'expédition à exclure lors du calcul des numéros de SLA. Par défaut, cet attribut prend la valeur "Terminé" (`"statusName":"complete"`).

Remarques :

Le nombre d'expéditions dans les portlets inclut à la fois les expéditions d'ordre de transfert et de bon de commande.
Vous pouvez regrouper les différents états d'expédition sous les catégories complete, inProgress et notStarted. Par défaut, cette option est implémentée pour les commandes Ramassage en magasin et Expédition depuis le magasin pour la configuration shipmentStatus . En revanche, le regroupement de différentes catégories de SLA sous overdue, dueSoon et withinSLA est déconseillé.
Vous pouvez ajouter ou retirer des catégories dans les configurations sla et shipmentStatus. Cependant, le nombre de catégories et leur nom doivent rester inchangés sous shipFromStore et pickupInStore.
Pour les nouvelles catégories ajoutées sous sla, vous devez définir l'étiquette, la classe CSS et les icônes correspondantes. Sinon, les détails des valeurs par défaut s'affichent.
En outre, les catégories sla définies dans le fichier doivent être configurées pour l'organisation dans Sterling Business Center. Sinon, les graphiques ne s'affichent pas et un message indique que la configuration n'est pas valide.

Les codes d'état et les critères de regroupement sont décrits dans les tableaux suivants :

Tableau 4. Codes d'état
Code de statut	Descriptif
`1100.70.06.10`	Prêt pour prélèvement dans la réserve
`1100.70.06.20`	Prélèvement dans la réserve en cours
`1100.70.06.50`	Prêt pour emballage
`1100.70.06.70`	Expédition en cours d'emballage
`1100.70.06.30`	Prêt pour le client
`1400`	Expédition envoyée
`1300`	Emballé

Tableau 5. Critères de regroupement pour le statut de la commande
Statut de la commande	Critères de regroupement
Non démarré	Toutes les commandes ayant le statut `Ready For Backroom Pick` .
En cours	Toutes les commandes ayant le statut `Backroom Pick in Progress` Toutes les commandes Expédition depuis le magasin ayant le statut `Ready For Packing` Toutes les commandes Expédition depuis le magasin ayant le statut `Shipment Being Packed`
Opération terminée	Toutes les commandes Prélèvement en magasin à l'état `Ready For Customer` . Toutes les commandes ayant le statut `Shipment Shipped` . Toutes les commandes Expédition depuis le magasin ayant le statut `Packed` .

Tableau 6. Critères de regroupement pour l'ANS
accord sur les niveaux de service	Critères de regroupement
En retard	Le temps restant pour l'exécution de la commande est inférieur ou égal à 0 minute.
Échéance proche	Le temps restant pour l'exécution de la commande est inférieur ou égal à 30 minutes. Ce groupe inclut les commandes de priorité moyenne ou élevée.
Compris dans le SLA	Le temps restant pour l'exécution de la commande est supérieur à 30 minutes.

Les critères de regroupement mentionnés ici sont basés sur les données d'implémentation de référence fournies pour l'organisation par défaut. De même, vous pouvez configurer les critères de regroupement SLA de votre organisation à l'aide de la configuration des indicateurs de niveau de service dans Sterling Business Center.

Personnalisation des icônes SLA

Configurez les indicateurs de niveau de service pour la priorité SLA à l'aide de Sterling Business Center. Pour plus d'informations, voir Configuration des indicateurs de niveau de service.
Le chemin et l'extension des images de SLA sont tronqués ; le nom d'image est utilisé comme nom de classe CSS pour définir la couleur des icônes de priorité de SLA. Par exemple, dans le chemin wsc/resources/css/icons/images/timeLeftOverdue.png, timeLeftOverdue devient le nom de classe CSS ; la couleur de l'icône peut être définie comme suit : .timeLeftOverdue{color:#DD1D32!important;fill:#DD1D32!important}
Pour définir des formes pour les icônes SLA, reportez-vous à la procédure de la rubrique Remplacement des icônes de police existantes . Cependant, lors de l'exécution de cette procédure, vous devez modifier le code en fonction des icônes à remplacer. Par exemple, pour l'icône timeLeftOverdue , vous pouvez avoir le code .app-icon-timeLeftOverdue{...}.

Paramètres régionaux pour la configuration de SLA : lorsque vous changez de paramètres régionaux de base de données, vérifiez les changements suivants :

La configuration de SLA dans le fichier manager-dashboard.json se trouve dans les paramètres régionaux de base de données.
Les zones combinedStatusArray et statusUIDefaults concordent.
Par défaut, les zones contiennent des entrées pour les paramètres régionaux de base de données en anglais (paramètres régionaux de base). Si les paramètres régionaux de base de données sont dans une langue, les entrées suivantes doivent être remplacées par les littéraux des paramètres régionaux de base de données dans le fichier manager-dashboard.json :
```
Time Left Overdue
Time Left High Priority
Time Left Medium Priority
Time Left Low Priority
```

Considérations :

Les graphiques d'état des commandes et les graphiques de SLA ne sont générés que pour les bons de commande.
Pour calculer le nombre de commandes ayant le statut Not Started et In Progress , les commandes de la journée en cours et les commandes en attente de la journée précédente sont prises en compte.
Pour calculer le nombre de commandes ayant le statut Completed , les commandes terminées qui appartiennent à la date en cours ou à une date future sont prises en compte.
Les valeurs 0h00 et 23h59 sont considérées, respectivement, comme le début et la fin d'une journée.
Les données du tableau de bord sont automatiquement mises à jour toutes les 5 minutes par défaut et l'intervalle de temps peut être configuré dans Sterling Business Center.

Important: Une commande peut avoir plusieurs expéditions ou plusieurs commandes peuvent se trouver dans une seule expédition. Pour l'essentiel, les applications composites utilisées dans cette fonction extraient uniquement des expéditions. Cependant, en utilisant les expéditions renvoyées par les applications composites, l'application fournit des informations en termes de détails de commande correspondants pour aider les utilisateurs finaux.

Affichage des expéditions

Dans le portlet Expédition depuis le magasin ou Prélèvement depuis le magasin , lorsque l'utilisateur clique sur une icône de légende ou sur une région du graphique Statut de la commande ou du graphique SLA, une combinaison d'applications composites est appelée, qui à son tour appelle un service.

Tableau 7. Les mashups et leurs fonctions
Applications composites	Fonction
`shipmentList_getShipmentListByStatus_sla`	Extrait la liste d'expéditions pour le mode de livraison requis pour le SLA. Appelle l'API `getShipmentList`.
`shipmentList_getShipmentListByStatus_orderstatus`	Extrait la liste d'expéditions pour le mode de livraison requis pour l'état de la commande. Appelle l'API `getShipmentList`.
`sla_getShipmentCountForGivenStatuses`	Extrait le nombre d'expéditions sous chaque catégorie de SLA définie dans le fichier `manager-dashboard.json` pour les commandes "Expédition depuis le magasin" ou "Enlèvement en magasin". Appelle le service `YCD_GetShipmentCountForStatusList`.
`orderstatus_getShipmentCountForGivenStatuses`	Extrait le nombre d'expéditions sous chaque catégorie d'état de commande définie dans le fichier `manager-dashboard.json` pour les commandes "Expédition depuis le magasin" ou "Enlèvement en magasin". Appelle le service `YCD_GetShipmentCountForStatusList`.

La page Liste des expéditions est chargée ; les deux applications composites suivantes sont agrégées et appelées selon que l'utilisateur clique sur le graphique de SLA ou sur le graphique d'état des commandes :

Si l'utilisateur clique sur le graphique de SLA, les applications composites shipmentList_getShipmentListByStatus_sla et sla_getShipmentCountForGivenStatuses sont agrégées et appelées.
Si l'utilisateur clique sur le graphique d'état des commandes, les applications composites shipmentList_getShipmentListByStatus_orderstatus et orderstatus_getShipmentCountForGivenStatuses sont agrégées et appelées.

L'une des applications composites dresse la liste des expéditions et l'autre indique le nombre total d'expéditions (affiché sur les onglets de chaque catégorie).

La navigation entre les onglets correspondant à la catégorie d'état des commandes ou à la catégorie de SLA appelle l'application composite appropriée, selon que l'utilisateur arrive sur la page Liste des expéditions à partir du graphique de SLA ou du graphique d'état des commandes.

Remarque: La liste des expéditions affichée dans les différents onglets pour la priorité SLA ou le statut de la commande inclut à la fois les expéditions de bon de commande et d'ordre de transfert.

Détails spécifiques aux périphériques

Le tableau de bord de gestionnaire est affichable dans la version de bureau et dans la version mobile de l'application.

Implémentation

La section suivante décrit les règles que vous devez configurer.

Un utilisateur de magasin doit disposer des droits d'accès aux ressources Manager Dashboard Pickup in Store Portlet et Manager Dashboard Ship from Store Portlet . Pour plus d'informations sur la gestion des autorisations des groupes d'utilisateurs, voir la section Gestion des autorisations des groupes d'utilisateurs.
Configurez les indicateurs du niveau de service de manière appropriée. Pour plus d'informations, voir Configuration des indicateurs de niveau de service
Le tableau de bord du gestionnaire est actualisé en fonction de l'intervalle d'interrogation configuré dans Sterling Business Center. Pour plus d'informations, voir Configuration de l'intervalle d'interrogation.