Complemento de transformación XSL (obsoleto) para grupos de agentes privados de Jitterbit

Introducción

El complemento XSL Transform aplica una hoja de estilos XSL Transform (XSLT) a un archivo de entrada a medida que pasa del origen al destino. El complemento utiliza el procesador XSLT de Saxon, que admite XSLT 2.0.

Este complemento solo se puede asociar con grupos de agentes privados y no está disponible en los grupos de agentes de nube Jitterbit.

Descargue y agregue el complemento

El complemento XSL Transform es un complemento Jitterbit estándar que ya está disponible en la Management Console Complementos página y no necesita descargarse ni agregarse a la organización.

Si el soporte lo indica, este complemento se puede descargar en el enlace que se proporciona a continuación y agregarlo a la organización.

• XSLT 2.0 (.ZIP)

Asociar el complemento con un grupo de agentes

El complemento XSL Transform debe estar asociado con un grupo de agentes privados para que el complemento esté disponible en todos los agentes del grupo.

El complemento aparece en la Management Console Complementos página con un nombre para mostrar de Jitterbit XSL Transform.

Establecer variables y utilizar el complemento en un proyecto

Consulte estos temas para obtener información sobre el uso de complementos en un proyecto:

• Complementos (Integration Studio)
• Complementos (Design Studio)

El complemento XSL Transform utiliza estas variables:

Ejemplo

Un ejemplo típico es obtener datos de un servicio web y enviarlos a un segundo servicio web. En este ejemplo, los datos obtenidos del servicio web de origen tienen espacios de nombres (ns1). Sin embargo, el servicio web de destino no necesita los espacios de nombres. Si se utiliza el complemento XSL Transform, los espacios de nombres se eliminarán de los datos del servicio web de origen antes de llamar al servicio web de destino.

Estos pasos describen cómo utilizar el complemento XSL Transform para eliminar los espacios de nombres de los datos del servicio web de origen y luego llamar al servicio web de destino. Los pasos utilizan Design Studio como ejemplo; puedes usar este complemento en Integration Studio siguiendo pasos similares.

1. Acceda al archivo de manifiesto del complemento XSL Transform a través de la Management Console Complementos página.

2. Lea el manifiesto para encontrar la ubicación donde el complemento espera que se instale Java. Verifique que Java esté instalado en esa ubicación. Si Java está en una ubicación diferente en el agente privado, debe realizar estos pasos en cada agente del grupo:

   1. Detener al agente privado.
   2. Busque la carpeta del complemento en el agente privado.
   3. Edite el archivo de manifiesto para que apunte a la ubicación correcta de Java.
   4. Reinicie el agente privado.

3. En Design Studio, cree un nuevo secuencia de comandos para eliminar los espacios de nombres como se muestra en este secuencia de comandos de ejemplo:

   <trans>
   $XSLT.stylesheet = '<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"
   xmlns:ns1="urn:microsoft-dynamics-nav/xmlports/x50001" exclude-result-prefixes="ns1">
   <xsl:output method="xml" encoding="utf-8" indent="yes"/>
   <xsl:strip-space elements="*"/
   <xsl:template match="ns1:*">
   <xsl:element name="{local-name()}" namespace="urn:microsoft-dynamics-nav/xmlports/x50001">
   <xsl:apply-templates select="node() | @*"/>
   </xsl:element>
   </xsl:template>
   <xsl:template match="node() | @*">
   <xsl:copy>
   <xsl:apply-templates select="node() | @*"/>
   </xsl:copy>
   </xsl:template>
   </xsl:stylesheet> ';
   </trans>
   

   Nota

   El nombre de la variable en el secuencia de comandos anterior es importante. Debes usar el mismo nombre de variable que busca el complemento. El complemento busca específicamente XSLT.stylesheet y utiliza el valor que se le asigna en el secuencia de comandos.

4. Cree una operación y utilice el secuencia de comandos en cualquier parte del flujo de la operación. En la operación que se muestra a continuación, el secuencia de comandos se denomina Código XSLT.

   

5. Aplique el complemento en el punto donde se llama al servicio web. En la operación de ejemplo anterior, el servicio web se llama createInvoice. Para abrir el cuadro de diálogo Complementos de Pipeline, haga clic con el botón derecho en el servicio web y seleccione Complemento en el menú:

   

   1. El complemento se ha asignado al agente privado en pasos anteriores, lo que permite que Design Studio vea y muestre el complemento en la sección Complementos disponibles en la mitad inferior del cuadro de diálogo. Si el complemento no se muestra de inmediato, haga clic en el botón Actualizar en el cuadro de diálogo.
   2. Debes seleccionar la Posición de Pipeline. En este ejemplo, el complemento se llama cuando se envía la entrada, lo que ocurre mientras se realiza la solicitud al servicio web. La opción WebServiceCall - OnRequest está seleccionada.
   3. Haga clic en el botón Asignar.

6. El complemento Transformación XSL ahora se muestra en la sección Actualmente asignado del cuadro de diálogo. Haga clic en el botón Aplicar para asignar el complemento y haga clic en Aceptar para cerrar el cuadro de diálogo:

   

7. Guarde e desplegar la operación. La operación está completa y lista para probar.