Validar XML em fluxos de trabalho com os Aplicativos Lógicos do Azure
Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Standard)
Em cenários B2B de integração corporativa, os parceiros comerciais de um contrato precisam garantir que as mensagens trocadas entre eles sejam válidas antes de iniciar um processamento de dados. O fluxo de trabalho do aplicativo lógico pode validar mensagens e documentos XML usando a ação de validação de XML e um esquema predefinido.
Se ainda não estiver familiarizado com os aplicativos lógicos, veja O que são os Aplicativos Lógicos do Azure? Para mais informações sobre a integração empresarial B2B, consulte Fluxos de trabalho de integração empresarial B2B com Aplicativos Lógicos do Azure e Enterprise Integration Pack.
Pré-requisitos
Uma conta e uma assinatura do Azure. Caso ainda não tenha uma assinatura, inscreva-se em uma conta gratuita do Azure.
O fluxo de trabalho do aplicativo lógico, em branco ou existente, em que você deseja usar a ação Validação de XML.
Se você tiver um fluxo de trabalho em branco, use qualquer gatilho desejado. Este exemplo usa o gatilho de solicitação.
Um recurso de conta de integração no qual você define e armazena artefatos, como parceiros comerciais, contratos, certificados e assim por diante, para usar em seus fluxos de trabalho de integração empresarial e B2B. O recurso precisa atender aos seguintes requisitos:
Estar associado à mesma assinatura do Azure que o recurso de aplicativo lógico.
Existir no mesmo local ou na região do Azure que o recurso de aplicativo lógico em que você planeja usar a ação de Validação de XML*.
Se você estiver usando o tipo de recursoAplicativo lógico (consumo), a sua conta de integração exige os itens a seguir:
O esquema a ser usado para validar o conteúdo XML.
Se você usa o tipo de recurso de Aplicativo Lógico (Padrão), você não armazena esquemas na sua conta de integração. Em vez disso, você pode adicionar diretamente esquemas ao recurso de aplicativo lógico usando o portal do Azure ou o Visual Studio Code. É possível 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 o recurso do 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 o recurso do aplicativo lógico.
Observação
Atualmente, somente o tipo de recurso Aplicativo Lógico (consumo) oferece suporte a operações RosettaNet. O tipo de recurso Aplicativo Lógico (Padrão) não inclui as operações RosettaNet.
Adicionar ação de validação de XML
No portal do Azure, abra o aplicativo lógico e o fluxo de trabalho na exibição do designer.
Se tiver um aplicativo lógico em branco que não tenha um gatilho, adicione qualquer gatilho que desejar. Este exemplo usa o gatilho de solicitação. Caso contrário, prossiga para a próxima etapa.
Para adicionar o gatilho de solicitação, na caixa de pesquisa do designer, insira
HTTP requeste selecione o gatilho de solicitação chamado Quando uma solicitação HTTP é recebida.Na etapa do fluxo de trabalho que deseja adicionar a ação Validação de XML, escolha uma das etapas a seguir:
Para um aplicativo lógico baseado em plano de consumo ou ISE, escolha uma etapa:
Para adicionar a ação de Validação de XML no final do fluxo de trabalho, escolha Nova etapa.
Para adicionar a ação Validação de XML entre etapas existentes, mova o mouse sobre a seta que conecta essas etapas para que o sinal de adição (+) seja exibido. Escolha o sinal de adição e 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 de XML no final do fluxo de trabalho, escolha o sinal de adição ( + ) e, em seguida, Adicionar uma ação.
Para adicionar a ação Validação de XML entre as etapas existentes, escolha o sinal de adição ( + ) que é exibido entre as etapas e, em seguida, Adicionar uma ação.
Em Escolher uma operação, selecione Interno. Na caixa de pesquisa, insira
xml validation. Na lista de ações, selecione Validação de 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 cabeçalho do gatilho ou da ação na lista e se você pode selecionar Ver mais.
Para um aplicativo lógico com base em plano de consumo ou ISE, o designer é semelhante a este exemplo:
Para um aplicativo lógico baseado em plano padrão, o designer é semelhante ao exemplo:
Na lista de conteúdo dinâmico, escolha o token de propriedade para o conteúdo que deseja validar.
Este exemplo seleciona o token Corpo do gatilho.
Para especificar o esquema a ser usado para validação, abra a lista Nome do esquema e escolha o esquema que você adicionou anteriormente.
Quando terminar, certifique-se de salvar o fluxo de trabalho do aplicativo lógico.
Agora você concluiu a configuração de sua ação Validação de XML. 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 ao Salesforce, adicione uma ação Salesforce.
Para testar sua ação de validação, dispare e execute o fluxo de trabalho. Por exemplo, para o gatilho de solicitação, envie uma solicitação para a URL do ponto de extremidade do gatilho.
A ação de validação de XML é executada após o disparo do seu fluxo de trabalho e quando o conteúdo XML está disponível para validação.