Compartilhar via

Validar XML usando esquemas em fluxos de trabalho B2B com Aplicativos Lógicos do Azure

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

Em cenários B2B (business-to-business) de integração empresarial, os parceiros comerciais que se comunicam entre si com base em um contrato precisam garantir que suas mensagens sejam válidas antes que qualquer processamento de dados possa ser iniciado.

Este guia mostra como o fluxo de trabalho do aplicativo lógico pode validar mensagens XML e documentos usando um esquema predefinido e a ação de Operações XML que valida XML.

Pré-requisitos

  • Uma conta e uma assinatura do Azure. Obtenha uma conta gratuita do Azure.

  • O recurso de aplicativo lógico e o fluxo de trabalho em que você deseja validar o XML.

    Seu fluxo de trabalho deve começar com um gatilho, mas você pode usar qualquer gatilho que funcione para seu cenário. Para obter mais informações, consulte estas etapas gerais para adicionar qualquer gatilho desejado.

    Os exemplos neste guia usam o Request gatilho chamado 'Quando uma Solicitação HTTP é Recebida', que aguarda até que um chamador externo envie uma solicitação para o gatilho. Como alternativa, você pode usar o gatilho Agendar chamado Recorrência.

  • Um recurso de conta de integração para definir e armazenar artefatos para uso em sua integração empresarial e fluxos de trabalho B2B em vários recursos de aplicativo lógico.

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

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

  • Antes de começar a trabalhar com operações XML que usam artefatos como esquemas em uma conta de integração, você deve vincular seu aplicativo lógico de Consumo ou vincular seu aplicativo lógico Padrão à conta de integração antes de começar a trabalhar. Em seguida, você pode usar os artefatos entre fluxos de trabalho em vários recursos de aplicativo lógico.

    Opcionalmente, você pode adicionar artefatos específicos diretamente a um recurso de aplicativo lógico Standard. No entanto, somente fluxos de trabalho no mesmo recurso podem funcionar com esses artefatos.

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

    Cuidado

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

Se você usar um gatilho que aguarda uma solicitação iniciar o fluxo de trabalho, precisará de uma ferramenta de solicitação HTTP para testar o gatilho e o fluxo de trabalho.

Adicionar uma ação XML de validação

  1. No portal do Azure, abra o recurso de aplicativo lógico. Abra o fluxo de trabalho no designer.

  2. No designer, siga estas etapas gerais para adicionar a ação de Operações XML com o nome que corresponde ao tipo de fluxo de trabalho:

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

  3. Para exibir as opções de origem do conteúdo XML, siga estas etapas:

    1. Selecione dentro da caixa Conteúdo e, em seguida, selecione uma opção:

      Fonte de conteúdo XML Selecionar Description
      Saída de uma operação de fluxo de trabalho anterior Ícone de raio Abra a lista de conteúdo dinâmico para que você possa selecionar a saída do gatilho ou de uma ação anterior.
      Saída de uma expressão Ícone de função Abra o editor de expressões para que você possa usar uma função de expressão ou criar uma expressão para produzir o conteúdo XML.

      Este exemplo continua com a lista de conteúdo dinâmico, por exemplo:

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

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

      Este exemplo seleciona a saída do Corpo do gatilho chamado Quando uma solicitação HTTP é recebida.

  4. Para especificar o esquema de validação, siga as etapas para o tipo de fluxo de trabalho:

    • Consumo

      Na lista Nome do Esquema , selecione o esquema na conta de integração vinculada.

    • Standard

      1. Na lista de origem do esquema , selecione IntegrationAccount ou LogicApp.

        Este exemplo seleciona IntegrationAccount.

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

  5. Quando terminar, salve o fluxo de trabalho.

Agora você terminou de configurar sua ação XML de validação. Em um aplicativo real, convém armazenar os dados validados em um aplicativo LOB (linha de negócios), como o SalesForce. Para enviar a saída validada para o Salesforce, adicione uma ação salesforce .

Testar seu fluxo de trabalho

Confirme se o fluxo de trabalho funciona da maneira esperada.

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

  2. Na propriedade URL HTTP, copie e salve a URL do ponto de extremidade para o gatilho.

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

  4. Para disparar o gatilho Solicitação, utilize sua ferramenta HTTP preferida para enviar o conteúdo XML para a URL do ponto de extremidade do gatilho.

    A ação XML de validação é executada depois que o gatilho é acionado e o conteúdo XML está disponível para validação.

  5. Para examinar o status de cada operação, entradas e saídas, siga as etapas em Revisar histórico de execução do fluxo de trabalho.

Conteúdo relacionado

  • Last updated on