Looping

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

I cicli possono essere implementati all'interno di un flusso di lavoro per ripetere una serie di attività in base a condizioni definite.

I cicli vengono eseguiti in sequenza. Massimo 4 passaggi possono essere eseguiti in parallelo.

Alla configurazione del ciclo si accede nella scheda Avanzate di una configurazione di blocco oppure facendo clic con il pulsante destro del mouse su un blocco e selezionando Modifica ciclo.

Le impostazioni del ciclo richiedono un elenco di cose su cui operare:

Valori semplici e singoli, che possono poi essere utilizzati in parametri di attività come {{ @item }}.
Un oggetto .JSON in cui ogni elemento nell'oggetto può essere indirizzato dalla sua chiave come {{ @item.key }}.

Accedere ai risultati aggregati di un ciclo

L'output di tutte le iterazioni è accessibile come array .JSON una volta completato un ciclo. L'output di ogni iterazione deve essere un file .JSON valido.

Ci sono quattro tipi di loop che possono essere definiti e selezionati nel campo loop_with:

withSequence
withItems
withComplexItems
withParam

withSequence

Il ciclo withSequence consente un'iterazione su una sequenza di numeri o la generazione di un intervallo di valori all'interno di un flusso di lavoro.

Può essere utilizzato per ripetere una serie di passaggi un numero specifico di volte o eseguire operazioni in base a un intervallo di valori.

Per creare un campione withSequence loop, segui i passaggi riportati di seguito:

Seleziona un blocco empty e apri la configurazione Loop.
Fai clic su Modifica ciclo.

Vengono presentate le opzioni di configurazione di loop_with.
Dal campo loop_with, seleziona withSequence.
Immettere il numero di iterazioni del ciclo nel campo Conteggio.
Facoltativamente, inserisci un valore da cui deve iniziare e/o terminare il ciclo.
Fai clic su Salva ciclo.
Dalla configurazione dei parametri fare clic su Modifica parametri.

Vengono presentate le opzioni di configurazione.
Nel campo Messaggio, inserisci {{ @item }} e fai clic su Salva parametri.

Questo valore verrà convertito a runtime.

Ad esempio, se il conteggio è impostato su 3 e il valore di inizio è 2, i risultati di questo ciclo saranno:

elenco ciclo => ["2", "3", "4"]
{{ @item }} => 2 o 3 o 4, in base all'iterazione

withItems

Il ciclo withItems consente l'iterazione su un elenco di elementi.

Può essere utilizzato quando è necessario eseguire operazioni in base a un elenco di elementi.

Per creare un ciclo withItems di esempio, segui i passaggi riportati di seguito:

Seleziona un blocco empty e apri la configurazione Loop.
Fai clic su Modifica ciclo.

Vengono presentate le opzioni di configurazione di loop_with.
Dal campo loop_with, seleziona withItems
Inserisci en nel campo della variabile e fai clic su +Elemento (viene creato un altro campo della variabile).
Inserisci de nel secondo campo della variabile e crea un terzo campo.
Inserisci fr nel terzo campo della variabile e crea un quarto campo.
Inserisci noi nel quarto campo della variabile.
Fai clic su Salva ciclo.
Dalla configurazione dei parametri fare clic su Modifica parametri.

Vengono presentate le opzioni di configurazione.
Nel campo Messaggio, inserisci {{ @item }} e fai clic su Salva parametri.

Questo valore verrà convertito a runtime.

I risultati di questo ciclo saranno un'iterazione su un elenco di codici lingua:

elenco ciclo => ["en", "de", "fr", "ua"]
{{ @item }}=> it o de .. ua

withComplexItems

Il ciclo withComplexItems consente l'iterazione su un elenco di oggetti.

Può essere utilizzato quando è necessario eseguire operazioni basate su un elenco di elementi complessi.

Per creare un campione withComplexItems loop, segui i passaggi riportati di seguito:

Seleziona un blocco empty e apri la configurazione Loop.
Fai clic su Modifica ciclo.

Vengono presentate le opzioni di configurazione di loop_with.
Dal campo loop_with, seleziona withComplexItems
Fare clic su +Chiave:valore per aggiungere una seconda chiave.
Per l’oggetto 1, immettere quanto segue:
- Chiave: Value1
  - chiave (opzionale): nome
  - (facoltativo): Progetto 1
- Chiave: Value2
  - chiave (opzionale): ID
  - (facoltativo): 11
Fare clic su +Oggetto per aggiungere un secondo oggetto e +Chiave:valore per una seconda chiave.
Per l’oggetto 2, immettere quanto segue:
- Chiave: Value1
  - chiave (opzionale): nome
  - (facoltativo): Progetto 2
- Chiave: Value2
  - chiave (opzionale): ID
  - (facoltativo): 22
Campione impostazioni:
Dalla configurazione dei parametri fare clic su Modifica parametri.

Vengono presentate le opzioni di configurazione.
Nel campo Messaggio, inserisci {{ @item.name }} e fai clic su Salva parametri. Questo valore verrà convertito a runtime.

I risultati di questo ciclo saranno un'iterazione su un elenco di progetti:

elenco ciclo =>

[
  {
    "nome": "Progetto 1",
    "id": 11
  },
  {
    "nome": "Progetto 2",
    "id": 22
  }
]

{{ @item }} =>
```
{
  "nome": "Progetto 1",
  "id": 11
}
```
{{ @item.name }}=> Progetto 1
{{ @item.id }} => 11

withParam

Il ciclo withParam consente l'iterazione su un elenco dinamico che è output di qualsiasi attività o trigger precedente.

Questo ciclo è solo usato come riferimento nel campo dei parametri.

Esempio:

Risultati dell'attività (Strings: Pubblica una versione):

{
  "created_at": "2015-01-28T09:52:53Z",
  "environments": ["development", "production"],
  "id": "abcd1234cdef1234abcd1234cdef1234",
  "locales": [
    {
      "code": "en-GB",
      "id": "abcd1234cdef1234abcd1234cdef1234",
      "nome": "Inglese"
    },
    {
      "id": "abcd5678cdef5678abcd5678cdef5678",
      "nome": "Tedesco",
      "code": "de_DE"
    }
  ],
  "platforms": ["android"],
  "progetto": {
    "created_at": "2015-01-28T09:52:53Z",
    "id": "abcd1234cdef1234abcd1234cdef1234",
    "main_format": "xml",
    "nome": "Il mio progetto Android",
    "updated_at": "2015-01-28T09:52:53Z"
  },
  "updated_at": "2015-01-28T09:52:53Z",
  "versione": 1
}

Se impostazioni loop withParam sono impostate con {{ $.locales }}, allora:

elenco ciclo =>

[
  {
    "code": "en-GB",
    "id": "abcd1234cdef1234abcd1234cdef1234",
    "nome": "Inglese"
  },
  {
    "id": "abcd5678cdef5678abcd5678cdef5678",
    "nome": "Tedesco",
    "code": "de_DE"
  }
]

Primo {{ @item }} =>

{
  "code": "en-GB",
  "id": "abcd1234cdef1234abcd1234cdef1234",
  "nome": "Inglese"
}

{{ @item.code }}=> en-GB
{{ @item.name }}=> Inglese

Oppure, se si fa riferimento a {{ $.environments }}, allora:

elenco loop => ["sviluppo", "produzione"]
{{ @item }} => sviluppo o produzione