Predefined XPath expressions for topology reports

The content-assist menu in the BIRT data set editor provides commonly used XPath expressions. These predefined expressions help you to refer to particular topology elements.

Most functions for topology reports, as described in Functions for topology report expressions, accept one or more XPath expressions as parameters. For example, the function getTopologyDiagrams accepts the XPath location of a topology along with either the name of a diagram or an asterisk character as a wildcard. If you are using a data source based on a single topology, the XPath location of that topology is usually DeployCoreRoot/topology. Similarly, if you are defining a data set that lists every unit in the topology, you might use the XPath expression DeployCoreRoot/topology/_schema-element_unit.

The content assistance in the data set editor provides several predefined XPath expressions along with the functions for topology reports. You can access content assistance by pressing Ctrl+Space in the data set editor.

Using content assist to insert a predefined XPath expression

Note that when using these predefined expressions, you must allow the expression editor to convert the keyword in the content assist window into the XPath expression. For example, if you select topologyXPath in the content assist window, content assist inserts the XPath expression DeployCoreRoot/topology into the expression editor. In this way, you cannot use topologyXPath as a literal value in your expression; you must allow content assist to convert your selection into the XPath expression DeployCoreRoot/topology.

Predefined XPath expressions for topology reports

Content assistance provides the following expressions for use with topology reports.

topologyImportXPath

The XPath location of the imported topologies in the current topology:

DeployCoreRoot/topology/import

topologyUnitArtifactXPath

The XPath location of the artifacts on the units in the topology:

DeployCoreRoot/topology/_schema-element_unit/_schema-element_artifact

topologyUnitCapabilityXPath

The XPath location of the capabilities on units in the topology:

DeployCoreRoot/topology/_schema-element_unit/_schema-element_capability

topologyUnitConstraintXPath

The XPath location of the constraints on the units in the topology:

DeployCoreRoot/topology/_schema-element_unit/_schema-element_constraint

topologyUnitConstraintLinkXPath

The XPath location of the constraint links in the topology:

DeployCoreRoot/topology/_schema-element_unit/link.constraint

topologyUnitDependencyLinkXPath

The XPath location of the dependency links in the topology:

DeployCoreRoot/topology/_schema-element_unit/link.dependency

topologyUnitHostingLinkXPath

The XPath location of the hosting links in the topology:

DeployCoreRoot/topology/_schema-element_unit/link.hosting

topologyUnitMemberLinkXPath

The XPath location of the membership links in the topology:

DeployCoreRoot/topology/_schema-element_unit/link.member

topologyUnitRealizationLinkXPath

The XPath location of the realization links in the topology:

DeployCoreRoot/topology/_schema-element_unit/link.realization

topologyUnitRequirementXPath

The XPath location of the requirements on units in the topology:

DeployCoreRoot/topology/_schema-element_unit/_schema-element_requirement

topologyUnitXPath

The XPath location of the units in the topology:

DeployCoreRoot/topology/_schema-element_unit

topologyXPath

The XPath location of the current topology:

DeployCoreRoot/topology