Codifique e decodifice arquivos simples nos Aplicativos Lógicos do Azure

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

Antes de enviar conteúdo XML para um parceiro de negócios em um cenário B2B (business-to-business), convém codificar esse conteúdo primeiro. Se você receber conteúdo XML codificado, precisará decodificar esse conteúdo primeiro. Ao criar um fluxo de trabalho de aplicativo lógico nos Aplicativos Lógicos do Azure, você pode codificar e decodificar arquivos simples usando as ações internas do conector 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 padrão de locatário único.

Embora nenhum gatilho de arquivo simples esteja disponível, você pode usar qualquer gatilho ou ação para alimentar o conteúdo XML de origem em seu fluxo de trabalho. Por exemplo, você pode 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 seu fluxo de trabalho.

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

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

• Consumo versus aplicativos lógicos padrão
• Conta de integração built-in conectores
• Visão geral dos conectores internos para os Aplicativos Lógicos do Azure
• Conectores gerenciados ou hospedados no Azure nos Aplicativos Lógicos do Azure

Pré-requisitos

• Uma conta e subscrição do Azure. Se ainda não tiver uma subscrição, inscreva-se numa conta gratuita do Azure.

• O fluxo de trabalho do aplicativo lógico, em branco ou existente, onde você deseja usar a ação Arquivo Simples.

  Se você tiver um fluxo de trabalho em branco, use qualquer gatilho que você deseja iniciar o fluxo de trabalho. Este exemplo usa o gatilho Request .

• Seu recurso e fluxo de trabalho do aplicativo lógico. As operações de arquivo simples não têm nenhum gatilho disponível, portanto, seu fluxo de trabalho precisa incluir minimamente um gatilho. Para obter mais informações, veja a seguinte documentação:

  • Criar um exemplo de fluxo de trabalho do aplicativo lógico de consumo em aplicativos lógicos do Azure multilocatários

  • Criar um exemplo de fluxo de trabalho de aplicativo lógico padrão em Aplicativos Lógicos do Azure de locatário único

• Um esquema de arquivo simples para codificar e decodificar o conteúdo XML. Para obter mais informações, Adicione esquemas para usar com fluxos de trabalho nos Aplicativos Lógicos do Azure.

• Com base no fato de você estar trabalhando em um fluxo de trabalho de aplicativo lógico Consumo ou Padrão, você precisará de um recurso de conta de integração. Normalmente, você precisa desse recurso quando deseja definir e armazenar artefatos para uso em integração empresarial e fluxos de trabalho B2B.

  Importante

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

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

  • Se você estiver trabalhando em um fluxo de trabalho de aplicativo lógico padrão, poderá vincular o recurso do aplicativo lógico à sua conta de integração, carregar esquemas diretamente para o recurso do 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, poderá vincular sua conta de integração a vários recursos do aplicativo lógico padrão onde deseja usar os artefatos. Dessa forma, você não precisa carregar esquemas para cada aplicativo lógico individual. Para obter mais informações, consulte Vincular seu recurso de aplicativo lógico à sua conta de integração.

    • O conector interno de arquivo simples permite selecionar um esquema que você carregou anteriormente para o recurso do aplicativo lógico ou para uma conta de integração vinculada, mas não ambos. Em seguida, você pode usar esse artefato em todos os fluxos de trabalho filho dentro do mesmo recurso de aplicativo lógico.

    Então, se você não tem ou precisa de uma conta de integração, você pode usar a opção de upload. Caso contrário, você pode usar a opção de vinculação. De qualquer forma, você pode usar esses artefatos em todos os fluxos de trabalho filho dentro do mesmo recurso de aplicativo lógico.

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

  • Código do Visual Studio com uma extensão do Visual Studio Marketplace
  • PowerShell Invoke-RestMethod
  • Microsoft Edge - Ferramenta Network Console
  • Adriano
  • ondulação

  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, certifique-se de usar 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 exposição de dados confidenciais ao público.

Limitações

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

• No esquema de arquivo simples, verifique se os grupos XML contidos não têm números excessivos da max count propriedade definidos como um valor maior que 1. Evite aninhar um grupo XML com um max count valor de propriedade maior que 1 dentro de outro grupo XML com uma max count propriedade 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, os Aplicativos Lógicos do Azure geram um símbolo e uma previsão para esse fragmento. Se o esquema permitir muitas dessas construções, por exemplo, mais de 100.000, a expansão do esquema se torna excessivamente grande, o que consome muitos recursos e tempo.

Carregar esquema

Depois de criar o esquema, agora você precisa carregar o esquema com base no seguinte cenário:

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

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

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

Consumo

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

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

   Este exemplo continua com o gatilho Request chamado When a HTTP request is received.

3. No designer de fluxo de trabalho, na etapa em que você deseja adicionar a ação Arquivo Simples, selecione Nova etapa.

4. Na caixa Escolha uma pesquisa de operação, selecione Incorporado. Na caixa de pesquisa, digite arquivo simples.

5. Na lista de ações, selecione a ação chamada Codificação de arquivo simples.

   

6. Na propriedade Content da ação, forneça a saída do gatilho ou de uma ação anterior que você deseja codificar seguindo estas etapas:

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

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

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

   

   Nota

   Se a propriedade Body não aparecer 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 a ser codificado na caixa Conteúdo .

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

   

   Nota

   Se a lista de esquemas estiver vazia, o recurso do aplicativo lógico não estará vinculado à sua conta de integração ou a sua conta de integração não conterá nenhum arquivo de esquema.

   Quando terminar, a sua ação será semelhante à seguinte:

   

8. Para adicionar outros parâmetros opcionais à ação, selecione esses parâmetros na lista Adicionar novos parâmetros .

   Parâmetro	valor	Description
   Modo de geração de nó vazio	ForcedDisabled ou HonorSchemaNodeProperty ou ForcedEnabled	O modo a ser usado para geração de nó vazio com codificação de arquivo simples. Para o BizTalk, o esquema de arquivo simples tem uma propriedade que controla a geração de nó vazio. Você pode seguir o comportamento da propriedade de geração de nó vazio para seu esquema de arquivo simples ou pode usar essa configuração para que os Aplicativos Lógicos do Azure gerem ou omitam nós vazios. Para obter mais informações, consulte Tags para elementos vazios.
   Normalização XML	Sim ou Não	A configuração para habilitar ou desabilitar a normalização XML na codificação de arquivo simples. Para obter mais informações, consulte XmlTextReader.Normalization.

9. Salve seu fluxo de trabalho. Na barra de ferramentas do estruturador, selecione Guardar.

Standard

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

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

   Este exemplo continua com o gatilho Request chamado When a HTTP request is received.

3. No designer, na etapa em que você deseja adicionar a ação Arquivo Simples, selecione o sinal de adição (+) e, em seguida, selecione Adicionar uma ação.

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

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

   

6. Na propriedade Content da ação, forneça a saída do gatilho ou de uma ação anterior que você deseja codificar seguindo estas etapas:

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

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

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

   

7. Na lista Source , selecione LogicApp ou IntegrationAccount como sua fonte de esquema.

   Este exemplo continua selecionando IntegrationAccount.

   

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

   

   Nota

   Se a lista de esquemas estiver vazia, o recurso do aplicativo lógico não estará vinculado à sua conta de integração, a conta de integração não conterá nenhum arquivo de esquema ou o recurso do aplicativo lógico não conterá nenhum arquivo de esquema.

9. Salve seu fluxo de trabalho. Na barra de ferramentas do estruturador, selecione Guardar.

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

Consumo

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

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

   Este exemplo continua com o gatilho Request chamado When a HTTP request is received.

3. No designer de fluxo de trabalho, na etapa em que você deseja adicionar a ação Arquivo Simples, selecione Nova etapa.

4. Na caixa Escolha uma pesquisa de operação, selecione Incorporado. Na caixa de pesquisa, digite arquivo simples.

5. Na lista de ações, selecione a ação chamada Decodificação de arquivo simples.

   

6. Na propriedade Content da ação, forneça a saída do gatilho ou de uma ação anterior que você deseja decodificar seguindo estas etapas:

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

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

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

   

   Nota

   Se a propriedade Body não aparecer 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 a ser codificado na caixa Conteúdo .

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

   

   Nota

   Se a lista de esquemas estiver vazia, o recurso do aplicativo lógico não estará vinculado à sua conta de integração ou a sua conta de integração não conterá nenhum arquivo de esquema.

   Quando terminar, a sua ação será semelhante à seguinte:

   

8. Salve seu fluxo de trabalho. Na barra de ferramentas do estruturador, selecione Guardar.

Standard

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

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

   Este exemplo continua com o gatilho Request chamado When a HTTP request is received.

3. No designer, na etapa em que você deseja adicionar a ação Arquivo Simples, selecione o sinal de adição (+) e, em seguida, selecione Adicionar uma ação.

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

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

   

6. Na propriedade Content da ação, forneça a saída do gatilho ou de uma ação anterior que você deseja decodificar seguindo estas etapas:

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

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

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

   

7. Na lista Source , selecione LogicApp ou IntegrationAccount como sua fonte de esquema.

   Este exemplo continua selecionando IntegrationAccount.

   

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

   

   Nota

   Se a lista de esquemas estiver vazia, o recurso do aplicativo lógico não estará vinculado à sua conta de integração, a conta de integração não conterá nenhum arquivo de esquema ou o recurso do aplicativo lógico não conterá nenhum arquivo de esquema.

9. Salve seu fluxo de trabalho. Na barra de ferramentas do estruturador, selecione Guardar.

Agora você terminou de configurar sua ação de decodificação de arquivo simples. Em um aplicativo do mundo real, talvez você queira armazenar os dados decodificados em um aplicativo de linha de negócios (LOB), 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 para Aplicativos Lógicos do Azure
• Conectores internos para Aplicativos Lógicos do Azure

Testar o fluxo de trabalho

Para acionar seu fluxo de trabalho, siga estas etapas:

1. No gatilho Request , localize a propriedade HTTP POST URL 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 POST método com a URL.

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

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

Próximos passos

• Saiba mais sobre o Pacote de Integração Empresarial