Compartilhar via

Codificar e decodificar conteúdo XML em arquivos simples para fluxos de trabalho nos Aplicativos Lógicos do Azure

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

Quando você troca conteúdo XML com um parceiro comercial em uma integração B2B (entre empresas), geralmente você deve codificar o conteúdo antes de enviá-lo. Ao receber conteúdo XML codificado, você deve decodificar esse conteúdo antes de usá-lo.

Este guia mostra como codificar e decodificar XML em seus fluxos de trabalho usando as ações do conector interno Flat File e um esquema de Flat File.

Referência técnica do conector

As ações de codificação e decodificação de Arquivo simples estão disponíveis para fluxos de trabalho de aplicativo lógico de Consumo e Padrão.

Aplicativo lógico Ambiente
Consumo Aplicativos Lógicos do Azure multilocatários
Standard Aplicativos Lógicos do Azure de locatário único, Ambiente do Serviço de Aplicativo v3 (somente planos do Windows) e implantação híbrida

Para obter mais informações, consulte conectores integrados da conta de integração.

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 onde você deseja usar as operações Flat File.

    As operações de Arquivo Simples não incluem gatilhos. Seu fluxo de trabalho pode começar com qualquer gatilho ou usar qualquer ação para trazer o XML de origem.

    Os exemplos neste artigo usam o gatilho de solicitação chamado Quando uma solicitação HTTP é recebida.

    Para obter mais informações, consulte:

  • Um recurso de conta de integração para definir e armazenar artefatos para integração empresarial e fluxos de trabalho B2B.

    • 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.

    • Antes de começar a trabalhar com as operações de Arquivo Simples, você deve vincular seu aplicativo lógico de Consumo ou Padrão à conta de integração para trabalhar com artefatos, como parceiros comerciais e acordos. Você pode vincular uma conta de integração a vários recursos do aplicativo lógico de Consumo ou Padrão para compartilhar os mesmos artefatos.

    Dica

    Se você não estiver trabalhando com artefatos B2B, como parceiros comerciais e contratos em fluxos de trabalho Standard, talvez não precise de uma conta de integração. Em vez disso, você pode carregar esquemas diretamente no recurso de aplicativo lógico Standard. É possível usar o mesmo esquema em todos os fluxos de trabalho secundários no mesmo recurso de aplicativo lógico. Para usar o mesmo esquema em vários recursos de aplicativo lógico, você deve usar e vincular uma conta de integração.

  • Um esquema de arquivo simples que especifica como codificar ou decodificar conteúdo XML.

    Em fluxos de trabalho Padrão, as operações de Arquivo Simples permitem selecionar um esquema de uma conta de integração vinculada ou que foi carregado anteriormente no aplicativo lógico, mas não ambos.

    Para obter mais informações, consulte Adicionar esquemas a contas de integração.

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

    Atenção

    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.

Limitações

  • O conteúdo XML que você deseja decodificar precisa ser codificado no formato UTF-8.

  • No esquema de arquivo simples, os grupos XML contidos não devem ter números excessivos da propriedade max count definidos com um valor maior que 1. Evite aninhar um grupo XML com um valor de propriedade max count maior que 1 dentro de outro grupo XML com uma propriedade max count maior que 1.

  • Quando os Aplicativos Lógicos do Azure analisam o esquema de arquivo simples e quando o esquema permite a escolha do próximo fragmento, os Aplicativos Lógicos do Azure geram um símbolo e uma previsão para esse fragmento. Se o esquema permitir muitos constructos, por exemplo, mais de 100.000, a expansão do esquema se tornará muito grande, o que consome muito tempo e recursos.

Carregar esquema

Depois de criar seu esquema, carregue o esquema com base no fluxo de trabalho:

Adicionar uma ação de codificação de arquivo simples

  1. Abra o recurso de aplicativo lógico no portal do Azure.

  2. Na ferramenta designer, abra o fluxo de trabalho.

    Se o fluxo de trabalho não tiver um gatilho ou outras ações necessárias, adicione essas operações primeiro.

    Este exemplo usa o gatilho de solicitação chamado Quando uma solicitação HTTP é recebida. Para adicionar um gatilho, consulte Adicionar um gatilho para iniciar seu fluxo de trabalho.

  3. No designer, siga estas etapas gerais para adicionar a ação interna chamada Codificação de Arquivo Simples.

    O painel de informações de ação é aberto com a guia Parâmetros selecionada.

  4. No parâmetro Conteúdo da ação, forneça o conteúdo XML para codificar, que é a saída do gatilho ou de uma ação anterior, seguindo estas etapas:

    1. Selecione dentro da caixa Conteúdo e, em seguida, selecione o ícone relâmpago para abrir a lista de conteúdo dinâmico.

    2. Na lista de conteúdo dinâmico, selecione o conteúdo XML a ser codificado.

    O exemplo a seguir mostra a lista de conteúdo dinâmico aberto, a saída do gatilho Quando uma solicitação HTTP é recebida e o conteúdo do Corpo selecionado da saída do gatilho.

    A captura de tela mostra o portal do Azure, o designer de fluxo de trabalho, a ação de Codificação de Arquivo Simples e o parâmetro Conteúdo com a lista de conteúdo dinâmico e o conteúdo selecionado para codificação.

    Observação

    Se Body não aparecer na lista de conteúdo dinâmico, ao lado do rótulo Quando uma solicitação HTTP é recebida, selecione Mostrar mais. Você também pode inserir diretamente o conteúdo para codificação na caixa Conteúdo.

  5. Na lista Nome do esquema, selecione o esquema.

    A captura de tela mostra o designer e a lista de Nomes de Esquema abertos com o esquema selecionado para codificação.

    Observação

    Se a lista de esquemas estiver vazia, a causa poderá ser:

    • O recurso de aplicativo lógico não está vinculado a uma conta de integração.
    • A conta de integração vinculada não contém nenhum arquivo de esquema.
    • O recurso de aplicativo lógico não contém nenhum arquivo de esquema. Esse motivo se aplica apenas aos aplicativos lógicos Standard.

  6. Para adicionar outros parâmetros opcionais à ação, selecione esses parâmetros na lista de parâmetros Avançados .

    Parâmetro Valor Descrição
    Modo de geração de nó vazio ForcedDisabled ou HonorSchemaNodeProperty ou ForcedEnabled O modo a ser usado para geração de nós vazios com a codificação de arquivo simples.

    Para BizTalk, o esquema de arquivo simples tem uma propriedade que controla a geração de nós vazios. Você pode seguir o comportamento da propriedade de geração de nós vazios para o esquema de arquivos simples. Como alternativa, você pode usar essa configuração para que os Aplicativos Lógicos do Azure gerem ou omita nós vazios. Para obter mais informações, confira Marcas para elementos vazios.
    Normalização de XML Sim ou Não A configuração para habilitar ou desabilitar a normalização de XML na codificação de arquivo simples. Para obter mais informações, confira XmlTextReader.Normalization.

  7. Salve seu fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

Adicionar uma ação de decodificação de arquivo simples

  1. Abra o recurso de aplicativo lógico no portal do Azure.

  2. Abra o fluxo de trabalho no designer.

    Se o fluxo de trabalho não tiver um gatilho ou outras ações necessárias, adicione essas operações primeiro.

    Este exemplo usa o gatilho de solicitação chamado Quando uma solicitação HTTP é recebida. Para adicionar um gatilho, consulte Adicionar um gatilho para iniciar seu fluxo de trabalho.

  3. No designer, siga estas etapas gerais para adicionar a ação interna chamada Decodificação de Arquivo Simples.

  4. No parâmetro Conteúdo da ação, forneça o conteúdo XML a ser decodificado, como saída do gatilho ou de uma ação anterior seguindo estas etapas:

    1. Selecione dentro da caixa Conteúdo e, em seguida, selecione o ícone relâmpago para abrir a lista de conteúdo dinâmico.

    2. Na lista de conteúdo dinâmico, selecione o conteúdo XML a ser decodificado.

    O exemplo a seguir mostra a lista de conteúdo dinâmico aberto, a saída do gatilho Quando uma solicitação HTTP é recebida e o conteúdo do Corpo selecionado da saída do gatilho.

    A captura de tela mostra o portal do Azure, o designer de fluxo de trabalho, a ação de Decodificação de Arquivo Simples e o parâmetro Conteúdo com a lista de conteúdo dinâmico e o conteúdo selecionado para decodificação.

    Observação

    Se você não vir Corpo na lista de conteúdo dinâmico, selecione Ver mais ao lado do rótulo da seção Quando uma solicitação HTTP é recebida. Você também pode inserir diretamente o conteúdo para decodificação na caixa Conteúdo.

  5. Na lista Nome do esquema, selecione o esquema.

    A captura de tela mostra o designer e a lista de nomes de esquema aberta com o esquema selecionado para decodificação.

    Observação

    Se a lista de esquemas estiver vazia, a causa poderá ser:

    • O recurso de aplicativo lógico não está vinculado a uma conta de integração.
    • A conta de integração vinculada não contém nenhum arquivo de esquema.
    • O recurso de aplicativo lógico não contém nenhum arquivo de esquema. Esse motivo se aplica apenas aos aplicativos lógicos Standard.

  6. Salve seu fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

Agora, você concluiu a configuração de sua ação de decodificação de arquivo simples. Em um aplicativo real, convém armazenar os dados decodificados em um aplicativo LOB (linha de negócios), como o Salesforce. Ou, você pode enviar os dados decodificados para um parceiro comercial. Para enviar a saída da ação de decodificação para o Salesforce ou para seu parceiro comercial, use os outros conectores disponíveis nos Aplicativos Lógicos do Azure:

Testar seu fluxo de trabalho

Para disparar seu fluxo de trabalho, siga estas etapas:

  1. No disparador Solicitação, encontre o parâmetro URL de HTTP POST e copie a URL.

  2. Abra sua ferramenta de solicitação HTTP e use suas instruções para enviar uma solicitação HTTP para a URL copiada, incluindo o método esperado pelo gatilho de Solicitação.

    Esse exemplo usa o método POST com o URL.

  3. Inclua o conteúdo XML que você quer codificar ou decodificar no corpo da solicitação.

  4. Depois que o fluxo de trabalho terminar de ser executado, vá para o histórico de execução do fluxo de trabalho e examine as entradas e saídas da ação Flat File.

Conteúdo relacionado

  • Last updated on