Show TOC

Dokumentation zur VorgehensweiseConsumer-Proxy generieren Dieses Dokument in der Navigationsstruktur finden

 

ABAP-Consumer-Proxys werden in einer Anwendung dafür verwendet, einen Web Service aufzurufen (zu konsumieren).

Ein Consumer-Proxy enthält ABAP-Objektklassen und basiert auf einem Outbound-Service-Interface.

Consumer-Proxys müssen lediglich von einer Anwendung generiert und verwendet werden – wohingegen Provider-Proxys in dem ABAP-Backend-System generiert und implementiert werden müssen, in dem der Service bereitgestellt wird.

Voraussetzungen

ABAP-Consumer-Proxys können für Objekte generiert werden, die im Enterprise Services Repository (ES Repository) modelliert wurden, oder auch für externe Services.

ABAP-Consumer-Proxys können in jedem ABAP-System generiert werden, da nur die WSDL-Beschreibung erforderlich ist. Die Objekte müssen nicht zuerst im Enterprise Services Repository (ES Repository) modelliert werden. Wenn die Objekte für ein Consumer-Proxy im ES Repository modelliert werden, ist das zugehörige ES Repository-Objekt ein Outbound-Service-Interface.

Ein Consumer-Proxy kann generiert werden, wenn eine der folgenden Voraussetzungen erfüllt ist:

  • Das zugehörige Outbound-Service-Interface ist im ES Repository verfügbar.

  • Es ist ein WSDL-Dokument für ein zuvor generiertes ABAP-Provider-Proxy vorhanden.

  • Ein WSDL-Dokument von einem externen Service-Provider ist verfügbar und dessen URL ist bekannt oder steht als Datei bereit.

Vorgehensweise

Der Generierungsprozess für ein Consumer-Proxy ist davon abhängig, ob der Consumer im Enterprise Services Repository besteht oder ob ein WSDL-Dokument verfügbar ist – entweder ein externes WSDL-Dokument oder ein WSDL-Dokument für ein zuvor generiertes ABAP-Provider-Proxy.

Consumer-Proxy generieren – das Modell besteht im ES Repository
  1. Starten Sie den Enterprise Services Repository Browser (Transaktionscode SPROXY).

  2. Machen Sie die Software-Komponentenversion und den Namensraum ausfindig.

  3. Expandieren Sie den Knoten Service-Interfaces.

  4. Wählen Sie das Outbound-Service-Interface aus.

  5. Öffnen Sie das Kontextmenü und wählen Sie Anlegen.

    Das System fordert Sie zur Angabe eines Präfixes und eines Transportauftrags auf.

  6. Bestätigen Sie die Aktion.

    Das Consumer-Proxy wird generiert. Während der Generierung werden zudem alle zugehörigen Datentypen und Message-Typen im gleichen Namensraum generiert.

    Das Register Konfiguration zeigt die Standardeigenschaften an, die vom WSDL-Dokument extrahiert werden. Diese Eigenschaften legen die Einstellungen einer Laufzeitkonfiguration fest, die bei Verwendung des Proxys generiert wird.

  7. Sichern Sie.

  8. Aktivieren Sie.

    Wenn das Consumer-Proxy aktiviert wird, werden außerdem automatisch die Proxy-Klassen und zugehörigen Methoden angelegt und aktiviert.

Consumer-Proxy generieren – das Modell wird durch ein externes WSDL-Dokument beschrieben
  1. Starten Sie den Repository Browser (Transaktionscode SE80).

  2. Öffnen Sie das Paket, für das Sie das Consumer-Proxy generieren möchten.

  3. Wählen Sie im Kontextmenü des Pakets   Anlegen   Enterprise Service  .

  4. Wählen Sie im Dialogfeld Service-Consumer.

  5. Wählen Sie Weiter.

  6. Wählen Sie die Quelle des WSDL-Dokuments.

    Dabei kann es sich um eine URL oder eine Datei handeln.

  7. Wählen Sie Weiter.

  8. Geben Sie eine URL oder einen Dateinamen an.

  9. Geben Sie ein Paket, ein Präfix und einen Transportauftrag an.

  10. Wählen Sie Weiter.

    Das Consumer-Proxy wird generiert. Während der Generierung werden Proxys für alle zugehörigen Datentypen und Message-Typen generiert.

    Das Register Konfiguration zeigt die Standardeigenschaften an, die vom WSDL-Dokument extrahiert werden. Diese Eigenschaften legen die Einstellungen einer Laufzeitkonfiguration fest, die bei Verwendung des Proxys generiert wird.

  11. Sichern Sie.

  12. Aktivieren Sie.

    Wenn das Consumer-Proxy aktiviert wird, werden außerdem automatisch die Proxy-Klassen und zugehörigen Methoden angelegt und aktiviert.