EOL: SentryOne Test reached its end of life date on June 15, 2022. See the Solarwinds End of Life Policy for more information.
The following list is a collection of asserts that can compare a variety of object types.
Expression
| Icon | Description |
|---|---|
 | The Expression assert lets you enter a free-form expression to use more powerful combinational logic to validate that one or more resource values are correct. |
Expression Editor
| Function | Description |
|---|---|
| Language | Select the expression language. Currently only the SimpleFilter language is available. |
| Filter Expression | To add a clause to the expression, simply select the resource in the left hand combo box, choose the operator in the middle combo box and type the value you require in the right hand text box. Selecting the + button adds the specified clause to the expression. For more information about filter expressions, please see the filtering topic. Note: Help on the filtering language is also available in the editor directly by selecting on the ? icon in the bottom right. |
Often when filtering, whether in SQL or using SentryOne Test filters, the identifiers relate to field names. In this instance, the identifiers relate to resource keys. For example, if there was an Execute Query Scalar action that generated a resource called MyScalarValue then the expression could include a clause such as [MyScalarValue] > 10.
Integer Comparison
| Icon | Description |
|---|---|
 | The Integer Comparison assert tests two integers for different levels of equality. Specify to test for greater than, less than, or even user defined tolerances. The integer to compare your actual value to can either be a static value defined in the element's editor, or from another resource key. |
Important: The Integer Comparison assertion is now deprecated. While existing projects can still continue to use it, new products should migrate to using the Value Comparison assertion.
Integer Comparison Editor
| Function | Description | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Comparable Resource Key | Select a resource key you want to compare against if you opt not to use a static value to compare. | ||||||||||||||
| Comparable Value Source | Specifies if the element should use a static value or a resource key to make the comparison. | ||||||||||||||
| Comparison Mode |
| ||||||||||||||
| Comparison Value | The static value to use if you opt for a static value over a resource. | ||||||||||||||
| Resource Key | The resource key of the integer you want to compare. | ||||||||||||||
| Tolerance | Specifies the fixed or percent tolerance. |
Range Check
| Icon | Description |
|---|---|
 | The Range Check assert checks a resource key's value to see if it's between the user set maximum and minimum value. |
Range Check Editor
| Function | Description |
|---|---|
| Maximum Value | The maximum allowable value for the Value Resource Key. |
| Minimum Value | The minimum allowable value for the Value Resource Key. |
| Value Resource Key | Selects a resource key where you want to compare a value. |
Scalar Comparison
| Icon | Description |
|---|---|
 | The Scalar Comparison assert takes the result of an Execute Scalar action and compares with either a static value or another scalar result. The scalar values can be several different types, each with their own specifications of equality. |
Important: The Scalar Comparison assertion is now deprecated. While existing projects can still continue to use it, new products should migrate to using the Value Comparison assertion.
Scalar Comparison Editor
| Function | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| Comparable Resource Key | Enter the resource key for the dynamic value if you do not opt to use a static value to compare against. | ||||||||
| Comparable Value Source | Specify whether to use a static value or a dynamic value from another resource key. | ||||||||
| Comparison Type | Specify the type of the value to compare:
| ||||||||
| Equality Type | Specify the equality type:
| ||||||||
| Resource Key | The value to compare. | ||||||||
| Tolerance | Specify fixed or percent tolerance for certain value types. |
Value Comparison
| Icon | Description |
|---|---|
 | The Value Comparison assert is a general purpose comparison for comparing two single values. It supersedes both the Integer Comparison and the Scalar Comparison assertions, presenting a simpler configuration while also significantly extending the available options. |
Value Comparison Editor
 Static Value
|  Resource
|
There are four main sections to the editor:
| Function | Description | ||||||
|---|---|---|---|---|---|---|---|
| Actual Value | This is the value that you want to validate. It always comes from a resource that's available in the test. To select the resource to test, select the arrow to the right of the resource name box. | ||||||
| Expected Value | This is the value that you expect the actual value to match. This can either come from a static value that you configure in the user interface or from a resource. If you're using a static value, type the value that you want into the static value box. If your're using a resource then select that option and pick the resource in the same way you did for the actual value. | ||||||
| Comparison | This section specifies the options that we use for comparison:
| ||||||
| Summary | Provides a plain text description of what's configured in the assertion editor. |
Xml Comparison
| Icon | Description |
|---|---|
 | The Xml Comparison assert compares two Xml resources. These resources can be loaded many different ways, such as a from a Load Asset that's loading a File Content Asset, result of a query, or even from a Get Properties Action. The Xml in the resource passes in as a string, and checks if it's valid Xml compared to the other resource. |
Xml Comparison Editor
| Function | Description |
|---|---|
| Actual Xml Resource Key | The resource key for the Xml you want to compare. |
| Compare Attribute Order | When enabled, the comparison compares the order of attributes in an element, before comparing the content. If left disabled, only the attribute value is compared. |
| Expected Xml Resource Key | The resource key for the Xml you want to compare the Actual Xml against. |
| Ignore White Space | Specifies whether to ignore any extra spaces or white spaces in or around elements. |
| Actual XPath Exclusion | This field takes an XPath string that executes against the Actual Xml once it loads. Elements found by the XPath are excluded from the comparison on the Actual side only. This field can be a | (pipe) delimited string, allowing for multiple XPath items to execute. |
| Expected XPath Exclusion | This field takes an XPath string that executes against the Expected Xml once it loads. Elements found by the XPath are excluded from the comparison on the Expected side only. This field can be a | (pipe) delimited string, allowing for multiple XPath items to execute. |
| Actual XPath Comparison | This field takes an XPath string that executes against the Actual Xml once it loads. Only the elements found by the XPath are used in the comparison for the Actual side only. |
| Expected XPath Comparison | This field takes an XPath string that executes against the Expected Xml once it loads. Only the elements found by the XPath are used in the comparison for the Expected side only. |
