Adicione mapas para transformações em fluxos de trabalho com apps Azure Logic

Ações de fluxo de trabalho como Transform XML e Liquid requerem um mapa para executar as suas tarefas. Por exemplo, a ação Transform XML requer um mapa para converter XML entre formatos. Um mapa é um documento XML que utiliza a linguagem extensível de transformação da linguagem da folha de estilo (XSLT) para descrever como converter dados de XML para outro formato e tem a extensão do nome do ficheiro .xslt. O mapa consiste num esquema XML de origem como entrada e um esquema XML alvo como saída. Pode definir uma transformação básica, como copiar um nome e endereço de um documento para outro. Ou, pode criar transformações mais complexas usando as operações de mapa fora da caixa. Pode manipular ou controlar dados utilizando diferentes funções incorporadas, tais como manipulações de cordas, atribuições condicionais, expressões aritméticas, formadores de tempo de data e até construções em loop.

Por exemplo, suponha que recebe regularmente encomendas ou faturas B2B de um cliente que utiliza o formato de data do YearMonthDay (YYYYMMDD). No entanto, a sua organização utiliza o formato de data MonthDayYear (MMDDYYYY). Pode definir e utilizar um mapa que transforme o formato YYYYMMDD no formato MMDDYYYY antes de armazenar os dados da encomenda ou da fatura na base de dados de atividade do cliente.

Este artigo mostra como adicionar um mapa à sua conta de integração. Se estiver a trabalhar com um fluxo de trabalho de aplicações lógica padrão, também pode adicionar um mapa diretamente ao seu recurso de aplicação lógica.

Pré-requisitos

  • Uma conta e subscrição do Azure. Se ainda não tiver uma subscrição, inscreva-se para uma conta Azure gratuita.

  • O mapa que quer adicionar. Para criar mapas, pode utilizar as seguintes ferramentas com o SDK de integração empresarial:

    Nota

    Não instale a extensão juntamente com a extensão BizTalk Server. Ter ambas as extensões pode produzir um comportamento inesperado. Certifique-se de que só tem uma destas extensões instaladas.

    Em monitores de alta resolução, você pode experimentar um problema de exibição com o designer de mapas em Visual Studio. Para resolver este problema de exibição, reinicie o Visual Studio no modo DPI-unaware ou adicione o valor do registo DPIUNAWARE.

    Para mais informações, reveja a secção De mapas Create neste artigo.

  • Com base no facto de estar a trabalhar num fluxo de trabalho de aplicações lógicas de Consumo ou Padrão, vai precisar de um recurso de conta de integração. Normalmente, você precisa deste recurso quando você quer definir e armazenar artefactos para uso na integração empresarial e fluxos de trabalho B2B.

    Importante

    Para trabalhar em conjunto, tanto a sua conta de integração como o recurso de aplicação lógica devem existir na mesma subscrição Azure e na região de Azure.

    • Se estiver a trabalhar num fluxo de trabalho de aplicações lógicas de Consumo, precisará de uma conta de integração ligada ao recurso da sua aplicação lógica.

    • Se estiver a trabalhar num fluxo de trabalho de aplicações lógica padrão, pode ligar a sua conta de integração ao seu recurso de aplicação lógica, enviar mapas diretamente para o seu recurso de aplicação lógica, ou ambos, com base nos seguintes cenários:

      • Se já tem uma conta de integração com os artefactos que precisa ou quer usar, pode ligar a sua conta de integração a vários recursos de aplicações lógicas Standard onde pretende utilizar os artefactos. Dessa forma, não é preciso enviar mapas para cada aplicação lógica individual. Para mais informações, reveja Link o seu recurso de aplicação lógica para a sua conta de integração.

      • O conector incorporado líquido permite-lhe selecionar um mapa que já carregou para o seu recurso de aplicação lógica ou para uma conta de integração ligada, mas não para ambos. Em seguida, pode utilizar este artefacto em todos os fluxos de trabalho das crianças dentro do mesmo recurso de aplicação lógica.

      Portanto, se não tiver ou precisar de uma conta de integração, pode usar a opção de upload. Caso contrário, pode utilizar a opção de ligação. De qualquer forma, você pode usar estes artefactos em todos os fluxos de trabalho de criança dentro do mesmo recurso de aplicação lógica.

Limitações

  • Os limites aplicam-se ao número de artefactos, como mapas, por conta de integração. Para mais informações, reveja limites e informações de configuração para Azure Logic Apps.

  • Com base no facto de estar a trabalhar num fluxo de trabalho de aplicações lógicas de consumo ou padrão, aplicam-se as seguintes limitações:

    • Fluxos de trabalho padrão

      • Apenas XSLT 1.0 é suportado.

      • As referências a conjuntos externos a partir de mapas não são suportadas.

      • Não se aplicam limites aos tamanhos dos ficheiros do mapa.

    • Fluxos de trabalho de consumo

      • Suporta referências a conjuntos externos a partir de mapas, que permitem chamadas diretas de mapas XSLT para código .NET personalizado com os seguintes requisitos:

        • Precisa de uma montagem de 64 bits. O serviço de transformação executa um processo de 64 bits, por isso as assembléias de 32 bits não são suportadas. Se tiver o código de origem para uma montagem de 32 bits, recomplíne o código num conjunto de 64 bits. Se não tiver o código fonte, mas obteve o binário de um fornecedor de terceiros, obtenha a versão de 64 bits desse fornecedor. Por exemplo, alguns fornecedores fornecem conjuntos em pacotes que têm versões de 32 e 64 bits. Se tiver a opção, utilize a versão de 64 bits.

        • Tem de fazer o upload da montagem e do mapa numa ordem específica para a sua conta de integração. Certifique-se de que faz o upload da montagem primeiro e, em seguida, carre deixe de carregar o mapa que faz referência à montagem.

        • Se a sua montagem ou mapa for 2 MB ou menor, pode adicionar a sua montagem e mapa à sua conta de integração diretamente a partir do portal do Azure.

        • Se a sua montagem for maior do que 2 MB, mas não maior do que o limite de tamanho para conjuntos, precisará de uma conta de armazenamento Azure e um recipiente de bolhas onde pode carregar a sua montagem. Mais tarde, pode fornecer a localização do contentor quando adicionar a montagem à sua conta de integração. Para esta tarefa, a tabela a seguir descreve os itens de que necessita:

          Item Descrição
          Conta de armazenamento Azure Nesta conta, crie um recipiente de bolhaS Azure para a sua montagem. Saiba como criar uma conta de armazenamento.
          Contentor de blobs Neste recipiente, pode fazer o upload da sua montagem. Também precisa da localização URI de conteúdo deste recipiente quando adicionar a montagem à sua conta de integração. Aprenda a criar um recipiente de bolhas.
          Explorador do Storage do Azure Esta ferramenta ajuda-o a gerir mais facilmente as contas de armazenamento e os recipientes blob. Para utilizar Explorador de Armazenamento, faça o download e instale Explorador de Armazenamento do Azure. Em seguida, conecte Explorador de Armazenamento à sua conta de armazenamento seguindo os passos em Começar com Explorador de Armazenamento. Para saber mais, consulte Quickstart: Crie uma bolha no armazenamento de objetos com Explorador de Armazenamento do Azure.

          Ou, no portal do Azure, selecione a sua conta de armazenamento. No menu da sua conta de armazenamento, selecione Explorador de Armazenamento.

          Para adicionar mapas maiores, pode utilizar as Aplicações Lógicas AZure REST API - Mapas. Para fluxos de trabalho standard, a Azure Logic Apps REST API está atualmente indisponível.

      • A Azure Logic Apps atribui memória finita para o processamento de transformações de XML. Se criar fluxos de trabalho de consumo, e o seu mapa ou transformações de carga útil tiver um consumo de memória elevado, tais transformações podem falhar, resultando em erros de memória. Para evitar este cenário, considere estas opções:

        • Edite os seus mapas ou cargas para reduzir o consumo de memória.

        • Crie fluxos de trabalho de aplicações lógicas standard em vez disso.

          Estes fluxos de trabalho funcionam em aplicativos Azure Logic, que oferecem opções dedicadas e flexíveis para computação e recursos de memória. No entanto, os fluxos de trabalho standard suportam apenas XSLT 1.0 e não suportam a referência a conjuntos externos a partir de mapas.

Criar mapas

Para criar um documento XSLT para usar como mapa, crie um projeto de integração no Visual Studio 2019 ou 2015 utilizando o SDK de Integração Empresarial. No projeto de integração, pode construir um ficheiro de mapa de integração, que permite mapear visualmente itens entre dois ficheiros de esquemaS XML. Estas ferramentas oferecem as seguintes capacidades de mapa:

  • Você trabalha com uma representação gráfica do mapa, que mostra todas as relações e ligações que cria.

  • Pode fazer uma cópia de dados direta entre os esquemas XML que utiliza para criar o mapa. O SDK de Integração Empresarial para O Estúdio Visual inclui um mapper que torna esta tarefa tão simples como desenhar uma linha que ligue os elementos no esquema XML de origem com as suas contrapartidas no esquema XML alvo.

  • Estão disponíveis operações ou funções para vários mapas, incluindo funções de cordas, funções de hora de data, e assim por diante.

  • Para adicionar uma amostra de mensagem XML, pode utilizar a capacidade de teste do mapa. Com apenas um gesto, pode testar o mapa que criou e rever a saída gerada.

  • Depois de construir o seu projeto, obtém um documento XSLT.

O seu mapa deve ter os seguintes atributos e uma CDATA secção que contenha a chamada para o código de montagem:

  • name é o nome de montagem personalizado.

  • namespace é o espaço de nome na sua montagem que inclui o código personalizado.

O exemplo a seguir mostra um mapa que faz referência a um conjunto nomeado XslUtilitiesLib e chama o circumference método da montagem.

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:user="urn:my-scripts">
<msxsl:script language="C#" implements-prefix="user">
    <msxsl:assembly name="XsltHelperLib"/>
    <msxsl:using namespace="XsltHelpers"/>
    <![CDATA[public double circumference(int radius){ XsltHelper helper = new XsltHelper(); return helper.circumference(radius); }]]>
</msxsl:script>
<xsl:template match="data">
<circles>
    <xsl:for-each select="circle">
        <circle>
            <xsl:copy-of select="node()"/>
                <circumference>
                    <xsl:value-of select="user:circumference(radius)"/>
                </circumference>
        </circle>
    </xsl:for-each>
</circles>
</xsl:template>
</xsl:stylesheet>

Adicionar conjuntos referenciados (Apenas fluxos de trabalho de consumo)

  1. Na portal do Azure, inscreva-se com as suas credenciais de conta Azure.

  2. Na caixa de pesquisa principal do Azure, insira integration accountse selecione contas de Integração.

  3. Selecione a conta de integração onde pretende adicionar o seu conjunto.

  4. No menu da sua conta de integração, selecione Overview. Em Definições, selecione Conjuntos.

  5. Na barra de ferramentas do painel de montagem, selecione Adicionar.

Com base no tamanho do seu ficheiro de montagem, siga os passos para o upload de um conjunto que seja até 2 MB ou mais de 2 MB, mas apenas até 8 MB. Para limites nas quantidades de montagem em contas de integração, rever limites e configuração para Azure Logic Apps.

Nota

Se alterar a sua montagem, também deve atualizar o seu mapa se o mapa tem ou não alterações.

Adicionar conjuntos até 2 MB

  1. Em Assembl assemblagem, insira um nome para a sua montagem. Mantenha o ficheiro Small selecionado. Ao lado da caixa de montagem , selecione o ícone da pasta. Encontre e selecione o conjunto que está a carregar.

    Depois de selecionar a montagem, a propriedade 'Nome de montagem ' mostra automaticamente o nome do ficheiro do conjunto.

  2. Quando tiver terminado, selecione OK.

    Após o seu ficheiro de montagem terminar o upload, o conjunto aparece na lista de Conjuntos . No painel de visão geral da sua conta de integração, em Artefactos, o seu conjunto carregado também aparece.

Adicionar conjuntos mais de 2 MB

Para adicionar conjuntos maiores, pode enviar o seu conjunto para um recipiente de bolhas Azure na sua conta de armazenamento Azure. Os seus passos para adicionar conjuntos diferem com base no facto de o seu recipiente de bolhas ter acesso público. Primeiro, verifique se o seu recipiente de bolhas tem ou não acesso ao público, seguindo estes passos: Definir o nível de acesso público para o recipiente blob

Verifique o nível de acesso ao contentor

  1. Abra Explorador de Armazenamento do Azure. Na janela Explorer, expanda a subscrição do Azure se não for já expandida.

  2. Expandir contas> de armazenamento {sua conta de armazenamento} >Recipientes blob. Selecione o seu recipiente blob.

  3. No menu de atalho do seu recipiente blob, selecione Definir o Nível de Acesso Público.

Upload para contentores com acesso público

  1. Faça o upload da montagem para a sua conta de armazenamento. Na janela do lado direito, selecione Upload.

  2. Depois de terminar o upload, selecione o seu conjunto carregado. Na barra de ferramentas, selecione Copy URL para que copie o URL do conjunto.

  3. Volte ao portal do Azure onde está aberta a vidraça add assembly. Insira um nome para a sua assembleia. Selecione Ficheiro Grande (superior a 2 MB).

    A caixa Content URI aparece agora, em vez da caixa de Montagem .

  4. Na caixa Content URI , cole o URL do seu conjunto. Termine de adicionar a sua montagem.

    Depois de terminar o upload da montagem, o conjunto aparece na lista de Conjuntos . No painel de visão geral da sua conta de integração, em Artefactos, o seu conjunto carregado também aparece.

Upload para contentores sem acesso público

  1. Faça o upload da montagem para a sua conta de armazenamento. Na janela do lado direito, selecione Upload.

  2. Depois de terminar o upload, gere uma assinatura de acesso partilhado (SAS) para a sua montagem. No menu de atalho da sua assembléia, selecione Obter Assinatura de Acesso Partilhado.

  3. No painel assinatura de acesso partilhado , selecione Gerar assinatura de acesso partilhado ao nível do contentor URI>Create. Depois de o URL SAS ser gerado, junto à caixa URL , selecione Copy.

  4. Volte ao portal do Azure onde está aberta a vidraça add assembly. Insira um nome para a sua assembleia. Selecione Ficheiro Grande (superior a 2 MB).

    A caixa Content URI aparece agora, em vez da caixa de Montagem .

  5. Na caixa Content URI , cole o SAS URI que gerou anteriormente. Termine de adicionar a sua montagem.

Depois de terminar o upload da montagem, o conjunto aparece na lista de Conjuntos . Na página geral da sua conta de integração, em Artefactos, o seu conjunto carregado também aparece.

Adicionar mapas

  • Se estiver a trabalhar com um fluxo de trabalho de consumo, deve adicionar o seu mapa a uma conta de integração ligada.

  • Se estiver a trabalhar com um fluxo de trabalho standard, tem as seguintes opções:

    • Adicione o seu mapa a uma conta de integração ligada. Você pode compartilhar o mapa e a conta de integração através de vários recursos de aplicações lógicas Standard e seus fluxos de trabalho infantil.

    • Adicione o seu mapa diretamente ao seu recurso de aplicação lógica. No entanto, só é possível partilhar esse mapa através de fluxos de trabalho infantis no mesmo recurso de aplicação lógica.

Adicionar mapa à conta de integração

  1. Na portal do Azure, inscreva-se com as suas credenciais de conta Azure.

  2. Na caixa de pesquisa portal do Azure, introduza contas de integração e selecione contas de Integração.

  3. Encontre e selecione a sua conta de integração.

  4. No menu de navegação da conta de integração, em Definições, selecione Maps.

  5. Na barra de ferramentas do painel maps , selecione Add.

Para fluxos de trabalho de consumo, com base no tamanho do ficheiro do seu mapa, siga agora os passos para o upload de um mapa que seja até 2 MB ou mais de 2 MB.

Adicione mapas até 2 MB

  1. No painel Add Map , insira um nome único para o seu mapa.

  2. No tipo Mapa, selecione o tipo, por exemplo: Líquido, XSLT, XSLT 2.0 ou XSLT 3.0.

  3. Ao lado da caixa Mapa , selecione o ícone da pasta. Selecione o mapa para carregar.

    Se deixou a propriedade Name vazia, o nome do ficheiro do mapa aparece automaticamente nessa propriedade depois de selecionar o ficheiro do mapa.

  4. Quando tiver terminado, selecione OK.

    Depois de o seu ficheiro de mapa terminar o upload, o mapa aparece na lista do Maps . Na página geral da sua conta de integração, em Artefactos, o seu mapa carregado também aparece.

Adicionar mapas mais de 2 MB

Para adicionar mapas maiores para fluxos de trabalho de consumo, use as aplicações lógicas Azure REST API - Mapas.


Adicione mapa ao recurso de aplicativo lógico Standard

Os seguintes passos aplicam-se apenas se pretender adicionar um mapa diretamente ao seu recurso de aplicação lógica Standard. Caso contrário, adicione o mapa à sua conta de integração.

Portal do Azure

  1. No menu do recurso da sua aplicação lógica, em Definições, selecione Maps.

  2. Na barra de ferramentas do painel maps , selecione Add.

  3. No painel 'Adicionar Mapa ', insira um nome único para o seu mapa e inclua o nome da .xslt extensão.

  4. Ao lado da caixa Mapa , selecione o ícone da pasta. Selecione o mapa para carregar.

  5. Quando tiver terminado, selecione OK.

    Depois de o seu ficheiro de mapa terminar o upload, o mapa aparece na lista do Maps . Na página geral da sua conta de integração, em Artefactos, o seu mapa carregado também aparece.

Visual Studio Code

  1. Na estrutura do seu projeto de aplicação lógica, abra a pasta Artefactos e, em seguida, a pasta Maps .

  2. Na pasta Maps , adicione o seu mapa.


Editar um mapa

Para atualizar um mapa existente, tem de carregar um novo ficheiro de mapa que tenha as alterações que pretende. No entanto, primeiro pode descarregar o mapa existente para edição.

  1. No portal do Azure, abra a sua conta de integração, se não já aberta.

  2. No menu da sua conta de integração, em Definições, selecione Maps.

  3. Depois de abrir o painel maps, selecione o seu mapa. Para baixar e editar primeiro o mapa, na barra de ferramentas do painel maps , selecione Baixar e guardar o mapa.

  4. Quando estiver pronto para carregar o mapa atualizado, no painel maps , selecione o mapa que pretende atualizar. Na barra de ferramentas do painel maps , selecione Update.

  5. Encontre e selecione o mapa atualizado que pretende carregar.

    Depois de o seu ficheiro de mapa terminar o upload, o mapa atualizado aparece na lista do Maps .

Excluir um mapa

  1. No portal do Azure, abra a sua conta de integração, se não já aberta.

  2. No menu da sua conta de integração, em Definições, selecione Maps.

  3. Depois de abrir o painel maps, selecione o seu mapa e, em seguida, selecione Delete.

  4. Para confirmar que pretende eliminar o mapa, selecione Sim.

Passos seguintes