Analisar um XML usando esquemas em fluxos de trabalho Standard com os Aplicativos Lógicos do Azure (versão prévia)
Aplica-se a: Aplicativos Lógicos do Azure (Standard)
Importante
Esse recurso está em versão prévia e está sujeito aos Termos de uso suplementares para versões prévias do Microsoft Azure.
Em cenários de migração do BizTalk ou B2B (entre empresas) de integração empresarial, talvez seja necessário analisar documentos XML. O fluxo de trabalho do aplicativo lógico Standard pode analisar um XML usando a ação chamada Analisar XML com o esquema, que exige um esquema XSD.
Por exemplo, suponha que você receba regularmente pedidos de clientes ou faturas que usam o XML como o formato de troca e precisam acessar elementos XML individuais no Designer de Fluxo de Trabalho para os Aplicativos Lógicos do Azure.
Limitações
No momento, essa ação ainda não dá suporte ao recurso e fluxo de trabalho do aplicativo lógico de Consumo.
Pré-requisitos
Uma conta e uma assinatura do Azure. Caso ainda não tenha uma assinatura, inscreva-se em uma conta gratuita do Azure.
Um fluxo de trabalho do aplicativo lógico Standard que já começa com um gatilho, para que você possa adicionar a ação Analisar XML com o esquema ao fluxo de trabalho.
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.
Existe na mesma localização ou região do Azure que o recurso de aplicativo lógico em que você planeja usar a ação Analisar XML com o esquema.
Se você estiver trabalhando em um recurso e fluxo de trabalho de aplicativo lógico Standard, poderá vincular sua conta de integração ao seu recurso de aplicativo lógico, carregar esquemas XSD diretamente para seu recurso de aplicativo lógico, ou ambos, com base nos seguintes cenários:
Se você já tiver uma conta de integração com os artefatos que precisa ou deseja usar, vincule essa conta a diversos recursos de aplicativo lógico Standard nos quais deseja usar os artefatos. Dessa forma, você não precisa carregar esquemas XSD para cada aplicativo lógico individual. Para obter mais informações, examine Vincular o recurso do aplicativo lógico à conta de integração.
Se você não tiver uma conta de integração ou só pretende usar seus artefatos em vários fluxos de trabalho dentro do mesmo recurso de aplicativo lógico, adicione esquemas diretamente ao recurso de aplicativo lógico usando o portal do Azure ou o Visual Studio Code.
Portanto, se você não tiver ou precisar de uma conta de integração, poderá usar a opção de carregamento. Caso contrário, use a opção de vinculação. É possível usar esses artefatos em todos os fluxos de trabalho secundários 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.
O esquema XSD a ser usado com a ação Analisar XML com o esquema. Garanta que esse esquema inclua um elemento raiz, que seja parecido com o seguinte exemplo:
<xs:element name="Root"> <....> </xs:element>
Adicionar uma ação Analisar XML com o esquema
No portal do Azure, abra o fluxo de trabalho e o aplicativo lógico Standard no designer.
Se você tem um fluxo de trabalho em branco que não tem um gatilho, siga estas etapas gerais para adicionar o gatilho desejado. Caso contrário, prossiga para a próxima etapa.
Este exemplo usa o gatilho Solicitação.
Na etapa do fluxo de trabalho em que você deseja adicionar a ação Analisar XML com o esquema, siga estas etapas gerais para adicionar a ação chamada Analisar XML com o esquema.
Na caixa Conteúdo, especifique o conteúdo XML que você deseja analisar usando os dados XML recebidos na solicitação HTTP.
Para selecionar saídas de operações anteriores no fluxo de trabalho, na ação Analisar XML com o esquema, selecione dentro da caixa Conteúdo e escolha a opção de lista de conteúdo dinâmico (ícone de raio).
Na lista de conteúdo dinâmico, selecione o token para o conteúdo que você deseja analisar.
Este exemplo seleciona o token Corpo do gatilho.
Na lista Origem, selecione o local em que você carregou o esquema XSD: o recurso LogicApp ou a IntegrationAccount.
Na lista Nome, selecione o esquema XSD.
Quando terminar, salve o fluxo de trabalho.
Você acabou de terminar de configurar a ação Analisar XML com o esquema. Em um aplicativo do mundo real, o ideal é armazenar os dados analisados em um aplicativo LOB (linha de negócios), como o Salesforce. Para enviar a saída analisada ao Salesforce, adicione uma ação do Salesforce.
Para testar a ação de análise, dispare e execute o 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 Analisar XML com o esquema é executada depois que o fluxo de trabalho é disparado e quando o conteúdo XML está disponível para análise.
Parâmetros avançados
A seguinte tabela descreve os parâmetros avançados disponíveis nessa ação:
| Parâmetro | Valor | Descrição |
|---|---|---|
| Processamento de DTD | - Ignorar - Analisar - Proibir |
Especifica como tratar a DTD (definição de tipo de documento) XML. |
| Normalizar XML | Não ou Sim | Indica se o conteúdo XML deve ser normalizado. |
| Ignorar Espaço em Branco? | Não ou Sim | Indica se um espaço em branco insignificante deve ser analisado ou ignorado, como espaços, guias e linhas em branco em documentos XML. |
| Ignorar Instruções de Processamento de XML? | Não ou Sim | Indica se as instruções de processamento de XML devem ser seguidas ou ignoradas. |
| Ignorar Atributos XML | Não ou Sim | Indica se os atributos XML devem ser gravados ou ignorados. |
| Usar Nomes Totalmente Qualificados? | Não ou Sim | Indica se devem ser usados nomes locais mais simples ou nomes XML totalmente qualificados. |
| Nome Qualificado do Nó Raiz | <root-node-qualified-name> | O nome qualificado do nó raiz, caso o esquema contenha várias definições de elementos não referenciados. |