The syntax described in this topic specifies a dimension value
path to the
collection()/record
function.
The path can specify just the root dimension value, or it can traverse part or all of a dimension hierarchy. The query will return all records that are tagged with the specified dimension value and with descendants (if any) of that dimension value.
Use the following steps to construct a dimension value path:
The path must start with the NCName of the dimension from which the dimension values will be filtered. Tthe dimension name is not quoted and is case sensitive:
[dimName = collection("dimensions")
It must then be followed by a slash-separated step specifier that uses the dval keyword (or the * keyword, both are interchangeable) and the name of the root dimension value, which is the same name as the dimension name. The name is case sensitive and must be within double quotes:
/dval[name = "dvalName"]
or/*[name = "dvalName"]
.Optionally, you can use one or more slash-separated step specifiers to specify a path to a dimension value descendant. These step specifiers use the same syntax as described in the previous step. Names of descendant dimension values do not have to be in the NCName format.
The dimension value path must be terminated with
//id
. The//id
path terminator specifies that the path be extended to any descendants of the last specified dvalName dimension value. The resulting syntax is:collection()/record[dimName = collection("dimensions")/dval[name = "dvalName"]//id
.
Note that you can use one of the negation operators described in the "Negation operators" topic.