Web Service Call Settings

www.altova.com Print this Topic Previous Page Up One Level Next page

Home >  Calling Web Services >

Web Service Call Settings

You can change the settings applicable to Web services from the Web Service Call Settings dialog box. To open this dialog box, do one of the following:

 

Click the Web service component on the mapping, and, then, on the Component menu, click Properties.
Double-click the component header.
Right-click the component header, and then click Properties.

 

The list of available settings depends on whether the Service definition option at the top of the dialog box is set to WSDL or Manual. The following image illustrates the settings applicable for a generic HTTP Web service:

mf_ws_01

The following image illustrates the settings applicable for a WSDL-style Web service:

mf_ws_08

 

The available settings are described below.

 

Service Definition

If the settings you define apply to a WSDL-style Web service, select WSDL. Otherwise, select Manual.

 

When Manual is selected, you must enter the Web service settings manually into the dialog box. Optionally, if you have the WADL file of the Web service, you can import the Web service settings by clicking Import from WADL (see Importing Web Service Information from WADL). Also, if you want to extract the Web service parameters from a URL, click the Import from URL button (see Importing Web Service Parameters from URL).

 

WSDL Settings

This group of settings is applicable only for WSDL-style Web services.

 

WSDL Definitions

Specifies the Web Service Definition Language (WSDL) file of the web service to be called.

Service

Specifies the name of the Web service to be called. If the WSDL file defines multiple web services, click Choose to select the required one.

Endpoint

Specifies the endpoint (or port) of the Web service to be called. If the selected Web service defines multiple web service endpoints, click Choose to select the required one.

Operation

Specifies the operation of the Web service to be called. If the selected endpoint defines multiple web service operations, click Choose to select the required one.

 

Request Method

This setting is applicable only for generic (not WSDL) Web services. It defines the HTTP method (verb) used by the service (for example, GET, POST, PUT, and so on).

 

Connection Settings

URL specifies the address (URL) of the Web service. Timeout defines the time interval after which the Web service call will time out if there is no response from the server. Select Infinite if the call should wait for a response for an indefinite amount of time.

 

If you would like to supply the URL of the Web service from the mapping, select the Dynamic URL (supplied by mapping) check box. This creates an additional input connector on the Web service component on the mapping, to which you can connect some input which provides the URL of the Web service.

 

Parameters

This group of settings is applicable only for generic (not WSDL) Web services. The Parameters table specifies the URL parameters with which MapForce will call the Web service (see Defining Web Service Parameters).

 

Structures

This group of settings is applicable only for generic (not WSDL) Web services. For more information, see Defining the Request Structure and Defining the Response Structure.

 

HTTP Security Settings

If the Web service requires authentication (either HTTP or HTTPS), click Edit to specify the required authentication settings (see Setting HTTP Security).

 

WS-Security Settings

These settings are applicable only for WSDL-style Web services. If the Web service uses SOAP security, click Edit to specify further settings (see Setting WS-Security).

 

Save all file paths relative to MFD file

When this option is enabled, MapForce saves the file paths displayed on the Component Settings dialog box relative to the location of the MapForce Design (.mfd) file. See also Using Relative and Absolute Paths.


© 2019 Altova GmbH