Web Service Profile Configuration Tab

To open the configuration dialog, click the New Configuration button and select WS Profile from the Configurations dialog.

Note

Any restrictions on the WSDL format will be ignored by the outgoing web service.

The Configuration tab consists of three parts: Create Configuration From, Service Port Definition and Validation.

The Web Service profile - Configuration tab

Create Configuration From

The WS profile configuration can either handle single WSDL file or several WSDL files, which all can be concatenated, using the Concatenated WSDL Files functionality.

The WSDL file must be a valid XML and must adhere to the W3C specifications - see http://www.w3schools.com/xml/xml_elements.asp. It is recommended that you use a validation service, outside , to check that the WSDL file is valid.

Note!

The type any cannot be used in a WSDL file. The type any maps to an org.w3c.dom.Element in java, which does not map to Ultra.
Web services require a namespace to be defined for the reference binding port !

Setting Description

Single WSDL File

The Import WSDL button is used to browse for, and import, a selected WSDL file. If the WSDL file is linked to adherent xsd files, all included files must be stored in the same directory as the imported WSDL file. If present, they will be imported at the same time as the WSDL file. If not, a validation error will occur.

Basic validation of the WSDL file is performed before the file is imported. After the file is imported, the content of the WSDL file and adherent files can be viewed in the View WSDL Content tab.

A more extended validation of the WSDL file is performed when the profile is saved.

Note

If you configure the Web Service agents with any value that contradicts the WSDL file specifications, your configuration will override the WSDL file.

Note!

If you are unable to import an encoded non-ASCII WSDL file to Web Services Profile, you need to ensure that the WSDL file is encoded with UTF-8 and includes the following header:

<?xml version="1.0" encoding="UTF-8"?>

You can use the Export WSDL button to export the original WSDL file to a directory on the local workstation. Refer to Web Service Profile Configuration Tab for further information.

Concatenated WSDL File

Used when parts of several WSDL files are required. The functionality is only useful if operations defined in bindings in several WSDL files shall be published at the same endpoint.

To add files to the Files list click on the Add button and browse for the correct WSDL files in the Add WSDL File dialog box.

The list of WSDL files will be concatenated when the profile is saved. The concatenation functionality concatenates and arranges all operations defined in the WSDL binding element of several WSDL files and everything else that is needed for the result to be a valid WSDL file.

The original WSDL file can be exported to a directory on the local workstation. Click on the Export menu and select the Export WSDL option.

Service Port Definition

This drop-down list consists of the service port definitions that are included in the WSDL file. Only one service element per WSDL file is supported. By selecting a port you set the binding address.

Note

If the WSDL file consists of several concatenated files, only the first WSDL file service port is applicable.
The Service Port Definition entries appear in the following format:
```
XXX:YYY(ZZZ).
```
- XXX: Currently only SOAP ports are supported.
- YYY: The name of the port.
- ZZZ: The binding that the port is connected to.

WSDL Validation

Setting	Description
Enable Desktop WSDL Validation	Select this checkbox to perform the WSDL validation in the client desktop during validation of the profile.
Enable Platform-Side Schema Validation	Select this checkbox to verify the WSDL file against WSDL schemas. This can only be performed in Platform during the save action. Note Validation will work if platform has external internet access.