SOAP Web service collector agent

This collector allows you to poll/query SOAP web services and interpret the results. It supports several simple 'macros' to make it easier to test returned values or even DataSets or Arrays.
WARNING - This collector requires the FULL .Net 4.0 framework due to the way Microsoft rearranged the .Net libraries.

Editing config

EditSOAPWebServiceCollectorConfig.png

Check and result types

The collector allows you to either check for a Success or Failure condition. This could be used to test for 'negative' conditions. The default check is for simple availability (success).
Other result types that can be checked for are:
- No/Empty value
- Specified value (handled as a string)
- Values in a range (must be numbers)
- DataSet
- String Array
Interpreting the results can be done using the two 'Custom' value fields.
For availability check and No/Empty value these fields are ignored.
For 'Specified value' only the first custom field is used (macros are not allowed).
For Values in range both first and second custom value must be numbers (macros are not allowed).
When using DataSet/Arrays you can use 'macros' (values in square brackets as seen in the drop down boxes of custom values).

Macros

Macros available on Custom Value 1
Macros are only used for DataSets and Arrays.
[Count] - Row count
[FirstValue] - Only look at the very first value encoutered ([0] for Arrays, [0][0] for DataSet)
[LastValue] - Only look at the very last value encoutered ([rows-1] for Arrays, [rows-1][cols-1] for DataSet)
[x] - Use row x value (only for arrays) compare to 'Custom value 2'
[x][y] - Use row x column y (only DataSets) compare to 'Custom value 2'
Macros available on Custom Value 2
[Between] x [and] y - Test for value between x and y (must be numbers)
[LargerThan] x - Test for value larger than x (must be a number)
[SmallerThan] x - Test for value smaller than x (must be a number)

Errors and Warnings

If more than one web service has been specified in one collector instance both needs to be in an 'Error' state for the combined result to be 'Error'. If only one/some returns an error a 'global' warning state will be raised. Of course, if there is only one web service instance then it will always be either 'Success' or 'Error'.

Viewing details

ViewSOAPWebServiceCollectorDetails.png

Last edited Mar 5, 2013 at 7:48 AM by RudolfHenning, version 8

Comments

No comments yet.