Creating a Web Service connection

To use a Web Service as a source or target, you must:

  1. Create a Web Service connection — Define a connection to a specific Web Service by specifying the location of the Web Service and any modifications you make to this specific Web Service connection. For example, you can change default values, capture unique exception scenarios, and set Web Service variables.
  2. Connect to the Web Service — After you create the Web Service connection, you need to add the connection to Insight by specifying the login information for the Web Service, including any credentials that are required.

Note: You can have more than one connection to the same Web Service, each with a different set of requirements. For example, the connections could be identical, except that each has a different connection name displayed and a different set of login credientials.

Create the connection

  1. In the Scribe Workbench, click View > Connections. The Connection Manager appears.
  2. Click New. The Add A Connection dialog box appears.
  3. Expand Adapters and click Web Services.
  4. Click OK. The Web Service Connection Manager dialog box appears.
  5. Click Add. The Edit Web Service dialog box appears.
  6. In the Location of WSDL box, enter or browse to the location of a WSDL file, which can be one of the following:
  7. In Display Name, enter a name for the Web Service connection. This name must be unique for each installation of Scribe Insight.
  8. Click Validate. When the WSDL location is verified, an Information message appears.

    Note: You cannot save or edit the Web Service connection until you have named and successfully validated a WSDL file.

  9. Click the Configuration tab and modify any property and configuration settings, as needed. For more information, see Configuring the Web Service Connection.
  10. Optionally, if you have configured a Log On or Log Off method on the Configuration tab, click the Validation tab, and select a method for this service.
  11. Click Save. You return to the Web Service Connection Manager dialog box, where the new Web Services connection appears.
  12. Click Close. You return to the Add A Connection dialog box.
  13. Click Cancel. You return to the Connection Manager.
  14. The connection you created does not appear in the Connection Manager until you connect to the Web Service.
  15. Click Close.

Connect to the Web Service

  1. In the Scribe Workbench, click View > Connections. The Connection Manager dialog box appears.
  2. Click the Web Service connection you want to use and click Edit. The Connection Settings dialog box appears.
  3. Click Change Connection. The Web Services Test Connection Information dialog box appears.
  4. Verify that Web Service is selected and click OK. The Web Service Connection Manager dialog box appears.
  5. Select the connection you want to use and click Connect. The Log In To The Web Service dialog box appears.
  6. Confirm that the location of the Web Service is correct.
  7. Select the Login Type, one of:

    Note: The credentials needed to log into a Web Service are the same as those required to navigate to the Web Service via a web browser.

    If you need to determine the Login Type, see the see the documentation or administrator for that Web Service.

  8. If required, enter an appropriate User ID and Password.

    Note: The credentials needed to log into a Web Service are the same as those required to navigate to the Web Service via a web browser.

    If you need to determine the Login Type, see the see the documentation or administrator for that Web Service.

  9. Click OK. The Connection Settings dialog box appears.
  10. If a Scribe Online message that the connection information has changed, do one of the following:
  11. Optionally, on the Global Connection Settings tab, change the Connection Name.
  12. Click OK. The Connection Manager appears with your Web Service connection listed.
  13. Click Close.

See Also

Configuring the connection

Working with methods and properties

Default values

Log on and log off methods

Catching unique exceptions