Compartilhar via


Codificar e decodificar arquivos simples nos Aplicativos Lógicos do Azure

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Standard)

Antes de enviar conteúdo XML para um parceiro de negócios em um cenário B2B (entre empresas), talvez você queira codificar esse conteúdo primeiro. Se você receber um conteúdo XML codificado, precisará decodificá-lo primeiro. Ao criar um fluxo de trabalho de aplicativo lógico nos Aplicativos Lógicos do Azure, é possível codificar e decodificar arquivos simples usando as ações do conector interno de Arquivo simples e um esquema de arquivo simples para codificação e decodificação. Você pode usar ações de Arquivo Simples em fluxos de trabalho de aplicativo lógico de Consumo multilocatário e fluxos de trabalho de aplicativo lógico Standard de locatário único.

Embora nenhum gatilho de Arquivo simples esteja disponível, é possível usar qualquer gatilho ou ação para alimentar o conteúdo XML de origem no fluxo de trabalho. Por exemplo, é possível usar um gatilho de conector interno, um gatilho de conector gerenciado ou hospedado no Azure disponível para Aplicativos Lógicos do Azure ou até mesmo outro aplicativo.

Este artigo mostra como adicionar as ações de codificação e decodificação de Arquivo simples ao fluxo de trabalho.

  • Adicione uma ação de codificação ou decodificação de Arquivo simples ao fluxo de trabalho.
  • Selecione o esquema que você deseja usar.

Para mais informações, consulte a seguinte documentação:

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 de Arquivo Simples.

    Se você tiver um fluxo de trabalho em branco, use qualquer gatilho que quiser para iniciar o fluxo de trabalho. Este exemplo usa o gatilho Solicitação.

  • Seu recurso de aplicativo lógico e seu fluxo de trabalho. As operações de arquivo simples não têm gatilhos disponíveis, portanto, o fluxo de trabalho precisa incluir um gatilho no mínimo. Para saber mais, confira a seguinte documentação:

  • Um esquema de arquivo simples para codificar e decodificar o conteúdo XML. Para saber mais, confira Adicionar esquemas para usar com fluxos de trabalho nos Aplicativos Lógicos do Azure.

  • Ao trabalhar com o fluxo de trabalho de aplicativo lógico de consumo ou padrão, você precisará de um recurso de conta de integração. Normalmente, esse recurso é necessário ao definir e armazenar artefatos para uso na integração corporativa e nos fluxos de trabalho de B2B.

    Importante

    Para trabalhar em conjunto, a conta de integração e o recurso de aplicativo lógico devem existir na mesma assinatura e região do Azure.

    • Se você estiver trabalhando em um fluxo de trabalho de aplicativo lógico de consumo, o recurso de aplicativo lógico precisará de um link para sua conta de integração.

    • Se você estiver trabalhando em um fluxo de trabalho de aplicativo lógico padrão, será possível vincular o recurso de aplicativo lógico à conta de integração, carregar esquemas diretamente nele ou ambos, com base nos seguintes cenários:

      • Se você já tiver uma conta de integração com os artefatos necessários ou desejados, será possível vincular essa conta a diversos recursos de aplicativo lógico padrão para uso dos artefatos. Dessa forma, não é necessário carregar esquemas para cada aplicativo lógico individual. Para obter mais informações, examine Vincular o recurso do aplicativo lógico à conta de integração.

      • O conector interno de Arquivo simples permite selecionar um esquema carregado anteriormente no recurso de aplicativo lógico ou em uma conta de integração vinculada, mas não em ambos. É possível usar esse artefato em todos os fluxos de trabalho filho no mesmo recurso de aplicativo lógico.

      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.

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 sempre que o esquema permite a escolha do próximo fragmento), eles geram um símbolo e uma previsão para o fragmento. Se o esquema permitir muitas dessas construções, por exemplo, mais de 100.000, a expansão do esquema se tornará excessivamente grande, o que consome muitos recursos e tempo.

Carregar esquema

Depois de criar o esquema, você deve carregá-lo com base no seguinte cenário:

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

  1. No portal do Azure, abra o fluxo de trabalho de aplicativo lógico no designer, se ele ainda não estiver aberto.

  2. Se o fluxo de trabalho não tiver um gatilho ou outras ações necessárias, adicione essas operações primeiro. As operações de arquivo simples não têm gatilhos disponíveis.

    Este exemplo continua com o gatilho de solicitação chamado Quando uma solicitação HTTP for recebida.

  3. No designer de fluxo de trabalho, na etapa de adição da ação de arquivo simples, selecione Nova etapa.

  4. Na caixa de pesquisa Escolher uma operação, selecione Interno. Na caixa de pesquisa, insira arquivo simples.

  5. Na lista de ações, selecione a ação chamada Codificação de Arquivo Simples.

    Captura de tela mostrando o portal do Azure e o designer de fluxo de trabalho de consumo com

  6. Na propriedade Conteúdo da ação, forneça a saída do gatilho ou uma ação anterior a ser codificada seguindo estas etapas:

    1. Clique dentro da caixa Conteúdo para que seja exibida a lista de conteúdo dinâmica.

    2. Na lista de conteúdo dinâmico, selecione o conteúdo do arquivo simples que você deseja codificar.

      Neste exemplo, na lista de conteúdo dinâmico, em Quando uma solicitação HTTP é recebida, selecione o token Corpo, que representa a saída do conteúdo do corpo do gatilho.

    Captura de tela mostrando o designer de fluxo de trabalho de consumo e a propriedade

    Observação

    Se você não vir a propriedade 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 codificação na caixa Conteúdo.

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

    Captura de tela mostrando o designer de fluxo de trabalho de consumo e a lista

    Observação

    Quando a lista de esquemas está vazia, isso significa que o recurso de aplicativo lógico não está vinculado à conta de integração ou que ela não contém um arquivo de esquema.

    Ao final, sua ação será semelhante ao seguinte:

    Captura de tela mostrando o fluxo de trabalho de consumo com a ação

  8. Para adicionar parâmetros opcionais à ação, selecione-os na lista Adicionar parâmetro.

    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 arquivo simples ou usar essa configuração para que os Aplicativos Lógicos do Azure gerem ou omitam os 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.
  9. Salve seu fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

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

  1. No portal do Azure, abra o fluxo de trabalho de aplicativo lógico no designer, se ele ainda não estiver aberto.

  2. Se o fluxo de trabalho não tiver um gatilho ou outras ações necessárias, adicione essas operações primeiro. As operações de arquivo simples não têm gatilhos disponíveis.

    Este exemplo continua com o gatilho de solicitação chamado Quando uma solicitação HTTP for recebida.

  3. No designer de fluxo de trabalho, na etapa de adição da ação de arquivo simples, selecione Nova etapa.

  4. Na caixa de pesquisa Escolher uma operação, selecione Interno. Na caixa de pesquisa, insira arquivo simples.

  5. Na lista de ações, selecione a ação chamada Decodificação de Arquivo Simples.

    Captura de tela mostrando o portal do Azure e o designer de fluxo de trabalho de consumo com

  6. Na propriedade Conteúdo da ação, forneça a saída do gatilho ou uma ação anterior a ser codificada seguindo estas etapas:

    1. Clique dentro da caixa Conteúdo para que seja exibida a lista de conteúdo dinâmica.

    2. Na lista de conteúdo dinâmico, selecione o conteúdo do arquivo simples que você deseja codificar.

      Neste exemplo, na lista de conteúdo dinâmico, em Quando uma solicitação HTTP é recebida, selecione o token Corpo, que representa a saída do conteúdo do corpo do gatilho.

    Captura de tela mostrando o designer de fluxo de trabalho de consumo e a propriedade

    Observação

    Se você não vir a propriedade 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 codificação na caixa Conteúdo.

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

    Captura de tela mostrando o designer de fluxo de trabalho de consumo e a lista

    Observação

    Quando a lista de esquemas está vazia, isso significa que o recurso de aplicativo lógico não está vinculado à conta de integração ou que ela não contém um arquivo de esquema.

    Ao final, sua ação será semelhante ao seguinte:

    Captura de tela mostrando o fluxo de trabalho de consumo com a ação

  8. 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 gatilho de Solicitação, localize a propriedade URL 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.

    Este exemplo usa o método POST com a URL.

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

  4. Ao final da execução do fluxo de trabalho, acesse o histórico de execução dele e examine as entradas e saídas da ação de arquivo simples.

Próximas etapas