/
Web Service (3.1)

Web Service (3.1)

Owned by Jenni Wallin
May 10, 2023

The Web Service (WS) profile enables you to define a web service. One profile defines one web service.

  • To open the configuration dialog, click the Configuration button in the upper left part of the  Desktop window. Then select WS Profile from the menu.

Note

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

In the WS profile you specify a WSDL file that includes the following parts of a Web Service definition:

  • XML Schema: Defines information about the service either directly or via an XSD-file

  • WSDL: Communication relevant information

  • Binding elements:  supports only SOAP bindings

The WS profile can include more than one WSDL file reference.

The WS profile is loaded when you start a workflow that depends on it. Changes to the profile become effective when you restart the workflow.

Saving a WS profile that is assigned with a WSDL file, maps data types that are specified in the WSDL Schema section as UDR types for the  workflow. For further information, see Web Service UDRs(3.0).

When saving a Web Service (WS) profile, the profile is saved in the folder selected in the Save As dialog with the name entered.

When the WS profile is saved, a number of UDRs are generated. They are saved in a folder structure based on the WS profile name. If a user renames or moves the profile to a new folder, the UDR's folder structure is not automatically adjusted and saved along with the WS profile. Therefore it is important to make sure the WS profile is saved in the appropriate place with a suitable name.

Note!

The name of the folder to which you save the WS profile or the WS profile name cannot include a dash (-). A dash in the folder or profile name invalidates the WS profile.

Note!

If possible, avoid renaming. If you must rename the profile, it must be saved again in its new location, regenerating the UDRs there. For further information about viewing the UDR type structure, see Web Service UDRs(3.0).

The Web Service profile configuration contains four tabs: Configuration, WSDL Content, Security, and Advanced.

Configuration Tab

The Configuration tab has the sections: Create Configuration From, Service Port Definition, and Validation.

Create Configuration From

The Web Service (WS) profile configuration can either handle single WSDL files or several WSDL files, which all can be concatenated, using the concatenate WSDL file 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 in . The any type maps to an org.w3c.dom.Element in java, which does not map to Ultra.

SettingDescription

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 are imported at the same time as the WSDL file. If not, a validation error occurs.

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 are shown in the View WSDL Content tab.

Full validation of the WSDL file is performed when the profile is saved.

The Web Desktop

If using the Web Desktop it is not possible to upload WSDL files linked to xsd files.

Note

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

Import WSDLClick to import the selected WSDL file.

Export WSDL

Exports the original WSDL file to a directory on the local workstation.

Concatenated WSDL Files

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 the Add button and browse for the correct WSDL files in the Add WSDL File dialog box.

The list of WSDL files are concatenated when the profile is saved. The concatenation functionality concatenates and arranges all operations defined in the WSDL binding element of several WSDL files so that the result is a valid WSDL file.

Service Port Definition

The 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.  

  • Select a port to set the bindi