Share via

Criar parâmetros entre ambientes para entradas de fluxo de trabalho no Azure Logic Apps

  • Artigo

Aplica-se a: Azure Logic Apps (Consumo + Standard)

No Azure Logic Apps, pode abstrair valores que podem ser alterados nos fluxos de trabalho em ambientes de desenvolvimento, teste e produção ao definir parâmetros. Quando utiliza parâmetros em vez de variáveis específicas do ambiente, pode inicialmente concentrar-se mais na conceção dos fluxos de trabalho e inserir as variáveis específicas do ambiente mais tarde.

Este artigo apresenta como criar, utilizar e editar parâmetros para fluxos de trabalho de aplicações lógicas de Consumo multi-inquilino e para fluxos de trabalho da aplicação lógica Standard de inquilino único. Também irá aprender a gerir variáveis de ambiente.

Para obter mais informações sobre o Azure Logic Apps multi-inquilino e de inquilino único, veja Ambiente de serviço de inquilino único versus multi-inquilino e de serviço de integração para o Azure Logic Apps.

Pré-requisitos

Parâmetros para consumo versus fluxos de trabalho de aplicações lógicas Standard

Para fluxos de trabalho de aplicações lógicas De Consumo e Standard, pode definir parâmetros com o estruturador. Depois de definir o parâmetro, pode referenciar esse parâmetro a partir de qualquer fluxo de trabalho ou ligação que esteja no mesmo recurso da aplicação lógica.

Nos fluxos de trabalho da aplicação lógica consumo multi-inquilino, depois de criar e utilizar parâmetros no estruturador, define e define as variáveis de ambiente no modelo do Azure Resource Manager (modelo arm) e ficheiros de parâmetros de modelo. Neste cenário, tem de definir e definir os parâmetros na implementação, o que significa que, mesmo que só tenha de alterar uma variável, tem de reimplementar o modelo arm da sua aplicação lógica.

Nos fluxos de trabalho da aplicação lógica Standard de inquilino único, pode trabalhar com variáveis de ambiente no runtime e na implementação através de parâmetros e definições da aplicação. As definições da aplicação contêm opções de configuração global para todos os fluxos de trabalho no mesmo recurso da aplicação lógica. Para obter mais informações, veja Editar definições do anfitrião e da aplicação para aplicações lógicas baseadas em inquilino único.

Nota

Nos fluxos de trabalho da aplicação lógica Standard, os tipos de dados seguros, como securestring e secureobject, não são suportados. No entanto, como opção alternativa, pode utilizar as definições da aplicação com o Azure Key Vault. Em seguida, pode referenciar diretamente cadeias de carateres seguras, como cadeias de ligação e chaves. Semelhante aos modelos do ARM, onde pode definir variáveis de ambiente no momento da implementação, pode definir as definições da aplicação na definição do fluxo de trabalho da aplicação lógica. Em seguida, pode capturar valores de infraestrutura gerados dinamicamente, como pontos finais de ligação, cadeias de armazenamento e muito mais.

No entanto, as definições da aplicação têm limites de tamanho e não podem ser referenciadas a partir de determinadas áreas no Azure Logic Apps. Os parâmetros oferecem uma maior variedade de casos de utilização do que as definições da aplicação, como suporte para tamanhos de valores grandes e objetos complexos.

Por exemplo, se utilizar o Visual Studio Code como a sua ferramenta de desenvolvimento local para executar fluxos de trabalho localmente, no seu projeto de aplicação lógica, pode definir parâmetros com o ficheiro parameters.json . Em seguida, pode referenciar qualquer parâmetro neste ficheiro de parâmetros a partir de qualquer fluxo de trabalho no ficheiro workflow.json do projeto ou a partir de qualquer objeto de ligação no ficheiro connections.json do projeto. A lista seguinte descreve alguns casos de utilização comuns:

  • Tenha um ficheiro de parâmetros de teste que inclua todos os valores que utiliza durante os testes. Na implementação, pode substituir o ficheiro de parâmetros de teste pelo ficheiro de parâmetros de produção.

  • Parametrize diferentes partes do ficheiro connections.json . Em seguida, pode verificar o seu ficheiro connections.json no controlo de origem e, em seguida, gerir quaisquer ligações através do ficheiro parameters.json .

  • Parametrize objetos complexos, como o authentication objeto JSON. Por exemplo, pode substituir o valor do authentication objeto por uma cadeia que contém uma única expressão de parâmetros, como @parameters('api-auth').

  • Reveja e edite as definições da aplicação no ficheiro local.settings.json do seu projeto. Em seguida, pode referenciar estas definições de aplicação nos parâmetros.

Nota

Como recomendação geral, considere a utilização de parâmetros como a forma predefinida de parametrizar valores e não as definições da aplicação. Dessa forma, quando precisar de armazenar chaves ou cadeias seguras, pode seguir a recomendação para referenciar as definições da aplicação a partir dos seus parâmetros. Se quiser, pode utilizar ambas as opções na sua solução ao utilizar parâmetros para referenciar as definições da aplicação.

Definir, utilizar e editar parâmetros

Portal do Azure

  1. Na portal do Azure, abra o fluxo de trabalho da aplicação lógica. Em Fluxos de trabalho, selecione e abra o fluxo de trabalho no estruturador.

  2. Na barra de ferramentas do estruturador, selecione Parâmetros.

    Captura de ecrã a mostrar portal do Azure, estruturador para Fluxo de trabalho de consumo e

  3. No painel Parâmetros , selecione Adicionar parâmetro.

  4. Forneça as seguintes informações sobre o parâmetro a criar:

    Propriedade Necessário Descrição
    Nome Sim O nome do parâmetro a criar.
    Tipo Yes O tipo de dados para o parâmetro, como Matriz, Bool, Flutuante, Int, Objeto, Objeto Seguro, Cadeia Segura e Cadeia.
    Valor Predefinido Yes O valor predefinido para o parâmetro . Tem de especificar o valor do parâmetro predefinido porque a lógica do fluxo de trabalho, as informações de ligação e os valores dos parâmetros não existem numa única localização. O estruturador tem de conseguir resolver os valores dos parâmetros antes de carregar.

    Importante: para os tipos de dados Objeto Seguro e Cadeia segura , evite definir um valor predefinido porque o valor é armazenado como texto simples.
    Valor Real No O valor real do parâmetro .

    O exemplo seguinte mostra uma definição para um parâmetro de cadeia:

    Captura de ecrã a mostrar portal do Azure, estruturador para Fluxo de trabalho de consumo e o painel

  5. Se tiver mais parâmetros para adicionar, selecione Adicionar Parâmetro. Caso contrário, feche o painel de parâmetros, mas certifique-se de que guarda o fluxo de trabalho para guardar a nova definição de parâmetro.

  6. Para referenciar o parâmetro a partir de um acionador ou ação que está no mesmo fluxo de trabalho, siga estes passos:

    1. No estruturador, abra o fluxo de trabalho pretendido e expanda o acionador ou ação.

    2. Na propriedade onde pretende utilizar o parâmetro, clique no interior da caixa de edição dessa propriedade.

    3. Na lista de conteúdos dinâmicos que é aberta, em Parâmetros, selecione o parâmetro criado anteriormente, por exemplo:

      Captura de ecrã a mostrar o estruturador do fluxo de trabalho consumo e a ação de exemplo com o cursor na caixa de edição de propriedades, a lista de conteúdos dinâmicos expandida e o parâmetro criado anteriormente selecionado.

  7. Para ver ou editar os parâmetros num fluxo de trabalho de aplicação lógica, siga estes passos:

    1. Abra o fluxo de trabalho da aplicação lógica no estruturador. Na barra de ferramentas do estruturador, selecione Parâmetros.

      O painel Parâmetros é aberto e apresenta todos os parâmetros que definiu para esse fluxo de trabalho.

    2. Faça as suas edições, feche o painel de parâmetros e guarde o fluxo de trabalho da aplicação lógica.

Passos seguintes