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

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

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