Entering content frame

Procedure documentation Creating a Web Service Definition Locate the document in its SAP Library structure

Use

The Web service definition (WSD) includes:

·         The specification of the behavior of a Web service

·        The publication of the WSD in the UDDI as tModel

Features such as communication type or authentication level are assigned in abstract form. The technical details are defined in the Web service configuration.

Through the assignment of abstract features, you ensure that a WSD can be used for various application servers that have different technical features. The proxy generation on the client side refers to the WSD. Technical details that are predefined in the Web service configuration are configured separately in the WS client runtime.  

Prerequisites

You have created a VI.

Procedure

To create a WSD, proceed as follows:

...

       1.      Select the VI and choose New ® Web Service Definition in the context menu.

       2.      In the following dialog box, enter the required data.

This graphic is explained in the accompanying text

Choose Finish. In the Overview tab, the name of the WSD and the VI on which the WSD is based are displayed.

       3.      Choose the Features tab.

This graphic is explained in the accompanying text

The selection options in the lower section of the screen refer to the features selected in the upper section. The following options are available:

Feature:

Selection:

Meaning:

Session

Choose Select Feature.

Choose this feature if communication is to be stateful.

Authentication

Choose one of the following options:

·         No authentication

·         Basic (user/password)

·         Strong (incl. certificates)

Choose Basic (user/password) 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.

Choose Strong if authentication is to additionally require X.509 client certificates. For more information, refer to the section Web Services and Security.

Authorization

Choose Select Feature.

Operation calls can be protected using security roles.

For more information, refer to the section Web Services and Security.

Security roles are assigned when creating the Web Service Configuration .

Transport guarantee

Choose one of the following options:

·         No

·         Integrity + Confidentiality

Choose Integrity + Confidentiality if data that is to be passed from Web service clients to the server through SOAP requests is to be encrypted. This is done with the help of the Secure Socket Layer protocol (SSL), also called HTTPS. 

Note

For more information on how to activate SSL, refer to the section Structure linkUsing the Secure Sockets Layer Protocol.

       4.      Choose the Documentation tab and enter the documentation of the Web service. This will be displayed in the Web Service Homepage.

       5.      Choose the UDDI tab. In the following dialog box, enter the user name and the password. Authentication is necessary to store the VI and WSD on the SAP J2EE Engine. Storage takes place with the help of a simple repository (DTR_LITE). This repository is part of the Web service framework.

Note

Enter the name of the application server and the http port under Window ® Preferences  ® Web Services in the SAP NetWeaver Developer Studio.

The fields UDDI Client Context Root and WSD Upload Servlet Context Root have default values and should only be changed if necessary.

Choose the checkbox Enable Automatic Upload on Save if the VI and WSD are to be updated automatically in the DTR_LITE upon saving.

Choose Reset Upload Username/Password if you want the user name and password to be reset.

       6.      Choose Publish. The WSD is published as tModel in the UDDI registry. Then you see the browser of the UDDI Client:

This graphic is explained in the accompanying text

In the Service Definition Details tab, the URL under which the WSDL document for the WSD is stored is displayed.

       7.      Choose the Publish pushbutton in the UDDI Client Browser. Confirm by pressing OK to copy the tModel key of the published tModel into the WSD. The tModel key of the registered WSD is returned by the UDDI registry.

This graphic is explained in the accompanying text

       8.      Save the WSD.

 

Result

You have created and published a WSD.

Next Step

Follow the steps given in the section Creating a Web Service and Web Service Configuration.

 

 

 

Leaving content frame