Using the Web Service Task
The Web Service Task is an SSIS control flow component that can be used to read / retrieve data from a web service.
The component includes the following two pages to configure how you want to read data.
- Error Handling
The General page of the Web Service Task allows you to specify the general settings of the component.
The Web Service Task requires a connection in order to connect to a web service. The Connection Manager drop-down will show a list of all connection managers that are available to your current SSIS package.
Note that the Connection Managers offered within this toolkit are the following:
- HTTP Connection Manager
- Source WSDL
The Source WSDL field specifies the location of the WSDL that you are trying to read from. This location can be either a location on the file system, or a URL. For example a value of: c:\wsdl\mathservice.wsdl or http://localhost:28854/MathService.svc?wsdl will both work. There is a button labelled "..." beside the source WSDL field that will launch a dialog let you select a file from the file system. If you select a WSDL file using the open file dialog provided by the "..." button the WSDL file will automatically be loaded upon clicking OK.
- Load WSDL button
The Load WSDL button will try to load a WSDL file from the location specified in the Source WSDL field, and it will populate the other fields in the editor with information from the loaded WSDL file. Use this button after you have entered the path of a WSDL file into the source WSDL field. If you select a WSDL file from the open file dialog provided by the "..." button the WSDL file will automatically be loaded upon clicking OK.
Select a Service from the list of services contained in the web service.
Select a Binding from the list of bindings contained in the service.
Select an Operation from the list of operations contained in the binding.
- Input Parameters
After selecting an operation, the Input Parameters grid will be populated with a list of parameters of the input message, and their types. Values can be entered into the value field for each parameter. Use the checkbox column to determine whether or not a parameter will be sent with the input message. Entering a value for a parameter will automatically check its checkbox. Empty parameters can be used by manually clicking the checkbox.
The input parameters that are visible can be filtered by entering text in the Filter text box.
- Hide Unused Fields
When the Hide Unused Fields checkbox is checked unused input parameters will be hidden.
- Hide Used Fields
When the Hide Used Fields checkbox is checked used input parameters will be hidden.
- Custom SOAP Headers
Custom soap headers can be specified in the Custom SOAP Headers grid. Enter any namespaces, separated by semi colons, in the first column, and the header in the second column. Namespaces will be added to the SOAP envelope.
- Response Body Output
The Response Body Output radio buttons determines what will happen with the response body. The following options are available:
- None - The response body is not used for anything
- Output To Variable - The response body is output to a variable. Selecting this option will enable a drop down field that allows a variable to be chosen.
- Output To File - The response body is saved to a file. Selecting this option will enable a text field where the file name can be entered.
Error Handling page
The Error Handling page allows you to specify how errors should be handled when they happen.
There is one option available.
- Continue on Error
Checking or unchecking this option will determine if the task should continue or fail when an error occurs.