Generating Proxies 

Use

You can generate client or server proxies in ABAP to send or receive messages. You generate client proxies from outbound message interfaces and server proxies from inbound message interfaces.

If a proxy is generated for an inside-out service or an external WSDL document, proxy generation is executed in the Object Navigator (transaction SE80).

Integration

For more information about programming with proxies, see Proxy Runtime.

Prerequisites

Depending on the proxy type, the following tasks must be executed before the proxy can be generated:

●      All objects must have been created in the Integration Repository.

If a proxy is to be generated for an object that references another object in the same namespace, the proxy for the referenced object is generated automatically. So, for example, a proxy can be generated for an interface that references a specific data type.

If a referenced object is in another namespace, you must generate the proxy for the referenced object separately.

●      The package structure must be defined in the ABAP backend system.

The package structure defines where the proxies are created, where the main service provider is located, and how the packages fit into the general application structure.

Translation and package assignment

The creation of dictionary objects and classes/interfaces during proxy generation can result in a large number of objects that require translation. This translation is pointless, however, since these proxy objects do not appear in user interfaces. You should therefore ensure that proxy objects are separated at package level. Create a separate package for the proxy objects and set it as not relevant for translation.

Use declaration

The packages that contain or use proxy objects must have a use declaration for the package interface SAI_TOOLS. For the proxy runtime, a use declaration must be available for the package interface SAI_SXMS.

For more information, refer to Creating Use Access.

●      Prefixes can be defined for ABAP objects.

It is recommended that you define prefixes as this ensures that ABAP objects are assigned clear and consistent names in the backend system.

Procedure

Proxy Generation Using Transaction SPROXY

...

       1.      Start the Enterprise Services Repository Browser (transaction code SPROXY).

       2.      Make the software component version and namespace easy to locate.

       3.      Expand the Service Interfaces/Message Interfaces nodes.

       4.      Select an outbound interface.

For more information on the status of objects: Object Status.

       5.      Open the context menu and choose Create.

The system asks you to enter a prefix and a transport request.

       6.      Confirm the action.

The client proxy is generated. During this process, the corresponding data types and message types are generated in the same namespace.

The Configuration tab shows the default properties extracted from the WSDL document. These properties define the settings of a runtime configuration that is generated when the proxy is used.

       7.      Save your data.

       8.      Activate the client proxy.

When the client proxy is active, the proxy classes and associated methods are created and activated automatically.

...

Proxy Generation Using the Object Navigator (Transaction SE80)

       1.      Start the Repository Browser (transaction code SE80).

       2.      Open the package for which you want to create the consumer proxy.

       3.      In the context menu of the package, choose Create ® Enterprise Service.

       4.      Choose Service Consumer in the dialog box.

       5.      Choose Next.

       6.      Select the source of the WSDL document: Enterprise Services Repository, a URL, or a file.

For more information on the Enterprise Services Repository, see Creating Enterprise Services Repository 7.1 Consumers/Providers.

       7.      Choose Next.

       8.      Specify a URL or file name.

       9.      Specify a package, a prefix, and a transport request.

   10.      Choose Next. The client proxy is generated.

   11.      Save your data.

   12.      Activate the client proxy.

The proxy classes and associated methods are created and activated.

...

Also note Tips for Proxy Generation and the executions in the Displaying ABAP Proxy Objects section.

 

Result

To generate proxies, the WSDL description of the interface is read using HTTP. The objects are not created in the system until you choose the Activate function. Before you activate these objects, you can save metadata managed by the transaction that contains all the information needed for generating the proxy. You can then generate the proxy itself later.