Moderne Workflow- Programmierung mit ABAP Objects

Transkript

1 Ulrich Mende Moderne Workflow- Programmierung mit ABAP Objects Handbuch für Entwickler

2 Ulrich Mende Lektorat: Dr. Michael Barabas Copy-Editing: Ursula Zimpfer, Herrenberg Satz: Josef Hegele, Birgit Bäuerlein Herstellung: Birgit Bäuerlein Umschlaggestaltung: Helmut Kraus, Druck und Bindung: M.P. Media-Print Informationstechnologie GmbH, Paderborn Bibliografische Information der Deutschen Nationalbibliothek Die Deutsche Nationalbibliothek verzeichnet diese Publikation in der Deutschen Nationalbibliografie; detaillierte bibliografische Daten sind im Internet über abrufbar. ISBN Auflage 2012 Copyright 2012 dpunkt.verlag GmbH Ringstraße 19 B Heidelberg Die vorliegende Publikation ist urheberrechtlich geschützt. Alle Rechte vorbehalten. Die Verwendung der Texte und Abbildungen, auch auszugsweise, ist ohne die schriftliche Zustimmung des Verlags urheberrechtswidrig und daher strafbar. Dies gilt insbesondere für die Vervielfältigung, Übersetzung oder die Verwendung in elektronischen Systemen. Es wird darauf hingewiesen, dass die im Buch verwendeten Soft- und Hardware-Bezeichnungen sowie Markennamen und Produktbezeichnungen der jeweiligen Firmen im allgemeinen warenzeichen-, marken- oder patentrechtlichem Schutz unterliegen. In dieser Publikation wird auf Produkte der SAP AG, Dietmar-Hopp-Allee 16, Walldorf/Deutschland, Bezug genommen. Bei den Bezeichnungen dieser Produkte handelt es sich um eingetragene und/oder nicht eingetragene Marken der SAP AG. Die SAP AG ist weder Autor noch Verleger dieses Buches und ist für seinen Inhalt nicht verantwortlich. Alle Angaben und Programme in diesem Buch wurden mit größter Sorgfalt kontrolliert. Weder Autor noch Verlag können jedoch für Schäden haftbar gemacht werden, die in Zusammenhang mit der Verwendung dieses Buches stehen

3 vii Inhaltsverzeichnis Einleitung 1 Wer hat das Buch geschrieben? Dank Worum geht es in diesem Buch? An wen richtet sich das Buch? n Hinweise zu den einzelnen Kapiteln SAP Business Workflow im Überblick Die Architektur des SAP Business Workflow Definitionszeit Workflows und Workitems zur Ausführungszeit Bearbeiterfindung Workflow als Reaktion auf Anwendungssignale Vorkonfigurierte Workflow-Definitionen Der typische Workflow-Benutzer Ein typisches Workflow-Szenario Dokumentation und Tutorial Business Workplace Mails im Business Workplace Workitems mit Benutzerdialog in der Worklist Workflow-Entwicklung Tools Workflow aus Entwicklersicht Workflow als Framework Schichtenmodell einer Workflow-Anwendung Paketorientierte Workflow-Entwicklung in der SE Das Workflow-Bereichsmenü SWLD

4 viii Inhaltsverzeichnis 2.2 Workflow-Beispiellösungen der SAP Tutorials Workflow-Anwendung»Urlaubsantrag« Workflows der Aufgabengruppe WFUNIT Workflows der Aufgabengruppe WF_Verify SAP Service Marketplace SAP Support Portal mit Hinweissystem SDN-Community SAP Help online und offline ABAP Objects Grundlagen Objektorientierung als Abbild der realen Welt Klassen und ihre Komponenten PUBLIC-, PROTECTED- und PRIVATE-Komponenten Statische und Instanzkomponenten Abstrakte und finale Methoden und Klassen Lokale und globale Klassen Objekte und Referenzen Zugriff auf Klassen- und Instanzkomponenten Vererbung und Casting von Referenzen Klasse CL_VATER Klasse CL_SOHN Klasse CL_ENKEL Beispielprogramm zur Vererbung Upcasting und Downcasting von Referenzen Events Prinzip Publish and Subscribe Event Handling Events im Workflow-Kontext Interfaces Definition von Interfaces Interfaceimplementierung und -referenzen Polymorphie Allgemeines Polymorphie durch Vererbung Polymorphie über Interfaces Ausnahmen und Ausnahmeklassen Klassische Ausnahmen ohne Ausnahmeklassen Ausnahmeklassen Ausnahmetexte aus dem OTR

5 Inhaltsverzeichnis ix 3.8 Zugriff auf die Klassendefinition im Repository Dynamischer Aufruf von Klassenmethoden Parameter vom Typ REF TO dynamisch übergeben Run Time Type Services Run Time Type Identification (RTTI) Run Time Type Creation (RTTC) Übernehmen lokaler Klassen in das Repository Durchgängiges Beispiel des Buches: Kreditverträge Aufgabenstellung Tabelle ZVERTRAG Vertragstransaktion Statusdiagramm Implementierung (DB und ABAP) Quelltext der Vertragstransaktion Quelltext zur Berechnung des Ratenplans Die neue Welt: ABAP Objects im Workflow Problemstellung IF_WORKFLOW Vertragsbearbeitung im Workflow Klasse ZCL_VERTRAG Attribute MV_VERNR und MS_VERTRAG Methoden ANZEIGEN, AENDERN, GENEHMIGEN Ereignisse CREATED, CHANGED und CANCELLED Erste Tests der Klasse ohne Interface IF_WORKFLOW Einfachste Ausprägung von IF_WORKFLOW Erweiterte Ausprägung IF_WORKFLOW Workflow-Container und Workflow-Ereignisse Konzept Workflow-Container Die Klasse CL_SWF_CNT_CONTAINER Datenflüsse zwischen Containern Containerpersistenz auf der Datenbank Ereigniserzeugung Universelle Ereigniserzeugung in ABAP-Programmen Erzeugung von BOR-Events mit SWE_EVENT_CREATE Ereigniserzeugung über Änderungsbelege Weitere Methoden der Ereigniserzeugung

6 x Inhaltsverzeichnis 6.4 Ereignis-Verbraucher-Kopplungen Typkopplung mit Funktionsbaustein oder Methode Verbrauchertyp Verbraucher-Funktionsbaustein Check-Funktionsbaustein Verbrauchertyp-Funktionsbaustein Typkopplung aktiv, Ereignis-Queue zulassen Instanzkopplung Einträge in den Koppeltabellen durch Workflow Workflow-Startbedingungen Ereignisverarbeitung Ablauf der Ereignisverarbeitung Erzeuger- und Verbraucherkontext Ereignisfluss bei Vererbung Laufzeitwerkzeuge für Ereignisse Ereignis auslösen Ereignis simulieren Ereignis-Trace Ereignis-Queue Organisationsmanagement und Regeln Konzept Bestandteile des Organisationsmanagements Organisationseinheiten Besetzungsplan Aufgabenprofil Einfache Pflege der Aufbauorganisation Infotypen OM-Typebene und OM-Objektebene OM-Objekttypen (Infotyp 1000) Verknüpfungen zwischen Objekttypen (Infotyp 1001) Weitere Infotypen Zuständigkeiten Regeln und Regelauflösung Konzept Regeldefinition Regeln mit Funktionsbausteinen Regeln mit Zuständigkeiten

7 Inhaltsverzeichnis xi 7.6 Dynamische Eingangskörbe Aufgabenstellung Das Prinzip der dynamischen Eingangskörbe Pflege der Bestandteile dynamischer Eingangskörbe Standardaufgaben anlegen und verwenden Konzept Standardaufgaben Standardaufgaben anlegen Objekttyp und Methode Hintergrundaufgabe und Dialogaufgabe Verarbeitungsende bestätigen Container und Initialwerte Aufgabe mit Rückgabewert Workitem-Text Beschreibung Auslösende Ereignisse Beendende Ereignisse Mögliche Bearbeiter Zuständige Bearbeiter Defaultregeln Standardaufgaben starten Start aus Workflow (Standardfall) Start über Ereignis Start aus Programm Workflow-Muster anlegen und verwenden Konzept Workflow-Muster Workflow-Interface Workflow-Container Initialwerte Aufgabentext Aufgabenbeschreibung Auslösende Ereignisse Workflow-Definition Die Arbeit mit dem grafischen Editor Der Bedingungseditor Übersicht Schritttypen Schritttyp Aktivität Schritttyp Webaktivität Schritttyp Mailversand Schritttyp Formular Schritttyp Benutzerentscheidung

8 xii Inhaltsverzeichnis Schritttyp Warten auf Ereignis Schritttyp Bedingung Schritttyp Mehrfachbedingung Schritttyp Paralleler Abschnitt Schritttyp UNTIL-Schleife Schritttyp WHILE-Schleife Schritttyp Ablaufsteuerung Schritttyp Containeroperation Schritttyp Ereigniserzeuger Schritttyp Ad-hoc-Anker Schritttyp Block Schritttyp Lokaler Workflow Container in der Workflow-Definition Workflow-Grunddaten Versionsunabhängig (Aufgabe) Versionsabhängig (aktuelle Workflow-Version) Einfacher Vertrags-Workflow Technische Workflow-Beschreibung und Pseudocode Workflow-Muster zao_main Bearbeiterfindung im Workflow Allgemeines Definition der möglichen Bearbeiter Zuständige und ausgeschlossene Bearbeiter Ermittlung der Empfänger Arbeiten mit dem Business Workflow Explorer Zweck des Business Workflow Explorer Auswahl des Suchbereiches Anzeige und Bearbeitung von Objekten Lesen der Workflow-Definitionen Starten von Workflows Start von Workflows über ABAP OO Start von Workflows über Ereignisse Klassenbasierte Techniken im Workflow SAP-Klassen im Workflow-Umfeld Iterator-Klassen, Factory-Klassen und Utility-Klassen Iterator-Klassen Factory-Klassen und Factory-Methoden Utility-Klassen

9 Inhaltsverzeichnis xiii 10.3 Terminüberwachung Problem und Lösungsprinzip Standardfall mit Deadline-Workitems Berechnete Termine mit Deadline-Workitem Obsolet setzen eines Workitems Nebenmethoden Problem und Lösungsprinzip Methode zur Vertragsanzeige Eintrag als Nebenmethode in die Aktivität Amodaler Aufruf der Nebenmethode Objektreferenzen in die Workitem-Vorschau einstellen Referenzen auf bestehende Workflow-Klassen Referenzen auf spezielle Anzeigeklassen Programmier-Exits für Workitems Das Interface IF_SWF_IFS_WORKITEM_EXIT Logging mit CHECK-POINT-Gruppe Automatisches Zurücklegen eines Workitems Fortgeschrittene Workflow-Definition Lokale Ereignisse und Ausnahmen Lokale Ereignisse und komplexe Bedingungen TRY/CATCH im Workflow: Blöcke und Ausnahmen Lokale Workflows und lokale Ereignisse Dynamische Blöcke Dynamisch sequenzieller Block = Workflow-Iterator Dynamisch paralleler Block Beispiel: Bewertungs-Workflow für Vertrag Ad-hoc-Funktionen im Workflow Ad-hoc-Aufgabenauswahl Ad-hoc-Bearbeiterauswahl Ad-hoc-Workflow einbinden Reaktion eines Workflows auf externe Ereignisse Standardreaktionen über Grunddaten des Workflows Modellierte Reaktionen über Ereignisempfänger Klassenverwendung im Workflow ohne Standardaufgaben Konzept %-%-Zugriff ohne IF_WORKFLOW &-&-Zugriff über ungebundene Containerreferenzen &-&-Zugriff über gebundene Containerreferenzen Geschachtelter Zugriff mit %-% und &-& Methoden mit mehreren Exportparametern Objektreferenzen on-the-flight

10 xiv Inhaltsverzeichnis 11 Klassenbasierte Eigenentwicklungen im Workflow Utility-Klasse ZCL_DATE: Datumsberechnung auf Kalendern Verwendung von Datumsberechnungen Implementierung von ZCL_DATE Verwendung von ZCL_DATE in Ausdrücken Utility-Klasse ZCL_COND: komplexe Bedingungen Konzept komplexer Bedingungen im Workflow Tabelle ZCONDITION Implementierung von ZCL_COND Verwendung von ZCL_COND in ZCL_VERTRAG Setzen und Prüfen von Vertragsbedingungen Aufruf von ZCL_COND in Ausdrücken Utility-Klasse ZCL_CONST: Datenbankkonstanten Konzept»variabler«Konstanten Tabelle der Konstanten ZCONST Aufruf der Konstanten über ZCL_CONST Implementierung von ZCL_CONST Einführen neuer Konstanten Verwendung der Konstanten im Workflow Utility-Klasse ZCL_SYSTEM: generische Systemmethoden Inhalt von ZCL_SYSTEM Erzeugen von Klassenreferenzen im Workflow GENERICINSTANTIATE von CL- und BOR-Referenzen MAKE_CL_REF für den Aufruf in Ausdrücken Kommunikation zwischen parallelen Subworkflows Kommunikation über Ereignisse ZCL_SYSTEM: Lesen fremder Workflow-Container Mails im Workflow-Umfeld Mail senden mit Schritttyp Mailversand ZCL_SYSTEM: Mail mit eigenem Absender ZCL_SYSTEM: Mail mit SAP Text und Containerbezug HTML-Mails mit Rückantwort Business Workplace als Userinterface Allgemeines zum Business Workplace Fenster im Business Workplace Das Mappenfenster (1) Das Inboxfenster (2) Das Vorschaufenster (3)

11 Inhaltsverzeichnis xv 12.3 Funktionen im Workplace Funktionen der Workflow-Inbox Persönliche Workflow-Einstellungen Workflow-Vertretungen Vertretungen in Tabelle HRUS_D Die Anpassung der Inbox Layoutfunktionen des ALV-Grids Verwendung dynamischer Anwenderspalten Webservices im Workflow Webservices im Workflow Das Webservice-Framework Erstellen eigener Webservices Einbinden fremder Webservices Beispiel: Einbinden eines Webservice SOAP-Webservice für Wetterdienste Einbinden eines Webservice in SAP Generierte Klasse ZCO_GLOBAL_WEATHER_SOAP Anlegen logischer Ports Aufruf des Webservice Aufruf des Service GlobalWeather in einem Programm Einbinden des Webservice in den Workflow Das Workflow-Laufzeitsystem Konzept Die Tabellen des Laufzeitsystems Die Tabelle SWWWIHEAD der Workitem-Köpfe Die Tabelle SWW_WI2OBJ für Objektreferenzen Die Tabelle SWWORGTASK Die Tabelle SWWUSERWI der Benutzerzuordnung Views Programmierter Zugriff auf die Laufzeittabellen Wichtige Funktionsbausteine und Klassen SAP_WAPI-Bausteine Klassen des Laufzeitsystems Die Arbeitsweise des Laufzeitsystems Datenfluss über Container Aktionen auf Workitems Termin- und Fehlerüberwachung Business Workplace als Sicht auf die Laufzeittabellen.. 407

12 xvi Inhaltsverzeichnis 15 Tests und Fehlersuche Workflow-Instanzen suchen Workitem-Selektion mit ihren Anzeigemöglichkeiten Workflow-Instanzen zu Objekttyp Workflow-Instanzen zu Objektinstanz Workflow-Protokoll mit seinen diversen Sichten ActiveX-Protokoll und seine Sichten Technisches Workflow-Protokoll und seine Sichten Grafisches Workflow-Protokoll Anzeigen, Ändern und Beenden von Workitems Testen der Fristverletzung an Ereignisempfängern Debug-Report für Batch-Workitems Notwendigkeit Anwendung Quelltext des Reports ZAO_DEBUGWI Hintergrundschritte im Status STARTED Dump-Analyse Wiederanstarten nach Fehlerkorrektur Nützliche Hilfsprogramme Container-Update SBE fortsetzen mit Simulation der Auswahl Benutzer an Dialog-Workitems ändern Ultima Ratio nach 22 Uhr Up- und Download von Workflow-Mustern Problematik Noch kein SAPlink-Plug-in für Workflows Up- und Download von Klassen im XML-Format Up- und Download von Workflow-Mustern als XML Workflow-Transporte Workflow-Administration Aufgabe und Festlegung der Administratoren Allgemeine Aufgaben des Workflow-Administrators Customizing verifizieren Workflow-Administrator global einstellen Workflow-Administrator pro Workflow-Definition Batchjobs konfigurieren und einplanen Terminüberwachung Workitem-Fehlerüberwachung Bedingungsauswertung

13 Inhaltsverzeichnis xvii Notification für SAP-Gelegenheitsbenutzer Pflege der -Adresse für das Weiterleiten Pflege der persönlichen -Adresse in den Benutzerdaten Erzeugen von s zu neuen Workitems Versenden der Internetmails über SAPconnect Reaktion auf Fehlermeldungen des Laufzeitsystems Typische Workflow-Fehler und ihre Behebung Workitems ohne Bearbeiter Workitems mit Terminüberschreitungen Diagnose fehlerhafter Workitems Laufzeitpuffer synchronisieren Restarten unterbrochener Workflows Restart fehlerhafter Workflows Restart nach Systemabsturz oder Schrittdump Analysen Workitems pro Aufgabe Workitems nach Bearbeitungsdauer Workload-Analyse Reorganisation der Laufzeitdaten Allgemeines Auslastung der Workflow-Laufzeittabellen Gezieltes Löschen von einzelnen Workflows Löschen von Workflows im Batch Archivieren von Workflows im Batch Transportieren von Workflows Anhang A Die alte Welt BOR-Objekte im Workflow 467 A.1 Historisches A.2 Anlegen eines neuen Objekttyps A.2.1 Die Objektliste mit ihren Bestandteilen A.2.2 Programm des Objekttyps als Subroutinenpool A.2.3 Interface A.2.4 Freigeben von Objekttyp und Komponenten A.3 Attribute A.3.1 Datenbankattribute mit GET_TABLE_PROPERTY A.3.2 Objektreferenzen und Makros für den Objektzugriff A.3.3 Implementierung und Aufruf virtueller Attribute

14 xviii Inhaltsverzeichnis A.4 Implementierung und Aufruf von Methoden A.4.1 Synchrone Anzeigemethode als Defaultmethode A.4.2 Synchrone Dialogmethode mit Ergebnisparameter A.4.3 Synchrone Hintergrundmethode mit Parametern A.4.4 Asynchrone Dialogmethode ohne alles A.4.5 Methoden mit Ausnahmen A.4.6 Überdefinieren von Methoden A.5 Ereignisse A.6 Prüfen und Testen einer Objektimplementierung A.7 Vererbung und Delegation A.7.1 Vererbung und Delegation im BOR A.7.2 Vererbung und keine Delegation für ABAP-Klassen A.7.3 Ereignisbehandlung bei Vererbung und Delegation A.8 Standardisierte Schnittstellen Container A.8.1 Container in Programmen Include <CNTN01> A.8.2 Persistente Instanzen von Containern A.8.3 Container im Workflow A.9 Spezielle Objekttypen Literatur 511 Inhalt des Downloadbereiches 513 Abkürzungsverzeichnis 517 Index 519