Auswertung und Pflege der Typkopplungen

Transport und Mandanten-Copy

Typkopplungen sind mandantenabhängig und werden automatisch auf einen Customizing-Transportauftrag geschrieben, sofern der Mandant (in der Tabelle T000) so eingestellt ist, dass Änderungen automatisch aufgezeichnet werden. Alle Einträge einschließlich ihres Aktivierungskennzeichens werden dann transportiert.

Beim Mandanten-Copy ist zu beachten, dass die Typkopplungen in den Zielmandanten kopiert werden, aber im Zielmandanten immer deaktiviert sind.

Das Kennzeichen der Aktivierung jeder einzelnen Typkopplung wird nur auf expliziten Wunsch (Parameteroption zum Kopieren von Tabellen der Klasse A) beim Mandanten-Copy mitkopiert.

Ablauf

Der Ereignismanager beginnt die Auswertung der aktiven Typkopplungen, wenn ihm der Name eines erzeugten Ereignisses mitgeteilt wird. Damit eine Ereignisbehandlung stattfindet, muss bei der Typkopplung entweder das erzeugte Ereignis und sein auslösender Objekttyp oder das erzeugte Ereignis und ein Supertyp des auslösenden Objekttyps eingetragen sein.

Wenn der Ereignismanager für das erzeugte Ereignis eine Typkopplung findet, laufen folgende Verarbeitungsschritte ab:

1. Wenn ein Verbrauchertyp-Funktionsbaustein eingetragen ist, wird dieser zur Ermittlung des Verbrauchertyps aufgerufen.

2. Wenn ein Check-Funktionsbaustein eingetragen ist, wird dieser aufgerufen. Endet dessen Ausführung mit einer Ausnahme, wird die Kopplung nicht ausgeführt.

3. Der Verbraucherfunktionsbaustein wird mit den Parametern Ereignis , Verbrauchertyp und Ereigniscontainer aufgerufen.

Beim Auftreten eines Fehlers innerhalb des Funktionsbausteines SWW_WI_CREATE_VIA_EVENT (fehlende oder fehlerhafte Aufgabe, Probleme beim tRFC) wird eine Mail an den Systemadministrator für Workflow verschickt.

Daten einer Typkopplung

In der Typkopplungstabelle stehen folgende Felder zur Verfügung:

• Objekttyp und Ereignisname

  Hinweis

  Objekttyp und Ereignis müssen im Business Object Repository definiert sein

• Verbrauchertyp

• Verbraucherfunktionsbaustein

• Check-Funktionsbaustein (optional)

• Verbrauchertyp-Funktionsbaustein (optional)

• Kennzeichen: Typkopplung aktiviert

  Wenn dieses Kennzeichen gesetzt ist, wird die Typkopplung vom Ereignismanager ausgewertet.

• Kennzeichen: Ereignis-Queue ermöglichen

  Dieses Kennzeichen wird nur ausgewertet, wenn die Ereignis-Queue aktiv ist.

  Wenn das Kennzeichen gesetzt ist, erfolgt der Start des Ereignisverbrauchers durch die Ereignis-Queue. Wird dieses Kennzeichen nicht gesetzt oder ist die Ereignis-Queue nicht aktiv, wird der Verbraucher sofort gestartet.

• Verhalten bei Fehlerrückmeldung

  Hier kann die Systemvoreinstellung, die auf der Registerkarte Grunddaten der Ereignis-Queue-Administration gepflegt wird, übernommen oder überdefiniert werden.

• Verbraucherstatus

  Der Status des Ereignisverbrauchers hat Auswirkung auf den Start des Verbrauchers. Generell muss die Verbraucherkopplung aktiv sein, um den Verbraucher starten zu können. Der Status der Verbraucherkopplung hat dabei folgende Auswirkungen:

  • fehlerfrei

    Ist die Verbraucherkopplung im Status fehlerfrei , so werden die Verbraucher durch das System gestartet. Der Start kann dabei direkt oder durch die Ereignis-Queue erfolgen.

  • fehlerhaft

    Ist die Verbraucherkopplung im Status fehlerhaft , so wird der Verbraucher nicht sofort gestartet, sondern automatisch in die Ereignis-Queue gestellt. Dort erhält der Eintrag den Status wartend wegen Fehler . Somit wird der Verbraucher einerseits nicht gestartet, andererseits besteht jedoch die Möglichkeit, diese Verbraucher nach der Beseitigung des Fehlers erneut zu starten. Ausgelöste Ereignisse gehen damit auch bei fehlerhaften Kopplungen nicht verloren. Das erneute Starten der Ereignisverbraucher kann über die Registerkarte Fehlerhafte Kopplungen vorgenommen werden.

Pflege der Typkopplung

In folgenden Fällen müssen Sie Typkopplungen manuell definieren und bearbeiten:

• Sie verwenden die Ereignissteuerung im Rahmen eigener Entwicklungen unabhängig vom Workflow.

• Sie wollen die vom Workflow-System vorgenommenen Einträge analysieren.

• Sie wollen einen Check-Funktionsbaustein nachtragen.

• Sie wollen eine Typkopplung aktivieren, die nicht durch den Workflow gesteuert wird.

• Sie wollen, dass die Ereignisse einer bestimmten Typkopplung die Ereignis-Queue nutzen.

Die Pflege der Typkopplungen im Rahmen des SAP Business Workflow wird ansonsten vom Workflow-System übernommen.

Über folgenden Funktionsbaustein können Sie eine Typkopplung anlegen:

          
SWE_EVENT_REC_TYPE_ENTER
            

Darüber hinaus stehen APIs zum Bearbeiten einzelner Felder einer Typkopplung zur Verfügung:

Verwenden Sie folgenden Funktionsbaustein, um eine Typkopplung zu löschen:

          
SWE_EVENT_REC_TYPE_DELETE