Manually

Kalipso - Developing - Specific options - Web Services - Manually

When you open the option, a window appears with three tabs that make it easy to fill in the necessary fields. Thus, tabs allow:

Tab - General

The fields are:

• Name - Name for the Web Service. The name cannot contain spaces.

• WSDL Address - Field to place the WSDL (Web Services Description Language) address.

• User - Enter the user, if applicable, to access the server where the web service is provided.

• Encoding - The encoding schema used for the communication. The possible options for this parameter are:

  • utf-8

  • utf-7

  • ansi

  • unicode

• Port - The Port where the Web Service is available. This value is inherited from the Web Service Properties but it can be overwritten.

• Passw - Enter the password for the user to access the server where the web service is provided.

• XML Version - Enter the XML version. If you are unsure, please do not enter a value here.

• Description - Description for the Web Service. Kalipso does nothing with this field. Is for your information only.

Tab - Details

This tab allows to view the details of the operations. Thus, the table that is presented indicates the operations divided by "Soap", "Soap 1.2", "HTTP Get" and "HTTP Post". The table itself provides the following columns:

• Name - Name of the web service created (tab General)

• Type - The type of the field.

• Min. Occurs - Minimum number of occurrences.

• Max. Occurs - Maximum number of occurrences.

On the right side of the tab are icons that allow actions on the operations in the table. The icons are:

• Add - Adds a soap operation (this opens a new window).

• Modify - Modify a selected operation on the table (opens a new window).

• Refresh - Refresh the operation on the table.

• Delete - Deletes a selected operation on the table.

Clicking on adding a selected operation, the following window appears:

The fields in this window only appear when there is no service that is already associated. Hence it will question more elements.

The available fields are:

• Name - Name for the operation

• Location - URL where the WSDL file is located

• Soap Action - Enter the soap action manually

• Input Type - Enter the input type. It can be one of:

• Namespace - The default XML namespace to use for the XML Web service.

• Message - Represents the data in a SOAP request or SOAP response at a specific SoapMessageStage.

If you already have an association with a Web Service, then you can add parameters or attributes in this tab. So, when you click on the add button, the system asks if you want to add:

• Parameter before

• Parameter after

• Sub-parameter

• Attribute

Then, a window asks (parameters options):

• Name - Name of the web service.

• Type - The type of the field. Choose from a predefined list.

• Min. Occurs - Minimum number of occurrences. From 1 to 9.

• Max. Occurs - Maximum number of occurrences. From 1 to 9 and unbounded.

Adding an attribute the window asks:

• Name - Name for the attribute

• Type - The type of the field. Choose from a predefined list.

At the end just click the "Add" button to save and make the information available in the previous table.

It is usually not necessary to use these options (add or edit). Only in case there is any problem with the connection to the WSDL file then edit using these options. However, we advise you to do this carefully.

Tab - WSDL

Area where the Web Service code that was obtained after binding with WSDL appears. A button is also available to refresh the information reconnecting with the online server.

If you added an address on the previous screen then this area will appear pre-filled with the webservice code.

After importing a Web Services definitions through their WSDL (Web Services Description Language) then you can execute them in your project with the WebServiceRun Action.

The images shown above contain example information. The content appears because it was previously associated with a web service.