Triangle Direction Settings

There are two options for setting triangle direction. Only one tag is allowed at a time.

This tag contains sub-tags that set a series of thresholds as well as the directions in which the triangle alert points.

The threshold tag defines a numeric threshold.

For example:

threshold 700 sets 700 as a threshold.

The threshold-value tag defines a column that represents a numeric threshold.

For example:

threshold-value "$(MEASURE_1)" sets the value of the passed measure as a threshold.

Each of these three tags defines where the triangle points when a value is before, between, or after a threshold.

For example:

```
define-direction-thresholds {
	down
	threshold 700    // setting the "down" region to below the first threshold
	neutral    
	threshold-value "$(MEASURE_1)"  // setting the "neutral" region between the two thresholds ,and the "up" region above the second one
	up
			} 
```

Existing color thresholds (the "threshold" tags in the chart component) are used as boundaries between the down, up, and neutral regions, specified by id strings added to the existing thresholds.

Specifies the id of a threshold that has been previously defined.

For example:

threshold 1000 {
	id "threshold1"
	inclusive
}
...
alert-options {

	use-color-thresholds-for-triangle-direction {
		down
		threshold-id "threshold1"
		neutral
		another-threshold-id "threshold2"
		up
	}
}

This sets the threshold-id value to be 1000.

Specifies the id of a threshold that has been previously defined. This tag is used for any subsequent thresholds after the initial threshold.

For example:

threshold 5000 {
	id "threshold2"
	inclusive
}
...
alert-options {

	use-color-thresholds-for-triangle-direction {
		down
		threshold-id "threshold1"
		neutral
		another-threshold-id "threshold2"
		up
	}
}

This sets the threshold-id value to be 5000.

Each of these three tags defines where the triangle points when a value is before, between, or after a threshold.

For example:

```
	threshold 600
	threshold 700 {
		id "example-id"
	}
	threshold 750
	threshold 800 {
		id "example-id-2"
	}
	alert-options {
		use-color-thresholds-for-triangle-direction {
			down
			threshold-id "example-id" // setting the "down" region to below the threshold with id "example-id"
			neutral
			another-threshold-id "example-id-2"
			up
		}
	}
```

It is possible to have only one region (in any direction), any two regions with one threshold between them, or all three regions, depending on which direction ("up", "neutral", "down") tags are present. The order of the direction tags allows for the equivalent of the "reverse triangle direction" option in the interface: "down"/"neutral"/"up" and "up"/"neutral"/"down" with the same thresholds in between them are the equivalent of selecting the "reverse triangle direction" option.

```
define-direction-thresholds {
	down // there is only the down region, all values result in the indicator pointing down
} define-direction-thresholds {
	up // below the threshold, indicator points up (equivalent to "reverse indicator direction" in the interface with a down/up region)
	threshold 700
	down
}
```

There are three valid orders of the direction and threshold tags:

  • One direction tag (and no thresholds) meaning that any value results in that direction.

  • Any two direction tags with one threshold between them, marking the boundary between the regions.

  • All three direction tags with two thresholds, the directions alternating with the thresholds, and with "neutral" as the middle direction (using an example of, "neutral"/threshold/"up"/threshold/"down" would not be a valid order because if there are three regions and one is neutral, the neutral region must be in the middle).

NOTE: The triangle direction is separate from the indicator color, so these settings do not affect the indicator color thresholds.