Smyčkování

Obsah je strojově přeložen z angličtiny s použitím Phrase Language AI.

Smyčky mohou být implementovány v rámci pracovního postupu k opakování sady úkolů na základě definovaných podmínek.

Nastavení smyčky je přístupné buď na záložce Pokročilé konfigurace bloku, nebo kliknutím pravým tlačítkem na blok a výběrem Upravit smyčku.

Nastavení smyčky vyžaduje seznam věcí, na kterých má pracovat:

Jednoduché, jednotlivé hodnoty, které jsou pak použitelné v parametrech úkolu, jako je {{ @item }}.
Objekt .JSON, kde každý prvek v objektu může být adresován jeho klíčem, jako je {{ @item.key }}.

Přístup k agregovaným výsledkům smyčky

Výstup všech iterací může být přístupný jako pole .JSON, jakmile je smyčka dokončena. Výstup každé iterace musí být platný soubor .JSON.

Existují čtyři typy smyček, které mohou být definovány a vybírány v poli smyčka_s:

withSequence
s_položkami
withComplexItems
withParam

withSequence

Smyčka s_sekvencí umožňuje iteraci přes sekvenci čísel nebo generaci rozsahu hodnot v rámci pracovního postupu.

Může být použita k opakování sady kroků konkrétní početkrát nebo k provádění operací na základě rozsahu hodnot.

Chcete-li vytvořit vzorovou smyčku s_sekvencí, postupujte podle těchto kroků:

Vyberte prázdný blok a otevřete konfiguraci Smyčka.
Klikněte na Upravit smyčku.

Možnosti konfigurace loop_with jsou prezentovány.
Z pole loop_with vyberte withSequence.
Zadejte počet iterací smyčky do pole Count.
Volitelně zadejte hodnotu, od které by měla smyčka začít a/nebo s kterou by měla skončit.
Klikněte na Save loop.
Z konfigurace Parameters klikněte na Edit parameters.

Možnosti konfigurace jsou prezentovány.
Do pole Message zadejte {{ @item }} a klikněte na Save parameters.

Tato hodnota bude převedena za běhu.

Například, pokud je počet nastaven na 3 a počáteční hodnota je 2, výsledky této smyčky budou:

loop list => ["2", "3", "4"]
{{ @item }} => 2 nebo 3 nebo 4, na základě iterace

withItems

Smyčka withItems umožňuje iteraci přes seznam položek.

Může být použita, když je potřeba provádět operace na základě seznamu položek.

Chcete-li vytvořit vzorovou smyčku withItems, postupujte podle těchto kroků:

Vyberte prázdný blok a otevřete konfiguraci Smyčka.
Klikněte na Upravit smyčku.

Možnosti konfigurace loop_with jsou prezentovány.
Z pole loop_with vyberte withItems
Zadejte en do pole variable a klikněte na +Item (je vytvořeno další pole variable).
Zadejte de do druhého pole variable a vytvořte třetí pole.
Zadejte fr do třetího pole variable a vytvořte čtvrté pole.
Zadejte us do čtvrtého proměnného pole.
Klikněte na Save loop.
Z konfigurace Parameters klikněte na Edit parameters.

Možnosti konfigurace jsou prezentovány.
Do pole Message zadejte {{ @item }} a klikněte na Save parameters.

Tato hodnota bude převedena za běhu.

Výsledky tohoto cyklu budou iterací přes seznam jazykových kódů:

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

withComplexItems

Cyklus sKomplexnímiPoložkami umožňuje iteraci přes seznam objektů.

Může být použit, když je potřeba provádět operace na základě seznamu komplexních položek.

Pro vytvoření vzorového sKomplexnímiPoložkami cyklu postupujte podle těchto kroků:

Vyberte prázdný blok a otevřete konfiguraci Smyčka.
Klikněte na Upravit smyčku.

Možnosti konfigurace loop_with jsou prezentovány.
Z pole cyklus_s vyberte sKomplexnímiPoložkami
Klikněte na +Klíč:hodnota pro přidání druhého klíče.
Pro Objekt 1 zadejte následující:
- Klíč: Hodnota1
  - klíč (volitelný): název
  - (volitelný): Projekt 1
- Key: Value2
  - klíč (volitelný): id
  - (volitelný): 11
Klikněte na +Objekt pro přidání druhého objektu a +Klíč:hodnota pro druhý klíč.
Pro Objekt 2 zadejte následující:
- Klíč: Hodnota1
  - klíč (volitelný): název
  - (volitelný): Projekt 2
- Key: Value2
  - klíč (volitelný): id
  - (volitelný): 22
Ukázka nastavení:
Z konfigurace Parameters klikněte na Edit parameters.

Možnosti konfigurace jsou prezentovány.
Do pole Message zadejte {{ @item.name }} a klikněte na Save parameters. Tato hodnota bude převedena za běhu.

Výsledky tohoto cyklu budou iterací přes seznam projektů:

cyklus seznamu =>

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

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

withParam

Cyklický sParam umožňuje iteraci přes dynamický seznam, který je výstupem z jakéhokoli předchozího úkolu nebo spouštěče.

Tento cyklus se používá pouze jako reference v poli parametrů.

Příklad:

Výstupy úkolu (Řetězce: Publikovat vydání):

{
  "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": "Můj Android Projekt",
    "updated_at": "2015-01-28T09:52:53Z"
  },
  "updated_at": "2015-01-28T09:52:53Z",
  "version": 1
}

Pokud jsou nastavení smyčky withParam nastavena s {{ $.locales }}, pak:

loop list =>

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

První {{ @item }} =>

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

{{ @item.code }} => en-GB
{{ @item.name }} => Angličtina

Nebo pokud je {{ $.environments }} odkazováno, pak:

loop list => ["development", "production"]
{{ @item }} => vývoj nebo produkce