Criar uma transformação ou um mapa

Atualizado: julho de 2015

Você pode definir relações entre um documento XML de entrada, adicionar Operação de mapeamentos para modificar os dados e gerar um documento XML. Uma Transformação ou um mapa faz parte do modelo SDK da Serviços BizTalk no Visual Studio. Consulte Instalar o SDK dos Serviços BizTalk do Azure.

Neste tópico:

Escolher o tipo de projeto

Adicionar os esquemas

Adicionar as operações de mapeamento

Criar dicas de área e truques

Mais sobre mapas

Há dois modos de criar um novo Transformação: Adicionar um mapa ao Projeto do Serviço BizTalk ou crie um novo projeto Artefatos de serviço BizTalk.

Quando um mapa é adicionado ou criado no Projeto do Serviço BizTalk, ele faz parte do projeto e deve ser usado na Ponte unidirecional XML ou na Ponte de solicitação-resposta XML. Quando cria um projeto de Artefatos do Serviço BizTalk, você está criando um mapa independente de qualquer outro projeto. Quando a Transformação é concluída, ela pode ser salva, adicionada a um contrato entre empresas ou adicionada a um Projeto do Serviço BizTalk existente.

Muitos desenvolvedores preferem manter seus esquemas em um local central. Nessa situação, você pode usar o projeto de Artefatos do Serviço BizTalk para armazenar seus esquemas e mapas. Em seguida, você salva/faz backup de um projeto e de seus recursos. Quando você precisar desses esquemas ou mapas, basta adicioná-los a outros projetos.

  1. Abra o Visual Studio como administrador e o seu Projeto do Serviço BizTalk.

  2. No projeto Serviços BizTalk, vá até o Gerenciador de Soluções.

  3. Clique com o botão direito do mouse no projeto, selecione Adicionar e Novo Item ou Item Existente.

  4. Insira os detalhes do mapa e selecione Adicionar.

Depois de terminar de criar o mapa, você pode adicionar o mapa ao Estágio de Transformação da Ponte XML. Consulte Criar uma ponte unidirecional XML ou Criar uma ponte de solicitação-resposta XML. Usos e Estágios das Pontes fornece mais informações sobre o Estágio de Transformação.

  1. Abra o Visual Studio como administrador.

  2. Selecione Novo Projeto.

  3. Expanda o modelo Visual C# e selecione Serviços BizTalk.

  4. Selecione Artefatos do Serviço BizTalk.

  5. Insira o Nome do projeto, o Local do projeto, as propriedades de Nome da solução e a preferência Criar diretório para solução.

  6. Selecione OK.

Quando o projeto for aberto, Map.trfm, Schema1.xsd e Schema2.xsd são criados automaticamente. Esses arquivos estão em branco para que você possa alterá-los, excluí-los ou adicionar os seus próprios. Serviços BizTalk As Transformaçãos têm uma extensão. trfm e abrir um arquivo. trfm abre o designer de Transformação onde você pode adicionar esquemas, Operação de mapeamentos e desenhar seus links.

Você pode criar e modificar esquemas usando o Editor de Esquema interno. Depois que o mapa for adicionado, adicione seu Esquema de origem (entrada) e o Esquema de destino (saída):

  1. Abra uma Serviços BizTalk ou o projeto Artefatos do Serviço BizTalk no Visual Studio como administrador.

  2. Adicione um esquema existente (.xsd) ou adicione um novo esquema (.xsd) ao projeto:

    1. Clique com o botão direito do mouse no projeto e selecione Adicionar.

    2. Selecione Item existente para adicionar um esquema que já foi criado. Selecione Novo Item, Esquema para criar um novo esquema.

  3. Selecione Adicionar.

  4. Clique duas vezes no esquema (.xsd) para abrir o Editor de esquema.

A opção Desenvolver esquemas EDI fornece informações sobre como criar e modificar os esquemas existentes.

Depois que os esquemas forem adicionados, é possível usar as Operação de mapeamentos internas para alterar ou manipular os dados de entrada para corresponder ao esquema de saída:

  1. Na caixa de ferramentas, clique e arraste a Operação de mapeamento para o designer de Transformação:

    Clique duas vezes na Operação de mapeamento para configurar as entradas.

  2. Clique e arraste itens do seu esquema de entrada para as operações de mapeamento ou do esquema de saída para criar os links. AsOperação de mapeamentos oferecem suporte a três tipos de fonte de entrada:

    • Link de um nó de árvore

    • Link de um Operação de mapeamento

    • Valor constante

TipDica
  • Se um link de um nó de árvore ou um Operação de mapeamento não for permitido, uma mensagem declarando o motivo é exibida na Barra de Status.

  • Alguns Operação de mapeamentos têm uma propriedade do Tipo na janela da caixa de diálogo Configurar. Esta propriedade de Tipo é somente de leitura.

 

   

Cortar, copiar e colar

É possível Operação de mapeamentos usando Cortar/Copiar e Colar. Não é possível mover Links usando Cortar/Copiar e Colar. Se mover uma Operação de mapeamento usando Cortar/Copiar e Colar, os links são removidos.

Não é possível arrastar e soltar Operação de mapeamentos e links. Para mover os Operação de mapeamentos e seus links, use Ctrl + Clique para selecionar os itens a serem movidos. Ctrl + Clique corta os itens e, em seguida, cole-os na localização pretendida.

Suporte XSLT

Num projeto dos Serviços BizTalk ou Artefatos de Serviço BizTalk, um arquivo Transformação (.trfm) pode usar XSLT. As opções XSLT incluem inserir sintaxe XSLT e importar arquivos XSLT de saída, incluindo arquivos de extensão XML (EXT XML).

Para importar um arquivo XSLT existente, selecione a área de design Transformação. Em Propriedades, selecione Importar XSLT. Você pode selecionar um arquivo ou digitar diretamente a sintaxe XSLT.

Para importar um arquivo XSLT existente, selecione a área de design Transformação. Em Propriedades, selecione Importar XSLT. Você pode selecionar um arquivo ou digitar diretamente a sintaxe XSLT.

Selecione Usar XslCompiledTransform para melhor desempenho para transformar os dados em XML através da compilação de folhas de estilo XSLT e execução XSLT Transformação. Quando a folha de estilo é compilada, esta pode ser armazenada em cache e reutilizada. Quando esta opção não estiver ativada, a classe XslTransform é usada; qual é o melhor quando um Transformação é executado uma vez.

Vínculos diretos com registros recorrentes

Quando vincula um registro recorrente no documento de origem a um registro recorrente no documento de destino, é necessário um Loop MapEach. Criar esses vínculos de cada nó de origem para o nó de destino consume frequentemente muito tempo. Como resultado, os Serviços BizTalk incluem a funcionalidade Vínculo direto.

A vinculação direta consiste simplesmente em copiar um nó de entrada para um nó de saída, sem outro processamento. A vinculação direta também é usada quando vincula registros não recorrentes; que não requer um Loop MapEach.

As Operações de mapeamento de loop – uso e exemplos descrevem a funcionalidade Vínculo direto.

Rolagem

A rolagem vertical no Designer de Transformação pode ser feita de duas maneiras:

  • Rolar a roda do mouse

  • Usando as teclas de setas para cima e para baixo

A rolagem horizontal no Designer de Transformação pode ser feita de duas maneiras:

  • Manter pressionada a tecla SHIFT + rolar a roda do mouse

  • Usando as teclas de setas para a esquerda e para a direita

Superfície de desenho

A superfície de desenho no Designer de Transformação tem um tamanho padrão de 200*200 células. Para modificar o tamanho:

  1. Vá para o menu Ferramentas e selecione Opções.

  2. Expanda o Designer de Transformaçãos e clique em Geral.

  3. Modifique os valores de Número de células de grade no eixo X da superfície de grade e o Número de células de grade no eixo Y da superfície de grade. Os valores variam de 100 a 1000.

  4. Clique em OK.

Página

É possível adicionar, excluir e renomear páginas na área de design de Transformação. As Operação de mapeamentos e seus contêiners de escopo são por página.

Para adicionar, remover ou renomear uma página, clique o botão direito do mouse na guia Página 1 na parte inferior da área de design para exibir as opções disponíveis.

Consulte também

Mostrar: