Чтобы продолжить работу с примером рабочего процесса, его необходимо настроить.
Чтобы открыть настройки блока, нажмите «Изменить параметры» на вкладке «» либо щёлкните блок правой кнопкой мыши и выберите «Изменить параметры». Откроется окно «». После добавления параметров к блоку кнопка «» меняется на «».
Чтобы настроить блоки для примера, выполните следующие действия:
-
Откройте окно «» для действия «
».Список локалей
-
Для полей «» и «» нужны динамические значения, определяемые во время выполнения.
-
Нажмите значок связи
рядом с полем «» и выберите действие «
».Получить токены доступа
Значок связи становится зелёным, после чего поле можно редактировать.
-
Для доступа к свойствам триггера или действия, на которые ссылаются, используется следующий синтаксис:
{{$.path.to.value}}Если выходные данные действия «
» имеют следующий вид:Получить токены доступа
{ "tokens": {"strings_token": "STRINGS_TOKEN", "tms_token": "TMS_TOKEN"} }то в поле «» нужно ввести выражение
{{$.tokens.strings_token}}. -
Нажмите значок связи
рядом с полем «» и выберите триггер «
».uploads:create
Значок связи становится зелёным, после чего поле можно редактировать.
-
Выходные данные триггера «
» выглядят примерно так:uploads: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}}. -
Нажмите Сохранить.
Окно «» закрывается, а параметры действия сохраняются.
-
-
Для создания задания действию «
» необходимо передать идентификатор локали проекта по умолчанию. Действие «Создать задание
» принимает данные в формате JSON, применяет указанный фильтр и возвращает результат в формате JSON.Преобразовать JSON с помощью jq
-
На вкладке «» окна «» найдите phrase-jq.
Перетащите блок действия «
» под действие «Преобразовать JSON с помощью jq
», чтобы соединить их.Список локалей
-
Откройте окно «» для действия «
Преобразовать JSON с помощью jq». -
В раскрывающемся списке «» выберите «».
-
Нажмите значок связи
рядом с полем «» и выберите действие «
».Список локалей
Значок связи становится зелёным, после чего поле можно редактировать.
-
Поле «» принимает данные в формате JSON. Специальное фиксированное выражение (
@вместо$) обеспечивает передачу в поле всех выходных данных связанного действия.Введите выражение
{{@.outputs.result}}в поле «». -
Нажмите значок связи
рядом с полем «» и выберите действие «
».Список локалей
Значок связи становится зелёным, после чего поле можно редактировать.
-
Требуется фильтр списка локалей, который возвращает новый список, содержащий все элементы, для которых свойство
defaultимеет значениеtrue.В каждом проекте может быть только одна локаль по умолчанию, поэтому в списке обязательно есть один элемент, который можно однозначно определить. К этому элементу обращаются напрямую с помощью синтаксиса массива
.[0].Введите выражение
map(select(.default))|.[0]в поле «». -
Нажмите Сохранить.
Окно «» закрывается, а параметры действия сохраняются.
-
-
Теперь можно настроить действие «
», используя схемы из предыдущих блоков.Создать задание
-
Нажмите значок связи
рядом с полем «» и выберите действие «
».Получить токены доступа
Значок связи становится зелёным, после чего поле можно редактировать.
Введите выражение
{{$.tokens.strings_token}}. -
Нажмите значок связи
рядом с полем «» и выберите триггер «
».uploads:create
Ссылка становится зеленой, и поле можно редактировать.
Введите выражение
{{$.project.id}}. -
Нажмите значок ссылки
для поля «» и выберите действие «
Transform JSON with jq».Ссылка становится зеленой, и поле можно редактировать.
Введите выражение
{{@.outputs.result}}. -
Срок выполнения может быть рассчитан с помощью функций sprig или Expr, но в этом примере будет использоваться заранее заданная дата в формате, понятном API.
В поле «» введите 2023-12-31T12:00:00Z.
-
Нажмите Сохранить.
Конфигурация сохранена, и подробности можно просмотреть на вкладке «».
-
-
Каждое действие может иметь одно или несколько условий, объединенных логическими операторами
ANDиOR. Эти условия оцениваются во время выполнения, и действие вместе с его дочерними элементами будет выполнено только в том случае, если условие истинно.Чтобы отразить это в примере, выберите действие «
» и нажмите «Edit conditions» на вкладке «» или щелкните блок правой кнопкой мыши и выберите «Edit conditions».Create a job
Откроется окно «».
-
По аналогии с предыдущими блоками свяжите поле «» с триггером
и введите выражениеuploads:create
{{$.upload.tag}}. -
Выберите «NOT» в первом раскрывающемся списке, чтобы инвертировать условие.
-
Выберите «IsNull» в раскрывающемся списке «».
-
Нажмите Сохранить.
Условие отображается на вкладке «».
Рабочий процесс остановится в этой точке, если загрузка не содержит тега (это означает, что не было новых/обновленных ключей/переводов).
-
-
Теперь для задания требуются целевые локали. В этом примере будут созданы две локали: одна для испанского (es-ES) и одна для немецкого (de-DE). Локали будут добавлены к двум действиям «
» в окне «», как на шаге 3.Transform JSON with jq
-
В поле «» обоих действий введите выражение
{{@.outputs.result}}, свяжите его с действием «» и сохраните параметр.List locales
-
В поле «» одного действия введите выражение
map(select(.name == "es-ES"))|.[0]и свяжите его с действием «».List locales
Сохраните параметр.
-
Во втором действии введите выражение
map(select(.name == "de-DE"))|.[0]и свяжите его с действием «».List locales
Сохраните параметр.
-
-
Теперь локали будут применяться при создании задания.
Настройте два действия «
», используя те же шаблоны, что и ранее.Add a target locale to a job
-
Теперь задание можно запустить.
Настройте действие «
», используя те же шаблоны, что и ранее.Start a job
После настройки блоков рабочий процесс можно запустить по требованию для тестирования, не дожидаясь срабатывания триггера, например запуска по расписанию или вызова вебхука.
Запустите выполнение одним из следующих способов:
-
В редакторе рабочих процессов нажмите кнопку «Test run», чтобы открыть диалоговое окно «».
-
Отправьте
POST-запрос на/orchestrator/api/v1/workflows/{workflow_id}/executionsчерез общедоступный API.
При выполнении всегда используется последняя версия рабочего процесса. Версию не обязательно публиковать, но она должна пройти проверку публикации. Каждый запуск создает новое выполнение, которое отображается на странице «» с тегом «Manual».
Примечание
Запуск по требованию доступен только для рабочих процессов, использующих движок нового поколения. Для устаревших рабочих процессов кнопка «Test run» не отображается в редакторе, а API возвращает ошибку 422.
Пакеты действий и шаблоны нельзя запускать; кроме того, у рабочего процесса должен быть владелец.