Web Service Homepage 

Definition

The Web service homepage provides the following services to its user:

·        List of all Web services deployed on theJ2EE Engine

·        Documentation on the Web service

·        WSDL documents

·        Test options

You can test only Web service endpoints that require basic HTTP authentication (user ID and password) or no authentication.

For the needs of the Web service testing, you can create an endpoint with “Basic” or “None” authentication.

Use

You can call the Web service homepage in one of the following ways:

●      In the SAP NetWeaver Developer Studio

Choose Window → Show View → Others → Web Services → Web Service Navigator. Select the required Web service and choose Open from the context menu. The displayed homepage does not provide the WSDL documents.

●      Using the Web service URL

●      Using the Visual Administrator

The WebServicesAddOn.ear must be started.

·        Using the Web service URL

When you open the Web services homepage, by default, the system prompts you to enter username and password. The user has to be part of the WSNavigatorRole or administrator’s security role.

To set a user as part of the WSNavigatorRole, proceed as follows:

                            a.      Open the Visual Administrator.

                            b.      On the Cluster tab of the Visual Administrator, choose Security Provider.

                            c.      On the Runtime tab, choose Policy Configurations tab, and then choose sap.com/com.sap.engine.services.webservices.tool*wsnavigator.

                            d.      On the Security Roles tab, choose WSNavigatorRole.

                            e.      To switch to edit mode, choose

                              f.      Choose Modify.

                            g.      On the Security Roles area, choose all, and then choose Save.

Structure

The homepage contains the following sections:

●      Home

This page is displayed only if you use the Web service URL or the Visual Administrator for calling the homepage. It provides a way of displaying the WSDL of the service by entering the URL of the document. In addition, it lists all Web services deployed on the J2EE engine. Select one of them to view its data.

When you enter a WSDL URL, which points to a remote system, the Web Services Navigator verifies the host name in an allowed hosts list. If the host name is not in the list, then the Web Services Navigator does not establish a connection to the remote system at all.

More information about editing Web Services Navigator allowed hosts list: Configuring Global Settings

In addition, you can view all Web services deployed on the J2EE Engine through Telnet using the LIST_WS shell command. For more information about the Web services shell commands available, see WEBSERVICES.

●      Overview

On the Overview page you can see the WSDL file for the Web service that this homepage represents. Also, you can find the description of the Web service written in the WSDL file, UDDI publications if available, and tables with the features that are supported by all port types and bindings.

The Web service can be registered or published in a UDDI registry using the UDDI client.

●      WSDLs

There are two kinds of WSDLs – Standard and SAP WSDL. The standard WSDL is provided for those users who will use tools from other vendors to create clients. For SAP users, there is an extended SAP WSDL. This is an extended version of WSDL and can be parsed using SAP tools (SAP Proxy Generator), thus providing information about additional Web service requirements such as authentication, session, and so on.

●      Test

On the Test page you can test a specific operation for any WS port. The page displayed contains all the WS ports and operations for a specific port. Select the operation that you want to test. A structured tree is displayed that represents the request that will be sent to the server. You can modify the request by modifying the tree, for example, you can add or remove elements to arrays, send NULL values, or skip fields. To send the request to the server, choose Send. After receiving the response, structured trees are displayed that represent the request and the response. In addition, the real request and response are displayed.

Some of the headers may be hidden because of security reasons.

The test page is only for test purposes. You must not use it in a real scenario for a secured Web service under SSL because the SSL requests are displayed unencrypted.

 

Integration

You can provide access to the Web Service Navigator for particular user groups using the Security Provider Service in the Visual Administrator. In the Policy Configurations tab, select sap.com/com.sap.engine.services.webservices.tool*wsnavigator and choose the Security Roles tab.  Then, choose WSNavigatorRole and manage the users and groups that shall have access to the Web Service homepage. For more information about providing authorization and managing security roles, see Security Provider Service.