Validar XML em fluxos de trabalho com o Azure Logic Apps
Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)
Em cenários de integração empresarial entre empresas (B2B), os parceiros comerciais num acordo têm frequentemente de se certificar de que as mensagens que trocam são válidas antes de se poder iniciar qualquer processamento de dados. Seu fluxo de trabalho de aplicativo lógico pode validar mensagens e documentos XML usando a ação Validação de XML e um esquema predefinido.
Se você é novo em aplicativos lógicos, consulte O que são os Aplicativos Lógicos do Azure? Para obter mais informações sobre integração empresarial B2B, consulte Fluxos de trabalho de integração empresarial B2B com Aplicativos Lógicos do Azure e Pacote de Integração Empresarial.
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 do aplicativo lógico, em branco ou existente, onde você deseja usar a ação Validação XML .
Se você tiver um fluxo de trabalho em branco, use qualquer gatilho desejado. Este exemplo usa o gatilho Request.
Um recurso de conta de integração onde você define e armazena artefatos, como parceiros comerciais, contratos, certificados e assim por diante, para uso em sua integração empresarial e fluxos de trabalho B2B. Este recurso tem de cumprir os seguintes requisitos:
Está associado à mesma assinatura do Azure que seu recurso de aplicativo lógico.
Existe no mesmo local ou região do Azure que o recurso do aplicativo lógico onde você planeja usar a ação Validação XML*.
Se você estiver usando o tipo de recurso Aplicativo Lógico (Consumo), sua conta de integração exigirá os seguintes itens:
O esquema a ser usado para validar conteúdo XML.
Um link para o recurso do aplicativo lógico.
Se você estiver usando o tipo de recurso Logic App (Standard), não armazenará esquemas em sua conta de integração. Em vez disso, você pode adicionar esquemas diretamente ao recurso do aplicativo lógico usando o portal do Azure ou o Visual Studio Code. Em seguida, você pode usar esses esquemas em vários fluxos de trabalho dentro do mesmo recurso de aplicativo lógico.
Você ainda precisa de uma conta de integração para armazenar outros artefatos, como parceiros, contratos e certificados, além de usar as operações AS2, X12 e EDIFACT . No entanto, você não precisa vincular seu recurso de aplicativo lógico à sua conta de integração, portanto, o recurso de vinculação não existe. Sua conta de integração ainda precisa atender a outros requisitos, como usar a mesma assinatura do Azure e existir no mesmo local que seu recurso de aplicativo lógico.
Nota
Atualmente, apenas o tipo de recurso Logic App (Consumo) suporta operações RosettaNet . O tipo de recurso Logic App (Standard) não inclui operações RosettaNet .
Adicionar ação de validação XML
No portal do Azure, abra seu aplicativo lógico e fluxo de trabalho no modo de exibição de designer.
Se você tiver um aplicativo lógico em branco que não tenha um gatilho, adicione qualquer gatilho desejado. Este exemplo usa o gatilho Request. Caso contrário, avance para o passo seguinte.
Para adicionar o gatilho Solicitação, na caixa de pesquisa do designer, digite
HTTP requeste selecione o gatilho Solicitação chamado Quando uma solicitação HTTP for recebida.Na etapa do fluxo de trabalho em que você deseja adicionar a ação Validação XML, escolha uma das seguintes etapas:
Para um aplicativo de lógica de consumo, escolha uma das seguintes etapas:
Para adicionar a ação Validação XML no final do fluxo de trabalho, selecione Nova etapa.
Para adicionar a ação Validação XML entre as etapas existentes, mova o ponteiro sobre a seta que conecta essas etapas para que o sinal de adição (+) apareça. Selecione esse sinal de adição e, em seguida, selecione Adicionar uma ação.
Para um aplicativo lógico baseado em plano padrão, escolha uma etapa:
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 Validação XML entre as etapas existentes, selecione o sinal de adição (+) que aparece entre essas etapas e selecione Adicionar uma ação.
Em Escolha 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údo dinâmico seja exibida.
A lista de conteúdo dinâmico mostra tokens de propriedade que representam as saídas das etapas anteriores no fluxo de trabalho. Se a lista não mostrar uma propriedade esperada, verifique o título do gatilho ou da ação na lista e se você pode selecionar Ver mais.
Para um aplicativo de lógica de consumo, o designer se parece com este exemplo:
Para um aplicativo lógico baseado em plano padrão, o designer se parece com este exemplo:
Na lista de conteúdo dinâmico, selecione o token de propriedade para o conteúdo que você deseja validar.
Este exemplo seleciona o token Body do gatilho.
Para especificar o esquema a ser usado para validação, abra a lista Nome do esquema e selecione o esquema que você adicionou anteriormente.
Quando terminar, salve o fluxo de trabalho do aplicativo lógico.
Agora você terminou de configurar sua ação de Validação 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.
Para testar sua ação de validação, acione e execute seu fluxo de trabalho. Por exemplo, para o gatilho Solicitação, envie uma solicitação para a URL do ponto de extremidade do gatilho.
A ação Validação XML é executada depois que o fluxo de trabalho é acionado e quando o conteúdo XML está disponível para validação.