Table of Contents

Search

  1. Preface
  2. Web Services
  3. SOAP Web Services
  4. WSDL Data Object
  5. Schema Object
  6. How to Create a SOAP Web Service
  7. Operation Mappings
  8. Parsing Web Service SOAP Messages
  9. Generating Web Service SOAP Messages
  10. Web Service Consumer Transformation
  11. REST Web Services
  12. How to Create a REST Web Service
  13. REST Web Service Consumer Transformation
  14. REST and SOAP Web Service Administration
  15. Datatype Compatibility

Web Services Guide

Web Services Guide

SOAP Web Service Examples

SOAP Web Service Examples

You might create a web service to access customer data or you might create a web service to validate customer address data.

Access Customer Data

Hypostores customer service representatives want to access customer data from the Los Angeles and Boston offices over a network. The customer service representatives want to view customer details based on the customer name or the customer ID. The corporate policy requires that data accessed over a network must be secure.
The developer and administrator complete the following steps to provide access to the data required by customer service:
  1. In the Developer tool, the developer creates a web service with the following operations:
    • getCustomerDetailsByName
      The operation input includes an element for the customer name. The operation output includes elements for the customer details based on the customer name.
    • getCustomerDetailsById
      The operation input includes an element for the customer ID. The operation output includes elements for customer details based on the customer ID.
  2. The developer configures an operation mapping for each operation with the following components:
    • An Input transformation and an Output transformation.
    • A Lookup transformation that performs a lookup on a logical data object that defines a single view of customer data from the Los Angeles and Boston offices.
  3. The developer deploys the web service to a Data Integration Service.
  4. In the Administrator tool, the administrator configures the web service to use transport layer security and message layer security so that it can receive authorized requests using an HTTPS URL.
  5. The administrator sends the WSDL URL to customer service so that they can connect to the web service.

Validate Customer Address Data

The Hypostores fulfillment department wants to validate address data before finalizing orders. The Address Validator transformation compares input address data with address reference data to determine the accuracy of input addresses and fix errors in those addresses.
The developer and administrator complete the following steps to provide address validation functionality to the fulfillment department:
  1. In the Developer tool, the developer creates a mapplet with an Address Validator transformation that receives address data as input and returns validated address data as output.
  2. The developer creates a web service and uses the mapplet to create the web service operation.
    You can use the
    Create Web Service
    wizard to create an operation from an reusable object.
  3. The developer deploys the web service to a Data Integration Service.
  4. The administrator sends the WSDL URL to the fulfillment department so that they can connect to the web service.
The web service accepts an address as input and return a validated address as output.