Prozesssteuerung - Aufgabenkonfiguration

Überblick

Diese Seite stellt die Schritte vor, mit denen Sie Aufgaben-IDs im IMG anlegen und Aufgaben für den Kontext der Änderungsakte in BRF+ konfigurieren.

  1. Aufgaben-IDs sind ein eigenständiges Konzept von XCM. In der Standard-Prozesssteuerung von SAP legen Benutzer wegen kleiner Abweichungen im Prozess meist mehrere Prozessrouten-Vorlagen an. Das führt oft dazu, dass Aufgaben in mehreren Vorlagen doppelt vorkommen.
  2. Hier setzt XCM mit einem flexibleren Ansatz an: den Aufgaben-IDs.
  3. Mit Aufgaben-IDs definieren Sie gemeinsame Aufgaben einmal und konfigurieren sie abhängig von verschiedenen geschäftlichen Bedingungen.
  4. So lässt sich dieselbe Aufgabe in verschiedenen CR-Status wiederverwenden. In BRF+ pflegen Sie diese Aufgaben effizient in einer einzigen Regelzeile, die alle relevanten Bedingungen enthält.

Aufgaben nach Änderungsaktentyp und Änderungsgrund einschränken

Nicht jede Aufgabe passt zu jeder Art von Änderung. Eine Aufgabe lässt sich den Änderungsaktentypen zuordnen, für die sie gültig ist, und bei Bedarf bestimmten Änderungsgründen. XCM verwendet dann nur gültige Aufgaben:

  • Wird im Process Builder eine Aufgabe hinzugefügt, bietet die Wertehilfe nur die Aufgaben an, die für die Änderungsakte gültig sind.
  • Wird der Process Builder aus BRF+ generiert, wird eine Aufgabe, die für die Änderungsakte nicht gültig ist, weiterhin angezeigt, aber mit rotem Status und der Meldung Task not valid for record type and reason of the Change Record.
  • Beim Laden der Prozessroute wird eine aus BRF+ generierte Aufgabe, die nicht gültig ist, nicht angelegt. Stattdessen erhält der Administrator eine Aufgabe zur Prozessausnahme, um das Customizing oder die BRF+-Regel zu korrigieren.

Die Regel: Eine Aufgabe ist für eine Änderungsakte gültig, wenn sie dem Änderungsaktentyp zugeordnet ist und die Änderungsakte – sofern für diesen Typ Änderungsgründe gepflegt sind – einen dieser Änderungsgründe hat.

  • Ein Änderungsaktentyp ohne Änderungsgründe: Die Aufgabe ist für jeden Änderungsgrund dieses Typs gültig und auch dann, wenn die Änderungsakte keinen Änderungsgrund hat.
  • Ein Änderungsaktentyp mit Änderungsgründen: Die Aufgabe ist nur für die aufgeführten Änderungsgründe gültig.
  • Eine Aufgabe ohne Änderungsaktentyp ist für keine Änderungsakte gültig und wird nie angeboten. Denken Sie daran, jeder neuen Aufgabe Änderungsaktentypen zuzuordnen.

Hinweis: Diese Funktion steht in XCM für SAP S/4HANA 2023 ab dem Release 2026.3.4 zur Verfügung. Für SAP S/4HANA 2025 ist sie für ein späteres Release geplant.

Konfigurationsschritte

1. Nach dem Import (Pflicht): Führen Sie den Seeding-Report /XCM/PR_TASK_RT_SEEDING einmal mit der Transaktion SE38 aus. Er ordnet jede vorhandene Aufgabe jedem Änderungsaktentyp zu, ohne Änderungsgründe, sodass alle Prozesse wie bisher weiterlaufen. Der Report läuft standardmäßig im Testmodus und listet auf, was er hinzufügen würde. Führen Sie ihn danach ohne Testmodus erneut aus und geben Sie einen Customizing-Auftrag an, um die Zuordnungen aufzuzeichnen. Er fügt nur fehlende Zuordnungen hinzu, ein erneuter Lauf schadet daher nicht.
[Screenshot folgt: Seeding-Report mit Testmodus und Customizing-Auftrag]

2. Öffnen Sie das Customizing der Aufgaben (View-Cluster /XCM/PR_VC_TASK, Transaktion SM34), wählen Sie eine Aufgabe aus und öffnen Sie die Ebene Record Types. Behalten Sie die Änderungsaktentypen, für die die Aufgabe gültig ist, und entfernen Sie die anderen. Bei einer neuen Aufgabe fügen Sie hier ihre Änderungsaktentypen hinzu.
[Screenshot folgt: Änderungsaktentypen einer Aufgabe]

3. Optional: Wählen Sie einen Änderungsaktentyp der Aufgabe aus und öffnen Sie die Ebene Reasons for Change. Fügen Sie die Änderungsgründe hinzu, für die die Aufgabe gültig ist. Die Wertehilfe zeigt nur die Änderungsgründe dieses Änderungsaktentyps mit ihren Beschreibungen. Wenn Sie nicht mit Änderungsgründen arbeiten, lassen Sie diese Ebene leer.
[Screenshot folgt: Änderungsgründe eines Änderungsaktentyps]

4. Pflegen Sie den Administrator für ungültige Aufgaben in der BRF+-Administratorermittlung Ihrer Anwendung für die Prozesssteuerung: Fügen Sie eine Zeile für den Ausnahmetyp IT und das Szenario 01 hinzu, mit demselben Administrator wie für den Ausnahmetyp PE. Details finden Sie unter Ausnahmebehandlung in der Prozesssteuerung.

5. Test: Öffnen Sie den Process Builder einer Änderungsakte und prüfen Sie, ob die Wertehilfe von Add Task nur die gültigen Aufgaben anbietet. Generieren Sie den Process Builder neu und prüfen Sie, ob jede generierte Aufgabe einen grünen Status zeigt. Eine rote Aufgabe weist auf einen fehlenden Änderungsaktentyp oder Änderungsgrund in Schritt 2 oder 3 hin; korrigieren Sie ihn und generieren Sie neu.

Hinweis

  • Der Änderungsgrund wird beim Öffnen der Wertehilfe von Add Task aus der Änderungsakte gelesen. Aufgaben, die bereits in der Prozessroute stehen, werden nicht entfernt, wenn sich der Änderungsgrund später ändert.
  • In der Prozessroute wird der Änderungsgrund gelesen, wenn die Aufgaben eines Status angelegt werden; ein geänderter Änderungsgrund gilt daher ab dem nächsten Status.
  • Eine im Process Builder hinzugefügte Aufgabe, die für die Änderungsakte nicht gültig ist, wird abgelehnt, auch wenn sie nicht aus der Wertehilfe ausgewählt wurde.

Hintergrundschritte mit eigener Logik

Eine Prozessroute braucht oft einen Schritt, der im Hintergrund läuft und etwas Unternehmensspezifisches erledigt, zum Beispiel eine Spezifikation aktualisieren, eine E-Mail senden, ein Folgesystem aufrufen oder Daten prüfen, bevor der Prozess weiterläuft.
XCM liefert für solche Schritte eine generische Serviceklasse aus, /XCM/PR_BACKGROUND_SERVICE. Sie implementieren in einem BAdI nur die Geschäftslogik des Schritts. Um den Rest kümmert sich XCM: Es schreibt das Ergebnis in das Workflow-Protokoll, entscheidet, ob der Schritt abgeschlossen wird oder mit einem Fehler endet, und legt eine Ausnahmeaufgabe für einen Administrator an, wenn Ihre Logik das verlangt.

Konfigurationsschritte

1. Definieren Sie eine Servicefunktion mit der Serviceklasse /XCM/PR_BACKGROUND_SERVICE in der Servicedefinition der Prozessroute (View /PLMB/V_PR_SRV_D) und verwenden Sie sie in der XCM-Aufgabe, die im Hintergrund läuft. Eine Servicefunktion kann beliebig viele Hintergrundschritte bedienen; jeder Schritt wird über seine XCM-Aufgabe identifiziert.
[Screenshot folgt: Servicefunktion mit der Klasse /XCM/PR_BACKGROUND_SERVICE]

2. Implementieren Sie das BAdI /XCM/PR_EX_BACKGROUND_SRV in der IMG-Aktivität BAdI: Define Background Service Function for specific Task. Setzen Sie den Filter TASK_ID auf die XCM-Aufgabe des Schritts, sodass jeder Hintergrundschritt eine eigene Implementierung hat.
[Screenshot folgt: BAdI-Implementierung mit dem Filter TASK_ID]

3. Führen Sie in der Methode EXECUTE die Arbeit des Schritts aus und geben Sie Folgendes zurück:

  • Schweregrad – Erfolg, Information oder Warnung, wenn der Schritt seine Arbeit erledigt hat; Fehler, wenn nicht.
  • Nachricht – eine Nachricht, die das Ergebnis beschreibt.
  • Ausnahmeszenario – nur zusammen mit dem Schweregrad Fehler und nur, wenn ein Administrator das Problem lösen soll.

4. Gibt Ihr Schritt ein Ausnahmeszenario zurück, pflegen Sie in der BRF+-Anwendung der Prozesssteuerung die Ausnahmeregel für den Ausnahmetyp PE und dieses Szenario, mit der Aufgabe und den Bearbeitern, die das Problem lösen. Details finden Sie unter Ausnahmebehandlung in der Prozesssteuerung.

5. Testen Sie den Schritt: Setzen Sie eine Änderungsakte auf den Status, der die Hintergrundaufgabe anlegt, und prüfen Sie das Ergebnis im Workflow-Protokoll des Workitems.

Was mit dem Ergebnis geschieht

  • Die Nachricht wird immer in das Workflow-Protokoll des Workitems geschrieben.
  • Erfolg, Information oder Warnung: Der Schritt wird abgeschlossen, und die Prozessroute läuft weiter.
  • Fehler mit Ausnahmeszenario: XCM legt die Aufgabe zur Prozessausnahme für das Szenario an, mit den Bearbeitern aus BRF+. Der Schritt wird abgeschlossen, und der Prozess läuft über die Ausnahmeaufgabe weiter.
  • Fehler mit Ausnahmeszenario, aber es lässt sich keine Ausnahmeaufgabe anlegen (keine BRF+-Regel für das Szenario oder kein Bearbeiter gefunden): Das Workitem endet mit einem Fehler und einer Nachricht, die den Ausnahmetyp und das Szenario nennt.
  • Fehler ohne Ausnahmeszenario: Das Workitem endet mit einem Fehler und Ihrer Nachricht, sodass es sich analysieren und neu starten lässt.
  • Der Schweregrad Abbruch wird wie ein Fehler behandelt.
  • Fehlende Konfiguration: Wird für den Schritt keine XCM-Aufgabe gefunden oder gibt es für die Aufgabe keine BAdI-Implementierung, endet das Workitem mit einer entsprechenden Fehlermeldung, statt abgeschlossen zu werden, ohne etwas ausgeführt zu haben.

Hinweis: Ein Workitem, das mit einem Fehler endet, wird nicht automatisch wiederholt. Ein Administrator analysiert es und startet es im Workflow neu.

Verwendung der XCM-BAdIs

Erweiterungsspot /XCM/PR_ES_BACKGROUND_SRV
BAdI /XCM/PR_EX_BACKGROUND_SRV
Interface /XCM/PR_IF_BACKGROUND_SRV
Filter TASK_ID

Beschreibung: Liefert die Geschäftslogik eines Hintergrundschritts, der mit der generischen Serviceklasse /XCM/PR_BACKGROUND_SERVICE läuft. Die Einrichtung und wie XCM das Ergebnis behandelt, beschreibt der Abschnitt Hintergrundschritte mit eigener Logik oben.
Die Methode EXECUTE erhält die Objekt-ID und den Objekttyp der Änderungsakte sowie die Route-ID, die Position, das Workitem und die Aufgaben-ID des bearbeiteten Schritts.
Die Implementierung führt die Aktivität aus und meldet das Ergebnis über SEVERITY, ERROR_MESSAGE und EXCEPTION_SCENARIO zurück. Ein Fehler mit Ausnahmeszenario legt eine Aufgabe zur Prozessausnahme an; ein Fehler ohne Szenario beendet das Workitem mit einem Fehler.

Signatur zur Referenz

METHODS execute
  IMPORTING object_id   TYPE /plmb/gos_internal_key OPTIONAL
            object_type TYPE /plmb/gos_object_type OPTIONAL
            actarea     TYPE srmactar OPTIONAL
            route_id    TYPE /plmb/process_route_id OPTIONAL
            posid       TYPE /plmb/pr_posid OPTIONAL
            posid_wiid  TYPE /plmb/pr_item_wii OPTIONAL
            task_id     TYPE /xcm/pr_task_id OPTIONAL
  CHANGING  exception_scenario TYPE /xcm/pr_exception_scenario
            error_message      TYPE swf_t100ms
            severity           TYPE /plmb/spi_msg_severity .

Erweiterungsspot /XCM/PR_ES_TASK_CREATION
BAdI /XCM/PR_EX_TASK_CREATION
Interface /XCM/PR_IF_TASK_CREATE_EXIT

Beschreibung: Die für einen Status ermittelte Aufgabenliste lässt sich vor dem Anlegen der Aufgaben anpassen, wenn sich die benötigte Aufgabe nicht allein über die Entscheidungstabelle abbilden lässt.
Die Methode MODIFY_TASKS_FOR_CREATION erhält den Objekttyp und die Objekt-ID der Änderungsakte, ein Kennzeichen, ob der Prozess aus dem Process Builder gestartet wurde, sowie die Prozessroute. Die bis dahin ermittelte Aufgabenliste wird in TASK_FOR_CREATION übergeben.
Die Implementierung kann in TASK_FOR_CREATION Aufgaben hinzufügen, Aufgaben entfernen oder die Werte der Business-Parameter einer Aufgabe ändern. Die zurückgegebene Liste verwendet XCM zum Anlegen der Aufgaben. Die zurückgegebenen Aufgaben werden außerdem gegen die oben beschriebene Einschränkung nach Änderungsaktentyp und Änderungsgrund geprüft.

Dieser Exit wird bei jeder Aufgabenermittlung aufgerufen, auch bei den Läufen, die aus dem Process Builder ausgelöst werden. Bitte beschränken Sie die Implementierung auf die Änderungsaktentypen, für die die Anpassung erforderlich ist.

Signatur zur Referenz

class-methods MODIFY_TASKS_FOR_CREATION
  importing
    !OBJECT_TYPE        type /PLMB/GOS_OBJECT_TYPE
    !OBJECT_ID          type /PLMB/GOS_INTERNAL_KEY
    !IS_PROCESS_BUILDER type BOOLE_D optional
    !PROCESS_ROUTE      type /PLMB/S_PROCESS_ROUTE_WI_SP optional
  changing
    !TASK_FOR_CREATION  type /XCM/PR_TASKS_WITH_PARAM_VALUE .

Siehe auch

IMG-Customizing
BRF-Customizing
Erweitertes Framework für die Prozesssteuerung
Ausnahmebehandlung in der Prozesssteuerung
Process Builder

Stichwörter

Prozessroute, Prozesssteuerung, Aufgaben-IDs, Bearbeiterfindung, BRF+, Einschränkung von Aufgaben, Änderungsaktentyp, Änderungsgrund, Seeding-Report, Ausnahmetyp IT, Hintergrundservice, Hintergrundaufgabe, /XCM/PR_BACKGROUND_SERVICE, /XCM/PR_EX_BACKGROUND_SRV

Voraussetzungen

BRF+-Generierung - Prozesssteuerung