Transformaciones XPath incorporadas

Visión general

El Editor de correlaciones de datos gráficas admite funciones XPath que le permiten manipular gráficamente valores de serie, valores numéricos, comparación de fecha y hora, etc.

Para obtener más información sobre XPath, consulte Guía de aprendizaje de XPath o W3C XML Path Language (XPath) 2.0.

Todas las funciones 2.0 XPath están soportadas con el formato fn:<function_name>.

Cuando tenga que definir expresiones XPath complejas, utilice la transformación Custom XPath. Para obtener más información, consulte XPath personalizado.

Entradas frente a argumentos

Cuando utilice una transformación XPath, debe diferenciar entre las entradas a la transformación y los argumentos necesarios para ejecutar la función XPath representada mediante la transformación XPath.

Los argumentos son los elementos de datos necesarios para el cálculo de una función XPath.

Un argumento puede ser una expresión literal, una constante, un elemento de entrada, una expresión XPath personalizada o una combinación de varios elementos de entrada.

Puede tener cualquier cantidad de entradas en la transformación XPath. Utilice estas entradas para definir los argumentos de la función XPath.

En la figura siguiente, la transformación XPath tiene dos entradas. Cada entrada se utiliza como argumento de la transformación fn:concat:

Modificar el valor de un elemento de entrada antes de aplicar la función XPath en una correlación

Puede modificar el valor de un elemento de entrada a una función XPath en la página Propiedades de la transformación XPath.

Puede definir una expresión XPath o una llamada a un método estático en una clase Java™ importada para modificar su valor. También puede crear una expresión compleja que comprenda XPath y Java.

En el separador General obtendrá la lista de elementos de entrada de la transformación XPath. Para cada elemento se visualiza el nombre, tipo y valor.

Para cambiar el valor de entrada, debe seleccionar el elemento y pulsar Editar. A continuación puede especificar la expresión para modificar el valor.

Defina cuándo se aplicará la transformación en el tiempo de ejecución

Puede definir varias conexiones entre elementos de entrada y una transformación XPath. A continuación, puede utilizar estos elementos de entrada en una expresión condicional que define la condición bajo la que se aplica la transformación. Si la condición se evalúa en true, la transformación se aplicará.

De forma alternativa, para definir la expresión condicional, puede llamar a un método estático en una clase Java importada. También puede crear una expresión compleja que incluya XPath, Java y funciones de extensión como iib:getUserDefinedProperty("propertyname").

Configura la expresión en el separador Condición disponible en la página Propiedades de la transformación.

Para obtener más información, consulte Configuración de las propiedades de una transformación, Definición de una expresión condicional XPath para una transformación y Definición de una expresión condicional Java para una transformación.

Puede utilizar las entradas conectadas con una conexión primaria a la transformación. Para añadir más entradas, puede definir conexiones suplementarias entre los elementos de entrada y la transformación.

Ejemplo

Este ejemplo muestra cómo se utiliza la transformación fn:concat para concatenar varios elementos de entrada y establecer el valor de un elemento de serie utilizando la función fn:concat.

Los argumentos para la función XPath incluyen un prefijo, dos elementos y un sufijo. Uno de los argumentos se define mediante una función XPath que requiere datos de dos entradas. Uno de los argumentos se establece con datos procedentes de una entrada. El prefijo y el sufijo son literales.

<NewElement>
  <A>My FieldA</A>
  <B>B1</B>
  <C>Field_1</C>
  <D>4</D>
  <E>FIELD_E</E>
</NewElement>

<NewElement1>
    <a>MyPrefixFieldAFIELD_EMySuffix</a>
</NewElement1>

Resolución de problemas

BIP3946E :

BIP3946E: The map script generation for QName {1} has failed, with the following details: {2}

Se obtiene el mensaje BIP3946E cuando se intenta desplegar una correlación que contiene una expresión XPath no válida. Compruebe la descripción que proporciona {2} para averiguar cuál es la expresión no válida.