Orchestrator

Looping

O conteúdo de toda a Central de Ajuda é traduzido automaticamente de inglês pelo Phrase Language AI.

Os loops podem ser implementados em um fluxo de trabalho para repetir um conjunto de tarefas com base em condições definidas.

Os loops são executados em sequência. Um máximo de 4 etapas podem ser executadas em paralelo.

A configuração de loop é acessada na guia Avançado de uma configuração de bloco ou clicando com o botão direito do mouse em um bloco e selecionando Editar loop.

As configurações de loop exigem uma lista de itens para operar:

  • Valores simples e únicos, que podem ser usados em parâmetros de tarefa como {{ @item }}.

  • Um. Objeto JSON onde cada elemento no objeto pode ser endereçado por sua chave, como {{ @item.key }}.

Acessando os resultados agregados de um loop

A saída de todas as iterações pode ser acessada como um arquivo . Matriz JSON quando um loop é concluído. A saída de cada iteração deve ser um arquivo . Arquivo JSON.

Há quatro tipos de loop que podem ser definidos e são selecionados no campo loop_with :

  • withSequence

  • withItems

  • withComplexItems

  • withParam

withSequence

O loop withSequence permite uma iteração sobre uma sequência de números ou a geração de um intervalo de valores em um fluxo de trabalho.

Ele pode ser usado para repetir um conjunto de etapas um número específico de vezes ou executar operações com base em um intervalo de valores.

Para criar um exemplo com loop Sequence , execute estas etapas:

  1. Selecione um bloco vazio e abra a configuração de loop .

  2. Clique em Editar loop.

    loop_with opções de configuração são apresentadas.

  3. No campo loop_with , selecione withSequence.

  4. Insira o número de iterações de loop no campo Contagem .

  5. Opcionalmente, insira um valor do qual o loop deve começar e/ou terminar com.

  6. Clique em Salvar loop.

  7. Na configuração Parâmetros , clique em Editar parâmetros.

    As opções de configuração são apresentadas.

  8. No campo Mensagem , insira {{ @item }} e clique em Salvar parâmetros.

    Esse valor será convertido em tempo de execução.

Por exemplo, se count for definido como 3 e o valor inicial for 2, os resultados desse loop serão:

  • lista de loop => ["2", "3", "4"]

  • {{ @item }} => 2 ou 3 ou 4, com base na iteração

withItems

O loop withItems permite a iteração em uma lista de itens.

Ele pode ser usado quando é necessário executar operações com base em uma lista de itens.

Para criar um exemplo com o loop Items , execute estas etapas:

  1. Selecione um bloco vazio e abra a configuração de loop .

  2. Clique em Editar loop.

    loop_with opções de configuração são apresentadas.

  3. No campo loop_with , selecione comItens

  4. Digite en no campo de variável e clique em +Item (outro campo de variável é criado).

  5. Digite de no segundo campo variável e crie um terceiro campo.

  6. Digite fr no terceiro campo variável e crie um quarto campo.

  7. Digite-nos no quarto campo variável.

  8. Clique em Salvar loop.

  9. Na configuração Parâmetros , clique em Editar parâmetros.

    As opções de configuração são apresentadas.

  10. No campo Mensagem , insira {{ @item }} e clique em Salvar parâmetros.

    Esse valor será convertido em tempo de execução.

Os resultados desse loop serão uma iteração sobre uma lista de códigos de idioma:

  • lista de loop => ["en", "de", "fr", "ua"]

  • {{ @item }} => en ou de .. ua

withComplexItems

O loop withComplexItems permite a iteração sobre uma lista de objetos.

Ele pode ser usado quando é necessário executar operações com base em uma lista de itens complexos.

Para criar um exemplo com loop ComplexItems , execute estas etapas:

  1. Selecione um bloco vazio e abra a configuração de loop .

  2. Clique em Editar loop.

    loop_with opções de configuração são apresentadas.

  3. No campo loop_with , selecione withComplexItems

  4. Clique em +Chave:valor para adicionar uma segunda chave.

  5. Para Objeto 1, insira o seguinte:

    • Chave: Value1

      • Chave (opcional): Nome

      • (opcional): Projeto 1

    • Chave: Value2

      • Chave (opcional): ID

      • (opcional): 11

  6. Clique em +Object para adicionar um segundo objeto e em +Key:value para uma segunda chave.

  7. Para Objeto 2, insira o seguinte:

    • Chave: Value1

      • Chave (opcional): Nome

      • (opcional): Projeto 2

    • Chave: Value2

      • Chave (opcional): ID

      • (opcional): 22

    Exemplo de configurações:

    Loop_withComplexItems.png
  8. Na configuração Parâmetros , clique em Editar parâmetros.

    As opções de configuração são apresentadas.

  9. No campo Mensagem , insira {{ @item.name }} e clique em Salvar parâmetros. Esse valor será convertido em tempo de execução.

Os resultados desse loop serão uma iteração sobre uma lista de projetos:

  • lista de loops =>

    [
      {
        "name": "Projeto 1",
        "id": 11
      },
      {
        "name": "Projeto 2",
        "id": 22
      }
    ]
  • {{ @item }} =>

    {
      "name": "Projeto 1",
      "id": 11
    }
  • {{ @item.name }} => Projeto 1

  • {{ @item.id }} => 11

withParam

O loop withParam permite a iteração sobre uma lista dinâmica que é saída de qualquer tarefa ou gatilho anterior.

Esse loop é usado apenas como referência no campo de parâmetro.

Exemplo:

Saídas da tarefa (Strings: Publicar uma versão):

{
  "created_at": "2015-01-28T09:52:53Z",
  "environments": ["development", "production"],
  "id": "abcd1234cdef1234abcd1234cdef1234",
  "locales": [
    {
      "code": "en-GB",
      "id": "abcd1234cdef1234abcd1234cdef1234",
      "name": "English"
    },
    {
      "id": "abcd5678cdef5678abcd5678cdef5678",
      "name": "Alemão",
      "code": "de_DE"
    }
  ],
  "platforms": ["android"],
  "project": {
    "created_at": "2015-01-28T09:52:53Z",
    "id": "abcd1234cdef1234abcd1234cdef1234",
    "main_format": "xml",
    "name": "Meu Projeto Android",
    "updated_at": "2015-01-28T09:52:53Z"
  },
  "updated_at": "2015-01-28T09:52:53Z",
  "versão": 1
}

Se as configurações de loop withParam estiverem definidas com {{ $.locales }}, então:

  • lista de loops =>

    [
      {
        "code": "en-GB",
        "id": "abcd1234cdef1234abcd1234cdef1234",
        "name": "English"
      },
      {
        "id": "abcd5678cdef5678abcd5678cdef5678",
        "name": "Alemão",
        "code": "de_DE"
      }
    ]
  • Primeiro {{ @item }} =>

    {
      "code": "en-GB",
      "id": "abcd1234cdef1234abcd1234cdef1234",
      "name": "English"
    }
  • {{ @item.code }} => en-GB

  • {{ @item.name }} => Inglês

Ou se {{ $.environments }} for referenciado, então:

  • loop list => ["desenvolvimento", "produção"]

  • {{ @item }} => desenvolvimento ou produção

Esse artigo foi útil?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.