Entscheidungen in My Inbox validieren

Überblick

Trifft ein Genehmiger in My Inbox eine Entscheidung zu einem Workitem einer Änderungsakte (zum Beispiel Approve oder Reject), wird die Entscheidung normalerweise so übernommen, wie sie ist. In vielen Unternehmen gibt es jedoch Regeln, die vorher geprüft werden sollten, zum Beispiel ob ein Pflichtfeld gefüllt ist oder ob sich ein zugehöriges Objekt im richtigen Status befindet, bevor die Änderungsakte genehmigt werden kann.
Mit dem BAdI Validate Decision können Sie eigene Prüfungen hinzufügen, die laufen, bevor das Workitem aktualisiert wird. Je nach Ergebnis Ihrer Prüfung gilt:

  1. Eine Nachricht vom Typ Fehler stoppt die Entscheidung. Die Nachricht wird dem Genehmiger angezeigt, und das Workitem bleibt in My Inbox offen.
  2. Eine Nachricht vom Typ Warnung oder Information wird dem Genehmiger angezeigt, und die Entscheidung wird gesichert.
  3. Ohne Nachricht wird die Entscheidung wie bisher gesichert.

Die Prüfung lässt sich auf einen bestimmten Änderungsaktentyp und/oder eine bestimmte Aufgabe beschränken, sodass Sie nur das implementieren, was Ihr Prozess erfordert.

Welches BAdI brauche ich?

Der Erweiterungsspot /XCM/PR_ES_DECISION_EXIT enthält zwei BAdIs für Entscheidungen in My Inbox. Diese Seite beschreibt die Prüfung, bevor die Entscheidung übernommen wird.

Anforderung BAdI Dokumentation
Eine Entscheidung prüfen, bevor sie übernommen wird, und sie mit einer Fehlermeldung stoppen /XCM/PR_EX_VALIDATE_DECISION Diese Seite
Steuern, was nach der Entscheidung geschieht: parallele Aufgaben beenden, Positionen überspringen, Folgeaufgaben anlegen /XCM/PR_EX_DECISION_EXIT Erweitertes Framework für die Prozesssteuerung

Schritte zur Implementierung der Prüfung

1. Öffnen Sie die Transaktion SE18 (oder SE19) und legen Sie für den Erweiterungsspot /XCM/PR_ES_DECISION_EXIT eine Implementierung der BAdI-Definition /XCM/PR_EX_VALIDATE_DECISION an.
[Screenshot folgt: Erweiterungsspot /XCM/PR_ES_DECISION_EXIT mit dem BAdI /XCM/PR_EX_VALIDATE_DECISION]

2. Pflegen Sie die Filterwerte Ihrer Implementierung:

  • CHANGE_RECORD_TYPE – der Änderungsaktentyp, für den die Prüfung gilt.
  • TASK_ID – die Aufgaben-ID (wie in der BRF+-Entscheidungstabelle gepflegt), für die die Prüfung gilt.
  • Lassen Sie einen Filter offen, läuft die Prüfung für alle Änderungsaktentypen bzw. für alle Aufgaben.

3. Implementieren Sie die Methode VALIDATE_DECISION in Ihrer implementierenden Klasse. Die Methode erhält die Details des Workitems und die getroffene Entscheidung:

  • WORKITEM_ID – das Workitem in My Inbox
  • PROCESS_ROUTE_ID und POSITION – der Schritt der Prozessroute, zu dem die Aufgabe gehört
  • CHANGE_RECORD_TYPE und CHANGERECORDUUID – die Änderungsakte
  • TASK_ID – die XCM-Aufgabe
  • DECISION – die Entscheidung, die der Genehmiger ausgewählt hat
  • APPROVER – der Benutzer, der die Entscheidung trifft

Fügen Sie Ihre Nachrichten der Tabelle MESSAGES hinzu. Verwenden Sie den Nachrichtentyp E, um die Entscheidung zu stoppen, und W oder I, um den Genehmiger nur zu informieren.

4. Aktivieren Sie die Implementierung.

5. Testen Sie die Prüfung: Öffnen Sie ein Workitem einer Änderungsakte in My Inbox und treffen Sie die Entscheidung. Gibt Ihre Prüfung einen Fehler zurück, wird die Nachricht angezeigt, und das Workitem bleibt offen.

Hinweis:

  • Das BAdI kann mehrere aktive Implementierungen haben. Alle werden aufgerufen, und die Nachrichten aller Prüfungen werden zusammen angezeigt.
  • Die Prüfung wird aus der XCM-Implementierung /XCM/PR_EI_CHECK_TASK_DECISION des SAP-BAdIs /IWWRK/ES_WF_WI_BEFORE_UPD_IB aufgerufen. Die SAP-Standardimplementierung /PLMI/IM_EX_CR_WF_HANDLER bleibt inaktiv.
  • Die Prüfung, dass nur ein MDG-M-Administrator die MDG-M-Aufgabe abschließen kann, wird jetzt als Implementierung dieses BAdIs ausgeliefert (/XCM/PR_EI_MDG_M_ADMIN_CHECK). Wenn Sie die MDG-M-Integration verwenden, ist keine Aktion erforderlich. Details finden Sie unter Integration der PLM-Änderungsakte (CR) mit SAP MDG-M.
  • Nehmen Sie innerhalb der Prüfung keine Änderungen an der Änderungsakte vor. Die Prüfung sollte nur Daten lesen und Nachrichten zurückgeben. Um zu steuern, was nach der Entscheidung geschieht, verwenden Sie das BAdI /XCM/PR_EX_DECISION_EXIT, das unter Erweitertes Framework für die Prozesssteuerung beschrieben ist.

Verwendung der XCM-BAdIs

Erweiterungsspot /XCM/PR_ES_DECISION_EXIT
BAdI /XCM/PR_EX_VALIDATE_DECISION
Interface /XCM/PR_IF_VALIDATE_DECISION
Filter CHANGE_RECORD_TYPE, TASK_ID

Beschreibung: Das BAdI wird aufgerufen, bevor eine in My Inbox getroffene Entscheidung das Workitem einer XCM-Aufgabe aktualisiert. Geben Sie Nachrichten in MESSAGES zurück; eine Fehlermeldung weist die Entscheidung zurück und lässt das Workitem offen.

Signatur zur Referenz

METHODS validate_decision
  IMPORTING
    !workitem_id        TYPE sww_wiid
    !process_route_id   TYPE srmwfpthid
    !position           TYPE srmwfposid
    !change_record_type TYPE /iam/issue_type
    !task_id            TYPE /xcm/pr_task_id
    !decision           TYPE /plmb/pr_decision OPTIONAL
    !approver           TYPE syuname OPTIONAL
    !changerecorduuid   TYPE /bobf/conf_key
  CHANGING
    !messages           TYPE bapirettab .

Siehe auch

Erweitertes Framework für die Prozesssteuerung
Prozesssteuerung - Aufgabenkonfiguration
Ausnahmebehandlung in der Prozesssteuerung
Integration der PLM-Änderungsakte (CR) mit SAP MDG-M

Stichwörter

My Inbox, Entscheidung, Validierung, genehmigen, ablehnen, Workitem, BAdI, /XCM/PR_EX_VALIDATE_DECISION, /XCM/PR_EX_DECISION_EXIT

Voraussetzungen

  1. Verfügbar ab dem XCM-Release 2026.5.0.
  2. Die Aufgaben müssen in der Prozesssteuerung als XCM-Aufgaben konfiguriert sein. Details finden Sie unter Prozesssteuerung - Aufgabenkonfiguration.