Ciclo

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.

La configurazione del ciclo è accessibile nella scheda Advanced della configurazione di un blocco, oppure facendo clic con il tasto destro su un blocco e selezionando Edit loop.

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

Valori semplici e singoli, che sono quindi utilizzabili nei parametri dell'attività come {{ @item }}.
Un oggetto .JSON in cui ogni elemento nell'oggetto può essere indirizzato dalla sua chiave come {{ @item.key }}.

Accesso ai risultati aggregati di un ciclo

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

Esistono quattro tipi di ciclo 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 per eseguire operazioni basate su un intervallo di valori.

Per Crea un ciclo withSequence di esempio, seguire questi passaggi:

Selezionare un blocco vuoto e aprire la configurazione Loop.
Fare clic su Edit loop.

Le opzioni di configurazione loop_with sono presentate.
Dal campo loop_with, Seleziona withSequence.
Inserire il numero di iterazioni del ciclo nel campo Count.
Facoltativamente, inserire un valore da cui il ciclo deve iniziare e/o terminare.
Fare clic su salvare loop.
Dalla configurazione Parameters, fare clic su modificare parameters.

Le opzioni di configurazione sono presentate.
Nel campo Message, inserire {{ @item }} e fare clic su salvare parameters.

Questo valore verrà convertito in fase di esecuzione.

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

elenco loop => [\"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 basate su un elenco di elementi.

Per Crea un ciclo withItems di esempio, seguire questi passaggi:

Selezionare un blocco vuoto e aprire la configurazione Loop.
Fare clic su Edit loop.

Le opzioni di configurazione loop_with sono presentate.
Dal campo loop_with, Seleziona withItems
Inserire en nel campo variable e fare clic su +Item (viene creato un altro campo variable).
Inserire de nel secondo campo variable e Crea un terzo campo.
Inserire fr nel terzo campo variable e Crea un quarto campo.
Inserisci us nel quarto campo variable.
Fare clic su salvare loop.
Dalla configurazione Parameters, fare clic su modificare parameters.

Le opzioni di configurazione sono presentate.
Nel campo Message, inserire {{ @item }} e fare clic su salvare parameters.

Questo valore verrà convertito in fase di esecuzione.

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

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

withComplexItems

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

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

Per Crea un ciclo withComplexItems di esempio, segui questi passaggi:

Selezionare un blocco vuoto e aprire la configurazione Loop.
Fare clic su Edit loop.

Le opzioni di configurazione loop_with sono presentate.
Dal campo loop_with, Seleziona withComplexItems
Fai clic su +Key:value per aggiungere una seconda chiave.
Per Object 1, inserisci quanto segue:
- chiave: Value1
  - chiave (Facoltativo): name
  - (Facoltativo): progetto 1
- chiave: Value2
  - chiave (Facoltativo): ID
  - (Facoltativo): 11
Fai clic su +Object per aggiungere un secondo oggetto e +Key:value per una seconda chiave.
Per Object 2, inserisci quanto segue:
- chiave: Value1
  - chiave (Facoltativo): name
  - (Facoltativo): progetto 2
- chiave: Value2
  - chiave (Facoltativo): ID
  - (Facoltativo): 22
Esempio di impostazioni:
Dalla configurazione Parameters, fare clic su modificare parameters.

Le opzioni di configurazione sono presentate.
Nel campo Message, inserire {{ @item.name }} e fare clic su salvare parameters. Questo valore verrà convertito in fase di esecuzione.

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

elenco ciclo =>

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

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

withParam

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

Questo ciclo viene utilizzato solo come riferimento nel campo parametro.

Esempio:

Output dell'attività (Strings: Pubblica una release):

{
  "created_at": "2015-01-28T09:52:53Z",
  "environments": ["development", "production"],
  "id": "abcd1234cdef1234abcd1234cdef1234",
  "locales": [
    {
      "code": "en-GB",
      "id": "abcd1234cdef1234abcd1234cdef1234",
      "name": "English"
    },
    {
      "id": "abcd5678cdef5678abcd5678cdef5678",
      "name": "German",
      "code": "de_DE"
    }
  ],
  "platforms": ["android"],
  "project": {
    "created_at": "2015-01-28T09:52:53Z",
    "id": "abcd1234cdef1234abcd1234cdef1234",
    "main_format": "xml",
    "name": "My Android Project",
    "updated_at": "2015-01-28T09:52:53Z"
  },
  "updated_at": "2015-01-28T09:52:53Z",
  "version": 1
}

Se le impostazioni del ciclo withParam sono impostate con {{ $.locales }}, allora:

elenco ciclo =>

[
  {
    "code": "en-GB",
    "id": "abcd1234cdef1234abcd1234cdef1234",
    "name": "English"
  },
  {
    "id": "abcd5678cdef5678abcd5678cdef5678",
    "name": "German",
    "code": "de_DE"
  }
]

Primo {{ @item }} =>

{
  "code": "en-GB",
  "id": "abcd1234cdef1234abcd1234cdef1234",
  "name": "English"
}

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

O se {{ $.environments }} viene referenziato, allora:

loop elenco => [\"development\", \"production\"]
{{ @item }} => development o production