The Web Service client type generates deployment information for an OpenEdge Web service definition.

Client Details for the Web Service client type displays the following deployment settings:

• Namespace — In this field, enter a value for the Web service target namespace. This value is typically used to version the Web service in any WSDL that you generate. You can specify any value that meets the following requirements:
  • Uniquely identifies the Web service and its elements in the WSDL file
  • Uniquely identifies the Web service for the WSA instance where it is deployed
  • Meets the requirements of an XML namespace value (a valid URN or URL)

  For example:

urn:www-progress-com:OrderSvc:OrderInfo

For more information on using the target namespace for Web service versioning, see the sections on versioning Web services in OpenEdge Application Server: Administration.

• Generate Test WSDL — If you check this box, ProxyGen generates a WSDL file with the specified style/use (See the WSDL Style radio buttons).
• URL for WSA — In this field, enter the URL of the Web services adapter instance to which this Web service is deployed. This value can be modified at deployment time. For more information on this URL, see the sections on Web services administration in Web Services.
• SOAP Action — These radio buttons specify how you want the string value for the SOAP Action Header to appear in the WSDL file for each SOAP message: Blank or User-defined (any value you enter, including blank).

  If you select both User-defined and the Append Object Name check box, the name of the Web service object is appended to the value you enter, to form the SOAP Action Header value.

• WSDL Style — These radio buttons specify the format for SOAP messages supported by the Web service. The selected style/use must match the SOAP format supported by the client applications you intend to support.

  Style refers to the communications style. Some applications communicate by exchanging messages as remote procedure calls (RPCs), while others communicate by exchanging messages as XML documents.

  Use refers to the syntax or format of each message itself. The formatting of the messages can be encoded according to a set of encoding rules or represented literally using XML schema standards.

  Select one of the following style/use combinations:

  • Document/Literal — This option is the default because the entire SOAP message is defined in a single entity.
  • RPC/Literal — This option defines the entire SOAP message in a single entity and formats the message literally using XML schema standards.
  • RPC/Encoded — This option is not recommended. Although this option is legal for Web Services, it is not WS-I compliant, because the message cannot be validated since not all of the SOAP body is defined by XML schema.

  For more information on the WSDL style and use attributes and how they affect Web service client communications, see Develop Web Services.

• Suffix — These options specify the content and formatting of the generated WSM file and optional test WSDL file (See the Generate Test WSDL check box):
  • PortType/Binding — In this field, enter a custom suffix for the PortType and Binding name in the WSDL file. If you check the Use Default box, this field is disabled and displays the default value for the suffix (Obj).
  • Web Service — In this field, enter a custom suffix for the Service name in the WSDL file. If you check the Use Default box, this field is disabled and displays the default value for the suffix (Service).