Skip to main content

Pentaho+ documentation has moved!

The new product documentation portal is here. Check it out now at


Hitachi Vantara Lumada and Pentaho Documentation

Web services steps

Parent article

PDI jobs and transformations can interact with a variety of Web services through specialized steps. How you use these steps, and which ones you use, is largely determined by your definition of Web services. The most commonly used Web services steps are:

The Web Service Lookup step is useful for selecting and setting input and output parameters via WSDL, but only if you do not need to modify the SOAP request. You can see this step in action in the Web Services - NOAA Latitude and Longitude.ktr sample transformation included with PDI in the /data-integration/samples/transformations/ directory.

There are times when the SOAP message generated by the Web Service Lookup step is insufficient. Many Web services require the security credentials be placed in the SOAP request headers. There may also be a need to parse the response XML to get more information than the response values provide (such as namespaces). In cases like these, you can use the Modified Java Script Value step to create whatever SOAP envelope you need. You would then hop to an HTTP Post step to accept the SOAP request through the input stream and post it to the Web service, then hop to another Modified Java Script Value step to parse the response. The General - Annotated SOAP Web Service call.ktr sample in the /data-integration/samples/transformations/ directory shows this theory in practice.