Ir para o conteúdo

XSL Transform

Introdução

O plugin XSL Transform aplica uma folha de estilo XSL Transform (XSLT) a um arquivo de entrada à medida que 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 Jitterbit Grupos de Agentes em Nuvem.

Importante

Os plug-ins fornecidos pela Jitterbit estão obsoletos. Consulte Descontinuação e suporte em Plugins.

Baixe e Adicione o Plug-in

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 da Jitterbit, este plug-in pode ser baixado no link fornecido abaixo e adicionado à organização (consulte Adicionar novos plug-ins em Personalizações > Plug-ins).

Associe o Plug-in a um Grupo de Agentes

O plug-in XSL Transform deve estar associado a um Grupo de Agentes Privados para disponibilizar o plug-in em todos os agentes do grupo (consulte Associar grupos de Agente em Personalizações > Plug-ins).

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

Definir Variáveis e Usar o Plugin em um Projeto

Consulte estes tópicos para obter informações sobre como usar plug-ins em um projeto:

O plugin XSL Transform usa estas variáveis:

Nome Tipo Obrigatório Descrição
XSLT.stylesheet Corda Opcional Folha de estilo XSLT em texto simples.
XSLT.stylesheet_filename Corda Opcional Nome de um arquivo que contém a folha de estilo XSLT a ser aplicada. O valor pode ser um caminho absoluto ou relativo ao diretório de instalação do plugin.

Exemplo

Um exemplo típico é buscar dados de um serviço web e alimentá-los para um segundo serviço web. Neste exemplo, os dados obtidos do serviço web de origem possuem 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 (consulte 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.

    abra a caixa de diálogo

  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:

    atribuir o plugin

    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:

    aplique o plugin

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