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:

• Aplicativos lógicos de consumo versus padrão
• Conectores internos da conta de integração
• Visão geral dos conectores internos dos Aplicativos Lógicos do Azure
• Conectores gerenciados ou hospedados no Azure em Aplicativos Lógicos do Azure

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:

  • Criar um exemplo de fluxo de trabalho de aplicativo lógico de Consumo em Aplicativos Lógicos do Azure multilocatário

  • Criar um exemplo de fluxo de trabalho de aplicativo lógico Standard nos Aplicativos Lógicos do Azure de locatário único

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

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

  • Visual Studio Code com uma extensão do Visual Studio Marketplace
  • Invoke-RestMethod do PowerShell
  • Microsoft Edge – ferramenta Console de Rede
  • Bruno
  • curl

  Cuidado

  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, funcione offline ou localmente, não sincronize seus dados com a nuvem e não exija que você entre em uma conta online. Dessa forma, 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 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:

• Se você estiver trabalhando em um fluxo de trabalho de aplicativo lógico de consumo, adicione o esquema à conta de integração.

• Se você estiver trabalhando em um fluxo de trabalho de aplicativo lógico padrão, adicione o esquema à conta de integração ou adicione o esquema ao recurso de aplicativo lógico.

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

Consumo

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.

   

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.

   

   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.

   

   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:

   

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.

Standard

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, na etapa de adição da ação de arquivo simples, selecione o sinal de mais (+) e, em seguida, Adicionar ação.

4. No painel Adicionar ação que aparece, na caixa de pesquisa, selecione Interno.

5. Na caixa de pesquisa, insira arquivo simples. Na lista de ações, selecione a ação chamada Codificação de Arquivo Simples.

   

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.

   

7. Na lista Fonte, selecione LogicApp ou IntegrationAccount como o esquema de origem.

   Este exemplo continua selecionando IntegrationAccount.

   

8. Na lista Nome, selecione o esquema que você carregou anteriormente em seu recurso de aplicativo lógico para codificação, por exemplo:

   

   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, que ela não contém um arquivo de esquema ou que o recurso de aplicativo lógico não contém um arquivo de esquema.

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

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

Consumo

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.

   

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.

   

   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.

   

   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:

   

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

Standard

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, na etapa de adição da ação de arquivo simples, selecione o sinal de mais (+) e, em seguida, Adicionar ação.

4. No painel Adicionar ação que aparece, na caixa de pesquisa, selecione Interno.

5. Na caixa de pesquisa, insira arquivo simples. Na lista de ações, selecione a ação chamada Decodificação de Arquivo Simples.

   

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.

   

7. Na lista Fonte, selecione LogicApp ou IntegrationAccount como o esquema de origem.

   Este exemplo continua selecionando IntegrationAccount.

   

8. Na lista Nome, selecione o esquema que você carregou anteriormente em seu recurso de aplicativo lógico para decodificação, por exemplo:

   

   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, que ela não contém um arquivo de esquema ou que o recurso de aplicativo lógico não contém um arquivo de esquema.

9. 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:

• Conectores gerenciados dos Aplicativos Lógicos do Azure
• Conectores internos de 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

• Saiba mais sobre o Enterprise Integration Pack