Importing Web Services 

Use

You can import Web services in CAF and map them to existing application service operations of your composite application and consume them later. You cannot configure reliable messaging for external services you have imported in your composite application. You can see which of the operation of the external service support reliable messaging in the Operations tab of the external service editor.

When you import a Web service, you can assign it to a particular ServiceGroup.

More information: Creation of Configuration Data

Prerequisites

You have configured the Universal Description Discovery and Integration (UDDI) server. To do that, in the SAP NetWeave Developer Studio, choose Window → Preferences → Web Services → SAP Services Registry  in the Server Name field enter name of the UDDI server.

When designing your composite applications you can consume existing enterprise services and map them to customizable application services that fit your particular needs.CAF allows you to edit the services in an entirely model-driven manner, which ensures flexibility, reusability, ease of development, and increased development productivity.You can browse the enterprise services that are offered in the Enterprise Service (ES) Workplace of the SAP Developer Network.

More information: Importing WSDL Documents in the SAP NetWeaver Developer Studio.

Procedure

       1.      In the Composite Applications Explorer of SAP NetWeaver Developer Studio, choose the CAF application in which you want to import a Web service.

       2.      Click the external node with the secondary mouse button and choose Import Web Service.

       3.      To import a WSDL definition, select one of the available WSDL sources:

○       Enterprise Service Repository – imports a Web service from a repository. Based on a WSDL definition you generate the service's implementation skeleton. This skeleton is a CAF application service containing service's operations with their input/output parameters.

More information: Implementing Web Services in CAF

○       Remote Location / File System – imports a Web service from your local file system or from another location.

...

                                                  i.       In the URL field, enter a URL address of a Web service.

                                                ii.       Choose Next.

○       Service Registry - imports UDDI (Universal Description, Discovery, and Integration) service or classification service

...

                                                  i.       Enter username and password for the UDDI and classification service.

                                                ii.       Choose Next.

                                               iii.       In the Search for definitions by field, enter the name of the Web service and choose Name from the dropdown box. You can use wild cards for the search.

                                               iv.       Choose Next.

                                                 v.       Select a service definition and an available endpoint for this definition.

                                               vi.       Chose Finish.

If the Web service requires authentication you may be prompted to enter user credentials for the server that provides the Web service.

After you import a service definition from one of the WSDL sources, choose Next.

       4.      Create a ServiceGroup for the configuration of the imported Web service. Choose from one of the following options:

○       Choose existing

○       Create new

                                                  i.       Choose a package. It equals to a java package in the EJB module.

                                                ii.       Enter a name for the ServiceGroup. You use it at runtime later.

                                               iii.       Enter an appropriate description for the ServiceGroup.

                                               iv.       From the Create in project dropdown box, choose for which project you want to create the ServiceGroup. In CAF only the EJB module is available.

○       No service group configuration – you do not need to assign your Web service to a ServiceGroup if your application has a dependency to a ServiceGroup Configuration development component.

To change the basic configurations of the service you have imported, open the Mass Configuration pane in the external service editor and choose Edit Service References.

       5.      If you need to apply customization for the imported WSDL definition, enable the Apply JAX-WS external customization files indicator. This way you can change the hierarchy of the Java packages or change the name of a particular Java file.

The location of all xsdand wsdlfiles is displayed in a new window, so that you can write proper external customization bindings. To read the specification of the JAX-WS technology, visit the link below.

 https://jax-ws.dev.java.net/

Result

The imported Web service appears under the external package node in Composite Application Explorer. You can now create mappings for the Web service.

More information: Mapping Service Operations

You can view the location of the WSDL on the local file system. To do that, click on the imported Web service with the secondary mouse button and from the context menu choose WSDL Document Location.

To check whether any of the operations of the service you have imported supports idempotency or reliable messaging, open the Operations tab page and check the Idempotency and WS-RM columns in the Existing Operations table.

You need to configure the ServiceGroups in SAPNetWeaver Administrator, after you have assigned the imported Web service to it.

More information: Configuring Consumer Applications