Show TOC Start of Content Area

Procedure documentation Web Service Creation Wizard  Locate the document in its SAP Library structure

Use

The Web Service Creation Wizard (WS Creation Wizard) makes it possible to define a Web service in a few steps. Features are assigned using configuration profiles.

When a Web service is defined using the WS Creation Wizard, the following are also created automatically:

·         A virtual interface

·         A Web service definition

·         A Web service and a Web service configuration

Prerequisites

You have already created an EJB project and assigned an EJB reference to this.

Procedure

...

       1.      Open the module project. Select the EJB reference under ejb.jar.xml and choose New Web Service.

This graphic is explained in the accompanying text

       2.      Enter a name for the Web service.

This graphic is explained in the accompanying text

       3.      Choose a suitable Default Configuration Type.

Configuration type:

Features:

Use:

Simple SOAP

·         Transport binding: SOAP over HTTP

·         Stateless communication

·         No security

Choose the profile Simple SOAP if the Web service is to be called over an Intranet.

Basic Auth SOAP

·         Transport binding: SOAP over HTTP

·         Stateless communication

·         Authentication: HTTP Basic

·         Authorization: Yes

All EJB security roles assigned
to all Web service methods

·         Transport guarantee: No

Choose Basic Auth SOAP if calling a Web service on the client side requires the authentication of the caller with the help of a user ID and a password.

Calling WS operations can be protected using security roles.

For more information, see Web Services Security.

Secure SOAP

·         Transport binding: SOAP over HTTPS

·         Stateless communication

·         Authentication: Certificates

·         Authorization: Yes

All EJB security roles assigned
to all Web service methods

·         Transport guarantee: Integrity and confidentiality

Choose Secure SOAP if authentication additionally requires X.509 client certificates.

Choose Integrity + Confidentiality if data that passed from Web service clients to the server, through SOAP requests, is to be encrypted. The Secure Socket Layer protocol (SSL) then encrypts the data. 

For more information, refer to the section Secure Transmission.

       4.      In the Configuration Name field, enter a name for the Web service configuration. The URL suffix in the Access URL field is set automatically. This is the relative path specification under which the Web service is found.

       5.      Choose Next.

       6.      In the dialog box that appears, select the methods that are to be offered in the Web service. Choose Finish to confirm your entries.

       7.      On the following screen, enter the name of an EAR project, if required.

To deploy a Web service, you must first assign it to an EAR project. If the workspace contains several EAR projects or none at all, you need to either enter a new name for the EAR project or choose an existing name. If only one EAR project exists in the workspace, this EAR project is selected automatically.  

This graphic is explained in the accompanying text

       8.      Deploy the Web service.

Note

Before you deploy the Web service, you can edit the virtual interface, the Web service definition, or the Web service configuration.

Select the name of the EAR project. From the context menu, choose Build EAR File.Select the name of the generated EAR project. In the context menu, choose Deploy to J2EE Engine.

In Deploy Output View, you can check whether the deployment process was successful.

This graphic is explained in the accompanying text

 

Result

You have created a Web service and deployed it.

This graphic is explained in the accompanying text

The virtual interface, the Web service definition, the Web service, and the Web service configuration were created automatically. You can now continue editing them in the EJB Explorer in the Web service perspective.

 

 

End of Content Area