AgileApps Support Wiki Pre Release

Difference between revisions of "Common:Web Service Configuration"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Line 12: Line 12:
#:
#:
#* '''Service Parameters:'''
#* '''Service Parameters:'''
#:* '''URL -''' Optional SOAP parameter. Use this field to point to a destination other than one defined in the WSDL file.
#:* '''URL -''' Optional for a SOAP service (used to point to a destination other than one defined in the WSDL file). Required for REST.
#:* '''Use Basic Auth -''' Check this box when the destination URL requires a username and password to be included in the standard <tt>http</tt> header.
#:* '''Use Basic Auth -''' Check this box when the destination URL requires a username and password to be included in the standard <tt>http</tt> header.
#::* '''Username -''' Optional. Username required to use the service, when needed
#::* '''Username -''' Optional. Username required to use the service, when needed

Revision as of 00:35, 12 April 2014

  1. In the Web Service Configuration form, configure the connection:
    • Basic Parameters:
    • Title - Required. Give the service a name. (Displays in the Name column of the Services list.)
    • Operation
      Required for a SOAP service. Not present for REST.
      Choose one of the operations defined in the WSDL file.
    • Version - Required. Enter text to identify the service version
    • Pipeline Service
      Check this box for a service that provides values for use in other web services.
      Any outputs from it that are made available for mapping can be used as inputs to other web services.
      Use it, for example, for APIs that be accessed only after logging in. You create a service that logs in and retrieves the cookie value or other access key required for subsequent requests. (That "two-step service chain" will be described in more detail, shortly.)
    • Service Parameters:
    • URL - Optional for a SOAP service (used to point to a destination other than one defined in the WSDL file). Required for REST.
    • Use Basic Auth - Check this box when the destination URL requires a username and password to be included in the standard http header.
    • Username - Optional. Username required to use the service, when needed
    • Password - Optional. Password required to use the service, when needed
    • Use a Pipeline Service - Check this box when the service request requires a prior login.
      Select a pipeline Web Service defined earlier for use in a two-step service chain.
    • TTL - Optional. The "Time to Live", in milliseconds.
      The amount of time the platform waits before abandoning a request.