Plugin XSL Transform (obsoleto) para grupos de agentes privados Jitterbit

Introdução

O plugin XSL Transform aplica uma folha de estilo XSL Transform (XSLT) a um arquivo de entrada conforme ele passa da origem para o destino. O plugin usa o processador Saxon XSLT, que suporta XSLT 2.0.

Este plugin pode ser associado apenas a grupos de agentes privados e não está disponível nos grupos de agentes de nuvem Jitterbit.

Baixe e adicione o plugin

O plugin XSL Transform é um plugin Jitterbit padrão que já está disponível no Management Console Plugins e não precisa ser baixado ou adicionado à organização.

Se orientado pelo suporte, este plugin pode ser baixado no link fornecido abaixo e adicionado à organização.

• XSLT 2.0 (.ZIP)

Associe o plugin a um grupo de agentes

O plugin XSL Transform deve ser associado a um grupo de agentes privados para tornar o plugin disponível em todos os agentes do grupo.

O plugin está listado no Management Console Plugins página com um nome de exibição de Jitterbit XSL Transform.

Defina variáveis e use o plugin em um projeto

Consulte estes tópicos para obter informações sobre o uso de plugins em um projeto:

• Plugins (Integration Studio)
• Plugins (Design Studio)

O plugin XSL Transform usa estas variáveis:

Exemplo

Um exemplo típico é buscar dados de um serviço web e alimentar os dados para um segundo serviço web. Neste exemplo, os dados buscados do serviço web de origem têm namespaces (ns1). No entanto, o serviço web de destino não precisa dos namespaces. Usando o plugin XSL Transform, os namespaces serão removidos dos dados do serviço web de origem antes de chamar o serviço web de destino.

Estas etapas descrevem como usar o plugin XSL Transform para remover os namespaces dos dados do serviço web de origem e, em seguida, chamar o serviço web de destino. As etapas usam Design Studio como exemplo; você pode usar este plugin em Integration Studio usando etapas semelhantes.

1. Acesse o arquivo manifesto do plugin XSL Transform através do Management Console Plugins página.

2. Leia o manifesto para encontrar o local onde o plugin espera que o Java seja instalado. Verifique se o Java está instalado nesse local. Se o Java estiver em um local diferente no agente privado, você deve executar estas etapas em cada agente no grupo:

   1. Pare o agente privado.
   2. Navegue até a pasta do plugin no agente privado.
   3. Edite o arquivo manifesto para apontar para o local correto do Java.
   4. Reinicie o agente privado.

3. No Design Studio, crie um novo script para remover os namespaces, conforme mostrado neste script de exemplo:

   <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

   O nome da variável no script acima é importante. Você precisa usar o mesmo nome de variável que o plugin procura. O plugin procura especificamente por XSLT.stylesheet e usa o valor atribuído a ele no script.

4. Crie uma operação e use o script em qualquer lugar no fluxo da operação. Na operação mostrada abaixo, o script é chamado de XSLT Code.

   

5. Aplique o plugin no ponto onde o serviço web é chamado. Na operação de exemplo acima, o serviço web é chamado de createInvoice. Para abrir a caixa de diálogo Plugins do Pipeline, clique com o botão direito do mouse no serviço web e selecione Plugin no menu:

   

   1. O plugin foi atribuído ao agente privado em etapas anteriores, permitindo assim que o Design Studio veja e exiba o plugin na seção Plugins Disponíveis na metade inferior da caixa de diálogo. Se o plugin não for exibido imediatamente, clique no botão Atualizar na caixa de diálogo.
   2. Você deve selecionar a Posição do Pipeline. Neste exemplo, o plugin é chamado quando a entrada é enviada, o que ocorre ao fazer a solicitação ao serviço web. A opção WebServiceCall - OnRequest é selecionada.
   3. Clique no botão Atribuir.

6. O plugin XSL Transform agora é exibido na seção Atualmente Atribuído do diálogo. Clique no botão Aplicar para atribuir o plugin e clique em OK para fechar o diálogo:

   

7. Salve e implantar a operação. A operação está concluída e pronta para teste.