Introduction

To use scope you must define an expression, read Using scope and filter expressions for more information.

On this page:

Available scope attributes

The system has a number of predefined attributes for use in a scope expression.

TypeName
Attributeostype
osver
name
rammb
osvertxt
agentver
vrplatform
model
fqdn
devtype
timezone
lastboot
tagtxt
managementgroup
criticality

Scope expression limitations pre v3.2

The two scope expression limitations for Tachyon pre v3.2 are the:

  • Only operator supported in the expression tree object is AND
  • System only supports single level expression trees, for example you cannot have an expression tree object and an operand for another expression tree object.

Handling tags

Tags are a specific case. Tags always use the tagtxt attribute name.

To scope on tags leave the Operator field blank (""), like:

Tag element Json
{
	"Attribute": "tagtxt",
	"Operator": "",
	"Value": "key=value"
}

Tag names are not case-sensitive but tag values are, so you will get an error if you specify a tag value whose case does not match one of the stored values defined for that tag.

Also there cannot be spaces around the = sign, if you specify "key = value" then you will get an error


Handling Management Groups

Management groups are another special case. They always use the managementgroup attribute name.

The only operator they support is == and do not have a data type.

The value is the UsableId, not the Name or Id of the Management group.

Tag element Json
{
	"Attribute": "managementgroup",
	"Operator": "==",
	"Value": "40497EF0F9C344BE937E2813D22457E9"
}

Handling Criticality

When criticality is used in a scope expression the value needs to be the numerical value, not the "friendly" name seen in the UI.

Mapping between the numbers and names can be found in the database in the GlobalSettings table, row with the name "CriticalityMapping".

The default mapping can be seen below.

Double check these mappings as they might have been changed in your installation of Tachyon.


Numerical ValueFriendly name
0Undefined
1Non-critical
2Low
3Medium
4High
5Critical