Partilhar via

Validar XML usando esquemas em fluxos de trabalho B2B com o Azure Logic Apps

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)

Em cenários de integração empresarial business-to-business (B2B), os parceiros comerciais que comunicam entre si com base num acordo precisam de garantir que as suas mensagens são válidas antes de qualquer processamento de dados poder começar.

Este guia mostra como o fluxo de trabalho da sua aplicação lógica pode validar mensagens e documentos XML usando um esquema pré-definido e a ação XML Operations que valida XML.

Pré-requisitos

  • Uma conta e subscrição do Azure. Crie uma conta Azure gratuita.

  • O recurso e fluxo de trabalho da aplicação lógica onde queres validar o XML.

    O teu fluxo de trabalho deve começar com um gatilho, mas podes usar qualquer gatilho que funcione para o teu cenário. Para mais informações, consulte estes passos gerais para adicionar qualquer gatilho que desejar.

    Os exemplos deste guia utilizam o gatilho de Request chamado Quando uma solicitação HTTP é recebida, que espera até que um chamador externo envie um pedido para o gatilho. Em alternativa, pode usar o gatilho Schedule chamado Recurrence.

  • Um recurso de conta de integração para definir e armazenar artefactos para utilização na integração empresarial e fluxos de trabalho B2B em múltiplos recursos de aplicação lógica.

    • Sua conta de integração e o recurso do aplicativo lógico devem existir na mesma assinatura do Azure e na mesma região do Azure.

    • O esquema a ser usado para validar conteúdo XML.

  • Antes de começar a trabalhar com operações XML que utilizam artefactos como esquemas numa conta de integração, deve ligar a sua aplicação Consumption Logic ou a sua aplicação Standard Logic à conta de integração. Depois podes usar os artefactos entre fluxos de trabalho em vários recursos de aplicações lógicas.

    Pode, opcionalmente, adicionar artefactos específicos diretamente a um recurso de aplicação Standard Logic. No entanto, apenas fluxos de trabalho no mesmo recurso podem funcionar com esses artefactos.

  • Instale ou use uma ferramenta que possa enviar solicitações HTTP para testar sua solução, por exemplo:

    Atenção

    Para cenários em que você tem dados confidenciais, como credenciais, segredos, tokens de acesso, chaves de API e outras informações semelhantes, certifique-se de usar uma ferramenta que proteja seus dados com os recursos de segurança necessários. A ferramenta deve funcionar offline ou localmente e não requer login em uma conta online ou sincronização de dados com a nuvem. Ao usar uma ferramenta com essas características, você reduz o risco de expor dados confidenciais ao público.

Se usares um trigger que espera por um pedido para iniciar o fluxo de trabalho, precisas de uma ferramenta de pedido HTTP para testar o trigger e o workflow.

Adicionar uma ação validar XML

  1. No portal Azure, abra o recurso da aplicação lógica. Abra seu fluxo de trabalho no designer.

  2. No designer, siga estes passos gerais para adicionar a ação XML Operations com o nome que corresponda ao seu tipo de fluxo de trabalho:

    Workflow Nome da ação
    Consumo Validação XML
    Standard Validar XML

  3. Para visualizar as opções de origem para o seu conteúdo XML, siga estes passos:

    1. Selecione dentro da caixa de Conteúdo , depois selecione uma opção:

      Fonte de conteúdo XML Selecionar Description
      Saída de uma operação de fluxo de trabalho anterior Ícone de relâmpago Abra a lista de conteúdo dinâmico para que possa selecionar o resultado do disparador ou de uma ação anterior.
      Saída de uma expressão Ícone de função Abra o editor de expressões para poder usar uma função de expressão ou construir uma expressão para produzir o conteúdo XML.

      Este exemplo continua com a lista dinâmica de conteúdos, por exemplo:

      A captura de ecrã mostra o portal Azure, o designer de fluxo de trabalho, a ação Validar XML selecionada, o cursor na caixa de Conteúdo e a lista dinâmica de conteúdo aberta.

    2. Da lista de conteúdo dinâmico, selecione a saída com o conteúdo XML da operação que deseja.

      Este exemplo seleciona a saída Body do trigger denominado Quando um pedido HTTP é recebido.

  4. Para especificar o esquema para validação, siga os passos para o seu tipo de fluxo de trabalho:

    • Consumo

      Na lista Nome do Esquema, selecione o esquema da conta de integração associada.

    • Standard

      1. Na lista de código-fonte do Esquema , selecione IntegrationAccount ou LogicApp.

        Este exemplo seleciona IntegrationAccount.

      2. Na lista de nomes do Esquema , selecione o esquema.

  5. Quando terminar, salve seu fluxo de trabalho.

Já terminou de configurar a ação de validar XML. Em um aplicativo do mundo real, talvez você queira armazenar os dados validados em um aplicativo de linha de negócios (LOB), como o SalesForce. Para enviar a saída validada para o Salesforce, adicione uma ação do Salesforce .

Testar o fluxo de trabalho

Confirma que o fluxo de trabalho funciona como esperas.

  1. No designer, selecione o gatilho chamado Quando uma solicitação HTTP é recebida.

  2. A partir da propriedade URL HTTP , copie e guarde o URL do endpoint para o trigger.

  3. Na barra de ferramentas do designer, selecione Executar>Executar.

  4. Para acionar o Request trigger, use a sua ferramenta de requisição HTTP preferida para enviar um pedido com o conteúdo XML para o URL de endpoint do trigger.

    A ação de validação XML executa-se após o acionamento do gatilho e o conteúdo XML está disponível para validação.

  5. Para rever o estado de cada operação, entradas e saídas, siga os passos em Rever o histórico de execução do fluxo de trabalho.

Conteúdo relacionado

  • Last updated on