Anfang des InhaltsbereichsVorgehensweisen Erste Schritte Dokument im Navigationsbaum lokalisieren

In diesem Kapitel wird anhand eines kurzen Beispiels gezeigt, wie Sie ein Micrososft-Visual-Basic-Formular erstellen können, das einen Workflow im SAP-System startet. Dieses Formular startet einen Workflow, der die Genehmigung eines Urlaubsantrags abwickelt. Das Formular, das wir entwerfen, stellt den Urlaubsantrag dar.

Voraussetzungen

Vorgehensweise

Um mit möglichst wenig Vorkenntnissen in Microsoft Visual Basic auszukommen, sollen Sie mit einem einfachen Microsoft-Visual-Basic-Projekt beginnen, das ein Formular mit Steuerelementen ohne zusätzlichen Microsoft-Visual-Basic-Quelltext enthält.

Der SAPforms-Designer fügt automatisch alle Definitionen hinzu, die für den Start eines Workflow anhand dieses SAPforms-Formulars benötigt werden. Sie brauchen keinen Quelltext dafür zu schreiben.

  1. Starten Sie Visual Basic.
  2. Überprüfen Sie, ob im Menü Add-Ins ein Eintrag mit dem Namen SAPforms enthalten ist. Falls ja, überspringen Sie den nächsten Schritt.
  3. Wählen Sie Add-Ins ® Add-In Manager, und markieren Sie dort den Eintrag SAPforms.
  4. Achtung

    Es besteht die Möglichkeit, daß das SAPforms-Add-In weder im Add-Ins-Menü von Microsoft Visual Basic noch im Add-In-Manager erscheint. Das ist zum Beispiel der Fall, wenn Microsoft Visual Basic nach SAPforms installiert worden ist. In diesem Fall, führen Sie bitte folgende Schritte aus:

    a) Schließen Sie Microsoft Visual Basic.

    b) Öffnen Sie die MS-DOS-Eingabeaufforderung.

    c) Gehen Sie in das Bin-Verzeichnis von SAPforms.

    d) Geben Sie WDFDES.EXE /R . ein.

    e) Starten Sie Microsoft Visual Basic wieder.

  5. Öffnen Sie das Projekt Demo3a im Verzeichnis ...\ SAPforms\Samples.
  6. Öffnen Sie das Formular frmTst3a.frm im Projektfenster. Hier handelt es sich um ein Abwesenheitsformular, das einen Workflow im SAP-System startet.
  7. Wählen Sie Add-Ins ® SAPforms ® Designer.
  8. Der SAPforms-Designers wird aufgerufen. Das Bild besteht im wesentlichen aus zwei Bereichen:

    Der obere Bereich ist im Moment noch leer.

    Im unteren Bereich finden Sie eine Tabelle, die in jeder Zeile ein Element aus dem Formular Urlaubsantrag enthält.

  9. Wählen Sie Extras ® Optionen.
  10. Das Optionendialogfenster des SAPforms-Designer erscheint.

  11. Wählen Sie die Registerkarte Plug-Ins.
  12. Tragen Sie im Rahmen in das Feld Aktives Plug-In den Wert SAP Forms Data Plug-In Demo ein. Verwenden Sie zur Eingabe die F4-Eingabehilfe.
  13. Im Rahmen SAP Transmit Plug-In wird nun automatisch im Feld Aktives Plug-In der Wert für das SAP Forms Transmit Plug-In Demo eingetragen.

  14. Verlassen Sie das Dialogfenster mit OK.
  15. Sie befinden Sie wieder im Hauptfenster des SAPforms-Designers.

  16. Öffnen Sie die SAP-Datenstruktur über Datei ® Demo Structure.
  17. Der obere Bildbereich wird mit einer Baumdarstellung der Demo-Datenstruktur gefüllt. Wählen Sie +, um auch die Felder der Struktur anzuzeigen.

    Hinweis

    Da Sie in Schritt 8 das Plug-In SAPforms Data Plug-In Demo gewählt haben, wird im oberen Steuerelement eine zu Demo-Zwecken hinterlegte Datenstruktur angezeigt.

    Falls Sie in Schritt 8 das Plug-In SAPforms Data Plug-In for Workflow Container gewählt hätten, würde die angezeigte Datenstruktur aus dem Inhalt des Workflow-Containers aufgebaut.

  18. Legen Sie fest, welches Formularfeld an welches Feld der SAP-Datenstruktur gebunden werden soll ("Datenflußdefinition").
  19. Wählen Sie ein Datenfeld im Strukturbaum des oberen Steuerelementes aus und ziehen Sie es in die Tabellenzeile, die das gewünschte Steuerelement enthält. Wenn diese Aktion erfolgreich war, zeigt die Spalte Data Element der Tabelle den Namen des SAP-Datenfeldes an, das nun an das Steuerelement aus dem Formular gebunden ist.

  20. Wählen Sie Datei ® Generieren, um den Datenfluß zu generieren.
  21. Sie erhalten ein Dialogfenster, das einige Optionen für die Generierung enthält.

  22. Markieren Sie Initialisierungscode in Load()-Methode einfügen und Schaltflächen zum Auslösen der Funktion einfügen.
  23. Wählen Sie OK.
  24. Wählen Sie Datei ® Schließen, um den SAPforms Designers zu beenden.
  25. Sie befinden Sie wieder in der Microsoft-Visual-Basic-Entwicklungsumgebung.

  26. Wählen Sie Run ® Start, um das Formular direkt aus der Microsoft-Visual-Basic-Entwicklungsumgebung zu starten.
  27. Die Laufzeit-Version des Formular erscheint. Die Steuerelemente sind zu Anfang ohne Inhalt.

  28. Füllen Sie die Felder mit Ihren Daten.
  29. Schicken Sie das Formular, indem Sie Submit wählen.

Ergebnis

Nun würde normalerweise der SAP-Workflow gestartet.

Da Sie aber in Schritt 8 das Plug-In SAPforms Data Plug-In Demo gewählt haben, läuft das Formular im Demo-Modus. Das bedeutet, daß das Absenden Ihres Formulars ein Fenster erscheinen läßt, in dem die Daten angezeigt werden, die normalerweise an das R/3-System geschickt würden.

Falls Sie in Schritt 8 das Plug-In SAPforms Data Plug-In for Workflow Container gewählt hätten, hätte das Absenden des Formulars den Start eines Workflow bewirkt. Aber da dafür mehr Anpassungen in SAPforms und im R/3-System notwendig gewesen wären, sollten Sie sich zunächst auf den Demo-Modus beschränken. Ein konkreter Workflow-Start wird in Beispiele für Workflow demonstriert.

Ende des Inhaltsbereichs