Dokumentation für Arbeitsvorräte

Einführung

Arbeitsvorräte stellen eine weitere spezielle Suchfunktion im Nachrichtenmonitor dar. Die Liste der Arbeitsvorräte wird verschiedene vordefinierte Filter enthalten. Der Benutzer kann diese dann als vordefinierte Suchen verwenden, um eine Suche auszuführen die in der täglichen Routine immer verwendet werden kann. Z. B. alle gelöschten FSS-Fehler finden.

Diese vordefinierten Filter dürfen vom Benutzer nicht geändert werden, aber andere Filter, die nicht deaktiviert sind, können geändert werden. Benutzer können keine neue Arbeitsvorratsliste hinzufügen, nur Admin-Benutzer können neue Arbeitsvorratsliste hinzufügen.

Darüber hinaus kann ein Arbeitsvorrat so angepasst werden, dass er eine bestimmte Sql-Abfrage enthält, um eine intelligentere Suche durchzuführen.

Wie man Arbeitsvorräte benutzt

Die unten stehende Abbildung zeigt die nötigen Schritte, um Arbeitsvorräte im MessageMonitor aufzurufen:

Der Benutzer kann einen der vordefinierten Arbeitsvorräte aus der Dropdown-Liste auswählen. Die Dropdown-Liste zeigt alle gültigen Arbeitsvorräte zusammen mit einer Beschreibung an.

Wenn der Benutzer sich fragt, warum einige Arbeitsvorräte, die bereits in der Admin-UI vordefiniert sind, aber nicht in der Dropdown-Liste des Arbeitsvorrats eingetragen sind, bedeutet dies, dass eine Fehlkonfiguration im Arbeitsvorrat vorliegt. Der Benutzer kann die falsch konfigurierten Arbeitsvorräte aus der Fehlerliste erkennen und die Admin-UI starten, um die falsch konfigurierten Arbeitsvorräte zu korrigieren:

Wenn Sie einen der Arbeitsvorräte ausgewählt haben, werden bestimmte Filter deaktiviert. Z.B. unten markierte Filter, an denen keine Änderungen vorgenommen werden dürfen.

In einigen Filtern taucht das Wort “Benutzerdefiniert” auf. Das bedeutet, dass der spezifische Filter in sqlWherePart param vordefiniert wurde. Z.B. Arbeitsvorrat -> title=Nicht archivierbare Nachrichten,description=Arbeitsvorrat zur Suche nach lipsum8,params=[sqlWherePart:(state <> ARC und state <> SUC und state <> MAN und Absender nicht wie %Job%)] . Untenstehendes Beispiel zeigt das Ergebnis.

Wie man einen Arbeitsvorrat konfiguriert

Es gibt zwei Möglichkeiten, einen Arbeitsvorrat in der B2B zu konfigurieren.

  1. Als Admin-Benutzer der den Arbeitsvorrat im Admin-UI-Modul konfigurieren kann. Einzelheiten werden später erklärt.
  2. Bestehende Arbeitsvorräte können mit Hilfe des B2B-Migrationstools übertragen werden.

Arbeitsvorräte müsen vom Admin-Benutzer im Admin-UI-Modul konfiguriert werden. Nach dem Start der Admin-Benutzeroberfläche muss der Admin-Benutzer zur Registerkarte Extensions gehen, um eine neue Extension zu erstellen, mit dem Namen = “WORKLISTS”.

Um einen gültigen Arbeitsvorrat zu erstellen, muss der Admin-Benutzer die folgenden Regeln befolgen:

  1. Jeder Arbeitsvorrat muss dem folgenden Format folgen: title=<title value>,description=<description value>,params=<params value>
  2. Eine Arbeitsvorratsdefinition mit fehlendem Titel ist ungültig

    title=,description=Ausgangsvalidierung fehlgeschlagen,params=[state:SUC]

  3. Eine Arbeitsvorratsdefinition mit fehlender Beschreibung ist ungültig

    title=Ausgangsvalidierung fehlgeschlagen,description=,params=[state:SUC]

  4. Eine Arbeitsvorratsdefinition mit fehlenden Parametern ist ungültig

    title=Ausgangsvalidierung fehlgeschlagen,description=Ausgangsvalidierung fehlgeschlagen Description,params=

  5. Eine Arbeitsvorratsdefinition mit leeren Parametern ist ungültig title=Ausgangsvalidierung fehlgeschlagen,description=Ausgangsvalidierung fehlgeschlagen Description,params=[]

  6. Eine Arbeitsvorratsdefinition ist ungültig, wenn ein Feld in Parametern definiert ist, die nicht denen aus dieser Spezifikation entsprechen (z.B. “…params=[stat:’SUC’”) <= Der Name des Feldes muss ‘state’ und nicht ‘stat’ lauten. In der folgenden Liste sind gültige Feldnamen aufgeführt, die für die Konfiguration des Arbeitsvorrats verwendet werden sollten:
    1. refNr - bezieht sich auf den Filter Referenznummer
    2. vdewType - bezieht sich auf Typ-Filter
    3. state - bezieht sich auf Verarbeitungsstatus-Filter
    4. ack - bezieht sich auf Bestatigungsstatus-Filter
    5. partner - bezieht sich auf Partner-Filter
    6. sysNr - bezieht sich auf System-Filter
    7. altId - bezieht sich auf Idoc-Nr. Filter
    8. Kanal - bezieht sich auf Kanal-Filter
    9. dir - bezieht sich auf Richtung-Filter
    10. ccode - bezieht sich auf Clearing-Code-Filter
    11. searchTerm - bezieht sich auf die Volltextsuche. Enthält Text/Referenznr./Alt.-ID…
    12. sqlWherePart - sqlWherePart sollte den untenstehenden Feldnamen für die sql-Anweisung verwenden
      1. referenceid - bezieht sich auf den Filter Referenznummer
      2. vdewtype - bezieht sich auf Typ-Filter
      3. acknowledgement - bezieht sich auf Bestatigungsstatus-Filter (Acknowledgement)
      4. Absender - bezieht sich auf Systemfilter
      5. alternativeid - bezieht sich auf Idoc-Nr. Filter
      6. channelid - bezieht sich auf Kanalfilter
      7. direction - bezieht sich auf Richtung Filter
      8. clearingcode - bezieht sich auf Clearing-Code-Filter

    params=[sqlWherePart:(state <> 'ARC' and state <> 'SCU' and state <> 'MAN' and sende not like '%Job%' and sender not like '%synchron%

    Der Schlüssel ist sender, nicht sende. Fehler ungültiges Schlüsselfeld

  7. Eine Arbeitsvorratsdefinition ist ungültig, wenn ein Wert eines in params definierten Feldes nicht korrekt ist (z.B. “….params=[state:’SCU’”) <= Der Wert des Feldes muss ‘SUC’ und nicht ‘SCU’ sein. In der folgenden Liste sind die gültigen Werte für Parameter aufgeführt:
    1. Gültige Werte für das Feld VDEW-Typ:
      1. UTILMD
      2. MSCONS
      3. CONTRL
      4. APERAK
      5. ALOCAT
      6. IFTSTA
      7. IMBNOT
      8. INSRPT
      9. INVOIC
      10. ORDERS
      11. ORDRSP
      12. PRICAT
      13. QUOTES
      14. REQOTE
      15. REMADV
      16. SCHEDL
      17. SSQNOT
      18. TSIMSG
      19. UNKNOWN

      title=Ausgangsvalidierung fehlgeschlagen,description=Ausgangsvalidierung fehlgeschlagen,params=[vdewType:UTILMD1] Fehler ungültiger Wert im Statusparameter. Das params=[vdewType:UTILMD1] sollte sein params=[vdewType:UTILMD]

    2. Gültige Werte für den Verarbeitungsstatus (VS):
      1. FINISHED
      2. ERRORS
      3. PROFESSIONAL_ERRORS
      4. SUC
      5. ERR
      6. RUN
      7. EMP
      8. QUE
      9. MAN
      10. ARC
      11. ARP
      12. ARCHIVE_ERROR
      13. RUW
      14. SDJ
      15. SECURITY_SERVER_WARNING
      16. SECURITY_SERVER_ERROR

      title=Ausgangsvalidierung fehlgeschlagen,description=Ausgangsvalidierung fehlgeschlagen1,params=[state:SCU] Fehler ungültiger Wert im Statusparameter. Das params=[state:SCU] sollte sein params=[state:SUC]

    3. Gültige Werte für den Bestätigungsstatus (BS):
      1. FINISHED
      2. ERRORS
      3. CTP
      4. CTW
      5. CTN
      6. RESPONSE_ERROR
      7. ALL_APERAK
      8. APC
      9. APV
      10. SSU
      11. SWA
      12. SER
      13. MAN
      14. MSU
      15. MER
      16. AIS
      17. AIE

      title=Ausgangsvalidierung fehlgeschlagen,description=Ausgangsvalidierung fehlgeschlagen1,params=[ack:CTP1] Fehler ungültiger Wert im Statusparameter. Das params=[ack:CTP1] sollte sein params=[ack:CTP]

    4. Gültige Werte für die Richtung:
      1. INBOUND
      2. OUTBOUND

    title=Ausgangsvalidierung fehlgeschlagen,description=Ausgangsvalidierung fehlgeschlagen1,params=[dir:outbound1] Fehler ungültiger Wert im Statusparameter. Das params=[dir:outbound1] sollte sein params=[dir:outbound]

  8. Eine Arbeitsvorratsdefinition mit einem Feld, das in allgemeinen Parametern UND im “sqlWherePart” definiert ist, ist ungültig. Unterhalb des ungültigen Arbeitsvorrats befindet sich ein Suchfilter, bei dem der Bestätigungsstatus der Nachricht zweimal in der normalen Param- und in der “sqlWherePart”-Abfrage konfiguriert wird.
    1. Z.B. title=Nicht archivierte Nachrichten,description=Arbeitsliste zur Suche nach lipsum9,params=[ ack:CTN; sqlWherePart:( acknowledgement not like CTP)]
  9. Ungültig mit benutzerdefiniertem Wert
    1. Die Arbeitsliste hat einen benutzerdefinierten Wert im Feld title=Nicht fristgerechte CONTRLs,description=CONTRLs,params=[refNr:custom;vdewType:custom;state:custom;ack:custom;partner:custom;sysNr:custom;altId:custom;channel:custom;dir:custom;ccode:custom;searchTerm:ERC+Z21 ERC+Z29 ERC+Z30 ERC+Z31; Es ist ein ungültiger vdev-Typ, ack, state, channel, dir, code

    2. Die Arbeitsliste hat zweimal einen benutzerdefinierten Wert, einen im Feld und einen im Suchbegriff title=Nicht fristgerechte CONTRLs,description=CONTRLs,params=[refNr:custom;vdewType:custom;state:custom;ack:custom;partner:custom;sysNr:custom;altId:custom;channel:custom;dir:custom;ccode:custom;searchTerm:ERC+Z21 ERC+Z29 ERC+Z30 ERC+Z31;sqlWherePart:(referenceid <> 'id1' AND vdewtype = 'type1' AND state='FAIL' and acknowledgement not in ('CTP', 'CPU') and partner = '34232222' and sender='532423423' and alternativeid = '1' OR channelid='IN_B2B' and direction='0' and clearingcode=123)] Es ist ein ungültiger vdew-Typ, Status, Kanal, Verzeichnis, Code und Duplikat refNr, vdew-Typ, Status, Bestätigung, Partner, Systemnummer, Alt-ID, Kanal, Richtung, Code

  10. Bei SQL-Zurückweisung ungültig, unterstützt die Abfrage nur “SELECT”, keine Unterstützung für andere Abfragen wie “INSERT, DELETE” usw.
    1. Insert Abfrage title=Nicht fristgerechte CONTRLs,description=CONTRLs,params=[sqlWherePart:(INSERT INTO b2bbp_data_message (acknowledgement, partner, sender, alternativeid, channelid, direction) value ('CTP','34232222','532423423','1','IN_B2B','0'))

    2. Tippfehler Insert (INSE) title=Nicht fristgerechte CONTRLs,description=CONTRLs,params=[sqlWherePart:(INSE INTO b2bbp_data_message (acknowledgement,partner, sender, alternativeid, channelid, direction) value ('CTP','34232222','532423423','1','IN_B2B','0'))

    3. Delete SQL ohne Gleich und Komma title=Nicht fristgerechte CONTRLs,description=CONTRLs,params=[sqlWherePart:(DELETE FROM b2bbp_data_message WHERE acknowledgement not in ('CTP') and partner <> '34232222' and sender<>'532423423' and alternativeid <> '1' OR channelid<>'IN_B2B' and direction<>'0')]

    4. Delete SQL mit Equal und Kommas sind in der Bedingung enthalten title=Nicht fristgerechte CONTRLs,description=CONTRLs,params=[state:ack;sqlWherePart:(DELETE FROM b2bbp_data_message WHERE acknowledgement not in ('CTP', 'CTW') and partner = '34232222' and sender='532423423' and alternativeid <> '1' OR channelid<>'IN_B2B' and direction<>'0')] Fehlerformat SQL

  11. Ungültiger doppelter Titel title=Ausgangsvalidierung fehlgeschlagen,description=Ausgangsvalidierung fehlgeschlagen1,params=[state:SUC] title=Ausgangsvalidierung fehlgeschlagen,description=Ausgangsvalidierung fehlgeschlagen2,params=[state:SUC] Fehler Titel duplizieren

  12. Nachstehend finden Sie einige gültige Beispiele für Arbeitsvorräte:
    1. title=Nicht fristgerechte CONTRLs,description=Arbeitsvorrat zur Suche nach nicht fristgerechten CONTRLs,params=[ack:CTN]
    2. title=IT Fehler,description=Arbeitsvorrat zur Suche nach IT Fehlern,params=[state:ERR]
    3. title=Eingehende APERAKs (AHB),description=Arbeitsvorrat zur Suche nach eingehenden APERAKs (AHB),params=[vdewType:APERAK;dir:inbound;searchTerm:ERC+Z21 ERC+Z29 ERC+Z30 ERC+Z31]
    4. title=Eingehende APERAKs (ZO und ÜN),description=Arbeitsvorrat zur Suche nach eingehenden APERAKs (ZO und ÜN),params=[vdewType:APERAK;dir:inbound;searchTerm:APERAK AND NOT ERC+Z21 AND NOT ERC+Z29 AND NOT ERC+Z29 AND NOT ERC+Z30 AND NOT ERC+Z31]
    5. title=Negative CONTRLs,description=Arbeitsvorrat zur Suche nach negativen Contrls,params=[dir:inbound;vdewType:CONTRL;channel:IN_ISU]
    6. title=Nicht archivierbare Nachrichten,description=Arbeitsvorrat zur Suche nach nicht archivierbaren Nachrichten,params=[sqlWherePart:(state <> ARC und state <> SUC und state <> MAN und Absender nicht wie %Job% und Absender nicht wie %synchron%)]
    7. title=Nicht archivierte Nachrichten,description=Arbeitsvorrat zur Suche nach nicht archivierten Nachrichten,params=[sqlWherePart:(state not like ARC)]
    8. title=UTILMD Eingehend,description=Arbeitsvorrat zur Suche nach eingehenden UTILMDs,params=[vdewType:UTILMD;channel:INBOUND]
    9. title=Eingehende OVE ccode,description=Arbeitsvorrat zur Suche nach eingehenden OVE ccode,params=[dir:outbound;ccode:OVE]

      Code muss in ClearingCodes der Erweiterung admin ui definiert werden

    10. title=Ausgangsvalidierung fehlgeschlagen,description=Test,params=[dir:outbound;ccode:000;ack:CTE]

      CTE.type=ACK

      CTE.description=CTE Extension

    11. title=Ausgangsvalidierung fehlgeschlagen,description=Test,params=[dir:outbound;ccode:000;state:CTE]

      CTE.type=STATE

      CTE.description=CTE Extension

Migration der Extension B3P_PREDEFINED_SEARCH_TERMS in Arbeitsvorräte

Die Extension B3P_PREDEFINED_SEARCH_TERMS kann in Arbeitsvorräte migriert werden. So können Sie die vorbelegten Filter auch in der neuen UI nutzen.

Beispiel Extension B3P_PREDEFINED_SEARCH_TERMS:

Kündigung="UTILMD" AND "BGM+E35"   
Zuordnungsliste="UTILMD" AND "BGM+E06"   
Informationsmeldung_ZC8="UTILMD" AND "BGM+E44" AND "STS+7++ZC8"

Jede Zeile der Extension B3P_PREDEFINED_SEARCH_TERMS wird in jeweils eine Zeile der Extension WORKLISTS konvertiert. Bei der Migration bleibt das Format gleich, aber Titel und Parameterwert sind unterschiedlich:

Beispiel Extension WORKLISTS:

title=Kündigung,description= ,params=[searchTerm:UTILMD AND BGM+E35]
title=Zuordnungsliste,description= ,params=[searchTerm:UTILMD AND BGM+E06]
title=Informationsmeldung_ZC8,description= ,params=[searchTerm:UTILMD AND BGM+E44 AND STS+7++ZC8]

Tip: Darüber hinaus enthält die Extension B3P_PREDEFINED_SEARCH_TERMS Konfiguration zur erweiterten Volltextsuche. Diese Konfiguration hat keine Verbindung zu den Arbeitsvorräten und ist nicht zu migrieren. Ignorieren Sie die Einträge, die mit idx beginnen. Details über die erweiterte Volltextsuche können Sie hier beziehen.

View Me   Edit Me