Orchestrator

Konfigurace pracovního postupu

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

Chcete-li pokračovat ve vzorovém pracovním postupu, je třeba jej nakonfigurovat.

Konfiguraci bloku otevřete kliknutím na Edit parameters na kartě Configure nebo kliknutím pravým tlačítkem na blok a výběrem možnosti Edit parameters. Otevře se okno Edit parameters. Jakmile má blok parametry, tlačítko Add parameters se změní na Edit parameters.

Chcete-li nakonfigurovat bloky pro tento příklad, postupujte podle těchto kroků:

  1. Otevřete okno Edit parameters pro akci language-blue.svgList locales.

  2. Pole Access token a Project budou vyžadovat dynamické hodnoty, které se vyřeší za běhu.

    1. Klikněte na ikonu odkazu Linking Icon u pole Access token a vyberte akci circle-blue.svgFetch access tokens.

      Odkaz zezelená a pole lze upravit.

    2. Syntaxe pro přístup k vlastnostem odkazované aktivační události nebo akce je:

      {{$.path.to.value}}

      Výstup akce circle-blue.svgFetch access tokens je následující:

      { "tokens": {"strings_token": "STRINGS_TOKEN", "tms_token": "TMS_TOKEN"} }

      takže pro pole Access token je potřeba výraz {{$.tokens.strings_token}}.

    3. Klikněte na ikonu odkazu Linking Icon u pole Project a vyberte aktivační událost history-orange.svguploads:create.

      Odkaz zezelená a pole lze upravit.

    4. Výstup aktivační události history-orange.svguploads:create vypadá takto:

      {
        "branch": {
          "name": "my_branch"
        },
        "event": "uploads:create",
        "message": "user-1 initialized file upload file.yml in project name_1672734591_11 within branch my_branch\n",
        "project": {
          "created_at": "2023-01-03 08:29:51 UTC",
          "id": "abcdabcdabcdabcd-11",
          "main_format": "yml",
          "name": "name_1672734591_10",
          "point_of_contact": null,
          "project_image_url": null,
          "slug": "name_1672734591_10",
          "updated_at": "2023-01-03 08:29:51 UTC"
        },
        "upload": {
          "created_at": "2023-01-03 08:29:48 UTC",
          "filename": "file.yml",
          "format": "yml",
          "id": "upload-1",
          "state": "initialized",
          "summary": {},
          "tag": null,
          "updated_at": "2023-01-03 08:29:48 UTC"
        },
        "user": {
          "gravatar_uid": "29a2d1baa67d4ea524cf0f247f7bbb94",
          "id": "9c365b9a6f77c247c3de959f6152b231",
          "name": "Joe Sixpack",
          "username": "user-1"
        }
      }
      

      takže pro pole Project je potřeba výraz {{$.project.id}}.

    5. Klikněte na Uložit.

      Okno Edit parameters se zavře a parametry akce se uloží

  3. K vytvoření úlohy pomocí akce work-blue.svgCreate Job je třeba předat ID výchozího národního prostředí projektu. Akce circle-blue.svgTransform JSON with jq přijme vstup ve formátu JSON, použije zadaný filtr a poté vrátí výstup ve formátu JSON

    1. Na kartě Actions v okně Workflow blocks vyhledejte phrase-jq.

      Přetáhněte blok akce circle-blue.svgTransform JSON with jq pod akci language-blue.svglist locales, abyste je propojili.

    2. Otevřete okno Edit parameters pro akci Transform JSON with jq.

    3. V rozevíracím seznamu Input Type vyberte JSON.

    4. Klikněte na ikonu odkazu Linking Icon u pole Input a vyberte akci language-blue.svglist locales.

      Odkaz zezelená a pole lze upravit.

    5. Pole Input přijímá vstup ve formátu JSON. Speciální pevný výraz (@ namísto $) zajišťuje, že celý výstup odkazované akce bude předán do pole.

      Do pole Input zadejte výraz {{@.outputs.result}}.

    6. Klikněte na ikonu odkazu Linking Icon u pole Jq a vyberte akci language-blue.svglist locales.

      Odkaz zezelená a pole lze upravit.

    7. Je vyžadován filtr seznamu národních prostředí, který vrátí nový seznam obsahující všechny prvky, u nichž je vlastnost default nastavena na true.

      V projektu může být pouze jedno výchozí národní prostředí a seznam obsahuje jeden identifikovatelný a povinný prvek. K tomuto prvku se přistupuje přímo pomocí syntaxe pole .[0].

      Do pole Jq zadejte výraz map(select(.default))|.[0].

    8. Klikněte na Uložit.

      Okno Edit parameters se zavře a parametry akce se uloží

  4. Nyní lze nakonfigurovat akci work-blue.svgCreate a job pomocí postupů použitých v předchozích blocích.

    1. Klikněte na ikonu odkazu Linking Icon u pole Access token a vyberte akci circle-blue.svgFetch access tokens.

      Odkaz zezelená a pole lze upravit.

      Zadejte výraz {{$.tokens.strings_token}}.

    2. Klikněte na ikonu odkazu Ikona propojení u pole Projekt a vyberte spouštěč language-orange.svguploads:create.

      Odkaz zezelená a pole lze upravit.

      Zadejte výraz {{$.project.id}}.

    3. Klikněte na ikonu odkazu Ikona propojení u pole Zdrojová jazyková varianta a vyberte akci Transformovat JSON pomocí jq.

      Odkaz zezelená a pole lze upravit.

      Zadejte výraz {{@.outputs.result}}.

    4. Datum splnění lze vypočítat pomocí funkcí sprig nebo Expr, ale pro účely tohoto příkladu bude použito pevně zadané datum, kterému API rozumí.

      Do pole Datum splnění zadejte 2023-12-31T12:00:00Z.

    5. Klikněte na Uložit.

      Konfigurace je uložena a podrobnosti lze zobrazit na kartě Konfigurovat.

  5. Každá akce může mít jednu nebo více podmínek kombinovaných pomocí logických AND a OR. Tyto podmínky se vyhodnocují za běhu a akce i její podřízené akce se provedou pouze v případě, že se podmínka vyhodnotí jako true.

    Chcete-li to v příkladu zohlednit, vyberte akci work-blue.svgVytvořit úlohu a na kartě Podmínky klikněte na Upravit podmínky. Případně klikněte pravým tlačítkem na blok a vyberte Upravit podmínky.

    Otevře se okno Upravit podmínky.

    1. Podle vzorů z předchozích bloků propojte pole proměnná se spouštěčem language-orange.svguploads:create a zadejte výraz {{$.upload.tag}}.

    2. Z první rozevírací nabídky vyberte NOT, čímž výrok znegujete.

    3. Z rozevírací nabídky porovnat vyberte IsNull.

    4. Klikněte na Uložit.

      Podmínka je zobrazena na kartě Podmínky.

    Pracovní postup se v tomto bodě zastaví, pokud nahraná data neobsahují značku (což znamená, že neobsahovala žádné nové ani aktualizované klíče či překlady).

  6. Pro úlohu jsou nyní vyžadovány cílové jazykové varianty. Pro účely tohoto příkladu budou vytvořeny dvě jazykové varianty: jedna pro španělštinu (es-ES) a jedna pro němčinu (de-DE). Jazykové varianty budou přidány ke dvěma akcím circle-blue.svgTransformovat JSON pomocí jq v okně Upravit parametry jako v kroku 3.

    1. Do pole Vstup obou akcí zadejte výraz {{@.outputs.result}}, propojte jej s akcí language-blue.svgSeznam jazykových variant a uložte parametr.

    2. Do pole Jg jedné akce zadejte výraz map(select(.name == "es-ES"))|.[0] a propojte jej s akcí language-blue.svgSeznam jazykových variant.

      Uložte parametr.

    3. Ve druhé akci zadejte výraz map(select(.name == "de-DE"))|.[0] a propojte jej s akcí language-blue.svgSeznam jazykových variant.

      Uložte parametr.

  7. Jazykové varianty se nyní použijí při vytváření úlohy.

    Nakonfigurujte dvě akce work-blue.svgPřidat k úloze cílovou jazykovou variantu podle stejných postupů jako dříve.

  8. Úlohu lze nyní spustit.

    Nakonfigurujte akci work-blue.svgSpustit úlohu podle stejných postupů jako dříve.

Spuštění pracovního postupu na vyžádání

Po nakonfigurování bloků lze pracovní postup spustit na vyžádání a otestovat jej, aniž byste museli čekat na jeho spouštěč, například na naplánovaný čas spuštění nebo webhook.

Spusťte běh jedním z těchto způsobů:

  • V editoru pracovních postupů použijte tlačítko Spustit k otevření dialogového okna Spustit.

  • Odešlete požadavek POST na /orchestrator/api/v1/workflows/{workflow_id}/executions ve veřejném rozhraní API.

Běh vždy používá nejnovější revizi pracovního postupu. Revize nemusí být publikována, ale musí projít ověřením před publikováním. Každý běh vytvoří nové spuštění, které je uvedeno na stránce Spuštění se štítkem Ruční.

Poznámka

Běhy na vyžádání jsou dostupné pouze pro pracovní postupy používající engine pracovních postupů nové generace. U starších pracovních postupů se tlačítko Spustit v editoru nezobrazuje a rozhraní API vrací chybu 422.

Balíčky akcí a šablony nelze spustit a pracovní postup musí mít vlastníka.

Byl pro vás tento článek užitečný?
★ ★ ★ ★ ★

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.