Webservice Behaviour

A webservice behaviour provides the means group together specific attributes of webservices. A behaviour is usually associated with a website or web application, since most services from a particular site will act similarly.

Webservice behaviours presently allow you to specify:

  • Base Url
  • Authentication
  • Request Throttling
  • Request Pagination
  • Tracing

ID

The ID of the webservice behaviour.

Description

A friendly name.

Base Url

The base Url. This value is combined with the URL of a Reader, Writer or Lookup, providing a central place to define the site to query or post.

This value is optional and the full Url may be individually specified.

Authentication Type

  • None
    • No authentication will be made.
  • Basic Authentication
    • Uses basic authentication.
  • OAuth
    • Use OAuth 2.0 authentication.

Authentication Id

Select authentication to use for the site. When authentication type is ‘None’ this drop down will be empty.

Request Throttling

  • None
    • Requests will be made synchronously as fast as possible. I.e. One request will be made immediately after the reply is received from the previous request.
  • Leaky Bucket

    • Requests will be made synchronously as fast as possible until a reply is received from the server indicating that too many requests have been made in a single period.

      When this threshold has been reached, IMan will throttle/limit the number of requests to a specified number per second.

      The leaky bucket makes requests and up to the maximum requests per second. The number of requests which can be made is released from the bucket at a set rate i.e. the requests per second. When the bucket runs out of requests, the leaking stops, and requests can be made as quickly as possible until the bucket fills. Once full subsequent requests can be mode once the bucket has begin to empty i.e. as space becomes available for further requests.

      It is important to note the throttling is isolated to the integration which is presently running. IMan does not keep a track of the number of requests across separate integrations. E.g. IMan would not be able to throttle requests to X per day if an integration was run more than once per day.

Throttling Http Status Code

This is the HTTP status code returned by the server once a limit has been reached.

The standard is to return a 429 'Too Many Requests'.

When no throttling has been selected this field is not present.

Throttling Request Per Second

This is the number of requests per second IMan will to the webservice once the limit has been reached i.e. once a request has failed where the http status on the response is the ttrottling status code.

When no throttling has been selected this field is not present.

PAGING

See Paging section.

Trace

When enabled all requests and responses will be logged to a file in \IMan\Debug\WSTRACE-<ID>.log where the <ID> is replaced with the Behaviour Id.