Entering content frame

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

Prerequisites

You have created a service definition with the help of the Service Definition Wizard.

Procedure

Double-click the service definition in the Object Navigator of the ABAP Workbench under Enterprise Services and choose Display/Change in the application toolbar.

Changes can be executed in the following tab pages:

This graphic is explained in the accompanying text

In this tab page you find general information on the service definition. You can change the short description.

In this tab page, you can perform the following changes:

     Change the names of operations

On the Interface tab, select the operation whose name you want to change. Enter a new name for the operation in the Name field:

     Adapt parameters

Choose the required parameter: You can then make any of the following changes to it:

      Change the parameter name

Enter a new name for the parameter in the Parameter field.

      Change the parameter type

You can change the type of a parameter if it is based on a structured type or table type.

To change the type of parameter, proceed as follows:

      Choose the Types tab.

      Select the type you want to copy. Choose Copy (from the context menu or application toolbar).

This graphic is explained in the accompanying text

      In the dialog box that appears, enter a name for the copied type. It then appears in the Copied Types category.

Fields belonging to the type can be deleted by selecting the appropriate function in the context menu.  If the copied type includes other fields that are based on a structured or table type, the context menu also contains the a Change Type option. If you want to change a type, choose a suitable type in the dialog box that appears. If appropriate, copy this type beforehand (see above).

Choose the Interface tab page to assign the new type. Enter the new type and confirm by pressing Return.  

     Specifying fixed values

Parameters that are optional in the original interface can also be optional in the service definition. In this case, the default value of the original interface is used. Alternatively, you can enter a default value yourself.

     Hide parameters    

Uncheck the Exposed checkbox.

If a parameter is hidden, it does not appear in the WSDL document at all. In such cases, the fixed value or parameter initial value is used.

     Variants

The variant of a service definition covers the following:

     Selection of features

     Publication of the service definition in the UDDI as a tModel

Features such as the communication type, authentication level, or transport properties are assigned in an abstract form. The technical details are defined when the Web service is released for the SOAP runtime.

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-oriented communication

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 be performed using the Secure-Socket Layer (SSL) protocol and X.509 client certificates. 

Transport guarantee

Choose one of the following options:

·         None

·         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. The SSL then encrypts the data.

 

Publish the service definition in the UDDI as a tModel. Choose UDDI underneath the service definition and choose Publish in the context menu. To access the UDDI Registry, enter a UDDI Registry, a user name, and a password in the dialog box that appears. (See also Maintaining UDDI Registries.) You need only enter a user and password if you have not entered a default user when setting up the UDDI Registry. The UDDI Registry returns the tModel key of the registered WSD and copies it to the service definition.

The browser of the UDDI client appears when you choose Change. In the Service Definition Details tab, the URL under which the WSDL document for the service definition can be called is displayed. Save your changes. Activate the service definition.

Next step:

Releasing a WSD for the SOAP Runtime

See also:

You will find information on changing a message interface in the section Structure linkMessage Interface.

 

Leaving content frame