Manager-Dashboard anzeigen

Lösung

Im folgenden Abschnitt werden APIs, Benutzerexits, Services und weitere Komponenten beschrieben.

Die Manager-Dashboard-Ansicht kann über die Startseite der Anwendung über das Augensymbol gestartet werden. Das Manager-Dashboard stellt die Gesamtzahl der Bestellungen, Auftragsstatusdiagramme, SLA-Diagramme usw. bereit. Das Dashboard wird wie folgt bestückt:

Es werden Mashups aufgerufen, über die jedes Portlet im Dashboard mit Daten bestückt wird. Zum Aufrufen eines Services, durch den SLA-Diagramm und Auftragsstatusdiagramm bestückt werden, werden mehrere Mashups nebeneinander angezeigt und zu einem einzigen Aufruf an den Server zusammengefasst. Basierend auf den Eingabeparametern aus dem Mashup fragt der Service die Datenbank für Versand aus Geschäft oder Abholung aus Geschäft -Bestellungen und die angeforderten Bestellstatus ab.
Ein Geschäft kann nur Aufträge vom Typ Abholung im Geschäft oder Aus Geschäft versenden verarbeiten. In diesen Fällen kann für die Geschäftsbenutzergruppe für den Zugriff auf das passende Portlet die erforderliche Ressourcenberechtigung aktiviert werden. Je nach aktivierter Ressourcenberechtigung wird das entsprechende Portlet in der Desktopgeräteversion der Anwendung mit nebeneinander angeordneten Auftragsstatus- und SLA-Diagrammen angezeigt. In der Mobilgeräteversion der Anwendung wird ein Link zum Umschalten zwischen den Diagrammen angezeigt. Das Portlet ist in solchen Fällen ausgeblendet, da es mit dem Hauptportlet redundant wäre.

Die Datei manager-dashboard.json present im Ordner <WAR>/ngstore/store/views/home/manager-dashboard/ enthält die Konfiguration für das Feature. Sie wird vom Service dazu verwendet, eine Abfrage an die Datenbank zu richten und die Anzahl der Aufträge zurückzumelden, die einem bestimmten Auftragsstatus oder SLA entsprechen. Die JSON-Datei der Konfiguration dient der Zusammenfassung der verschiedenen Versandstatus und SLAs, sodass eine einfachere Darstellung in der Benutzerschnittstelle möglich ist. Sie ist konfigurierbar, daher können Sie entsprechend den Geschäftsanforderungenen Status hinzufügen oder ändern.

Tabelle 1. Mashups und Service
Mashup	Funktion
`mgrdb_getCommonCodeListForSLA`	Ruft die Liste allgemeiner Codes ab, die den zeitlichen Schwellenwerten für die verschiedenen SLA-Kategorien entsprechen. Ruft die API `getCommonCodeList` auf.
`mgrdb_getDashboardPollingIntervalRuleDetails`	Dieses Mashup ruft die API `getRuleDetails` auf und ruft das Aktualisierungsintervall für Dashboards ab, das in Sterling Business Centerkonfiguriert ist.
`sfs_sla_getShipmentCountForGivenStatuses`	Ruft für Aufträge des Typs "Aus Geschäft versenden" zu jeder SLA-Kategorie in der Datei `manager-dashboard.json` die Anzahl der Sendungen ab. Ruft den Service `YCD_GetShipmentCountForStatusList` auf.
`sfs_orderstatus_getShipmentCountForGivenStatuses`	Ruft für Aufträge des Typs "Aus Geschäft versenden" zu jeder "Auftragsstatus"-Kategorie in der Datei `manager-dashboard.json` die Anzahl der Sendungen ab. Ruft den Service `YCD_GetShipmentCountForStatusList` auf.
`bopus_sla_getShipmentCountForGivenStatuses`	Ruft für Aufträge des Typs "Abholung im Geschäft" zu jeder SLA-Kategorie in der Datei `manager-dashboard.json` die Anzahl der Sendungen ab. Ruft den Service `YCD_GetShipmentCountForStatusList` auf.
`bopus_orderstatus_getShipmentCountForGivenStatuses`	Ruft für Aufträge des Typs "Abholung im Geschäft" zu jeder "Auftragsstatus"-Kategorie in der Datei `manager-dashboard.json` die Anzahl der Sendungen ab. Ruft den Service `YCD_GetShipmentCountForStatusList` auf.

Die folgende Logik wird ausgeführt, um Informationen zum Manager-Dashboard anzuzeigen:

Wenn das Manager-Dashboard gestartet wird, werden die Mashups mgrdb_getCommonCodeListForSLA und mgrdb_getDashboardPollingIntervalRuleDetails zusammengefasst und zusammen aufgerufen. Der Aufruf erfolgt nur einmal pro Sitzung, wobei die Benutzerschnittstelle blockiert wird. Jede danach durchgeführte Navigation zum Manager-Dashboard übernimmt so lange die im Cache gespeicherte Antwort, bis der Browser aktualisiert wird. Die für SLA-Schwellenwerte abgerufenen Daten werden von den Mashups sfs_sla_getShipmentCountForGivenStatuses und bopus_sla_getShipmentCountForGivenStatuses dazu verwendet, den Service YCD_GetShipmentCountForStatusList aufzurufen, um die SLA-relevanten Daten abzurufen.
sfs_sla_getShipmentCountForGivenStatuses und sfs_orderstatus_getShipmentCountForGivenStatuses werden zusammengefasst und vom Portlet "Aus Geschäft versenden" aufgerufen. Gleichzeitig werden die Mashups bopus_sla_getShipmentCountForGivenStatuses und bopus_orderstatus_getShipmentCountForGivenStatuses vom Portlet "Abholung im Geschäft" aufgerufen. Bei diesen beiden Aufrufen wird die Benutzerschnittstelle nicht blockiert.
Wenn sich der Geschäftsmanager dazu entschließt, zwischen SLA-Diagramm und Auftragsstatusdiagramm umzuschalten, wird eines der passenden Mashups aufgerufen.

JSON-Konfiguration

In der Datei manager-dashboard.json ist die vom Manager-Dashboard verwendete Konfiguration enthalten. Sie enthält die Konfiguration für SLA-und Auftragsstatusdiagramme, die nach den Auftragsausführungsmethoden Im Geschäft abholen und Aus Geschäft versenden getrennt sind. Die Datei stellt die Konfiguration für folgende Zwecke bereit:

Gruppierung der verschiedenen Versandstatus in drei Anzeigestatus zwecks einfacher grafischer Darstellung
Etiketten und Stile, die auf die Benutzerschnittstelle angewendet werden

Tabelle 2. Details zur Konfiguration
Attribut	Beschreibung
`statusName`	Name des Status.
`combinedStatusArray`	Mehrere Status zum Gruppieren und Anzeigen unter `statusName`.
`ui_chartConfig`	Konfiguration zur Verwendung in der Benutzerschnittstelle zum Anzeigen von Etikett (`labelKey`) und CSS (`cssClass`). `unitValueInnerPadding` und `radiusInnerPadding` werden vom Diagramm in der Benutzerschnittstelle verwendet.
`ui_chartId`	Muss der DOM-ID für das Diagramm entsprechen. Wird dazu verwendet, die JSON-Konfiguration auf das korrekte Diagramm einzustellen.

Die Konfiguration zum Gruppieren von Aufträgen auf Basis von SLA ist in folgenden Punkten anders:

Tabelle 3. Unterschiede in der Konfiguration
Attribut	Beschreibung
`combinedStatusArray`	Enthält die Liste der Beschreibungen (`shortDescription`) für die konfigurierten SLAs in Business Center. Müssen immer gleich bleiben und können nicht globalisiert werden.
`statusUIDefaults`	Für den Fall, dass unter `combinedStatusArray` mehrere SLA-Status zusammen gruppiert werden, werden die Symbole und Stile übernommen, die für den in der Datei erwähnten Status konfiguriert wurden.
`cssClass`	Nicht erforderlich. Wird automatisch aus `statusUIDefaults` übernommen.
`shipmentStatusToExclude`	Dies ist der Versandstatus, der während der Verarbeitung von SLA-Nummern nicht berücksichtigt werden sollte. Standardmäßig erfolgt hier ein Wechsel zu `"statusName":"complete"`.

Hinweise:

Die Anzahl der Sendungen in den Portlets umfasst sowohl die Sendungen für Vertriebsaufträge als auch die Sendungen für Transferaufträge.
Sie können verschiedene Versandstatus in den Kategorien complete, inProgress und notStarted gruppieren. Standardmäßig wird dies für die Konfiguration von Abholung im Geschäft und Versand aus Geschäft für shipmentStatus implementiert. Allerdings wird von einer Gruppierung verschiedener SLA-Kategorien unter overdue, dueSoon und withinSLA abgeraten.
Sie können Kategorien zu sla- und shipmentStatus-Konfigurationen hinzufügen oder daraus entfernen. Allerdings müssen die Anzahl der Kategorien und deren Namen unter shipFromStore und pickupInStore gleich sein.
Für die neuen unter sla hinzugefügten Kategorien müssen Sie jeweils Etikett, CSS und Symbole definieren. Ansonsten werden die Standarddetails angezeigt.
Darüber hinaus müssen die in der Datei definierten sla -Kategorien für die Organisation in Sterling Business Centerkonfiguriert werden. Ansonsten werden die Diagramme nicht angezeigt, und es wird eine Nachricht wegen ungültiger Konfiguration angezeigt.

Statuscodes und Gruppierungskriterien werden in den folgenden Tabellen beschrieben:

Tabelle 4. Status-Codes
Statuscode	Beschreibung
`1100.70.06.10`	Bereit für Warenlagerentnahme
`1100.70.06.20`	Warenlagerentnahme in Bearbeitung
`1100.70.06.50`	Bereit zum Verpacken
`1100.70.06.70`	Sendung wird verpackt
`1100.70.06.30`	Bereit für den Kunden
`1400`	Sendung versandt
`1300`	Gepackt

Tabelle 5. Gruppierungskriterien für den Auftragsstatus
Auftragsstatus	Gruppierungskriterien
Nicht gestartet	Alle Bestellungen im Status `Ready For Backroom Pick` .
In Bearbeitung	Alle Bestellungen im Status `Backroom Pick in Progress` Alle Bestellungen Aus Geschäft versenden im Status `Ready For Packing` Alle Bestellungen Aus Geschäft versenden im Status `Shipment Being Packed`
Abgeschlossen	Alle Bestellungen vom Typ Abholung im Geschäft im Status `Ready For Customer` . Alle Bestellungen im Status `Shipment Shipped` . Alle Aufträge Aus Geschäft versenden im Status `Packed` .

Tabelle 6: Gruppierungskriterien für SLA
SLA (Service Level Agreement)	Gruppierungskriterien
Überfällig	Die verbleibende Zeit für den Auftragsabschluss beträgt 0 Minuten oder weniger.
Bald fällig	Die verbleibende Zeit für die Auftragsausführung beträgt 30 Minuten oder weniger. Zu dieser Gruppe gehören Aufträge mittlerer und hoher Priorität.
Innerhalb SLA	Die verbleibende Zeit für den Auftragsabschluss beträgt mehr als 30 Minuten.

Die hier erwähnten Gruppierungskriterien basieren auf den für die Standardorganisation bereitgestellten Referenzimplementierungsdaten. Ebenso können Sie die SLA-Gruppierungskriterien für Ihre Organisation mithilfe der Konfiguration von Service-Level-Indikatoren in Sterling Business Centerkonfigurieren.

SLA-Symbole anpassen

Konfigurieren Sie Service-Level-Indikatoren für SLA-Priorität mithilfe von Sterling Business Center. Weitere Informationen finden Sie unter Service-Level-Indikatoren konfigurieren.
Pfad und Erweiterung der SLA-Images werden abgeschnitten, und der Imagename wird beim Definieren der Farbe für die SLA-Prioritätssymbole als CSS-Klassenname verwendet. So witd z. B. im Pfad wsc/resources/css/icons/images/timeLeftOverdue.png aus timeLeftOverdue der CSS-Klassenname, und die Farbe für das Symbol kann wie folgt definiert werden: .timeLeftOverdue{color:#DD1D32!important;fill:#DD1D32!important}
Informationen zum Definieren von Formen für die SLA-Symbole finden Sie im Abschnitt Vorhandene Schriftartsymbole ersetzen . Auf jeden Fall müssen Sie bei dieser Vorgehensweise den Code in Übereinstimmung mit den zu ersetzenden Symbolen ändern. Für das Symbol timeLeftOverdue könnte der Code beispielsweise .app-icon-timeLeftOverdue{...}sein.

Ländereinstellung für SLA-Konfiguration: Wenn Sie die DB-Ländereinstellung wechseln, müssen Sie für folgende Änderungen sorgen:

Stellen Sie sicher, dass die SLA-Konfiguration in der Datei manager-dashboard.json der DB-Ländereinstellung entspricht.
Stellen Sie sicher, dass die Felder combinedStatusArray und statusUIDefaults übereinstimmen.
Standardmäßig enthalten die Felder Einträge für die englische DB-Ländereinstellung (die Basis-Ländereinstellung). Wenn die Basis-DB-Ländereinstellung einer anderen Sprache entspricht, müssen die folgenden Einträge in der Datei manager-dashboard.json in Basis-Ländereinstellungs-Literale geändert werden:
```
Time Left Overdue
Time Left High Priority
Time Left Medium Priority
Time Left Low Priority
```

Hinweise:

Auftragsstatus- und SLA-Diagramme werden nur für Vertriebsaufträge generiert.
Um die Anzahl der Bestellungen im Status Not Started und In Progress zu berechnen, werden Bestellungen des aktuellen Tages und Bestellungen mit Rückstand vom vorherigen Tag berücksichtigt.
Um die Anzahl der Bestellungen im Status Completed zu berechnen, werden abgeschlossene Bestellungen berücksichtigt, die zum aktuellen Datum oder einem Datum in der Zukunft gehören.
00:00 und 23:59 werden als Tagesanfang und -ende verwendet.
Daten im Dashboard werden standardmäßig alle 5 Minuten automatisch aktualisiert und das Zeitintervall kann in Sterling Business Centerkonfiguriert werden.

Wichtig: Ein Auftrag kann mehrere Sendungen haben oder mehrere Aufträge können in einer einzigen Sendung enthalten sein. Grundsätzlich werden von den in diesem Feature verwendeten Mashups nur Sendungen abgerufen. Unter Verwendung der von den Mashups zurückgemeldeten Sendungen stellt die Anwendung zwecks Benutzerkomfort Informationen in Form entsprechender Auftragsdetails bereit.

Sendungen anzeigen

Wenn der Benutzer im Portlet Aus Geschäft versenden oder im Portlet Aus Geschäft abholen auf ein Legendensymbol oder eine Region im Diagramm "Auftragsstatus" oder SLA-Diagramm klickt, wird eine Kombination von Mashups aufgerufen, die wiederum einen Service aufruft.

Tabelle 7: Mashups und ihre Funktionen
Mashups	Funktion
`shipmentList_getShipmentListByStatus_sla`	Ruft die Liste der Sendungen für das für SLA erforderliche Lieferverfahren ab. Ruft die API `getShipmentList` auf.
`shipmentList_getShipmentListByStatus_orderstatus`	Ruft die Liste der Sendungen für das für den Auftragsstatus erforderliche Lieferverfahren ab. Ruft die API `getShipmentList` auf.
`sla_getShipmentCountForGivenStatuses`	Ruft für Aufträge des Typs "Aus Geschäft versenden" oder "Abholung im Geschäft" zu jeder in der Datei `manager-dashboard.json` definierten SLA-Kategorie die Anzahl der Sendungen ab. Ruft den Service `YCD_GetShipmentCountForStatusList` auf.
`orderstatus_getShipmentCountForGivenStatuses`	Ruft für Aufträge des Typs "Aus Geschäft versenden" oder "Abholung im Geschäft" zu jeder "Auftragsstatus"-Kategorie in der `manager-dashboard.json` die Anzahl der Sendungen ab. Ruft den Service `YCD_GetShipmentCountForStatusList` auf.

Je nachdem, ob vom Benutzer das SLA- oder das Auftragsstatusdiagramm angeklickt wurde, wird die Seite mit der Versandliste geladen, und es werden zwei Mashups zusammengefasst und wie folgt aufgerufen:

Wenn das SLA-Diagramm angeklickt wird, werden die Mashups shipmentList_getShipmentListByStatus_sla und sla_getShipmentCountForGivenStatuses zusammengefasst und aufgerufen.
Wenn das Auftragsstatusdiagramm angeklickt wird, werden die Mashups shipmentList_getShipmentListByStatus_orderstatus und orderstatus_getShipmentCountForGivenStatuses zusammengefasst und aufgerufen.

Von einem Mashup wird die Liste der Sendungen bereitgestellt, das andere Mashup sorgt für die Gesamtzahl an Sendungen, dargestellt als Ziffer auf den Registerkarten der verschiedenen Kategorien.

Analog dazu, ob der Benutzer die Seite mit der Versandliste über das SLA-Diagramm oder das Auftragsstatusdiagramm erreicht hat, wird durch die Navigation zwischen den Registerkarten (für die Kategorien Status oder SLA) das entsprechende Mashup aufgerufen.

Hinweis: Die Liste der Sendungen, die auf verschiedenen Registerkarten für die SLA-Priorität oder den Auftragsstatus angezeigt werden, enthält sowohl Lieferungen für Verkaufsaufträge als auch für Transferaufträge.

Gerätespezifische Details

Das Manager-Dashboard kann sowohl über die Desktop- als auch über die Mobilgeräteversion der Anwendung angezeigt werden.

Bereitstellung

Im folgenden Abschnitt sind die Regeln beschrieben, die Sie konfigurieren müssen.

Ein Geschäftsbenutzer sollte über die Ressourcenberechtigungen Manager Dashboard Pickup in Store Portlet und Manager Dashboard Ship from Store Portlet verfügen. Informationen zur Verwaltung von Benutzergruppenberechtigungen finden Sie im Abschnitt Verwalten von Benutzergruppenberechtigungen.
Konfigurieren Sie die Service-Level-Indikatoren entsprechend. Weitere Informationen finden Sie unter Service-Level-Indikatoren konfigurieren .
Das Manager-Dashboard wird basierend auf dem in Sterling Business Centerkonfigurierten Abfrageintervall aktualisiert. Weitere Informationen finden Sie unter Konfiguration des Abfrageintervalls.