Chapter 5: Web Console—Web Services

Web service administration

This section describes the procedures used to manage individual Web services.

Viewing or modifying Web service properties

Expand the Web service collection that contains the Web service you want to view or modify.
Highlight the Web service.
Select the General tab to view the Web service properties. See Table 5-3 for a description of the Web service properties.
Select the WSDL tab to view the WSDL for this Web service.

Activating a Web service

If a Web service is deactivated, the Web service icon has an “X” through it. You must activate the Web service to make it available to clients.

Expand the Web service collection that contains the Web service you want to activate.
Right-click the Web service and select Activate.

Deactivating a Web service

If a Web service is activated, the Web service icon appears without an “X” through it. Deactivate a Web service to make it unavailable to clients.

Expand the Web service collection that contains the Web service you want to deactivate.
Right-click the Web service and select Deactivate.

Deleting a Web service

This procedure deletes a Web service from a Web service collection.

Expand the Web service collection you are deleting.
Right-click the Web service and select Delete.

Table 5-3 describes the Web service properties.

**Table 5-3: Web service properties**
Property type	Property	Description
General	Name	The name of the Web service.
	Description	A description of the Web service.
	Implementation type	The type of component, class, or file that implements the Web service.
	Implementation class name	The name of the class file implementing the Web service.
	Style	The SOAP binding style: Document – indicates that the SOAP body contains an XML document. RPC (remote procedure call) – indicates that the SOAP body contains an XML representation of a method call.
	Use	The SOAP body use: Literal – if using a document binding style. Encoded – if using an RPC binding style.
	Service URL	The path, URL, or endpoint from which the Web service can be accessed.

Web service operation management

This section includes the procedures used to manage the operations (methods) of a Web service.

Overloaded methods

If you deploy a Web service that contains overloaded methods, the Web console displays only the first method of the overloaded method. Allowing or disallowing access to the method, affects all overloaded methods.

For example, if the Web service contains an overloaded method that contains the methods echo(String, String) and echo (String), the GUI displays only echo (String, String) twice, but the allowed/disallowed operation affects both echo(String, String) and echo(String).

Viewing or modifying Web service operation properties

Select the Web service collection and Web service you want to view or modify.
Highlight the Operations folder.
Select the General tab to view the Web service Operations properties. See Table 5-4 for a description of the Web service properties.

Allowing an operation

Select the Web service collection and Web service that contains the operation to which you want to allow client access.
Highlight the Operations folder.
Right-click the operation and select Allow.

Disallowing an operation

Select the Web service collection and Web service that contains the operation to which you want to disallow client access.
Highlight the Operations folder.
Right-click the operation and select Disallow.

Invoking an operation

Select the Web service collection and Web service that contains the operation you want to invoke.
Highlight the Operations folder.
Right-click the operation and select Invoke.
If a role is assigned to the operation, you may need to provide a user name and password to invoke the operation:

If a role is not assigned to a Web service operation, you do not need to provide a user name or password to invoke it. If a role is assigned to the Web service operation, you must provide a valid user name and password for a user within the assigned role.

Table 5-4 describes the Web service operation properties.

**Table 5-4: Web service operation properties**
Property type	Property	Description
General	Name	The name of the operation.
	Description	A description of the Web service operation.
	Binding Style	Specify the SOAP binding style: Document – indicates that the SOAP body contains an XML document. RPC (remote procedure call) – indicates that the SOAP body contains an XML representation of a method call.
	Return Type	Specifies the return type of the method.
	Is Return Value In Response Message	True or false.
	SOAP Action	The URI for the SOAPAction HTTP header for the HTTP binding of SOAP. The SOAPAction HTTP request header field can be used to indicate the intent of the SOAP HTTP request. The URI identifies the intent.
	Message Operation Style	Document, RPC, or wrapped.
	Is Allowed	True or false. Determines whether or not the method is available to a client as a Web service endpoint.

Web service parameter management

This section describes the procedures used to manage the parameters for a given method or operation of a Web service.

Viewing or modifying parameters

Select the Web service collection and Web service you want to view or modify.
Highlight the Operations folder.
Highlight the operation of interest.
Click the Parameters folder.
Highlight the parameter of interest.
Select the General tab to view the parameter properties. See Table 5-5 for a description of the parameter properties.

**Table 5-5: Web service parameter properties**
Property	Description
Name	Name of the parameter.
Type	The type of parameter. The type cannot be edited.
Mode	The mode of the parameter, “in”, “out”, or “inout”.
Order	The order of the parameters. If there is only one parameter, the order is “0”.