Dynamische Bearbeiterfindung

Überblick

Die Bearbeiter der Aufgaben der Prozessroute werden anhand der im System konfigurierten Hierarchie der Teams und Zuständigkeiten ermittelt. Die Logik folgt einer Suche von oben nach unten.
Zusätzlich zu den Teams bietet XCM zwei eigene Bearbeitertypen für Bearbeiter, die nicht in Teams und Zuständigkeiten gepflegt sind: ZA – Extended Agent Rule und CR – Change Record User Field. Beide werden unten beschrieben.

Algorithmus der Bearbeiterfindung

Die folgende Logik gehört zur Standardfunktionalität und wird in XCM genutzt, um Teammitglieder anhand vorgegebener Teamtypen und Zuständigkeitsattribute zu ermitteln und abzurufen:

  1. XCM erweitert („eXtends“) die Standardlogik der Bearbeiterfindung, indem es alle Teams einer Hierarchie gemäß ihren definierten Teamtypen und Zuständigkeitsattributen abruft.
  2. So werden für jedes oberste Team nur passende Teammitglieder aus den relevanten untersten Teams berücksichtigt – für eine genaue Zuordnung der Zuständigkeiten über verschiedene Änderungsaktentypen hinweg.

Bearbeitertypen in XCM

Der Bearbeitertyp einer Aufgabe wird in der BRF+-Entscheidungstabelle der Prozesssteuerung gepflegt (Spalte Agent Type) oder beim Hinzufügen einer Aufgabe im Process Builder. Folgende Bearbeitertypen stehen zur Verfügung:

  • TF – Team Function: Die Bearbeiter werden aus der Teamfunktion in Teams und Zuständigkeiten übernommen.
  • TH – Team Header: Die Bearbeiter werden aus dem Team in Teams und Zuständigkeiten übernommen.
  • US – SAP User: der als Bearbeiter gepflegte Benutzer.
  • BP – Business Partner: der als Bearbeiter gepflegte Geschäftspartner.
  • CX – Change Record Creator und CZ – Change Responsible: der Ersteller bzw. der Verantwortliche der Änderung.
  • CR – Change Record User Field: der Benutzer in einem Feld des Kopfs der Änderungsakte (siehe unten).
  • ZA – Extended Agent Rule: Die Bearbeiter werden durch Ihre eigene Logik ermittelt (siehe unten).

Bearbeitertyp ZA – Extended Agent Rule

Verwenden Sie den Bearbeitertyp ZA, wenn die Bearbeiter einer Aufgabe nicht in Teams und Zuständigkeiten gepflegt sind, zum Beispiel wenn sie in Ihrer eigenen Organisationstabelle oder in einem angebundenen System geführt werden. Sie definieren eine Bearbeiterregel und implementieren die Logik, die die Benutzer zu dieser Regel zurückgibt.
1. Pflegen Sie die Bearbeiterregel im Customizing:
/XCM/CUS → XCM Customizing → Agent Determination → Maintain Additional Agent Rule

  • Geben Sie eine Agent Rule (zum Beispiel Z_QUALITY_MANAGER) und eine Description ein.
  • Die Regel wird dann in der Wertehilfe für Bearbeiter zum Bearbeitertyp ZA angeboten.

2. Implementieren Sie das BAdI, das die Benutzer zu der Regel zurückgibt:
/XCM/CUS → XCM Customizing → Business Add-Ins(BAdIs) → BAdI: Determine Additional Agent for Agent Type ZA

  • Legen Sie eine Implementierung des BAdIs /XCM/PR_EX_ADD_AGENT mit dem Filter AGENT_TYPE = ZA an.
  • Lesen Sie in der Methode GET_AGENTS_BY_TYPE die Bearbeiterregel aus dem Parameter AGENT und geben Sie die Benutzer in USERS_LIST zurück. Die Details beschreibt der Abschnitt Verwendung der XCM-BAdIs unten.

3. Verwenden Sie die Bearbeiterregel in der Aufgabe:

  • Setzen Sie in der BRF+-Entscheidungstabelle der Prozesssteuerung den Agent Type auf ZA und den Agent auf Ihre Bearbeiterregel.
  • Die Aufgabe kann auch im Process Builder mit dem Bearbeitertyp ZA hinzugefügt werden.


Hinweis: Beim Anlegen der Prozessroute ruft XCM Ihre Implementierung auf, und die zurückgegebenen Benutzer werden die Bearbeiter der Aufgabe. Wird kein Benutzer zurückgegeben, wird die Aufgabe wie jede andere Aufgabe ohne Bearbeiter behandelt.

Bearbeitertyp CR – Change Record User Field

Verwenden Sie den Bearbeitertyp CR, wenn der Bearbeiter ein Benutzer ist, der in einem Feld des Kopfs der Änderungsakte oder der Kopferweiterung steht, zum Beispiel der Ersteller (CREATEDBYUSER), der Verantwortliche der Änderung (PARTNER) oder ein kundeneigenes Feld mit einem Benutzer. Der Agent der Aufgabe ist der Feldname, und der Benutzer in diesem Feld der aktuellen Änderungsakte erhält das Workitem.
1. Pflegen Sie die Benutzerfelder im Customizing (ab XCM 2026.5.0):
Pflege-View /XCM/CR_V_USERS in /XCM/CUS

  • Agent Type – CR
  • Agent – der Feldname im Kopf der Änderungsakte oder in der Kopferweiterung, zum Beispiel CREATEDBYUSER, PARTNER oder ZZ1_PARTNER2_IRT
  • Agent Classification – US, wenn das Feld einen SAP-Benutzer enthält, BP, wenn es einen Geschäftspartner enthält
  • Active – nur aktive Einträge werden verwendet

Die Einträge CREATEDBYUSER und PARTNER werden mit dem BC-Set /XCM/PR_CUSTOMIZATIONS ausgeliefert.

2. Verwenden Sie das Feld in der Aufgabe:

  • Setzen Sie in der BRF+-Entscheidungstabelle der Prozesssteuerung den Agent Type auf CR und den Agent auf den Feldnamen.
  • Die Aufgabe kann auch im Process Builder mit dem Bearbeitertyp CR hinzugefügt werden; die Wertehilfe zeigt die aktiven Einträge.

Hinweis:

  • Ist das Feld in /XCM/CR_V_USERS nicht gepflegt oder nicht aktiv, wird die Aufgabe nicht angelegt, und die Nachricht „Agent <field> is not maintained or not active in the CR agent customizing“ wird in das Workflow-Protokoll geschrieben. In der Prozesssimulation und im Process Builder wird dieselbe Nachricht angezeigt.
  • Vor XCM 2026.5.0 waren nur CREATEDBYUSER und PARTNER verfügbar, und weitere Felder mussten über eine Erweiterung des CDS-Views /XCM/CR_CHANGERECORD_USERS hinzugefügt werden. Diese Erweiterung ist nicht mehr nötig.
  • Für den Ersteller und den Verantwortlichen der Änderung können Sie auch die Bearbeitertypen CX und CZ verwenden, die kein Customizing benötigen.

Verwendung der XCM-BAdIs

Erweiterungsspot /XCM/PR_ES_AGENT_DETERMINE
BAdI /XCM/PR_EX_ADD_AGENT
Interface /XCM/PR_IF_ADD_AGENT
Filter AGENT_TYPE (verwenden Sie ZA)

Beschreibung: Lassen sich die Bearbeiter einer Aufgabe der Prozessroute nicht aus der Hierarchie der Teams und Zuständigkeiten ableiten, kann die Bearbeiterliste durch eine eigene Implementierung ermittelt werden. Das ist für Bearbeiter gedacht, die außerhalb von Teams und Zuständigkeiten geführt werden, etwa in einer eigenen Organisationstabelle oder in einem angebundenen System.
Das BAdI ist nach dem Bearbeitertyp gefiltert und wird nur aufgerufen, wenn als Bearbeitertyp der Aufgabe Specific Agent Type ZA (Extended Agent Rule) gepflegt ist. Für alle anderen Bearbeitertypen gilt die Standardermittlung.
Die Methode GET_AGENTS_BY_TYPE erhält den Bearbeitertyp und den in der Aufgabenkonfiguration gepflegten Bearbeiter (bei ZA die Bearbeiterregel aus Maintain Additional Agent Rule) sowie die Objekt-ID und den Objekttyp der Änderungsakte und gibt die Benutzer in USERS_LIST zurück.
Die von der Implementierung zurückgegebenen Benutzer werden als Bearbeiter der Aufgabe verwendet. Sie ersetzen die Bearbeiter, die XCM sonst ermitteln würde; die Implementierung muss daher die vollständige Liste zurückgeben.

Bitte stellen Sie sicher, dass der Bearbeitertyp der Aufgabe in der Aufgabenkonfiguration als Specific Agent Type (ZA) gepflegt ist; andernfalls wird die Implementierung nicht aufgerufen.

Signatur zur Referenz

class-methods GET_AGENTS_BY_TYPE
  importing
    !AGENT_TYPE  type /XCM/PR_AGENT_TYPE
    !AGENT       type /XCM/PR_AGENT
    !OBJECT_ID   type /PLMB/GOS_INTERNAL_KEY
    !OBJECT_TYPE type /PLMB/GOS_OBJECT_TYPE
  exporting
    !USERS_LIST  type /PLMB/T_TD_USRID .

Siehe auch

IMG-Customizing
Referenzen
T&R für die Änderungsakte einrichten mit den Schritten, um die erforderliche Konfiguration zu pflegen und Teams anzulegen
BRF-Customizing

Stichwörter

Business-Parameter, Hierarchie, Unterteam, übergeordnetes Team, Bearbeitertyp, ZA, erweiterte Bearbeiterregel, zusätzliche Bearbeiterregel, CR, Benutzerfeld der Änderungsakte, CX, CZ

Voraussetzungen

T&R für die Änderungsakte einrichten