Configuring the Web Service Connection

When you select a method, a SOAP Header, or a parameter within a method or SOAP Header, the right pane of the Configuration tab displays any properties that you can set for the object you select. Only properties that are valid for the selected object display.

From the Edit Web Service Configuration tab, you can:

configure the Web Service connection

  1. From the left pane, select any methods or parameters that you want to change from the default (or from the imported settings).
  2. When you select an object from the left pane, any valid configuration parameters display on the right, as described in:
  3. Make changes to the properties as needed.
  4. When you are done, open the Validation tab and click Validate.
  5. Then click Save to save your work and close the Edit Web Service page.

configure a method

  1. From the Properties section, select how you want to use this method:
  2. From the Derived Object Mapping section, you can associate the parameters in this method that are associated with a derived class.

    If a parameter references as base class and you need to create an instance of one of its derived classes, then enter the complete name of the base class and the derived class separated by a colon:

    baseclass:derivedclass, baseclass2:derivedclass2...

    Note: For information about derived classes for your Web Service see the documentation or administrator for that Web Service.

  3. After adding object mappings, open the Validation tab and click Validate so that any properties or arrays on the derived classes will be available for configuration.
  4. From the Array Elements section, specify the number of array elements to display. By default, there is no limit to the number of supported elements. To create a fixed-length array, change this number as required to direct Insight to process a specified number of elements. See Working with arrays for more information.

    For example, if your data has multiple address lines, and you want to ensure that the first 3 address lines are always mapped, you can set the size of the Address array to 3 elements.

    Web service showing array elements

  5. After adding array elements, open the Validation tab and click Validate so that any arrays will be available for configuration.
  6. Optionally, select a parameter to configure then select properties for that parameter. Only properties that are available for the parameter display.

Set SOAP Header Properties

If the Web method requires a SOAP header, you can set the value of the fields on the SOAP header. Values can be set statically or dynamically. See Default values and Runtime variables for more information.

To set a value for a SOAP Header:

  1. Click SOAP Headers to expand the tree view. SOAP Headers are listed with the SOAP Header Name (as defined in the WSDL) and field names in a flat table.

    For more information, see the description of SOAP header components in the Insight Online Help.

  2. Select the SOAP Header name and set the value for this field in the Value text box. You can enter either a static value or a variable for the SOAP Value.

Import and Export Web Service configuration settings

After you configure a Web Service for your environment, you can save and export the settings as an XML file. Once the settings have been saved, you can import them back into other Connections in other DTS files (including Connections on other computers).

export Web Service configuration settings

  1. After setting properties for this Web Service, click Export from the Configuration page.
  2. Specify a name and location to save the configuration file.
  3. Click Save.

    The file is saved as an XML file in the location you specified.

import Web Service configuration settings

  1. From the Configuration tab of the Edit Web Service page, click Import.
  2. Browse to the location of the configuration settings XML file.
  3. Select the configuration file you want to import and click OK.

Changing The default Timeout

The default timeout for the Scribe Adapter for Web Services is 1 minute. The timeout specifies the length of time that a web service call waits for a response from the web service. There may also be a timeout setting on the web service itself. The lowest timeout setting, either on the web service or in Insight, is used.

You can adjust the timeout by changing the binding settings one of the Scribe application configuration files (either TWorkbench.exe.config or MessageProcessor.exe.config). The format for the setting is hours:minutes:seconds or hh:mm:ss.

To change the length of the default timeout, create a binding called ScribeDefaultBinding on the system.

See Also

Editing Web Service connections

SOAP Headers