Validar XML em fluxos de trabalho com o Azure Logic Apps
Aplica-se a: Azure Logic Apps (Consumo + Standard)
Em cenários empresariais de integração empresarial (B2B), os parceiros comerciais num contrato têm muitas vezes de se certificar de que as mensagens que trocam são válidas antes de qualquer processamento de dados poder começar. O fluxo de trabalho da aplicação lógica pode validar mensagens XML e documentos com a ação Validação XML e um esquema predefinido.
Se não estiver familiarizado com aplicações lógicas, veja O que é o Azure Logic Apps? Para obter mais informações sobre a integração empresarial B2B, veja B2B enterprise integration workflows with Azure Logic Apps and Enterprise Integration Pack (Fluxos de trabalho de integração empresarial B2B com o Azure Logic Apps e o Enterprise Integration Pack).
Pré-requisitos
Uma conta e subscrição do Azure. Se ainda não tiver uma subscrição, inscreva-se numa conta gratuita do Azure.
O fluxo de trabalho da aplicação lógica, em branco ou existente, onde pretende utilizar a ação Validação XML .
Se tiver um fluxo de trabalho em branco, utilize qualquer acionador pretendido. Este exemplo utiliza o acionador Pedir.
Um recurso de conta de integração onde define e armazena artefactos, como parceiros comerciais, contratos, certificados, etc., para utilização na integração empresarial e fluxos de trabalho B2B. Este recurso tem de cumprir os seguintes requisitos:
Está associado à mesma subscrição do Azure que o recurso da aplicação lógica.
Existe na mesma localização ou região do Azure que o recurso da aplicação lógica onde planeia utilizar a ação Validação XML*.
Se estiver a utilizar o tipo de recurso da Aplicação Lógica (Consumo), a sua conta de integração requer os seguintes itens:
O esquema a utilizar para validar conteúdo XML.
Se estiver a utilizar o tipo de recurso da Aplicação Lógica (Standard), não armazena esquemas na sua conta de integração. Em vez disso, pode adicionar diretamente esquemas ao recurso da aplicação lógica com o portal do Azure ou o Visual Studio Code. Em seguida, pode utilizar estes esquemas em vários fluxos de trabalho no mesmo recurso de aplicação lógica.
Ainda precisa de uma conta de integração para armazenar outros artefactos, como parceiros, contratos e certificados, juntamente com as operações AS2, X12 e EDIFACT . No entanto, não precisa de ligar o recurso da aplicação lógica à sua conta de integração, para que a capacidade de ligação não exista. A sua conta de integração ainda tem de cumprir outros requisitos, como utilizar a mesma subscrição do Azure e existir na mesma localização que o recurso da aplicação lógica.
Nota
Atualmente, apenas o tipo de recurso da Aplicação Lógica (Consumo) suporta operações rosettaNet . O tipo de recurso da Aplicação Lógica (Standard) não inclui operações rosettaNet .
Adicionar ação de validação XML
No portal do Azure, abra a aplicação lógica e o fluxo de trabalho na vista de estruturador.
Se tiver uma aplicação lógica em branco que não tenha um acionador, adicione qualquer acionador que pretenda. Este exemplo utiliza o acionador Pedir. Caso contrário, avance para o passo seguinte.
Para adicionar o acionador Pedido, na caixa de pesquisa do estruturador, introduza
HTTP requeste selecione o acionador Pedir com o nome Quando é recebido um pedido HTTP.No passo no fluxo de trabalho onde pretende adicionar a ação Validação XML , escolha um dos seguintes passos:
Para uma aplicação lógica baseada em planos de Consumo ou ISE, escolha um passo:
Para adicionar a ação Validação XML no final do fluxo de trabalho, selecione Novo passo.
Para adicionar a ação de Validação XML entre os passos existentes, mova o ponteiro sobre a seta que liga esses passos para que o sinal de adição (+) seja apresentado. Selecione esse sinal de adição e, em seguida, selecione Adicionar uma ação.
Para uma aplicação lógica baseada no plano Standard, escolha um passo:
Para adicionar a ação Validação XML no final do fluxo de trabalho, selecione o sinal de adição (+) e, em seguida, selecione Adicionar uma ação.
Para adicionar a ação de Validação XML entre os passos existentes, selecione o sinal de adição (+) que aparece entre esses passos e, em seguida, selecione Adicionar uma ação.
Em Escolher uma operação, selecione Incorporado. Na caixa de pesquisa, introduza
xml validation. Na lista de ações, selecione Validação XML.Para especificar o conteúdo XML para validação, clique dentro da caixa Conteúdo para que a lista de conteúdos dinâmicos seja apresentada.
A lista de conteúdos dinâmicos mostra tokens de propriedade que representam as saídas dos passos anteriores no fluxo de trabalho. Se a lista não mostrar uma propriedade esperada, verifique o cabeçalho de acionador ou ação na lista e se pode selecionar Ver mais.
Para uma aplicação lógica baseada em planos de Consumo ou ISE, o estruturador tem o seguinte aspeto:
Para uma aplicação lógica baseada em planos Standard, o estruturador tem o seguinte aspeto:
Na lista de conteúdos dinâmicos, selecione o token de propriedade para o conteúdo que pretende validar.
Este exemplo seleciona o token Corpo do acionador.
Para especificar o esquema a utilizar para validação, abra a lista Nome do Esquema e selecione o esquema que adicionou anteriormente.
Quando terminar, certifique-se de que guarda o fluxo de trabalho da aplicação lógica.
Acabou de configurar a ação de Validação XML . Numa aplicação do mundo real, poderá querer armazenar os dados validados numa aplicação de linha de negócio (LOB), como o SalesForce. Para enviar o resultado validado para o Salesforce, adicione uma ação do Salesforce.
Para testar a ação de validação, acione e execute o fluxo de trabalho. Por exemplo, para o Acionador de pedidos, envie um pedido para o URL do ponto final do acionador.
A ação Validação XML é executada após o fluxo de trabalho ser acionado e quando o conteúdo XML estiver disponível para validação.