Orchestrator

Настройка рабочего процесса

Контент автоматически переведен с английского языка с помощью Phrase Language AI.

Чтобы продолжить работу с примером рабочего процесса, его необходимо настроить.

Чтобы открыть настройки блока, нажмите «Изменить параметры» на вкладке «Настройка» либо щёлкните блок правой кнопкой мыши и выберите «Изменить параметры». Откроется окно «Изменить параметры». После добавления параметров к блоку кнопка «Добавить параметры» меняется на «Изменить параметры».

Чтобы настроить блоки для примера, выполните следующие действия:

  1. Откройте окно «Изменить параметры» для действия «language-blue.svgСписок локалей».

  2. Для полей «Токен доступа» и «Проект» нужны динамические значения, определяемые во время выполнения.

    1. Нажмите значок связи Значок связи рядом с полем «Токен доступа» и выберите действие «circle-blue.svgПолучить токены доступа».

      Значок связи становится зелёным, после чего поле можно редактировать.

    2. Для доступа к свойствам триггера или действия, на которые ссылаются, используется следующий синтаксис:

      {{$.path.to.value}}

      Если выходные данные действия «circle-blue.svgПолучить токены доступа» имеют следующий вид:

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

      то в поле «Токен доступа» нужно ввести выражение {{$.tokens.strings_token}}.

    3. Нажмите значок связи Значок связи рядом с полем «Проект» и выберите триггер «history-orange.svguploads:create».

      Значок связи становится зелёным, после чего поле можно редактировать.

    4. Выходные данные триггера «history-orange.svguploads:create» выглядят примерно так:

      {
        "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"
        }
      }
      

      поэтому в поле «Проект» нужно ввести выражение {{$.project.id}}.

    5. Нажмите Сохранить.

      Окно «Изменить параметры» закрывается, а параметры действия сохраняются.

  3. Для создания задания действию «work-blue.svgСоздать задание» необходимо передать идентификатор локали проекта по умолчанию. Действие «circle-blue.svgПреобразовать JSON с помощью jq» принимает данные в формате JSON, применяет указанный фильтр и возвращает результат в формате JSON.

    1. На вкладке «Действия» окна «Блоки рабочего процесса» найдите phrase-jq.

      Перетащите блок действия «circle-blue.svgПреобразовать JSON с помощью jq» под действие «language-blue.svgСписок локалей», чтобы соединить их.

    2. Откройте окно «Изменить параметры» для действия «Преобразовать JSON с помощью jq».

    3. В раскрывающемся списке «Тип входных данных» выберите «JSON».

    4. Нажмите значок связи Значок связи рядом с полем «Входные данные» и выберите действие «language-blue.svgСписок локалей».

      Значок связи становится зелёным, после чего поле можно редактировать.

    5. Поле «Входные данные» принимает данные в формате JSON. Специальное фиксированное выражение (@ вместо $) обеспечивает передачу в поле всех выходных данных связанного действия.

      Введите выражение {{@.outputs.result}} в поле «Входные данные».

    6. Нажмите значок связи Значок связи рядом с полем «Jq» и выберите действие «language-blue.svgСписок локалей».

      Значок связи становится зелёным, после чего поле можно редактировать.

    7. Требуется фильтр списка локалей, который возвращает новый список, содержащий все элементы, для которых свойство default имеет значение true.

      В каждом проекте может быть только одна локаль по умолчанию, поэтому в списке обязательно есть один элемент, который можно однозначно определить. К этому элементу обращаются напрямую с помощью синтаксиса массива .[0].

      Введите выражение map(select(.default))|.[0] в поле «Jq».

    8. Нажмите Сохранить.

      Окно «Изменить параметры» закрывается, а параметры действия сохраняются.

  4. Теперь можно настроить действие «work-blue.svgСоздать задание», используя схемы из предыдущих блоков.

    1. Нажмите значок связи Значок связи рядом с полем «Токен доступа» и выберите действие «circle-blue.svgПолучить токены доступа».

      Значок связи становится зелёным, после чего поле можно редактировать.

      Введите выражение {{$.tokens.strings_token}}.

    2. Нажмите значок связи Значок связи рядом с полем «Проект» и выберите триггер «language-orange.svguploads:create».

      Ссылка становится зеленой, и поле можно редактировать.

      Введите выражение {{$.project.id}}.

    3. Нажмите значок ссылки Linking Icon для поля «Source locale» и выберите действие «Transform JSON with jq».

      Ссылка становится зеленой, и поле можно редактировать.

      Введите выражение {{@.outputs.result}}.

    4. Срок выполнения может быть рассчитан с помощью функций sprig или Expr, но в этом примере будет использоваться заранее заданная дата в формате, понятном API.

      В поле «Due date» введите 2023-12-31T12:00:00Z.

    5. Нажмите Сохранить.

      Конфигурация сохранена, и подробности можно просмотреть на вкладке «Configure».

  5. Каждое действие может иметь одно или несколько условий, объединенных логическими операторами AND и OR. Эти условия оцениваются во время выполнения, и действие вместе с его дочерними элементами будет выполнено только в том случае, если условие истинно.

    Чтобы отразить это в примере, выберите действие «work-blue.svgCreate a job» и нажмите «Edit conditions» на вкладке «Conditions» или щелкните блок правой кнопкой мыши и выберите «Edit conditions».

    Откроется окно «Edit conditionals».

    1. По аналогии с предыдущими блоками свяжите поле «variable» с триггером language-orange.svguploads:create и введите выражение {{$.upload.tag}}.

    2. Выберите «NOT» в первом раскрывающемся списке, чтобы инвертировать условие.

    3. Выберите «IsNull» в раскрывающемся списке «compare».

    4. Нажмите Сохранить.

      Условие отображается на вкладке «Conditions».

    Рабочий процесс остановится в этой точке, если загрузка не содержит тега (это означает, что не было новых/обновленных ключей/переводов).

  6. Теперь для задания требуются целевые локали. В этом примере будут созданы две локали: одна для испанского (es-ES) и одна для немецкого (de-DE). Локали будут добавлены к двум действиям «circle-blue.svgTransform JSON with jq» в окне «Edit parameters», как на шаге 3.

    1. В поле «Input» обоих действий введите выражение {{@.outputs.result}}, свяжите его с действием «language-blue.svgList locales» и сохраните параметр.

    2. В поле «Jg» одного действия введите выражение map(select(.name == "es-ES"))|.[0] и свяжите его с действием «language-blue.svgList locales».

      Сохраните параметр.

    3. Во втором действии введите выражение map(select(.name == "de-DE"))|.[0] и свяжите его с действием «language-blue.svgList locales».

      Сохраните параметр.

  7. Теперь локали будут применяться при создании задания.

    Настройте два действия «work-blue.svgAdd a target locale to a job», используя те же шаблоны, что и ранее.

  8. Теперь задание можно запустить.

    Настройте действие «work-blue.svgStart a job», используя те же шаблоны, что и ранее.

Запуск рабочего процесса по требованию

После настройки блоков рабочий процесс можно запустить по требованию для тестирования, не дожидаясь срабатывания триггера, например запуска по расписанию или вызова вебхука.

Запустите выполнение одним из следующих способов:

  • В редакторе рабочих процессов нажмите кнопку «Test run», чтобы открыть диалоговое окно «Run».

  • Отправьте POST-запрос на /orchestrator/api/v1/workflows/{workflow_id}/executions через общедоступный API.

При выполнении всегда используется последняя версия рабочего процесса. Версию не обязательно публиковать, но она должна пройти проверку публикации. Каждый запуск создает новое выполнение, которое отображается на странице «Executions» с тегом «Manual».

Примечание

Запуск по требованию доступен только для рабочих процессов, использующих движок нового поколения. Для устаревших рабочих процессов кнопка «Test run» не отображается в редакторе, а API возвращает ошибку 422.

Пакеты действий и шаблоны нельзя запускать; кроме того, у рабочего процесса должен быть владелец.

Была ли эта статья полезной?
★ ★ ★ ★ ★

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.