|
The General tab of the Web Service property sheet has the following components:
Name Shows the name of the selected web service.
Type Shows the type of object.
Service type Shows whether the selected web service is a RAW, XML, HTML, SOAP, or DISH web service. You can change the service type by selecting a different type from the dropdown list.
Format This field applies only to SOAP and DISH services.
Generates output formats compatible with various types of SOAP clients, such as .NET or Java JAX-RPC. If a SOAP service's format is not specified, the format is inherited from the service's DISH service declaration. If the DISH service does not declare a format, it defaults to DNET, which is compatible with .NET clients. A SOAP service that does not declare a format can be used with different types of SOAP clients by defining multiple DISH services, each with a different format type.
Data type This field only applies to SOAP services. The possible values are:
OFF No data typing of inputs and outputs. This is the default.
ON Supports data typing for input parameters and result set responses.
IN Supports data typing of input parameters only.
OUT Provides data type information for result set responses of all SOAP service formats.
Service name prefix This field applies only to DISH services. Only SOAP services whose names begin with this prefix are handled by the DISH service.
Authorization required Indicates whether users must authenticate in order to use this web service.
Select this option to indicate that authorization is required. When authorization is required, all users connecting to this service must provide a user name and password. If a checkmark appears beside the User field, you must authenticate as the specified user in order to use this web service. However, if a checkmark does not appear beside the User field and authentication is required, then you can authenticate with any database user in order to use this web service.
If authorization is not required, you must select a user from the dropdown list below. All requests are run using the account and permissions of the user specified in the User field.
User Shows which user's account is used to execute service requests. If the service does not require authorization, you must select a user from the dropdown list. All requests are run using the account and permissions of this user.
Security required Shows whether unsecure connections are accepted. Select this option to indicate that the web service requires security. If the web service requires security, then only HTTPS connections are accepted. If this option is cleared, then both HTTP and HTTPS connections are accepted.
URL path Specifies whether URI paths are accepted, and if so, how they are processed.
For more information about URLs and URIs, see:
Off Select this option if the remainder of the URI path is not permitted. If the service name ends with a forward slash (/), select Off. For example, if Off is selected and you have the URL path http://<host-name>/<service-name>/aaa/bbb/ccc, only http://<host-name>/<service-name> is permitted. The remainder of the URI path, /<aaa/bbb/ccc is not permitted.
On Select this option if the remainder of the URI path is permitted and is set as a single parameter. For example, in the URL path http://<host-name>/<service-name>/aaa/bbb/ccc, the remainder of the URI path is /aaa/bbb/ccc. It is treated as a single parameter.
Elements Select this option if the remainder of the URL path is permitted and is set as multiple parameters. For example, in the URL path http://<host-name>/<service-name>/aaa/bbb/ccc, each element of the path is treated as a separate parameter. For example, url1=aaa, url2=bbb, url3=ccc, and so on.
Comment Provides a place for you to type a description of the web service. For example, you could use this area to describe the web service's purpose in the system.