Web Services Integration

From AgileApps Support Wiki
Revision as of 21:58, 12 September 2013 by imported>Aeric (→‎Configuring a Web Service)

Warn.png

BETA:
This feature is currently in Beta testing. It's available for experimentation, but is not yet recommended for production use.

About Web Service Integration

Web Services whose connections are specified using the Web Service Description Language (WSDL) can be integrated into the platform without programming, by performing a few configuration steps.

In addition, the interface defined by the WSDL can be simplified by the IT admin, so it more closely matches the application, by:

  • Ignoring fields that are not needed
  • Hardcoding data for fields whose values are fixed
  • Creating more application-friendly names for the remaining fields defined in the WSDL

Those steps are covered below, under Configuring a Web Service.

Once done, an application designer can add a step in a Process Model to utilize the Web Service. The designer then uses the application-friendly names to:

  • Map current record fields to and from WSDL input and output fields
  • Specify fixed values or expressions for WSDL input fields
  • Define expressions that operate on WSDL output fields and store the results in the record

The mechanisms are discussed further below, under Working with a Web Service.

Configuring a Web Service

Start by uploading the WSDL file:

  1. Download the WSDL file for the service the application will connect to.
    (Web Services managed by the WebMethods integration server are recommended.)
  2. Go to GearIcon.png > Developer Resources > Web Services
  3. Click [New Web Services Invocation]
  4. Click [Select WSDL]
  5. Browse to the folder that contains the WSDL file, and upload it.

Once uploaded, you can configure a service:

Working with a Web Service

Once a Web Service has been configured, you can add it as a step in a Process Model:

  1. Go to GearIcon.png > Objects > {object} > Process Models
  2. ...