From d57a26ed5e05a5b6e4bd940c3d86431fbe0fa68a Mon Sep 17 00:00:00 2001 From: "pavel.korolkov" Date: Mon, 12 Oct 2026 14:38:42 +0500 Subject: [PATCH 1/3] docs: Add related entities action parameters documentation --- .../admin/actions/overview.ru.md | 60 ++++++++++++++++--- .../documentation/release-notes/v1.7.0.ru.md | 1 + content/documentation/user/properties.ru.md | 2 + 3 files changed, 56 insertions(+), 7 deletions(-) diff --git a/content/documentation/admin/actions/overview.ru.md b/content/documentation/admin/actions/overview.ru.md index 693d99d3..6b4775bb 100644 --- a/content/documentation/admin/actions/overview.ru.md +++ b/content/documentation/admin/actions/overview.ru.md @@ -109,30 +109,76 @@ project_id: {{ .property.project_id }} Для встроенных типов действий параметр «Тело запроса» является конфигурацией действия, при этом доступен пример данной конфигурации. -### Пользовательская форма +### Параметры действия {#пользовательская-форма} #### Параметры -В разделе «Пользовательская форма» указываются параметры, доступные пользователю для заполнения при запуске действия. Типы параметров описаны в разделе [«Параметры»](../../user/properties/). +На вкладке «Параметры действия» задаются параметры, доступные при запуске действия. Типы параметров описаны в разделе [«Параметры»](../../../user/properties/). Для каждого параметра доступны опции: -- «Редактируемый» — позволяет изменить значение параметра при запуске действия. Если опция выключена, значение изменить нельзя. -- «Обязательный» — требует указания значения при запуске действия. -- «Скрытый» — параметр не отображается в пользовательской форме при запуске действия. +- «Редактируемый параметр» — позволяет изменить значение параметра при запуске действия. Если опция выключена, значение изменить нельзя. +- «Обязательный параметр» — требует указания значения при запуске действия. +- «Скрытый параметр» — параметр не отображается в пользовательской форме при запуске действия. -Для каждого параметра можно задать значение по умолчанию, которое будет подставляться в форму при запуске. +Для обычных параметров можно задать значение по умолчанию, которое будет подставляться в форму при запуске. Параметр типа «RelatedEntities» получает значения из связей сущности. Действие принимает только параметры, объявленные в пользовательской форме. Если при запуске, например из процесса или через API, передан параметр, которого нет в форме, запуск завершается ошибкой `action "" does not declare property `. {{< alert level="info" >}} -Задайте значение по умолчанию для нередактируемых и скрытых параметров: при запуске действия пользователь не сможет их изменить. +Если скрытый или нередактируемый параметр не заполняется автоматически, задайте значение по умолчанию. +При запуске действия пользователь не сможет его изменить. {{< /alert >}} Описание параметра отображается при запуске действия по кнопке со значком «info». Заполните описание: оно помогает понять назначение параметра и снижает риск ошибок при запуске. В значениях параметров можно использовать шаблонные функции [Go template](https://pkg.go.dev/text/template). Например, выражение `{{ .entity.name }}` в значении параметра означает, что при запуске действия будет подставлено название сущности, для которой оно запускается. +#### Связанные сущности + +Параметр типа «RelatedEntities» получает данные напрямую связанных сущностей. +Он настраивается на вкладке «Параметры действия» и доступен при самостоятельном запуске и внутри процессов. + +Для параметра доступны настройки: + +- «Ресурс исходной сущности» — ресурс сущности, для которой запускается действие. +- «Направление связи» — «Родители — сущность действия на стороне потомка» получает родителей, + «Потомки — сущность действия на стороне родителя» — потомков. +- «Тип связи» — связь ресурсов, по которой выбираются сущности. +- «Количество результатов» — «Любое» допускает любое количество сущностей, «Ровно одна сущность» — одну. + При автоматическом заполнении проверяется количество совпадений после отбора, + при выборе пользователем — количество выбранных объектов. +- «Условия отбора» — необязательные условия для каждой связанной сущности. + В выражениях `.item` обозначает связанную сущность, `.entity` — сущность запуска. + Допустимые выражения перечислены в подсказке этого поля. + +По умолчанию параметр скрыт и получает все подходящие сущности автоматически. +Для выбора пользователем включите «Редактируемый параметр» и выключите «Скрытый параметр». +При значении «Любое» обязательность выбора задаёт опция «Обязательный параметр»; +при значении «Ровно одна сущность» выбор обязателен. + +Например, для отбора по логическому параметру `primary` укажите +`{{ .item.properties.primary }}` в поле «Проверяемое значение» и выберите операцию «Истина». +Кнопка «Проверить источник» позволяет проверить отбор без запуска действия и изменения параметров. + +Результат параметра с идентификатором `related` доступен в `.property.related` и всегда является массивом. +В шаблонах можно читать поля `slug`, `name`, `uuid` и параметры в `properties`. + +Для переноса идентификатора и названия одной связанной сущности выберите «Ровно одна сущность». +На вкладке «Обновление» активируйте переключатель «Включить обновление параметров» и добавьте правила: + +| Источник | Параметр сущности | +| ---------------------------------------- | ----------------- | +| `{{ (index .property.related 0).slug }}` | `related_slug` | +| `{{ (index .property.related 0).name }}` | `related_name` | + +Целевые параметры должны быть объявлены в ресурсе исходной сущности. +Правила применяются после успешного выполнения действия. +Для записи всей коллекции как JSON-текста используйте источник `{{ .property.related | toJson }}`. + +Связанные сущности читаются с правами пользователя, запустившего действие. +Если хотя бы одна из них недоступна, действие завершается ошибкой. + #### Условия параметров Параметры могут автоматически скрываться или отображаться в пользовательской форме в зависимости от значения параметра типа `Boolean`. Настройка выполняется в разделе «Условия параметров», где задаются правила показа или скрытия для выбранных параметров. diff --git a/content/documentation/release-notes/v1.7.0.ru.md b/content/documentation/release-notes/v1.7.0.ru.md index eb0415fe..c89d7e1b 100644 --- a/content/documentation/release-notes/v1.7.0.ru.md +++ b/content/documentation/release-notes/v1.7.0.ru.md @@ -97,6 +97,7 @@ ClickHouse появился в этом релизе. Чтобы продолж ### Действия +- Добавлен параметр типа [«RelatedEntities»](../../admin/actions/overview/#связанные-сущности): чтение связанных сущностей, выбор одной или нескольких при запуске и использование их данных в шаблонах действия. - Добавлен механизм автоматического [удаления сущностей](../../admin/actions/overview/#удаление-сущностей) после успешного выполнения действия. - Добавлен механизм автоматического [удаления связей сущности](../../admin/actions/overview/#удаление-связей-сущности) после успешного выполнения действия. - Добавлена [синхронизация источников данных](../../admin/actions/overview/#синхронизация-источников-данных) после успешного выполнения действия: объект, созданный или удалённый действием, появляется в каталоге без ожидания синхронизации по расписанию. diff --git a/content/documentation/user/properties.ru.md b/content/documentation/user/properties.ru.md index 46e9cfd7..1ca082b2 100644 --- a/content/documentation/user/properties.ru.md +++ b/content/documentation/user/properties.ru.md @@ -22,6 +22,8 @@ description: Типы параметров каталога и форм, нас * «Users» — пользователи; * «YAML» — текст в YAML-формате. +Для параметров действий также доступен тип «RelatedEntities»: он получает непосредственно связанные сущности автоматически или позволяет выбрать одну либо несколько при запуске. Настройка и примеры описаны в разделе [«Связанные сущности»](../../admin/actions/overview/#связанные-сущности). + ## Ресурсы После добавления параметра для ресурса он будет отображаться у всех сущностей данного ресурса в их карточках и в таблице каталога. Для каждого параметра можно задать значение по умолчанию. Значение каждого параметра можно изменить для каждой сущности по отдельности. From 67efd5feb56f28d98f4cde12c52d399da2f83b7d Mon Sep 17 00:00:00 2001 From: Nikita Velgin Date: Thu, 5 Nov 2026 20:05:47 +0300 Subject: [PATCH 2/3] docs: update related entities documentation for v1.8.0 --- .../admin/actions/overview.ru.md | 83 +++++++++++++++---- .../documentation/admin/processes/store.ru.md | 14 ++++ .../documentation/release-notes/v1.7.0.ru.md | 1 - .../documentation/release-notes/v1.8.0.ru.md | 1 + content/documentation/user/properties.ru.md | 6 +- 5 files changed, 84 insertions(+), 21 deletions(-) diff --git a/content/documentation/admin/actions/overview.ru.md b/content/documentation/admin/actions/overview.ru.md index 6b4775bb..b1c8ff91 100644 --- a/content/documentation/admin/actions/overview.ru.md +++ b/content/documentation/admin/actions/overview.ru.md @@ -126,7 +126,7 @@ project_id: {{ .property.project_id }} Действие принимает только параметры, объявленные в пользовательской форме. Если при запуске, например из процесса или через API, передан параметр, которого нет в форме, запуск завершается ошибкой `action "" does not declare property `. {{< alert level="info" >}} -Если скрытый или нередактируемый параметр не заполняется автоматически, задайте значение по умолчанию. +Если обычный скрытый или нередактируемый параметр не заполняется автоматически, задайте значение по умолчанию. При запуске действия пользователь не сможет его изменить. {{< /alert >}} @@ -137,7 +137,8 @@ project_id: {{ .property.project_id }} #### Связанные сущности Параметр типа «RelatedEntities» получает данные напрямую связанных сущностей. -Он настраивается на вкладке «Параметры действия» и доступен при самостоятельном запуске и внутри процессов. +Он настраивается на вкладке «Параметры действия» и используется при самостоятельном запуске, +в процессах и сценариях. Для параметра доступны настройки: @@ -145,39 +146,87 @@ project_id: {{ .property.project_id }} - «Направление связи» — «Родители — сущность действия на стороне потомка» получает родителей, «Потомки — сущность действия на стороне родителя» — потомков. - «Тип связи» — связь ресурсов, по которой выбираются сущности. -- «Количество результатов» — «Любое» допускает любое количество сущностей, «Ровно одна сущность» — одну. +- «Количество результатов» — «Любое» допускает коллекцию, «Ровно одна сущность» требует один объект. При автоматическом заполнении проверяется количество совпадений после отбора, - при выборе пользователем — количество выбранных объектов. + при ручном выборе — количество выбранных объектов. - «Условия отбора» — необязательные условия для каждой связанной сущности. - В выражениях `.item` обозначает связанную сущность, `.entity` — сущность запуска. - Допустимые выражения перечислены в подсказке этого поля. + «Объединение условий» определяет, должны ли выполняться все условия или хотя бы одно. -По умолчанию параметр скрыт и получает все подходящие сущности автоматически. -Для выбора пользователем включите «Редактируемый параметр» и выключите «Скрытый параметр». +При создании параметр скрыт, нередактируем и получает все подходящие сущности автоматически. +Опции «Редактируемый параметр» и «Скрытый параметр» определяют способ заполнения: + +| Редактируемый параметр | Скрытый параметр | Заполнение при запуске | +| --- | --- | --- | +| Выключен | Любое значение | Автоматически передаются все подходящие сущности; переданное через API значение игнорируется | +| Включён | Выключен | Пользователь выбирает одну или несколько сущностей; первоначальный выбор пустой | +| Включён | Включён | Без переданного значения автоматически используются все подходящие сущности; переданный через API выбор проверяется и учитывается | + +Для ручного выбора включите «Редактируемый параметр» и выключите «Скрытый параметр». +Даже если подходит одна сущность, выберите её в форме запуска. При значении «Любое» обязательность выбора задаёт опция «Обязательный параметр»; при значении «Ровно одна сущность» выбор обязателен. +Для автоматического параметра опция «Обязательный параметр» выключена; +режим «Ровно одна сущность» всё равно требует ровно одно совпадение после отбора. + +При передаче редактируемого параметра через API укажите UUID строкой для «Ровно одна сущность» +или массив UUID для «Любое». Для скрытого редактируемого параметра отсутствие ключа означает +автоматическое заполнение, а явно переданное пустое значение — пустой выбор. +Некорректные, повторяющиеся, несвязанные и исключённые отбором UUID отклоняются. + +В условиях `.item` обозначает связанную сущность, `.entity` — сущность запуска. +Для сравнения с входными значениями доступны обычные параметры `.property`, параметры сценария +`.workflow`, процесса `.process`, контекст запуска `.context`, переменные `.global`, `.team` +и хранилище `.store`. Условия не могут обращаться к другим параметрам «RelatedEntities», +учётным данным или ответу действия. Например, для отбора по логическому параметру `primary` укажите `{{ .item.properties.primary }}` в поле «Проверяемое значение» и выберите операцию «Истина». -Кнопка «Проверить источник» позволяет проверить отбор без запуска действия и изменения параметров. +Чтобы отбирать по параметру запуска `environment`, сравните +`{{ .item.properties.environment }}` с `{{ .property.environment }}` на равенство. + +Нажмите «Проверить источник», выберите исходную сущность и нажмите «Показать связанные сущности». +Проверка показывает количество найденных и подходящих сущностей, результат отбора и JSON каждого объекта. +Она не запускает действие и не изменяет параметры сущностей. +Для проверки условий с входными значениями раскройте «Дополнительно: входные данные для проверки». +Для примера с `environment` задайте контекст: + +```json +{ + "property": { + "environment": "production" + } +} +``` + +Эти значения используются только для проверки отбора. -Результат параметра с идентификатором `related` доступен в `.property.related` и всегда является массивом. -В шаблонах можно читать поля `slug`, `name`, `uuid` и параметры в `properties`. +Результат параметра с идентификатором `related` доступен в `.property.related` и всегда является массивом, +в том числе при выборе одной сущности. Каждый объект содержит поля `slug`, `name`, `uuid` и `properties`. +При ручном выборе сохраняется порядок переданных UUID; автоматически полученная коллекция +упорядочена по идентификатору сущности, затем по UUID. Для переноса идентификатора и названия одной связанной сущности выберите «Ровно одна сущность». На вкладке «Обновление» активируйте переключатель «Включить обновление параметров» и добавьте правила: -| Источник | Параметр сущности | -| ---------------------------------------- | ----------------- | -| `{{ (index .property.related 0).slug }}` | `related_slug` | -| `{{ (index .property.related 0).name }}` | `related_name` | +| Источник | Параметр сущности | +| --- | --- | +| `{{ (index .property.related 0).slug }}` | `related_slug` | +| `{{ (index .property.related 0).name }}` | `related_name` | Целевые параметры должны быть объявлены в ресурсе исходной сущности. Правила применяются после успешного выполнения действия. Для записи всей коллекции как JSON-текста используйте источник `{{ .property.related | toJson }}`. +Для передачи массива следующим задачам настройте [запись в хранилище процесса](../processes/store/#сохранение-связанных-сущностей). Связанные сущности читаются с правами пользователя, запустившего действие. -Если хотя бы одна из них недоступна, действие завершается ошибкой. +Доступ проверяется до отбора: если хотя бы один кандидат недоступен, действие завершается ошибкой, +даже если условия исключили бы эту сущность. + +Данные загружаются перед выполнением действия. Его шаблоны, правила обновления сущности +и хранилища используют один снимок связанных данных. +После подтверждения, при следующем проходе цикла и при принудительном повторе шага +связи и права проверяются заново, а коллекция формируется из актуальных данных с учётом исходного выбора. +Автоматические повторы HTTP-запроса используют снимок текущего выполнения. #### Условия параметров @@ -191,7 +240,7 @@ project_id: {{ .property.project_id }} | Контекст | Описание | Пример | | ----------- | ------------------------------------------------------------------------ | ------------------------------------ | -| `.property` | Значения из пользовательской формы | `{{ .property.repo }}` | +| `.property` | Параметры действия, включая связанные сущности | `{{ .property.repo }}` | | `.response` | Разобранный ответ действия (JSON) | `{{ .response.id }}` | | `.entity` | Параметры сущности каталога, для которой выполняется действие | `{{ .entity.slug }}` | | `.workflow` | Параметры сценария | `{{ .workflow.branch }}` | diff --git a/content/documentation/admin/processes/store.ru.md b/content/documentation/admin/processes/store.ru.md index 087bde8a..eb15493f 100644 --- a/content/documentation/admin/processes/store.ru.md +++ b/content/documentation/admin/processes/store.ru.md @@ -94,6 +94,20 @@ params: | ------- | -------- | ---- | -------- | | | Удалить | `temp.payload` | | +### Сохранение связанных сущностей + +Чтобы передать результат параметра действия [«RelatedEntities»](../actions/overview/#связанные-сущности) +следующим задачам, включите «Включить обновление хранилища» и добавьте правило. +Для параметра с идентификатором `related` задайте: + +| Условие | Операция | Цель | Источник | +| --- | --- | --- | --- | +| — | Записать JSON | `relations.related` | `{{ toJson .property.related }}` | + +После успешного выполнения действия в `.store.relations.related` будет доступен массив объектов, +включая вариант с одной сущностью. Следующие задачи могут читать его поля или использовать массив +как коллекцию цикла. Правила обновления сущности и хранилища получают тот же снимок, что и шаблоны действия. + ### Панель «Контекст цикла» В редакторе правил действия доступна панель **Контекст цикла**: она показывает ключи контекста цикла (`_loop.item`, `_loop.index` и др.). Нажмите на ключ, чтобы вставить его в правило. diff --git a/content/documentation/release-notes/v1.7.0.ru.md b/content/documentation/release-notes/v1.7.0.ru.md index c89d7e1b..eb0415fe 100644 --- a/content/documentation/release-notes/v1.7.0.ru.md +++ b/content/documentation/release-notes/v1.7.0.ru.md @@ -97,7 +97,6 @@ ClickHouse появился в этом релизе. Чтобы продолж ### Действия -- Добавлен параметр типа [«RelatedEntities»](../../admin/actions/overview/#связанные-сущности): чтение связанных сущностей, выбор одной или нескольких при запуске и использование их данных в шаблонах действия. - Добавлен механизм автоматического [удаления сущностей](../../admin/actions/overview/#удаление-сущностей) после успешного выполнения действия. - Добавлен механизм автоматического [удаления связей сущности](../../admin/actions/overview/#удаление-связей-сущности) после успешного выполнения действия. - Добавлена [синхронизация источников данных](../../admin/actions/overview/#синхронизация-источников-данных) после успешного выполнения действия: объект, созданный или удалённый действием, появляется в каталоге без ожидания синхронизации по расписанию. diff --git a/content/documentation/release-notes/v1.8.0.ru.md b/content/documentation/release-notes/v1.8.0.ru.md index df7e360f..77473c0f 100644 --- a/content/documentation/release-notes/v1.8.0.ru.md +++ b/content/documentation/release-notes/v1.8.0.ru.md @@ -28,6 +28,7 @@ description: Рабочие пространства с IDE, AI-агентом - [Синхронизация внешних MCP-серверов](../user/mcp-management/#автоматическая-синхронизация) поддерживает расписание и сохраняет последний успешный каталог при ошибке. - [Статистика AI](../user/ai-statistics/) показывает использование агентов, моделей, MCP, навыков и рабочих пространств. - Элемент процесса [«Источник данных»](../admin/processes/overview/#источник-данных) запускает синхронизацию выбранных источников и продолжает процесс после её окончания. +- Параметр действия [«RelatedEntities»](../admin/actions/overview/#связанные-сущности) получает данные связанных сущностей автоматически или по выбору пользователя для использования в шаблонах и правилах действия. ## Улучшения diff --git a/content/documentation/user/properties.ru.md b/content/documentation/user/properties.ru.md index 1ca082b2..05ffb39a 100644 --- a/content/documentation/user/properties.ru.md +++ b/content/documentation/user/properties.ru.md @@ -22,7 +22,7 @@ description: Типы параметров каталога и форм, нас * «Users» — пользователи; * «YAML» — текст в YAML-формате. -Для параметров действий также доступен тип «RelatedEntities»: он получает непосредственно связанные сущности автоматически или позволяет выбрать одну либо несколько при запуске. Настройка и примеры описаны в разделе [«Связанные сущности»](../../admin/actions/overview/#связанные-сущности). +Для параметров действий также доступен тип «RelatedEntities»: он получает непосредственно связанные сущности автоматически или позволяет выбрать одну либо несколько при запуске. Настройка и примеры описаны в разделе [«Связанные сущности»](../admin/actions/overview/#связанные-сущности). ## Ресурсы @@ -53,9 +53,9 @@ description: Типы параметров каталога и форм, нас ## Конфигурация -Новый параметр в редакторе по умолчанию необязателен, доступен для редактирования и виден пользователю. Включите «Обязательный параметр», если его значение требуется для сохранения формы или запуска. Настройки задаются отдельно для каждого параметра: +Обычный параметр при создании необязателен, доступен для редактирования и виден пользователю. Параметр «RelatedEntities» создаётся скрытым и нередактируемым; способ заполнения задаётся в [настройках связанных сущностей](../admin/actions/overview/#связанные-сущности). Включите «Обязательный параметр», если его значение требуется для сохранения формы или запуска. Настройки задаются отдельно для каждого параметра: -* «Редактируемый параметр» — для каждого параметра можно настроить разрешение либо запрет редактирования пользователем. В случае запрета редактирования пользователь при запуске действий или сценариев не сможет изменить значение параметра, то есть всегда будет использоваться значение по умолчанию. +* «Редактируемый параметр» — для каждого параметра можно настроить разрешение либо запрет редактирования пользователем. Если редактирование обычного параметра запрещено, при запуске действия или сценария используется его значение по умолчанию. * «Обязательный параметр» — каждый параметр может быть обязательным либо опциональным. Значение обязательного параметра не может быть пустым при запуске действий, сценариев и процессов и при сохранении [формы сущности](../catalog/#создание-и-редактирование-сущности). Параметр типа «Boolean» всегда имеет значение. Значение опционального параметра может оставаться пустым без влияния на работоспособность действия. При создании и изменении сущности через API, источники данных и действия обязательность параметров ресурса не проверяется. * «Скрытый параметр» — скрытый параметр не отображается в таблицах и карточках сущностей, а также при запуске действий и сценариев. * «Показывать в упрощённой форме» — параметр отображается в упрощённой форме окна запуска процесса. Остальные параметры сохраняют значения по умолчанию и передаются при запуске. Обязательные параметры без значения отображаются в упрощённой форме независимо от этого признака. Признак доступен только для параметров процесса. From f5e906294c47eb1a4fd0f6082d99ebe25c1066b1 Mon Sep 17 00:00:00 2001 From: Nikita Velgin Date: Thu, 5 Nov 2026 20:25:52 +0300 Subject: [PATCH 3/3] fixes --- content/documentation/admin/actions/overview.md | 6 +++--- content/documentation/admin/actions/overview.ru.md | 8 ++++---- .../admin/examples/service-autoupdates.ru.md | 8 ++++---- content/documentation/user/templating.md | 2 +- content/documentation/user/templating.ru.md | 2 +- 5 files changed, 13 insertions(+), 13 deletions(-) diff --git a/content/documentation/admin/actions/overview.md b/content/documentation/admin/actions/overview.md index 27145d02..b96a3127 100644 --- a/content/documentation/admin/actions/overview.md +++ b/content/documentation/admin/actions/overview.md @@ -105,11 +105,11 @@ With this request body, the expression `{{ .property.project_id }}` is replaced For built-in actions, the "Request body" parameter is part of the action configuration, and a configuration example is available. -### User form +### Properties -#### Parameters +#### Property settings -The "User form" section specifies the parameters that the user can fill in when launching the action. Property types are described in the [Properties](../../user/properties/) section. +The "Properties" tab specifies the parameters that the user can fill in when launching the action. Property types are described in the [Properties](../../user/properties/) section. The following options are available for each parameter: diff --git a/content/documentation/admin/actions/overview.ru.md b/content/documentation/admin/actions/overview.ru.md index b1c8ff91..5d16cd7c 100644 --- a/content/documentation/admin/actions/overview.ru.md +++ b/content/documentation/admin/actions/overview.ru.md @@ -109,11 +109,11 @@ project_id: {{ .property.project_id }} Для встроенных типов действий параметр «Тело запроса» является конфигурацией действия, при этом доступен пример данной конфигурации. -### Параметры действия {#пользовательская-форма} +### Параметры -#### Параметры +#### Настройка параметров -На вкладке «Параметры действия» задаются параметры, доступные при запуске действия. Типы параметров описаны в разделе [«Параметры»](../../../user/properties/). +На вкладке «Параметры» задаются параметры, доступные при запуске действия. Типы параметров описаны в разделе [«Параметры»](../../../user/properties/). Для каждого параметра доступны опции: @@ -137,7 +137,7 @@ project_id: {{ .property.project_id }} #### Связанные сущности Параметр типа «RelatedEntities» получает данные напрямую связанных сущностей. -Он настраивается на вкладке «Параметры действия» и используется при самостоятельном запуске, +Он настраивается на вкладке «Параметры» и используется при самостоятельном запуске, в процессах и сценариях. Для параметра доступны настройки: diff --git a/content/documentation/admin/examples/service-autoupdates.ru.md b/content/documentation/admin/examples/service-autoupdates.ru.md index b3172c74..f085dfec 100644 --- a/content/documentation/admin/examples/service-autoupdates.ru.md +++ b/content/documentation/admin/examples/service-autoupdates.ru.md @@ -334,7 +334,7 @@ description: Настройка ресурсов, связи, источника - На вкладке «Основная информация» в поле «Ресурс» выбран ресурс, который содержит информацию о сервисах (действие запускается для сущности сервиса, который нужно обновить). -- На вкладке «Пользовательская форма» есть параметр «Идентификатор шаблонного репозитория» с идентификатором `template_ddp_slug` (или другим, если это необходимо) типа Entities — будет автоматически подставляться идентификатор сущности шаблона внутри DDP, из которого будет клонироваться код. В дополнительных настройках укажите: Ресурс: «Шаблоны», Связь: «Шаблоны-Сервисы», Поле: «Идентификатор». Это позволяет выбрать нужный шаблон из связанных сущностей. Данный параметр можно сделать скрытым. +- На вкладке «Параметры» есть параметр «Идентификатор шаблонного репозитория» с идентификатором `template_ddp_slug` (или другим, если это необходимо) типа Entities — будет автоматически подставляться идентификатор сущности шаблона внутри DDP, из которого будет клонироваться код. В дополнительных настройках укажите: Ресурс: «Шаблоны», Связь: «Шаблоны-Сервисы», Поле: «Идентификатор». Это позволяет выбрать нужный шаблон из связанных сущностей. Данный параметр можно сделать скрытым. - На вкладке «Обновление» активирована опция «Обновление параметров сущности» и настроено сохранение переменных, использованных при шаблонизации, обратно в сущность, для которой запускалось действие. @@ -362,7 +362,7 @@ description: Настройка ресурсов, связи, источника Проверьте, что на вкладке «Основная информация» в поле «Ресурс» выбран ресурс, который содержит информацию о сервисах. -Проверьте наличие следующих полей на вкладке «Пользовательская форма»: +Проверьте наличие следующих полей на вкладке «Параметры»: - Параметр «Переменные используемые при шаблонизации» с идентификатором `template_values` (или другим, если это необходимо) типа String — он хранит переменные, которые были использованы при изначальной шаблонизации (хранятся в параметре сущности). Значение по умолчанию: `{{ .entity.properties.template_values }}` — использует сохранённые переменные из параметра сущности. Если параметр называется иначе (например, `template_vars`), используйте соответствующий идентификатор. @@ -414,9 +414,9 @@ values: {{ .template_values | nindent 4 }} - «Команда владелец»: [Укажите команду владелец]. -#### Вкладка «Пользовательская форма» +#### Вкладка «Параметры» -На вкладке «Пользовательская форма» настройте поля для заполнения при запуске действия. Параметры, которые необходимо настроить, зависят от действия, которое вы создаёте. +На вкладке «Параметры» настройте поля для заполнения при запуске действия. Параметры, которые необходимо настроить, зависят от действия, которое вы создаёте. Для действия «Создать проект в GitLab» добавьте параметры: diff --git a/content/documentation/user/templating.md b/content/documentation/user/templating.md index 1c4d6e5b..5b037c47 100644 --- a/content/documentation/user/templating.md +++ b/content/documentation/user/templating.md @@ -418,7 +418,7 @@ where: - `property` — indicates that an action parameter is being accessed. - `` — the identifier of the parameter whose value should be substituted. -Parameter identifiers can be viewed on the "User form" tab in the action configuration window. +Parameter identifiers can be viewed on the [Properties](../admin/actions/overview/#properties) tab in the action configuration window. Usage examples: diff --git a/content/documentation/user/templating.ru.md b/content/documentation/user/templating.ru.md index 32a8516c..cdf82347 100644 --- a/content/documentation/user/templating.ru.md +++ b/content/documentation/user/templating.ru.md @@ -418,7 +418,7 @@ Deckhouse Development Portal (портал) поддерживает шабло - `property` — указывает на то, что идёт обращение к параметрам действия. - `` — идентификатор параметра, значение которого необходимо подставить. -Идентификаторы параметров можно посмотреть на вкладке «Пользовательская форма» в окне конфигурации действия. +Идентификаторы параметров можно посмотреть на вкладке [«Параметры»](../admin/actions/overview/#параметры) в окне конфигурации действия. Примеры использования: