Looping

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

Smyčky lze implementovat do pracovního postupu a opakovat tak sadu úkolů na základě definovaných podmínek.

Smyčky se spouštějí po sobě. Paralelně mohou běžet maximálně 4 kroky.

Ke konfiguraci smyčky se přistupuje buď v záložce Rozšířené konfigurace bloku, nebo kliknutím pravým tlačítkem myši na blok a výběrem Upravit smyčku.

Nastavení smyčky vyžaduje seznam věcí, se kterými chcete pracovat:

Prosté, jednotlivé hodnoty, které jsou pak použitelné v parametrech úkolu, jako je {{ @item }}.
Objekt .JSON, kde lze každý prvek v objektu adresovat pomocí klíče, jako je například {{ @item.key }}.

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

Po dokončení smyčky je výstup všech iterací přístupný jako pole .JSON. Výstupem každé iterace musí být platný soubor .JSON.

Existují čtyři typy smyček, které lze definovat a vybrat v poli loop_with:

withSequence
withItems
withComplexItems
withParam

withSequence

Smyčka withSequence umožňuje iteraci po řadě čísel nebo generování rozsahu hodnot v rámci pracovního postupu.

Může být použit pro opakování sady kroků určitý početkrát nebo provádění operací na základě rozsahu hodnot.

Chcete-li vytvořit vzorek pomocí sekvenční smyčky, postupujte takto:

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

Zobrazí se konfigurační možnosti loop_with.
Z pole loop_with vyberte withSequence.
Do pole Počet zadejte počet opakování smyčky.
Případně zadejte hodnotu, od které má smyčka začínat a/nebo končit.
Klikněte na Uložit smyčku.
V konfiguraci Parametry klikněte na Upravit parametry.

Zobrazí se možnosti konfigurace.
Do pole Zpráva zadejte {{ @item }} a klikněte na Uložit parametry.

Tato hodnota bude převedena za běhu.

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

seznam smyček => ["2", "3", "4"]
{{ @item }} => 2 nebo 3 nebo 4, podle iterace

withItems

Smyčka withItems umožňuje opakování nad seznamem položek.

Může být použit, když potřebujete provést operace na základě seznamu položek.

Vzorek vytvoříte pomocí smyčky Items, postupujte takto:

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

Zobrazí se konfigurační možnosti loop_with.
Z pole loop_with vyberte withItems
Zadejte en do pole proměnná a klikněte na +Položka (vytvoří se další pole proměnné).
Do druhého pole proměnné zadejte de a vytvořte třetí pole.
Do třetího pole proměnné zadejte fr a vytvořte čtvrté pole.
Zadejte nás do čtvrtého pole proměnné.
Klikněte na Uložit smyčku.
V konfiguraci Parametry klikněte na Upravit parametry.

Zobrazí se možnosti konfigurace.
Do pole Zpráva zadejte {{ @item }} a klikněte na Uložit parametry.

Tato hodnota bude převedena za běhu.

Výsledkem této smyčky bude opakování nad seznamem kódů jazyků:

seznam smyček => ["cs", "de", "fr", "ua"]
{{ @item }} => en or de .. ua

withComplexItems

Smyčka withComplexItems umožňuje opakování nad seznamem objektů.

Může být použit, když potřebujete provést operace na základě seznamu složitých položek.

Chcete-li vytvořit vzorek s ComplexItems smyčkou, postupujte takto:

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

Zobrazí se konfigurační možnosti loop_with.
Z pole loop_with vyberte withComplexItems
Kliknutím na tlačítko +Klíč:hodnota přidejte druhý klíč.
U objektu 1 zadejte následující:
- Klíč: Hodnota1
  - klíč (volitelné): název
  - (volitelné): Projekt 1
- Klíč: Hodnota2
  - klíč (volitelné): ID
  - (volitelné): 11
Kliknutím na tlačítko +Objekt přidáte druhý objekt a kliknutím na tlačítko +Klíč:hodnota druhého klíče.
U objektu 2 zadejte následující:
- Klíč: Hodnota1
  - klíč (volitelné): název
  - (volitelné): Projekt 2
- Klíč: Hodnota2
  - klíč (volitelné): ID
  - (volitelné): 22
Vzorek nastavení:
V konfiguraci Parametry klikněte na Upravit parametry.

Zobrazí se možnosti konfigurace.
Do pole Zpráva zadejte {{ @item.name }} a klikněte na Uložit parametry. Tato hodnota bude převedena za běhu.

Výsledkem této smyčky bude opakování seznamu projektů:

seznam smyček =>

[
  {
    "Název": "Projekt 1",
    "id": 11
  },
  {
    "Název": "Projekt 2",
    "id": 22
  }
]

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

withParam

Smyčka withParam umožňuje opakování dynamického seznamu, který je výstupem z jakéhokoli předchozího úkolu nebo spouštěče.

Tato smyčka slouží pouze jako reference v poli parametrů.

Příklad:

Výstupy úkolu (Strings: Zveřejnit vydání):

{
  "created_at": "2015-01-28T09:52:53Z",
  "prostředí": ["vývoj", "výroba"],
  "id": "abcd1234cdef1234abcd1234cdef1234",
  "locales": [
    {
      "code": "en-GB",
      "id": "abcd1234cdef1234abcd1234cdef1234",
      "Název": "English"
    },
    {
      "id": "abcd5678cdef5678abcd5678cdef5678",
      "Název": "Němčina",
      "code": "de_DE"
    }
  ],
  "platforms": ["android"],
  "project": {
    "created_at": "2015-01-28T09:52:53Z",
    "id": "abcd1234cdef1234abcd1234cdef1234",
    "main_format": "xml",
    "Název": "Můj projekt Android",
    "updated_at": "2015-01-28T09:52:53Z"
  },
  "updated_at": "2015-01-28T09:52:53Z",
  "verze": 1
}

Pokud je nastavení smyčky sParam nastaveno pomocí {{ $.locales }}, pak:

seznam smyček =>

[
  {
    "code": "en-GB",
    "id": "abcd1234cdef1234abcd1234cdef1234",
    "Název": "English"
  },
  {
    "id": "abcd5678cdef5678abcd5678cdef5678",
    "Název": "Němčina",
    "code": "de_DE"
  }
]

První {{ @item }} =>

{
  "code": "en-GB",
  "id": "abcd1234cdef1234abcd1234cdef1234",
  "Název": "English"
}

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

Nebo odkazuje-li se na {{ $.environments }}, pak:

seznam smyček => ["vývoj", "výroba"]
{{ @item }}=> vývoj nebo výroba