Funciones XPath y operadores

En la tabla siguiente se identifican los símbolos admitidos. Los números de símbolo de la primera columna se encuentran en http://www.w3.org/TR/xpath20/#id-grammar.

Elementos de datos predefinidos Common Base Event:

InboundEventDefinitionRef '/' 'predefinedData' '/' (
'creationTime'|'elapsedTime'|'extensionName'|'globalInstanceId'|
'localInstanceId'|'msg'|'priority'|'repeatCount'|'sequenceNumber'|
'severity'|'version')

Elementos de datos de contexto Common Base Event:

InboundEventDefinitionRef '/' 'propertyData' '/' ContextDataElementName

Elementos de datos ampliados Common Base Event:

InboundEventDefinitionRef '/' 'extendedData' '/' ExtendedDataElementName (
'/' ExtendedDataElementName)*

Cualquier contenido de suceso:

InboundEventDefinitionRef '/' EventPartId '/' Expr

donde:

• InboundEventDefinitionRef es una vía de acceso a un punto de entrada de suceso o un punto de salida en una jerarquía de definición de contexto de supervisión. La vía de acceso puede incluir los ID de definiciones anidadas de contexto de supervisión, punto "." o dos puntos seguidos (".."). Debe tener como último paso un ID, y solamente uno, de una definición de suceso de entrada. Por ejemplo, itemContext/outOfStockEvent.
• ContextDataElementName es el nombre de un elemento de datos de contexto definido por el tipo Common Base Event del punto de salida o entrada del suceso al que se hace referencia. Se hace referencia a la definición de tipo de suceso Common Base Event pertinente mediante el atributo extensionName.
• ExtendedDataElementName es el nombre de un elemento de datos ampliado definido por el tipo Common Base Event de punto de salida o entrada del suceso al que se hace referencia. Se hace referencia a la definición de tipo de suceso pertinente mediante el atributo extensionName.
• EventPartId es el ID de una parte de suceso definida para el punto de entrada o salida al que se hace referencia.
• Expr es una vía de acceso a una estructura de datos de sucesos de entrada o salida, que se añade al final de la vía de acceso definida para la parte de suceso a la que se hace referencia mediante EventPartId. Para las vías de acceso a sucesos de entrada, se aplica la tabla 2. Para las vías de acceso de los sucesos de salida (es decir, los extremos de la izquierda de las asignaciones de campos de sucesos de salida) se aplica la tabla 3. Asimismo, los predicados numéricos que se utilizan para crear secuencias en sucesos de salida no deben contener espacios vacíos y deben ser ascendentes en cada nivel de anidación. Un paso que no tenga un predicado numérico es equivalente a uno seguido de [1].

La tabla siguiente se aplica a las expresiones que hacen referencia los sucesos de entrada y su contenido.

La tabla siguiente se aplica a las expresiones que hacen referencia a los sucesos de salida y su contenido.

En la tabla siguiente se identifican los operadores soportados. Los números de fila indican el orden de precedencia y están definidos en http://www.w3.org/TR/xpath20/#id-precedence-order.

En la tabla siguiente se identifican los símbolos de terminal soportados. Los números de símbolo de la primera columna se encuentran en http://www.w3.org/TR/xpath20/#lexical-structure.

Puede utilizar predicados para referirse a elementos de una lista (a los que a veces se hace referencia como elementos de matriz). El predicado es una expresión encerrada entre corchetes que sigue a la expresión de vía de acceso que hace referencia a la lista. Por ejemplo, si myEvent/myEventPart/theOrder/item apunta a una lista de elementos en un orden, puede hacer referencia a un elemento individual si encierra un índice numérico entre corchetes. Por ejemplo, para acceder al precio de un artículo, por ejemplo, el artículo 12, utilizaría:

myEvent/myEventPart/theOrder/item[12]/price

Las listas pueden utilizarse también como argumentos para agregar funciones. Por ejemplo, para calcular la suma de los precios de todos los pedidos, utilizaría:

fn:sum(myEvent/myEventPart/theOrder/item/price)

Para obtener más información, consulte Agregar funciones.

Están soportadas las siguientes funciones de constructor. Las funciones de constructor son el mecanismo de XPath 2.0 que utiliza Business Monitor para dar soporte a cast. En XPath 2.0, la semántica de las funciones de constructor es equivalente al uso del operador "cast as", pero la sintaxis es diferente.

• xs:boolean($arg as xs:boolean?) as xs:boolean?
• xs:boolean($arg as xs:integer?) as xs:boolean?
• xs:boolean($arg as xs:decimal?) as xs:boolean?
• xs:boolean($arg as xs:string?) as xs:boolean?
• xs:integer($arg as xs:boolean?) as xs:integer?
• xs:integer($arg as xs:integer?) as xs:integer?
• xs:integer($arg as xs:decimal?) as xs:integer?
• xs:integer($arg as xs:string?) as xs:integer?
• xs:decimal($arg as xs:boolean?) as xs:decimal?
• xs:decimal($arg as xs:integer?) as xs:decimal?
• xs:decimal($arg as xs:decimal?) as xs:decimal?
• xs:decimal($arg as xs:string?) as xs:decimal?
• xs:decimal($arg as xs:duration?) as xs:decimal?
• xs:string($arg as xs:boolean?) as xs:string?
• xs:string($arg as xs:integer?) as xs:string?
• xs:string($arg as xs:decimal?) as xs:string?
• xs:string($arg as xs:string?) as xs:string?
• xs:string($arg as xs:duration?) as xs:string?
• xs:string($arg as xs:dateTime?) as xs:string?
• xs:string($arg as xs:date?) as xs:string?
• xs:string($arg as xs:time?) as xs:string?
• xs:duration($arg as xs:string?) as xs:duration?
• xs:duration($arg as xs:duration?) as xs:duration?
• xs:duration($arg as xs:decimal?) as xs:duration?
• xs:dayTimeDuration($arg as xs:integer?) as xs:dayTimeDuration?
• xs:dayTimeDuration($arg as xs:decimal?) as xs:dayTimeDuration?
• xs:dayTimeDuration($arg as xs:string?) as xs:dayTimeDuration?
• xs:dayTimeDuration($arg as xs:duration?) as xs:dayTimeDuration?
• xs:dateTime($arg as xs:string?) as xs:dateTime?
• xs:dateTime($arg as xs:dateTime?) as xs:dateTime?
• xs:dateTime($arg as xs:date?) as xs:dateTime?
• xs:date($arg as xs:string?) as xs:date?
• xs:date($arg as xs:dateTime?) as xs:date?
• xs:date($arg as xs:date?) as xs:date?
• xs:time($arg as xs:string?) as xs:time?
• xs:time($arg as xs:dateTime?) as xs:time?
• xs:time($arg as xs:time?) as xs:time?

Se admiten el subconjunto de funciones XPath 2.0 disponibles siguiente. Las declaraciones de espacio de nombres utilizadas son xmlns:xs="http://www.w3.org/2001/XMLSchema" y xmlns:fn="http://www.w3.org/2005/xpath-functions", como en http://www.w3.org/TR/xpath-functions/.

• fn:abs($arg as xs:integer?) as xs:integer?
• fn:abs($arg as xs:decimal?) as xs:decimal?
• fn:round($arg as xs:decimal?) as xs:decimal?
• fn:round($arg as xs:integer?) as xs:integer?
• fn:concat($arg1 as xs:anyAtomicType?, $arg2 as xs:anyAtomicType?, ... ) as xs:string
• fn:compare($comparand1 as xs:string?, $comparand2 as xs:string?) as xs:integer?
• fn:substring($sourceString as xs:string?, $startingLoc as xs:integer) as xs:string
• fn:substring($sourceString as xs:string?, $startingLoc as xs:decimal) as xs:string
• fn:substring($sourceString as xs:string?, $startingLoc as xs:integer, $length as xs:integer) as xs:string
• fn:substring($sourceString as xs:string?, $startingLoc as xs:integer, $length as xs:decimal) as xs:string
• fn:substring($sourceString as xs:string?, $startingLoc as xs:decimal, $length as xs:integer) as xs:string
• fn:substring($sourceString as xs:string?, $startingLoc as xs:decimal, $length as xs:decimal) as xs:string
• fn:string-length($arg as xs:string?) as xs:integer?
• fn:upper-case($arg as xs:string?) as xs:string
• fn:lower-case($arg as xs:string?) as xs:string
• fn:contains($arg1 as xs:string?, $arg2 as xs:string?) as xs:boolean
• fn:starts-with($arg1 as xs:string?, $arg2 as xs:string?) as xs:boolean
• fn:ends-with($arg1 as xs:string?, $arg2 as xs:string?) as xs:boolean
• fn:true() as xs:boolean
• fn:false() as xs:boolean
• fn:not($arg as xs:boolean?) as xs:boolean
• fn:not($arg as xs:integer?) as xs:boolean
• fn:not($arg as xs:decimal?) as xs:boolean
• fn:not($arg as xs:string?) as xs:boolean
• fn:empty($arg as xs:anyAtomicType?) as xs:boolean
• fn:exists($arg as xs:anyAtomicType?) as xs:boolean
• fn:current-dateTime() as xs:dateTime
• fn:current-date() as xs:date
• fn:current-time() as xs:time
• fn:days-from-duration($arg as xs:duration?) as xs:integer?
• fn:hours-from-duration($arg as xs:duration?) as xs:integer?
• fn:minutes-from-duration($arg as xs:duration?) as xs:integer?
• fn:seconds-from-duration($arg as xs:duration?) as xs:decimal?
• fn:year-from-dateTime($arg as xs:dateTime?) as xs:integer?
• fn:month-from-dateTime($arg as xs:dateTime?) as xs:integer?
• fn:day-from-dateTime($arg as xs:dateTime?) as xs:integer?
• fn:hours-from-dateTime($arg as xs:dateTime?) as xs:integer?
• fn:minutes-from-dateTime($arg as xs:dateTime?) as xs:integer?
• fn:seconds-from-dateTime($arg as xs:dateTime?) as xs:decimal?
• fn:timezone-from-dateTime($arg as xs:dateTime?) as xs:dayTimeDuration?
• fn:year-from-date($arg as xs:date?) as xs:integer?
• fn:month-from-date($arg as xs:date?) as xs:integer?
• fn:day-from-date($arg as xs:date?) as xs:integer?
• fn:timezone-from-date($arg as xs:date?) as xs:dayTimeDuration?
• fn:hours-from-time($arg as xs:time?) as xs:integer?
• fn:minutes-from-time($arg as xs:time?) as xs:integer?
• fn:seconds-from-time($arg as xs:time?) as xs:decimal?
• fn:timezone-from-time($arg as xs:time?) as xs:dayTimeDuration?
• fn:adjust-dateTime-to-timezone($arg as xs:dateTime?) as xs:dateTime?
• fn:adjust-dateTime-to-timezone($arg as xs:dateTime?, $timezone as xs:dayTimeDuration?) as xs:dateTime?
• fn:adjust-date-to-timezone($arg as xs:date?) as xs:date?
• fn:adjust-date-to-timezone($arg as xs:date?, $timezone as xs:dayTimeDuration?) as xs:date?
• fn:adjust-time-to-timezone($arg as xs:time?) as xs:time?
• fn:adjust-time-to-timezone($arg as xs:time?, $timezone as xs:dayTimeDuration?) as xs:time?
• fn:count($arg as item()*) as xs:integer
• fn:avg($arg as xs:integer*) as xs:decimal?
• fn:avg($arg as xs:decimal*) as xs:decimal?
• fn:max($arg as xs:integer*) as xs:integer?
• fn:max($arg as xs:decimal*) as xs:decimal?
• fn:min($arg as xs:integer*) as xs:integer?
• fn:min($arg as xs:decimal*) as xs:decimal?
• fn:sum($arg as xs:integer*) as xs:integer?
• fn:sum($arg as xs:decimal*) as xs:decimal?

Las métricas con tipos de datos de fecha, hora, o fecha-hora pueden tener un valor ajustado a un huso horario o un valor no ajustado a un huso horario. Cuando compare métricas con tipos de datos de fecha, hora o fecha-hora:

• Ambos valores deben estar asociados a un huso horario, O
• Ninguno de los valores debe estar asociado a un huso horario

De otro modo, se producirá un error en tiempo de ejecución cuando se realice la comparación.