Compartilhar via


Use a atividade Until para controlar o fluxo de execução

A atividade Until fornece a mesma funcionalidade que uma estrutura de loop do-until fornece em linguagens de programação. Ela executa um conjunto de atividades em um loop até que a condição associada à atividade seja avaliada como verdadeira. Se uma atividade interna falhar, a atividade Until não será interrompida. Você pode especificar um valor de tempo limite para a atividade Until.

Pré-requisitos

Para começar, você deve concluir os seguintes pré-requisitos:

Adicionar uma atividade Until a um pipeline com a interface do usuário

Para usar uma atividade Until em um pipeline, conclua estas etapas:

Criar a atividade

  1. Crie um pipeline no seu workspace.

  2. Procure Until no painel Atividades do pipeline e selecione-o para adicioná-lo à tela do pipeline.

    Screenshot of the Fabric UI with the Activities pane and Until activity highlighted.

  3. Selecione a nova atividade Until na tela se ela ainda não estiver selecionada.

    Screenshot showing the General settings tab of the Until activity.

Consulte as diretrizes de Configurações Geraispara definir a guia Configurações Gerais.

Adicionar uma variável de pipeline

Neste exemplo simples, testamos o valor de uma variável de pipeline. Selecione a tela de fundo da tela do editor de pipeline e selecione a guia Variáveis e adicione uma nova variável de tipo inteiro chamada TestVariable com o valor 0.

Screenshot showing the pipeline Variables tab with a variable added called TestVariable, having its value set to 0.

Configurações de atividade Until

  1. Selecione a atividade Until novamente na tela do pipeline e, em seguida, selecione a guia Configurações. Selecione o campo Expressão e selecione Adicionar de conteúdo dinâmico e forneça a seguinte expressão: @equals(variables('TestVariable'), 1).

    Screenshot showing the expression for the Until activity.

  2. Selecione a guia Atividades e selecione o ícone de lápis para editar/adicionar atividades à atividade Until ou selecione o ícone + na atividade Until na tela do editor de pipeline. Localize a atividade Definir variável e selecione-a para adicioná-la à lista de atividades secundárias da atividade Until (Até).

    Screenshot showing the addition of the Set Variable activity to the Until activity's child activity list.

  3. Selecione a atividade Definir variável recém-adicionada de onde ela aparece no painel Atividades da atividade Until na tela do editor de pipeline e, em seguida, selecione a guia Configurações no painel de propriedades da atividade. Para tipo variável, selecione variável pipeline e escolha o TestVariable criado anteriormente na lista suspensa. Para este exemplo, forneça um Valor de 1.

    Screenshot showing the settings of the Set Variable child activity of the Until activity.

Salvar e executar ou agendar o pipeline

Alterne para a guia Página Inicial na parte superior do editor de pipeline e selecione o botão Salvar para salvar o pipeline. Selecione Executar para executá-lo diretamente ou Agendar para agendá-lo. Você também pode exibir o histórico de execuções aqui ou definir outras configurações. Esse pipeline simples executará a atividade filho da atividade Until exatamente 1 vez, alterando o valor da variável de pipeline de 0 para 1, após o qual a expressão Until será avaliada como true e terminate.

Screenshot showing the Home tab in the pipeline editor with the tab name, Save, Run, and Schedule buttons highlighted.