B2B Administrator Benutzer

Diese Dokumentation ist für einen Admin-Benutzer bestimmt.

Rollen

Für die Module des B2B-Message-Monitors sind die folgenden Rollen erforderlich:

• B2B-MessageMonitor-Read: Diese Rolle ist erforderlich, um Zugriff auf die Seite des Nachrichtenmonitors zu erhalten, wie unten dargestellt. Diese Rolle ist auch erforderlich, um Daten von Nachrichten und Arbeitsvorräten zu erhalten.

• B2B-MessageMonitor-TechnicalDetails: Diese Rolle ist erforderlich, um Zugriff auf die Registerkarte Technische Details zu erhalten, wenn ein Benutzer auf eine bestimmte Nachricht klickt.

• B2B-MessageMonitor-Write: Diese Rolle ist für den schreibenden Zugriff erforderlich, um zum Beispiel den Tabelle anpassen, die Statusänderung und direkte Neustart-Aktionen durchzuführen zu können, den CSV / ZIP Download. Siehe Screenshot unten.

Mandanten

Die Mandantenfilterung kann im Nachrichtenmonitor vorgenommen werden, indem das Benutzerattribut in der Keycloak-Benutzerkonfiguration eingerichtet wird.

Wenn das Attribut “tenants” vorhanden ist, werden die Daten im Meldungsmonitor auf ein bestimmtes System beschränkt, das an diesen Mandanten gebunden ist. Die Zuordnung von Mandante zu System wird in den Extentions vorgenommen. Der Extensionname ist “TENANTS” und die Konfiguration erfolgt wie folgt.

Beispielwerte der Zuordnung von Mandanten zu System in der Extension:

• GRID=990077000002
• SUPPLIER=9912345678798094,9912345678798095,9912345678798096

Wie Sie oben sehen können, können einem Mandanten mehrere Systeme durch ein Komma zugeordnet werden. Werfen wir nun einen Blick auf die Anwendungsfälle

Die tenants = all können als Attribut verwendet werden, wenn der Benutzer auf alle Systeme zugreifen muss. Wenn der Benutzer ein Attribut als Tenants = all gesetzt hat, kann er alle Nachrichten in der B2B-UI für alle Systeme sehen. Ein Beispiel finden Sie im folgenden Screenshot

Benutzerattribut in keycloak wird als tenants = all gesetzt

In dem Screenshot unten sehen Sie, dass auf dem Nachrichtenmonitor Nachrichten von mehreren Mandanten angezeigt werden

Jetzt können Sie das Attribut so ändern, dass es nur für einen Mandanten gilt: tenants = GRID

In diesem Fall wird die Extension TENANTS als GRID=990077000002 festgelegt. Sobald also der Mieter auf den Wert GRID eingestellt ist, werden die Daten im Nachrichtenmonitor nur noch auf das System 990077000002 beschränkt.

Wie in der Bildschirmkopie unten zu sehen ist, sind die Nachrichten jetzt auf einen einzigen Mandanten beschränkt (die Filter für den Datumsbereich, die für beide Fälle verwendet wurden, waren dieselben).

Nehmen wir nun ein weiteres Beispiel, bei dem wir den tenant = SUPPLIER festlegen

In diesem Fall wird die Extension TENANTS als SUPPLIER=9912345678798094,9912345678798095, 9912345678798096. festgelegt. Wenn der Mandant einmal auf den Wert SUPPLIER eingestellt ist, sind die Daten im Nachrichtenmonitor daher nur auf die Systeme “9912345678798094, 991234567878798095 und 9912345678798096” beschränkt.

Wie im SCreenshot unten zu sehen ist, ist das Filtersystem jetzt auf drei Mandanten mit den Systemen 9912345678798094, 9912345678798095, 991234567879898096 beschränkt

Endbenutzer

Dieser Teil der Dokumentation ist für die Endbenutzer bestimmt.

Startseite des Message Monitors

Den Messagemonitor finden Sie im Menü auf der linken Seite, wie in der Abbildung unten dargestellt.

Alle Nachrichten können hier überwacht werden. Sie können gefiltert, für weitere Details angeklickt und heruntergeladen werden.

Filters

Die Filter können verwendet werden, um anhand verschiedener Kriterien und Kombinationen nach bestimmten Nachrichten zu suchen.

Filter-Schaltfläche

Alle Filter anzeigen

Die Schaltfläche Alle Filter anzeigen kann angeklickt werden, um alle verfügbaren Filter anzuzeigen.

Suche

Nachdem alle Daten in den Filtern ausgewählt wurden, kann die Schaltfläche Suchen angeklickt werden, um die Daten zu laden.

Filter zurücksetzen

Um die Filter zurücksetzen kann der Reset Knopf angeklickt werden, um jede Auswahl in den Filter zu löschen und neu zu beginnen.

Verfügbare Filter

Alle verfügbaren Filter die zur Eingrenzung der Suche nach Nachrichten möglicherweise zur verfügung stehen, sind im folgenden Screenshot dargestellt.

All Filters

Regex Filter

Alle Text-basierten Filter unterstützen die folgende erweiterte Syntax:

• logisches OR Trennen sie unterschiedliche Suchbegriffe mit einem Leerzeichen. Beispiel: 54321 123345
• Platzhalter Sie können den Stern * als Platzhalter verwenden. Beispiel: 99*
• logisches NOT Stellen Sie ein ! voran, wenn alles außer dem Suchbegriff gefunden werden soll. Beispiel: !OUT_ISU

Die Filter nach System & Channel unterstützen sowohl die erweiterte Syntax als auch die Auswahl über eine Dropdown-Liste.

Mit dem März Release unterstützt der System Filter noch nicht das logische NOT.

Volltextsuche im Nachrichtenmonitor

Volltextsuche im Nachrichtenmonitor

Bei der Volltextsuche im B2B-Nachrichtenmonitor können folgende Regeln angewendet werden:

• Zwischen Groß- und Kleinbuchstaben wird nicht unterschieden.

• Alle Sonderzeichen werden intern durch Leerzeichen ersetzt, um dem Format der Daten im Suchindex zu entsprechen. Die Sonderzeichen sind alle Zeichen, die keine Buchstaben oder Zahlen sind.

• Die Ausdrücke können mit einem Sonderzeichen (z.B. +) zwischen den Wörtern gebildet werden.
  • Beispiel: Mit Aachener+Str. findet man den Ausdruck “Aachener Str.”

• Die Suche nach dem exakten Edifact-Segment funktioniert deswegen auch: AGR+E03:E10’

• Zur Kombination zweier Begriffe stehen logische Operatoren AND, OR und NOT zur Verfügung. Sie müssen groß geschrieben werden.
  • Beispiel: UTILMD AND E35, UTILMD AND STS+7++E01, UTILMD OR MSCONS
• Das Leerzeichen zwischen Begriffen wird als der Operator OR ausgewertet
  • Beispiel: 9800033300008 9900033300008 9800033300007 findet die Nachrichten mit diesen ILNs
• Der Operator NOT muss mit mindestens einem anderen Suchbegriff verwendet werden.
  • Beispiel: CONTRL NOT 2.0
• Die Wildcards * und ? werden bei der Suche nach den einzelnen Begriffen ausgewertet. * steht für keins oder beliebig viele Zeichen, ? steht für genau ein Zeichen.
  • Beispiel: Aachen, 9?00055500006, Andrea? Michae, CONTR? AND UTILM?, BGM+7 AND Reklamation*
• Die Wildcards funktionieren nicht mit Ausdrücken oder in Begriffen mit Sonderzeichen (die werden als Ausdruck interpretiert).
  • Nicht korrekte Beispiele: Aachen+Str., AGR+E03:E
• Die Wildcards dürfen nicht am Anfang des Suchbegriffs stehen.
  • Nicht korrektes Beispiel: *52844147

Das Filtern und Durchsuchen von Nachrichten über URL wird ebenfalls unterstützt. Weitere Einzelheiten finden Sie unter diesem Link: link

Nachrichten in Datentabelle

Datentabellen-Spalten

VS Processing Status

Icon	Status	Code
	Erfolgreich	SUC
	Fehlerhaft	ERR
	Läuft	RUN
	AS4-Versandrückmeldung ausstehend	A4P
	In der Queue	QUE
	Manuell beendet	MAN
	Fehlende Referenz für Nachricht	OVR
	Ausgehender Validierungsfehler APERAK	OVA
	Ausgehender Validierungsfehler CONTRL	OVC
	Archiviert	ARC
	In Archivierung	ARP, ADP, AIP
	Archivierungsfehler	ARF

BS Processing Status

Icon	Status	Code
	Erfolgreich (Positive CONTRL)	CTP
	Fehlerhaft (Negative CONTRL)	CTE
	CONTRL ausstehend	CTW
	CONTRL nicht fristgerecht	CTN
	APERAK: Negativ	APC
	APERAK: Positiv	APP
	Manuell beendet	MAN
	Positive MDN/AS4 Receipt	MSU
	Negative MDN/AS4 Receipt	MER
	Erinnerungsmail für fehlende CONTRL gesendet	SEN
	ERP erfolgreich	SSU
	ERP ausstehend	SWA
	ERP fehlerhaft	SER

APP und APC bedeutet in diesem Fall, dass dies auch nur partiell auf die Nachricht zutreffen kann.

APC bedeutet somit, dass mindestens ein Vorgang aus der Nachricht mit einer negativen APERAK beantwortet wurde. Andere Vorgänge können eine positive oder keine APERAK erhalten haben.

APP bedeutet, dass mindestens ein Vorgang mit einer positiven APERAK beantwortet wurde und die restlichen Vorgänge keine APERAK erhalten haben.

APC überschreibt somit den Status APP.

SAP-Status-Synchronisierung

Dynamischer externer Link

Am Frontend wird der ISU-Synchronisationsstatus als BS-Statussymbol angezeigt. Wenn der BS-Status SSU, SWA oder SER ist, kann der Benutzer auf das BS-Status-Symbol klicken. Es wird ein Fenster geöffnet, das die Statushistory anzeigt.

Die Daten im Dialogfeld basieren auf der Konfiguration der Extension EXTERNAL_LINK_METADATA. Wenn ein Benutzer auf den externen Link klickt, wird eine extLink-Datei heruntergeladen. Diese Datei leitet den Benutzer auf das ISU-System um.

Um den dynamischen externen Link zu konfigurieren, besuchen Sie diesen Link

Notwendige Konfigurationsanpassungen

Für B2B-UI

• Fügen Sie in system.json die b2bUrl hinzu, z. B.

  "b2bUrl"="http://mycompany.de/b2bbp-engine"

• Stellen Sie in Keycloak sicher, dass diese Url als redirectUrl des b2b-tomcat-Clients bereitgestellt wird.

Schaltflächen der Werkzeugleiste

Diese Schaltflächen können zum Neustart, zur Statusänderung oder zum Herunterladen von Nachrichten verwendet werden

Direkter Neustart

Nach der Auswahl einer Nachricht durch Klicken auf die Schaltfläche des Kontrollkästchens kann der Benutzer die Nachricht durch Klicken auf die Schaltfläche “Neustart” neu starten (siehe Screenshot unten).

Status ändern

Nach der Auswahl einer Nachricht durch Klicken auf die Schaltfläche des Kontrollkästchens kann der Benutzer den Status der Nachricht durch Klicken auf die Pfeiltaste ändern (siehe Bildschirmfoto unten).

Nachdem Sie auf die Pfeiltaste zum Ändern des Status geklickt haben, öffnet sich ein Pop-up-Fenster:

Der Benutzer kann Folgendes einstellen: Clearing-Code unter Verwendung der Text- oder Dropdown-Option (obligatorisch).

“Clearing-Code” sucht nur nach Code. Die Dropdown-Liste wird erst angezeigt, wenn der gesamte Text im Textfeld “Clearing-Code” manuell gelöscht wurde

Kurzer Text: Kurztext einfügen (obligatorisch)

Langtext: Einen Langtext einfügen (optional)

Die Clearing History kann hier eingesehen werden.

Fahren Sie fort, den Statuscode zu ändern, indem Sie auf Speichern klicken.

Hinweis: Eine Nachricht in einem erfolgreichen Zustand kann nicht direkt neu gestartet werden. Sie muss vor dem Neustart in einen anderen Zustand geändert werden, wie Sie im folgenden Screenshot sehen können, dass die Schaltfläche “Direkter Neustart” für die ausgewählte Nachricht, die sich im erfolgreichen Zustand befindet, deaktiviert ist.

CSV herunterladen

Der Benutzer kann auf die Download-Schaltfläche klicken, wie im Screenshot oben gezeigt, um alle Nachrichten im CSV-Format herunterzuladen. Es werden alle Nachrichten heruntergeladen, die derzeit gefiltert sind, einschließlich der Nachrichten auf den nächsten Seiten.

Edifact Zip herunterladen

Der Benutzer kann auf die Schaltfläche Download als Zip klicken, wie im obigen Screenshot gezeigt, um alle Nachrichten als Zip herunterzuladen. Es werden alle Nachrichten heruntergeladen, die derzeit gefiltert sind, einschließlich der Nachrichten auf den nächsten Seiten. Wenn der Benutzer eine oder mehrere Nachrichten überprüft, werden nur diese heruntergeladen. Dies ist in der Bildschirmkopie unten zu sehen, wie es auch der Tooltip-Hinweis andeutet.

Quickfilter

Mit Hilfe der Quickfilter können die Such-Ergebnisse Spalten-weise weiter gefiltert werden, ohne dass eine erneute Suche gestartet wird. Um hier auf allen Daten zu arbeiten, ist der Quickfilter nicht in Kombination mit der Paginierung verwendbar.

Die Quickfilter-Menüs befinden sich in den Spalten-Köpfen der Tabelle. Bewegt man den Mauszeiger über die Spalten-Köpfe, so erscheint im rechten Bereich das Filter-Icon.

Klickt man auf dieses Icon, so öffnet sich das Quickfilter-Menü für die jeweilige Spalte.

Das Quickfilter-Menü enthält ganz oben 2 Icons für aufsteigende und absteigende Sortierung.

Darunter befindet sich ein Suchfeld für die Eingabe eines Filters. Die Eingabe kann einfacher Text sein oder verschiedene Operatoren enthalten.

Weiterhin ist die Filterung auch anhand einer Checkbox-Auswahl möglich. Dafür werden alle möglichen Werte für die Spalte aufgelistet so wie zusätzliche Checkboxen für “Alle” und “Kein Eintrag”.
Die Checkboxen werden für einige Spalten, wie zum Beispiel die Spalte Referenz-Nr. nicht angezeigt, da in der Regel zu viele Werte in der Liste wären und ein manuelles Selektieren kaum sinnvoll ist.

Die Quickfilter sind über mehrere Spalten miteinander kombinierbar.

Schaltflächen für die Paginierung

Die Navigation für die Datentabelle kann über die Navigationsleiste am unteren Ende der Tabelle erfolgen.

Die Seiten können mit den Pfeiltasten nach rechts und links zur nächsten und vorherigen Seite navigiert werden. Hotkeys (Tastaturkürzel) können auch zum Navigieren durch die Seiten verwendet werden

Die Elemente pro Seite können wie im Screenshot unten gezeigt ausgewählt werden.

Professionelle Attribute

Sobald der Benutzer auf eine Nachricht klickt, werden die professionellen Attribute in der Registerkarte unter der Tabelle angezeigt.

Oben rechts befinden sich drei Abkürzungstasten, mit denen Sie Folgendes tun können:

Button	Description
	Schnell-Link kopieren, um ihn in die Zwischenablage zu senden
	Kopieren des Quick-Links zu kohärenten Botschaften in die Zwischenablage
	Bezugsnachrichten in einem neuen Fenster öffnen

Schnell-Link-Kopieren, Kopieren des Quick-Links, Bezugsnachrichten sind abhängig von der Konfiguration in der globalen Eigenschaft admin ui B3P_QUICKLINK_FROM_DATE, B3P_QUICKLINK_TO_DATE, B3P_QUICKLINK_TO_TODAY_DATE

Beispiel

Das Datum der gestarteten Nachricht im Nachrichtenmonitor: 21.04.2021 15:21:01, heute (05/05/2021)

a. Erster Fall

Konfiguration

B3P_QUICKLINK_FROM_DATE=20 B3P_QUICKLINK_TO_DATE=10 B3P_QUICKLINK_TO_TODAY_DATE=true

Erwartetes Ergebnis, fromDate = Startdatum der Nachricht (21.04.2021) - 20 (B3P_QUICKLINK_FROM_DATE) zu toDate = heute (05/05/2021)

http://localhost:4200/b2b/messagemonitor?msgId=20503170-a272-11eb-a9a9-002b674222b9&fromDate=04%2F01%2F2021&toDate=05%2F05%2F2021

b. Zweiter Fall

Konfiguration

B3P_QUICKLINK_FROM_DATE=20 B3P_QUICKLINK_TO_DATE=10 B3P_QUICKLINK_TO_TODAY_DATE=false

Erwartetes Ergebnis, fromDate = Startdatum der Nachricht (21.04.2021) - 20 (B3P_QUICKLINK_FROM_DATE) zu toDate = Startdatum der Nachricht ( 21.04.2021) + 10 (B3P_QUICKLINK_TO_DATE)

http://localhost:4200/b2b/messagemonitor?msgId=11c310a0-a272-11eb-a9a9-002b674222b9&fromDate=04%2F01%2F2021&toDate=05%2F01%2F2021

c. Dritter Fall

Keine Konfiguration für globale Ansicht admin ui B3P_QUICKLINK_FROM_DATE, B3P_QUICKLINK_TO_DATE, B3P_QUICKLINK_TO_TODAY_DATE

Erwartetes Ergebnis, fromDate = Startdatum der Nachricht (21.04.2021) - 30 (Standardwert) zu toDate = Startdatum der Nachricht ( 21.04.2021) + 30 (Standardwert)

http://localhost:4200/b2b/messagemonitor?msgId=20503170-a272-11eb-a9a9-002b674222b9&fromDate=03%2F22%2F2021&toDate=05%2F21%2F2021

Mail-Details

Technische Einzelheiten

Sobald der Benutzer auf eine Nachricht klickt, können die technischen Details in der Registerkarte unter der Tabelle eingesehen werden

Zustand und weitere Details zu den Attributen können hier eingesehen werden:

Nach dem Klicken auf die Augen-Schaltfläche öffnet sich ein Popup-Fenster, das die Details anzeigt.

Personalization

Personalisierung der Spalten

Das Personalisierungsmenü bietet diese neuen Funktionen:

• Spalten anpassen
• Filter anpassen
• Personalisierung exportieren
• Personalisierung importieren

Spalten anpassen

a. Spalten anpassen erlaubt das Sichtbarmachen aller Spalten im Nachrichtenmonitor, einschließlich der „additional columns“

Sichtbare “Additional Columns” im Nachrichtenmonitor

b. Klicken Sie auf die Schaltfläche “Sichtbar” und klicken Sie auf “Speichern”, um diese Spalte im Nachrichtenmonitor nicht mehr anzuzeigen

c. Sie können per Drag&Drop die Reihenfolge der Spalten verändern

d. Klicken Sie auf “Standardwerte wiederherstellen” und dann auf “Speichern” oder löschen Sie manuell den Browser-Cache, um alle Spalten wieder sichtbar zu machen

Anpassen von Filtern

a. Die benutzerdefinierten Filter können verwendet werden, um diese spezifischen Felder, einschließlich zusätzlicher Spalten, ein- oder auszublenden.

b. Klicken Sie auf die Schaltfläche “Sichtbar” und auf “Beliebige Felder speichern”, um das Feld im Filter auszublenden

c. Sie können per Drag&Drop die Reihenfolge der Filter verändern

d. Klicken Sie auf “Standardwerte wiederherstellen” und dann auf “Speichern” oder löschen Sie manuell den Browsercache, um alle Filterfelder sichtbar zu machen

Anpassen von Spalten und Filtern

Für die Konfiguration in der Admin-UI mit B3P_MON_COLUMNS werden die Spalten und der Filter nur die Felder in B3P_MON_COLUMNS anzeigen, einschließlich zusätzlicher Spalten

a. Konfiguration in der Admin-Oberfläche

b. Spalten anpassen” zeigt nur die Felder in B3P_MON_COLUMNS an

c. Der benutzerdefinierte Filter zeigt nur die Felder in B3P_MON_COLUMNS an, die nicht in den Konfigurationsspalten B3P_MON_COLUMNS definiert sind.

Json-Datei importieren und exportieren

a. Json-Datei exportieren

Nachdem Sie die Konfiguration für die Spalten und Filter angepasst haben, können Sie auf die Schaltfläche Personalisierung exportieren klicken, um eine json-Datei zu exportieren, die alle Konfigurationen für die Spalten und Filter enthält

b. Json-Datei importieren

Falls die Einstellung gelöscht wird, können wir die zuvor konfigurierte Konfiguration wieder importieren. Klicken Sie auf “Personalisierung importieren” und laden Sie die json-Datei hoch, die mit “Personalisierung exportieren” exportiert wurde

Klicken Sie auf Importieren, um das gewünschte Ergebnis zu erhalten

Customizing

Spalten sortieren & verstecken

Die Spalten des Message Monitors können über die Global Property B3P_MON_COLUMNS sortiert oder versteckt werden. Weitere Details finden Sie hier.