XSL Transform¶

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 (veja Adicionar novos plugins em Personalizações > Plug-ins).

• 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 (consulte Associar grupos de agentes em Personalizações > Plug-ins).

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 (Cloud Studio)
• Plug-ins (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 de namespaces. Usando o plug-in 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 plug-in 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 um exemplo; você pode usar este plugin no Cloud Studio usando etapas semelhantes.

1. Acesse o arquivo de manifesto do plugin XSL Transform através do Management Console Plugins página (veja Exibir arquivos de manifesto em Personalizações > Plug-ins).

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ê deverá executar estas etapas em cada agente do grupo:

   1. Pare o agente privado.
   2. Navegue até a pasta do plugin no agente privado.
   3. Edite o arquivo de 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 do fluxo da operação. Na operação mostrada abaixo, o script é denominado Código XSLT.

   

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

   

   1. O plugin foi atribuído ao agente privado nas 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 plug-in não for exibido imediatamente, clique no botão Atualizar na caixa de diálogo.
   2. Você deve selecionar Posição do Pipeline. Neste exemplo, o plugin é chamado quando o input é enviado, o que ocorre durante a solicitação ao web service. A opção WebServiceCall - OnRequest está selecionada.
   3. Clique no botão Atribuir.

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

   

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