Anfang des InhaltsbereichsVorgehensweisen Lektion 10: Methode mit Parametern anlegen Dokument im Navigationsbaum lokalisieren

Verwendung

Sie legen in dieser Lektion die Methode Create als Methode mit Parametern an und implementieren sie. Methoden können zu ihrer Ausführung Parameter benötigen bzw. nach ihrer Ausführung zurückliefern.

Sie müssen diese Methode implementieren, wenn ihr Objekttyp das Interface IFCREATE unterstützt.

Voraussetzungen

Die Methode Create legt ein Objekt vom vorgegebenen Typ an. Sie gehört zu den Methoden, die Ihr Objekttyp vom Interface IFCREATE (Anlegen) erbt.

Diese Methode ist beim Interface noch nicht implementiert. Das Implementierungsprogramm muß entsprechend erweitert werden. Dazu wird in der Implementierung der Methode Create die Transaktion (oder der Funktionsbaustein) der Anwendung aufgerufen, mit der das Objekt bearbeitet wird. Für Kundenaufträge ist das die Transaktion VA01 .

Vom Interface IFCREATE werden folgende Eigenschaften und Ausnahmen der Methode Create vererbt:

Die Methode Create ist eine synchrone, instanzunabhängige Methode, die mit Dialog abläuft und kein Ergebnis zurückliefert.

Vorgehensweise

Anwendungsfunktionalität analysieren

  1. Wählen Sie Logistik ® Vertrieb ® Verkauf ® Auftrag ® Anlegen.
  2. Wählen Sie System ® Status.

    3. Sie sehen, daß Sie die Transaktion VA01 aufgerufen haben.

  3. Wählen Sie Diese Grafik wird im zugehörigen Text erklärt.

    4. Sie gelangen wieder auf das Bild Kundenauftrag anlegen: Einstieg.

    Die Auftragsart ist ein Mußfeld. Wenn Sie also einen Kundenauftrag über die Methode Create anlegen wollen, müssen Sie entweder die Auftragsart erfragen oder als Parameter beim Aufruf mitgeben.

  4. Positionieren Sie den Cursor auf dem Auswahlfeld.
  5. Wählen Sie F1.

    6. Sie gelangen auf das Dialogfenster mit der Feldhilfe.

  6. Wählen Sie Technische Info.

    7. Dem Bereich Felddaten entnehmen Sie, daß es sich bei dem Eingabefeld um das Tabellenfeld VBAK-AUART handelt.

  7. Verlassen Sie die Dialogfenster und das Bild zum Anlegen von Kundenaufträgen. Gehen Sie wieder zum Business Object Builder in die Bearbeitung Ihres Objekttypen.

Methode definieren

  1. Positionieren Sie den Cursor auf der Methode Create .
  2. Wählen Sie Diese Grafik wird im zugehörigen Text erklärt.

    3. Die Farbgebung des Eintrags ändert sich.

  3. Öffnen Sie die Methodendefinition durch Doppelklick auf dem Methodennamen
  4. Tragen Sie auf der Registerkarte ABAP/4 im Feld Name die Transaktion VA01 ein und markieren Sie Transaktion.
  5. Wählen Sie Diese Grafik wird im zugehörigen Text erklärt.

    6. Parameter anlegen
  6. Positionieren Sie den Cursor auf der Methode Create .
  7. Wählen Sie Parameter.

    8. Angezeigt wird der noch leere Methodencontainer.

  8. Wählen Sie Diese Grafik wird im zugehörigen Text erklärt.
  9. Beantworten Sie die Frage Anlegen mit ABAP/4-Feldvorlagen? mit Ja.
  10. Geben Sie VBAK in das Eingabefeld Tabelle ein
  11. Markieren Sie aus den angezeigten Tabellenfeldern das Feld AUART (Verkaufsbelegart).
  12. Wählen Sie Diese Grafik wird im zugehörigen Text erklärt.

    13. Sie gelangen auf das Dialogfenster zum Anlegen eines Parameters.

  13. Legen Sie den Parameter SalesDocumentType (Verkaufsbelegart) wie vorgeschlagen an, indem Sie Diese Grafik wird im zugehörigen Text erklärt wählen.
  14. Wählen Sie Diese Grafik wird im zugehörigen Text erklärt.
  15. Positionieren Sie den Cursor auf der Methode Create .
  16. Wählen Sie Programm. Lassen Sie sich das Muster für die fehlende Methode erzeugen.

Die Implementierung der Methode Create , die automatisch aus Ihren Angaben übernommen wurde, bleibt unverändert.

Importparameter der Methode werden mit den zur Verfügung gestellten Containermakros SWC_GET_ELEMENT (bei einzeiligen Elementen) und SWC_GET_TABLE (bei mehrzeiligen Elementen) aus dem Container ( CONTAINER ) gelesen und an den Funktionsbaustein oder die Transaktion bzw. an deren Verarbeitungsparameter ("SET/GET-Parameter") weitergeben.

Exportparameter werden innerhalb der Methodenimplementierung in den Container ( CONTAINER ) eingestellt. Dazu verwenden Sie das Containermakro SWC_SET_ELEMENT bei einzeiligem Rückgabeparameter bzw. das Containermakro SWC_SET_TABLE bei mehrzeiligem Rückgabeparameter.

Sie finden den Quelltext im Anhang in den Zeilen 118-125.

Ergebnis

Methode mit Parametern testen

  1. Damit der Objekttyp instanziiert und getestet werden kann, muß er zunächst generiert werden. Wählen Sie Diese Grafik wird im zugehörigen Text erklärt.

    2. Wenn der Objekttyp noch Fehler hat, werden Sie darauf hingewiesen. Versuchen Sie, über die Fehlerübersicht (Springen ® Fehlerliste) diese Fehler zu beheben.

  2. Um die Methode zu testen, wählen Sie Diese Grafik wird im zugehörigen Text erklärt.

    3. Sie gelangen auf das Bild Testen Objekttyp <Objektname>: keine Instanz gebunden.

  3. Wählen Sie Diese Grafik wird im zugehörigen Text erklärt Instanz.

    4. Identifizieren Sie ein Objekt vom Typ Kundenauftrag, indem Sie die Nummer eines beliebigen Kundenauftrags eintragen. Lassen Sie sich ggf. durch die F4-Eingabehilfe unterstützen.

  4. Wählen Sie Diese Grafik wird im zugehörigen Text erklärt.

Sie gelangen auf das Bild Testen Objekttyp <Objektname>, auf dem Sie Ihren Objekttyp testen können (Methoden ausführen, Werte der Attribute überprüfen).

Ende des Inhaltsbereichs