Default values

Web methods take input values and may return output values. With that basic design principle of a Web method, the Adapter for Web Services provides you the ability to define default values for the input values.

To use a Web method as a source, you may have to provide "input" values to get the return "output" value that will ultimately represent your source data.

For example, suppose that your Web method returns an array of customers as the output value. However, this Web method requires that you supply filter information as "input" values.

GetCustomers([in] FilterCriteria): [out] CustomerArray

To get the array of customers you wish to use , you must first supply filter criteria as an "input" by setting the default value for FilterCriteria input value.

In this example, you could set the default value to "*" (a wildcard). Then, when the GetCustomers(...) method is called, the value "*" will be supplied to the Web Service and the subsequent CustomerArray will contain your source data.

Every parameter in a method is prefixed with the direction of the parameter: [In], [Out], [In Out], or [Return].

To set the default value for a specific field:

  1. In the Scribe Workbench, click View > Connections. The Connection Manager dialog box appears.
  2. Select the Web Service connection and click Edit. The Connection Settings dialog box appears.
  3. Click the Connection tab.
  4. Click Change Connection. The Connection Information dialog box appears.

    If you are modifying a connection that is not used in a DTS, click Connection.

  5. Verify Web Services is selected and click OK. The Web Service Connection Manager dialog box appears.
  6. Select the Web Service you want to edit and click Edit. The Edit Web Service dialog box appears.
  7. Click the Configuration tab.
  8. Select the method, and then the parameter that you want to configure.
  9. As you select a parameter, the properties that you can assign display. Select any optional properties that you want to assign to the parameter.
  10. In the Value text box, type the default value or select it from the list.
  11. If desired, for Return parameters, enter the Failure Condition.

    Foo For Return parameters only, enter a regular expression to evaluate. If the value satisfies the regular expression, the Web method call is considered to have failed and that failure is logged.

Note: The Value text box includes the predefined values for :UserID and :Password. You can use these values to bind a user Id and password to specific parameters of a method designated as the Log On method. You can also define Web Service variables to be evaluated before or after the web method has been called.

See Also

Web Service variables

Editing Web Service connections

Log on and log off methods

Properties

Samples