Holkas
Написать в поддержку Поддержка

Справочник / часть объекта

Действие класса

Тип объекта в Holkas: ACT

Парус · Oracle и PostgreSQL

В командной строке: --object ACT:Request|Approve · как задать состав в CLI. Для файла пакета в наборе должен быть и сам объект «Класс»; в Git часть запишется, если его файл там уже есть

Действие КОР Парус 8: все поля, параметры, привязки методов, шаги, рёбра, ограничения и хранение в Git, S3 и файле пакета.

← К составу: Класс
На этой странице

Парус 8 · Конструктор отраслевых расширений

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

ИдентификаторACT + Класс|Действие
Три вложенные частиПараметры · привязки · шаги
Удаление действияНе формируется

Действие в КОР

Действие класса задаёт способ и последовательность вызова методов при работе с разделом. Например, у класса «Заявки» действие «Согласовать» получает идентификатор текущей записи и вызывает метод сохранения результата. Стандартные действия Паруса — добавление/размножение, исправление, удаление и другие; нестандартные реализуют прикладную логику разработчика.

ACT — описание действия Паруса на Oracle или PostgreSQL. Holkas записывает его настройки, параметры, привязки методов и шаги; само согласование заявок при переносе не выполняется. Настройка транзакции и асинхронного запуска относится к будущей работе действия в Парусе.

Действие принадлежит классу, но имеет отдельный адрес ACT:Класс|Код действия. Выбор класса раскрывает доступное семейство источника, включая действия. Выбор одного действия не означает включения всех упомянутых доменов, методов и других классов.

Что входит в перенос

Используются по ссылке: методы MET, методы вызова MEC, домены, атрибуты, пиктограммы и другие классы. Формы принадлежат CLS, даже когда назначены действию или его методу.
Удаление привязки Save из Methods не удаляет MET. Основной Method и список Methods — разные поля; наличие одного не заменяет другое.

Справочник полей

42 поля · 4 группы

Все поля ACT и его частей: 16 реквизитов и 3 списка действия, 12 полей параметра, 1 поле привязки метода и 10 полей шага. Имена Git YAML — с заглавной буквы, JSON обоих ZIP — со строчной.

Как читать обозначения и правила

Ключ узнаёт элемент внутри родителя; Часть ключа — составляющая адреса ACT; Сравнивается — разница учитывается в плане; По элементам — проверяются записи списка. Create создаёт, Update меняет, Delete удаляет, SetOrder закрепляет позиции.

При создании передаются все настройки. Update ACT, ACT.Param и ACT.Step передаёт весь набор полей соответствующей записи, а не только изменившееся поле. Парус проверяет сочетания и может отклонить команду целиком.

Действие · ACT19 полей
UnitCodeJSON: unitCodeстрокаЧасть ключаКод класса
Назначение
Класс, которому принадлежит действие, например Request. Вместе с Code образует адрес ACT.
При переносе:
Класс должен существовать в приёмнике. Другой UnitCode адресует действие другого класса, а не перемещает прежнее действие; старое не удаляется.
CodeJSON: codeстрокаЧасть ключаКод действия
Назначение
Код внутри класса, например Approve. Адрес объекта: Request|Approve.
При переносе:
Другое значение адресует другое действие. Если его нет, появится Create ACT; прежнее действие автоматически не удалится. Update не переименовывает код.
DetailCodeJSON: detailCodeстрока / nullСравниваетсяКод подраздела
Назначение
Подраздел для действия просмотра спецификации (Standard=10). Это код раздела, а не папка каталога.
При переносе:
Передаётся в Create / Update ACT. В исследованном Парусе для Standard=10 требуется непустое значение, для других типов — null. Отдельного ребра к подразделу нет.
NameJSON: nameстрокаСравниваетсяНаименование
Назначение
Название для человека, например «Согласовать», в меню действия.
При переносе:
Изменение даёт Update ACT: меняет подпись у того же Code. Штатная технология может запретить изменение этой настройки.
PositionJSON: positionцелоеСравниваетсяПозиция действия
Назначение
Место действия среди действий класса; это не порядок исполнения команд Holkas.
При переносе:
Передаётся в ACT. При переносе класса создание действия или смена позиции добавляют CLS.ActPos, закрепляющую позиции всех действий этого класса из переносимого набора. При одном ACT без CLS эту команду не обещаем.
StandardJSON: standardцелоеСравниваетсяТип действия
Назначение
0 — нестандартное; другие коды обозначают стандартные действия, например 1 — добавление/размножение, 2 — исправление, 3 — удаление. Полная шкала раскрывается ниже.
При переносе:
Передаётся в Create / Update ACT. Парус проверяет сочетание типа с методом, подразделом и режимами; простая смена числа не превращает действие в рабочую реализацию другого типа.
OverrideJSON: overrideцелое / nullСравниваетсяПереопределённый тип
Назначение
Тип стандартного поведения, переопределённого нестандартным действием. Применим при Standard=0.
При переносе:
Записывается вместе с остальными настройками ACT. Для стандартного действия исследованная БД требует null; null не равнозначен числу 0.
UncondAccessJSON: uncondAccessцелое / nullСравниваетсяБезусловная доступность
Назначение
Признак безусловной доступности действия в Парусе. Не означает выдачу прав на перенос в Holkas.
При переносе:
Передаётся в ACT; 1 — включено, 0 — выключено. Назначения прав пользователям и ролям не входят в модель ACT; правила штатной технологии могут отклонить изменение признака.
MethodJSON: methodстрока / nullСравниваетсяОсновной реализующий метод
Назначение
Код метода MET того же класса. Это ссылка на реализацию действия, а не коллекция его привязок Methods.
При переносе:
Create / Update ACT ждут Create MET названного метода, если такая команда есть. Отдельно включите нужный MET и физическую процедуру/функцию: запись кода сама их не создаёт.
ProcessModeJSON: processModeцелое / nullСравниваетсяРежим обработки
Назначение
0 — не зависит от записей; 1 — для одной текущей записи; 2 — для всех помеченных записей.
При переносе:
Меняет поведение будущего запуска в Парусе: например, 1→2 расширяет обработку с текущей записи на все помеченные. Тип действия ограничивает допустимое сочетание режимов.
TransactModeJSON: transactModeцелое / nullСравниваетсяФиксация при выполнении действия
Назначение
0 — после всех вызовов действия; 1 — после каждого вызова. Это настройка выполнения в Парусе.
При переносе:
Передаётся в ACT. Не включает единую транзакцию переноса Holkas. Например, для обработки помеченных записей режим 0 и режим 1 задают разную частоту фиксации будущего действия.
RefreshModeJSON: refreshModeцелое / nullСравниваетсяОбновление данных на экране
Назначение
0 — не обновлять; 1 — обновлять текущую запись; 2 — обновлять всю выборку после выполнения действия.
При переносе:
Меняет настройку ACT. Например, действие может изменить соседние записи, а RefreshMode=1 не требует обновления всей выборки клиента.
ShowDialogJSON: showDialogцелоеСравниваетсяПоказывать диалог
Назначение
Признак показа диалога действия: 1 — включено, 0 — выключено.
При переносе:
Меняется через ACT. Текст и устройство формы этим полем не переносятся: формы находятся в CLS.VisualForms.
SysImageJSON: sysImageстрока / nullСравниваетсяПиктограмма
Назначение
Код отдельной пиктограммы PIC. В базе считывается из SYSIMAGES; байты рисунка в ACT не входят.
При переносе:
Передаётся в ACT кодом. Непустой код ждёт Create PIC; если пиктограммы нет ни в наборе, ни в приёмнике, план называет её недостающей зависимостью. Без неё Парус отказывает в записи: «Пиктограмма … не определена».
OnlyCustomModeJSON: onlyCustomModeцелое / nullСравниваетсяТолько в режиме Конструктора
Назначение
Ограничивает использование действия режимом Конструктора Паруса: 1 — включено, 0 — выключено.
При переносе:
Записывается в ACT. Это не признак технологии записи и не способ обойти защиту штатного действия.
AsynchronExecJSON: asynchronExecцелое / nullСравниваетсяАсинхронное выполнение
Назначение
Признак асинхронного запуска действия в Парусе: 1 — включено, 0 — выключено.
При переносе:
Сохраняется через ACT. Holkas при переносе действие не запускает; ожидание и результат его будущего исполнения определяет Парус.
ParametersJSON: parametersсписокПо элементамПараметры действия
Назначение
Входные значения и способы их получения. Каждый параметр сопоставляется по Name.
При переносе:
Новые, изменённые и лишние записи дают ACT.Param. [] удаляет все прежние параметры этого действия; после создания или изменения параметра добавляется ACT.ParamPos.
MethodsJSON: methodsсписокПо элементамПривязки методов
Назначение
Ссылки на методы MET того же класса. Сами описания методов действию не принадлежат.
При переносе:
По Method формируются только Create/Delete ACT.Method. Снятие Save из списка убирает привязку Save, но не удаляет MET Request|Save. Учитывайте использующие её шаги и формы.
StepsJSON: stepsсписокПо элементамШаги выполнения
Назначение
Последовательность шагов, у каждого есть Position и свойства исполнения.
При переносе:
Сопоставляются по Position: новые позиции дают Create, исчезнувшие — Delete, изменённое содержимое занятой позиции — Update ACT.Step. [] удаляет все шаги, но не действие.
Параметр действия · ACT.Param12 полей
NameJSON: nameстрокаКлючИмя параметра
Назначение
Имя внутри текущего действия; например ID.
При переносе:
Замена ID на DocumentID, с удалением ID из списка, даёт Delete старого и Create нового параметра. Шаги с ExecParameter нужно переключить на новое имя.
DomainJSON: domainстрокаСравниваетсяДомен
Назначение
Мнемокод DOM, задающий тип значения параметра, например TRN.
При переносе:
Create / Update ACT.Param ждут Create DOM, если домен создаётся в том же плане. Смена домена передаётся процедуре Паруса вместе со всеми настройками параметра.
PositionJSON: positionцелоеСравниваетсяПозиция параметра
Назначение
Место параметра в списке действия. Не ключ: параметр узнаётся по Name.
При переносе:
Смена позиции даёт Update ACT.Param. Затем ACT.ParamPos расставляет весь список параметров из источника по Position. Перестановка элементов массива без изменения этих чисел не задаёт новый порядок.
DefaultStringJSON: defaultStringстрока / nullСравниваетсяЗначение: строка
Назначение
Строковое значение при LinkType=3, если домен строковый.
При переносе:
Передаётся в ACT.Param. В исследованной БД при LinkType=3 должно быть заполнено ровно одно из трёх полей значения; при других видах все три должны быть пусты.
DefaultNumberJSON: defaultNumberдесятичное / nullСравниваетсяЗначение: число
Назначение
Числовое значение при LinkType=3. Может быть дробным, например 1.75.
При переносе:
Сравнивается и записывается без округления: 1.75 и 1.25 — разные значения, и разница даёт Update ACT.Param.
DefaultDateJSON: defaultDateдата и время / nullСравниваетсяЗначение: дата
Назначение
Дата со временем при LinkType=3 и соответствующем домене.
При переносе:
Передаётся в ACT.Param. Время участвует в сравнении; null не означает «взять сегодняшнюю дату» и не пропускает запись.
LinkAttributeJSON: linkAttributeстрока / nullСравниваетсяСвязанный атрибут
Назначение
ColumnName атрибута CLS того же класса при LinkType=1.
При переносе:
Ссылка разрешается в приёмнике по имени. Create / Update ACT.Param ждут Create CLS.Attr. Если параметр удаляется или переходит на другой атрибут, прежний атрибут удаляется только после этого. Сам атрибут этим полем не создаётся.
LinkTypeJSON: linkTypeцелоеСравниваетсяСпособ получения значения
Назначение
0 — нет привязки; 1 — атрибут; 2 — контекст; 3 — заданное значение; 4 — результат функции; 5 — параметр метода вызова; 6 — локальная переменная.
При переносе:
Передаётся в ACT.Param. При смене вида согласуйте остальные поля: например, 2→1 требует LinkAttribute и пустого Context. Holkas не подставляет и не очищает их по этому числу.
ContextJSON: contextцелое / nullСравниваетсяЗначение из контекста
Назначение
Код источника контекста при LinkType=2: например 0 — первичный ключ, 3 — организация, 7 — пользователь. Перечень приведён ниже.
При переносе:
Передаётся в ACT.Param. 0 — настоящее значение, а не пустота; при другом LinkType поле должно быть пустым. Контекст определяется при запуске действия, не при его переносе.
LinkedFunctionJSON: linkedFunctionстрока / nullСравниваетсяМетод вычисления значения
Назначение
Код метода MET этого класса, возвращающего значение при LinkType=4. Не имя SQL-функции.
При переносе:
Create / Update ACT.Param ждут Create MET. Текст реализации и параметры метода переносятся в собственном MET и объекте БД; ACT.Param их не копирует.
SmParameterJSON: smParameterстрока / nullСравниваетсяПараметр метода вызова
Назначение
Имя параметра текущего метода вызова при LinkType=5.
При переносе:
Передаётся как имя в ACT.Param. Явного ребра к MEC.Param нет: проверьте соответствие имени нужному контексту вызова, особенно после переименования параметров.
SmVariableJSON: smVariableстрока / nullСравниваетсяЛокальная переменная
Назначение
Имя локальной переменной метода вызова при LinkType=6.
При переносе:
Передаётся в ACT.Param. Переменная и её инициализация принадлежат MEC, автоматического ребра к MEC.Var для этого имени нет.
Привязка метода · ACT.Method1 полей
MethodJSON: methodстрокаКлючКод метода класса
Назначение
Код MET этого класса, включённого в действие; например Save.
При переносе:
Смена кода в списке означает Delete старой привязки и Create новой; Update ACT.Method не бывает. Создание привязки ждёт Create MET. Определение MET и его реализующая процедура остаются отдельными объектами.
Шаг действия · ACT.Step10 полей
PositionJSON: positionцелоеКлючПозиция шага
Назначение
Номер шага внутри действия. В отличие от позиции параметра, является ключом.
При переносе:
Для шагов 1:Check, 2:Save обмен содержимым позиций даёт два Update. Перенос строки с позиции 2 на новую 3 может дать Delete 2 и Create 3; отдельного SetOrder шагов нет.
StepTypeJSON: stepTypeцелоеСравниваетсяТип шага
Назначение
0 — выполнить действие; 1 — открыть раздел; 2 — выполнить метод действия (Парус от 06.11.2025).
При переносе:
Передаётся в ACT.Step. Для вида 2 нужен ExecMethod, для открытия — метод вызова или функция. Разрешённый набор ссылок проверяет Парус; простая замена типа без согласования полей может быть отклонена.
ShowUnitCodeJSON: showUnitCodeстрока / nullСравниваетсяКласс открываемого раздела
Назначение
Код класса для поиска ShowMethodName.
При переносе:
Holkas получает по коду UnitName приёмника и передаёт это имя процедуре Паруса. Create / Update шага ждут Create CLS. Класс и его метод вызова нужно включить отдельно, если их нет в приёмнике.
ShowMethodNameJSON: showMethodNameстрока / nullСравниваетсяМетод вызова открываемого раздела
Назначение
Код MEC в классе ShowUnitCode. Это не основной MET действия.
При переносе:
При обоих непустых полях ShowUnitCode и ShowMethodName шаг ждёт Create MEC. При смене ссылки используется пара из источника; Update MEC сам по себе шаг не задерживает.
ShowKindJSON: showKindцелое / nullСравниваетсяРежим открытия
Назначение
0 — обычный; 1 — модальный; 2 — как словарь.
При переносе:
Передаётся в ACT.Step. Настройка задаёт вид будущего открытия раздела в Парусе; Holkas окна при переносе не открывает.
ShowParametersJSON: showParametersстрока / nullСравниваетсяПараметры открытия
Назначение
Текст параметров, передаваемых при открытии раздела.
При переносе:
Передаётся целиком. Holkas не разбирает произвольный текст для построения дополнительных зависимостей; null передаётся в процедуру, которая в исследованной БД сохраняет пустой длинный текст.
ExecParameterJSON: execParameterстрока / nullСравниваетсяИсполняемый параметр действия
Назначение
Имя параметра этого ACT, используемого шагом.
При переносе:
Новая ссылка ждёт Create ACT.Param. При смене или очистке старой ссылки Update шага, как и его Delete, должен выполниться до Delete прежнего параметра.
FunctionNameJSON: functionNameстрока / nullСравниваетсяФункция открытия
Назначение
Имя функции для шага открытия раздела; поле существует с 26.12.2024.
При переносе:
Передаётся в ACT.Step на поддерживающем релизе. Автоматического ребра к физической функции по этому полю нет. Её код не переводится между Oracle и PostgreSQL.
FunctionParameterJSON: functionParameterстрока / nullСравниваетсяПараметры функции
Назначение
Текст параметров FunctionName; с 26.12.2024.
При переносе:
Передаётся целиком, без разбора внутренних ссылок. Непустое значение для более старого приёмника отмечается как потеря: команда шага исключается до решения пользователя.
ExecMethodJSON: execMethodстрока / nullСравниваетсяМетод данного действия
Назначение
Код метода из Methods этого же действия для StepType=2; с 06.11.2025. Это ссылка на ACT.Method, не только на MET.
При переносе:
Создание или изменение шага ждёт Create ACT.Method новой привязки. Шаг, который меняет или очищает ExecMethod либо удаляется, выполняется раньше Delete ACT.Method прежней привязки: внешний ключ Паруса не даёт удалить привязку, пока на неё ссылается шаг.
Типы Standard и переопределение Override

Проверенная шкала Паруса 27.08.2026. Override — код переопределяемого стандартного типа только при Standard=0. Эти числа не команды Holkas.

КодТип действия
0Нестандартное
1Добавление/размножение
2Исправление
3Удаление
4Перемещение в каталог
5Перемещение из каталога
6Перемещение в иерархии
7Заполнение на основе данных раздела
8Перенос в Microsoft Excel
9Экспорт
10Просмотр спецификации
11Открытие раздела
12Формирование ЭП
13Проверка ЭП
14Удаление ЭП
15Файловый экспорт
16Файловый импорт
17Снятие контроля связей
18Восстановление контроля связей

Допустимые режимы зависят от типа: например, Standard=10 требует DetailCode; для ряда стандартных типов Парус требует определённые ProcessMode и RefreshMode. Не меняйте только тип, оставляя настройки другого действия.

Контекст параметра и выбор значения

При LinkType=2 Context задаёт: 0 — первичный ключ; 1 — первичный ключ мастера; 2 — каталог; 3 — организация; 4 — версия; 5 — код раздела; 6 — код родительского раздела; 7 — пользователь; 8 — пустое значение; 9 — идентификатор помеченных записей; 10 — код мастер-раздела. В проверенном ограничении БД допустим также 11, но его название в словаре TDMSCONTEXT не найдено: сохраняйте код своего экспорта, не назначайте его по догадке.

Какие поля нужны выбранному LinkType

При LinkType=3 заполнено ровно одно из DefaultString / DefaultNumber / DefaultDate, остальные пусты. При другом виде все три пусты. Для LinkType=1 нужен LinkAttribute, для 4 — LinkedFunction, для 5 — SmParameter, для 6 — SmVariable. Например, смена контекста на атрибут требует очистить Context и указать LinkAttribute; иначе Парус может отклонить ACT.Param.

Пустые значения, списки и сравнение текста

null передаётся процедуре и не означает «сохранить прежнее значение». Допустимость зависит от поля и остальных настроек. Число 0 — настоящее значение: Context=0 означает первичный ключ, ProcessMode=0 — независимость от записей.

При сравнении текста null и пустая строка считаются равными, окончания CRLF/LF не различаются. Регистр и пробелы учитываются. Это правило не доказывает одинаковое разрешение пустой ссылки процедурой Паруса.

Список [] означает отсутствие всех элементов части и может дать удаления. При чтении JSON наличие обязательных parameters, methods, steps проверяется: отсутствие или null отклоняются. При чтении YAML позиционные записи создаются иначе, и та же диагностика неполного файла не гарантируется; сохраняйте полные списки экспорта.

Команды плана

Пять собственных кодов. Порядок самих действий класса задаёт CLS.ActPos; ACT.ParamPos отвечает только за параметры одного действия.

Действие и его части5 кодов
ACT
CreateUpdate

Настройки действия

Create — адреса ещё нет; Update — изменились собственные реквизиты. Записываются настройки без исполнения действия. Изменения одних частей корневую команду не добавляют. Удаления целого ACT нет.

Ключ: Класс|Действие

ACT.Param
CreateUpdateDelete

Параметр действия

Создаёт новый параметр, меняет поля совпавшего Name или удаляет параметр, отсутствующий в источнике. После Create/Update параметров появляется ACT.ParamPos.

Ключ: Класс|Действие|Имя параметра

ACT.Method
CreateDelete

Привязка метода

Включает MET в действие или убирает привязку. Собственных изменяемых полей нет, Update не формируется; MET не удаляется.

Ключ: Класс|Действие|Код метода

ACT.Step
CreateUpdateDelete

Шаг действия

Создаёт новую позицию, меняет свойства занятой позиции или удаляет лишний шаг. Изменение позиции не отдельное перемещение. Поздние поля проверяются по релизу приёмника.

Ключ: Класс|Действие|Позиция

ACT.ParamPos
SetOrder

Порядок параметров

Возникает при хотя бы одном Create или Update ACT.Param, после всех команд параметров, включая Delete. Расставляет весь список из источника по Position, сначала уводя записи во временный диапазон. Только удаления эту команду не добавляют.

Ключ: Класс|Действие

Пример: убрать метод из действия

У учебного Request|Approve привязаны Check и Save. В источнике оставили только Check; шагов и форм, использующих привязку Save, нет. План содержит Delete ACT.Method Request|Approve|Save. Сам MET:Request|Save остаётся и может использоваться другим действием.

Если шаг 1 использовал ExecMethod=Save и в источнике переключён на Check, план выполняет замену за один перенос: Create ACT.Method …|Check → Update ACT.Step …|1 → Delete ACT.Method …|Save.

Ограничения и решения

Права и штатная технология

В ACT нет назначений прав, ролей и поля технологии TECHNOLOGY. Применение идёт через процедуры Конструктора; Парус проверяет технологию записи и может отклонить защищённые изменения. Совпадение кода со штатным действием не превращает его в пользовательское. Изменение доступности не переносит назначения прав источника.

Поздние поля и старый приёмник

FunctionName / FunctionParameter доступны с 26.12.2024, ExecMethod — с 06.11.2025. Если старый приёмник не хранит непустое поле, команда шага исключается с предупреждением. Её можно включить явно, согласившись на потерю поля; старые процедуры его не получат, остальные настройки всё ещё могут быть недопустимы. StepType=2 сам по себе не помечен как позднее поле: число без ExecMethod не доказывает поддержку нового вида шага старой базой.

Источник не знает позднего поля

Если источник старше поля, Holkas берёт его из приёмника у шага с той же Position. Например, у шага 1 может сохраниться функция новой базы, неизвестная старому источнику. У новой позиции брать значение неоткуда. Перенумерация меняет это сопоставление. Релизы и границы проверки →

Перестановка и удаление шагов

Шаг узнаётся по позиции. При обмене шагов 1 и 2 проверьте оба Update: это замена содержимого двух мест. Удаление уплотняет список средствами Паруса; отдельной ACT.StepPos нет. Правка номера в JSON не является простым перемещением одной записи.

Привязка метода ещё используется

Пока шаг ссылается на привязку через ExecMethod, Парус не удаляет её. Поэтому шаги, которые меняют, очищают ExecMethod или удаляются, идут в плане раньше удаления прежней привязки. Формы Действие|Метод принадлежат CLS: их ссылки тоже нужно согласовать, они не удаляются вместе с ACT.Method автоматически.

Новая пиктограмма

ACT.SysImage ждёт Create PIC. Если пиктограммы нет в приёмнике и она не выбрана, план называет её недостающей зависимостью; после добавления в набор она запишется раньше действия. Без неё Парус отказывает в записи: «Пиктограмма … не определена».

Дробное значение параметра

DefaultNumber переносится с дробной частью на обеих СУБД, без округления.

Параметры со снятыми командами

ACT.ParamPos закрепляет весь список из источника. При снятии отдельных команд список приёмника может отличаться от списка источника; согласованного порядка нельзя обещать по наличию одного SetOrder. При отказе уже выполненные команды в обычном режиме сохраняются; единая транзакция переноса имеет другие правила отката.

Рёбра команд

Что такое ребро и где оно видно в Holkas →

Рёбра помогают Holkas правильно отсортировать команды перед применением. Ребро связывает две команды и указывает, какая должна выполниться раньше. Например, шаг «выполнить метод действия» ждёт включения метода в действие.

1 · СначалаВключить метод в действиеCreate ACT.Method
→
2 · ЗатемСоздать использующий его шагCreate ACT.Step
ExecMethod ссылается на привязку в Methods того же действия. Создание одного MET не заменяет её.

30 правил: части ACT, прямые потребители, общие правила и связи с удалением целых объектов. Это виды правил, а не число рёбер каждого плана. Существующий домен без команды создания не добавляет Create DOM.

Действие3 правил
Create CLS→Create ACT

Когда: Создаётся действие класса.

Класс должен существовать до действия.

Create MET→Create / Update ACT

Когда: Method непустой; метод того же UnitCode.

Подготовить основной метод до назначения действию. Update MET здесь не ожидается.

Create PIC→Create / Update ACT

Когда: SysImage непустой.

Парус принимает пиктограмму кодом и записывает действие только с существующей. Update PIC здесь не ожидается.

Параметры и их позиции6 правил
Create ACT→Create ACT.Param

Когда: Добавляется параметр.

Создать действие до его параметра; его Update не ожидается.

Create DOM→Create / Update ACT.Param

Когда: Domain задаёт домен.

Подготовить домен до записи параметра.

Create CLS.Attr→Create / Update ACT.Param

Когда: LinkAttribute непустой.

Подготовить атрибут того же класса.

Create MET→Create / Update ACT.Param

Когда: LinkedFunction непустой.

Подготовить метод вычисления того же класса.

Delete / Update ACT.Param→Delete CLS.Attr

Когда: Параметр удаляется или его LinkAttribute сменился либо очищен, а прежний атрибут удаляется.

Внешний ключ DMSCLACTIONSPRM.LINK_ATTR не даёт удалить атрибут, пока параметр на него ссылается.

Create / Update / Delete ACT.Param→SetOrder ACT.ParamPos

Когда: Есть хотя бы один Create или Update параметра; ребро от всех команд параметров, включая Delete.

Закрепить позиции после изменений. Только удаления не добавляют SetOrder.

Привязки методов2 правил
Create ACT→Create ACT.Method

Когда: Создаётся привязка.

Действие должно существовать.

Create MET→Create ACT.Method

Когда: Method — код метода того же класса.

Сначала зарегистрировать метод, затем включить его в действие.

Шаги8 правил
Create ACT→Create ACT.Step

Когда: Создаётся шаг.

Сначала создать действие.

Create ACT.Param→Create / Update ACT.Step

Когда: ExecParameter непустой.

Подготовить параметр этого действия.

Create ACT.Method→Create / Update ACT.Step

Когда: ExecMethod непустой.

Метод должен быть привязан к действию; одного MET недостаточно.

Create CLS→Create / Update ACT.Step

Когда: ShowUnitCode непустой.

Подготовить класс открываемого раздела.

Create MEC→Create / Update ACT.Step

Когда: ShowUnitCode и ShowMethodName непустые.

Подготовить метод вызова открываемого раздела.

Update / Delete ACT.Step→Delete ACT.Param

Когда: Старый ExecParameter непустой и отличается от значения в источнике; либо шаг удаляется.

Все использовавшие параметр шаги должны освободить его до удаления.

Delete ACT.Step→Create / Update ACT.Step

Когда: Команды удаления и создания/изменения шагов одного действия есть в плане.

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

Update / Delete ACT.Step→Delete ACT.Method

Когда: Старый ExecMethod непустой и отличается от значения в источнике; либо шаг удаляется.

Все использовавшие привязку шаги должны освободить её до удаления.

Непосредственные потребители4 правил
Create ACT→Create / Update CLS.VF

Когда: Form называет действие без разделителя |.

Зарегистрировать действие перед привязкой формы.

Create ACT.Method→Create / Update CLS.VF

Когда: Form имеет вид Действие|Метод.

Сначала включить метод в действие, затем назначить форму.

Create / Update ACT→Create / Update CLS.VF

Когда: В FormData / FormDataExt распознана ссылка ContentDocumentAction; класс — из ссылки или самой формы.

Подготовить действие кнопки. Если тело в источнике null, берётся текущее. Произвольные обработчики не разбираются.

Create / Update ACT→SetOrder CLS.ActPos

Когда: Строятся команды CLS, есть новое действие или смена Position; список действий класса в переносимом наборе непустой. Рёбра от Added→Create и Modified→Update.

Закрепить порядок действий класса. Только порядок: снятие/ошибка ACT не распространяется; изменение одних частей может не дать корневую команду.

Общие правила4 правил
SCR Before→ACT / ACT.Param / ACT.Method / ACT.Step / ACT.ParamPos

Когда: Приёмник исполняет скрипты; область включает это действие, его класс или весь перенос.

Скрипт выполняется до команд. Без обычных команд охраняемых объектов он в план не входит.

ACT / ACT.Param / ACT.Method / ACT.Step / ACT.ParamPos→SCR After

Когда: Та же область; время — After.

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

Create / Update зависимости Oracle→Команда ACT или части с прямой ссылкой

Когда: Целевой корень не меняется, но это объект Oracle с сохранённым списком зависимостей (пакет, представление, функция или процедура), и он присутствует в сравнении.

Зависимости продолжаются и через неизменившиеся объекты. Обычные CLS, DOM, MET, MEC такого списка не имеют; одно FunctionName такого ребра не даёт.

Create / Update JTB.Col→Та же команда ACT или части

Когда: Обход предыдущего правила нашёл JTB; в плане есть команды её колонок.

Дождаться новых или изменяемых колонок. Это условное общее правило, а не автоматический разбор SQL из ACT.

Связи, не возникающие в обычном плане3 правил
Delete / Update ACT.Param→Delete ACT / MET

Когда: Delete — для своего действия и метода из текущего LinkedFunction; Update — для прежнего LinkedFunction, если он сменился или очищен.

Правило задано, но удаления этих целых объектов в обычном плане не возникают.

Delete ACT.Method→Delete ACT / MET

Когда: Своё действие и привязанный метод.

Зарезервированная связь не разрешает удалять весь метод по отсутствию привязки.

Delete ACT.Step→Delete ACT / CLS / MEC

Когда: Своё действие и открываемые ShowUnitCode / ShowMethodName.

Удалений этих целых объектов в обычном плане нет; шаг не удаляет открываемый раздел.

Границы зависимостей

Обычные рёбра связывают также выбор и отказ команд; CLS.ActPos влияет только на порядок. Недостающие объекты включаются по доступным зависимостям и выбранному режиму; поле-ссылка не означает, что объект уже едет.

Рёбер для ACT.SysImage, DetailCode, SmParameter, SmVariable, FunctionName и ссылок внутри ShowParameters / FunctionParameter нет. Разбор произвольной программы не обещается. UNITFUNC не входит в ObjectTables, поэтому общего ребра DAT.Row → ACT по коду действия здесь нет.

Как действие хранится в файлах

Git

YAML внутри класса
Class/Request.yaml

Действие — в Actions, внутри Parameters, Methods, Steps. Имена полей с заглавной буквы. В корне репозитория — .holkas.

S3

Отдельный JSON в ZIP
Action/Request%7CApprove.json

Само действие с parameters, methods, steps. manifest.json перечисляет ACT отдельно. Архив устроен так же, как у «Файла пакета».

Файл пакета

Отдельный JSON в ZIP
Action/Request%7CApprove.json

Само действие с parameters, methods, steps. manifest.json перечисляет ACT отдельно; %7C заменяет | в имени файла.

Во всех трёх вариантах параметры, привязки и шаги вложены в действие. Нет отдельных файлов ACT.Param или ACT.Step. DOM, MET, MEC и PIC — отдельные объекты; ссылка на них не означает, что они сохранены в выгрузке.

Один ACT без класса и ZIP прежних версий

Git при сохранении одного дочернего объекта использует уже существующий файл класса: заменяет пришедшее действие, сохраняя остальных детей. Если файла класса нет и создание CLS не входит в перенос, Git отказывает и просит добавить класс. Выгрузка класса целиком собирает файл из выбранного семейства.

S3 и «Файл пакета» сохраняют один ACT без CLS отдельным файлом и читают его обратно. Для применения в БД класс всё равно должен существовать в приёмнике или создаваться в том же переносе.

ZIP, записанные в S3 версией Holkas 0.1.30 или более ранней, хранили действие в списке actions внутри Class/Request.json. Такие архивы по-прежнему читаются и через S3, и через «Файл пакета».

Одно действие в Git YAML и JSON

Сокращённые учебные фрагменты для чтения, не готовые файлы для загрузки. Большинство реквизитов и частей опущено; [] нельзя использовать как обозначение пропуска. Для правки сохраняйте полный экспорт.

Git — фрагмент Class/Request.yaml:

UnitCode: Request
Actions:
  - UnitCode: Request
    Code: Approve
    Name: Согласовать
    Method: Save
    Methods:
      - Method: Save
    Steps:
      - Position: 1
        StepType: 2
        ExecMethod: Save

S3 или «Файл пакета» — фрагмент Action/Request%7CApprove.json:

{
  "unitCode": "Request",
  "code": "Approve",
  "name": "Согласовать",
  "method": "Save",
  "methods": [{ "method": "Save" }],
  "steps": [{ "position": 1, "stepType": 2, "execMethod": "Save" }]
}

Действие лежит в собственном файле, без внешнего списка actions. Параметры — в Parameters / parameters рядом с Methods / methods; в этих фрагментах они опущены.

У ACT нет поля папки, поиска или создания каталога Паруса. DetailCode — код подраздела. Class/ и Action/ — каталоги файлов, не дерево папок исходной базы.

Практические шаги: сохранить доработку в Git, выгрузить и загрузить файл пакета. Устройство ZIP — в справке о пакете.

Основа справки: руководство КОР Парус 8, издание 2026, с. 33–35; текущие DTO, экстракторы Oracle/PostgreSQL, сравнение, построители, исполнители и писатели/читатели Holkas 0.1.30. Режимы и ограничения уточнены чтением SQL Паруса 27.08.2026 на PostgreSQL 14. Сверено 8 ноября 2026; хранение в ZIP уточнено 9 ноября 2026. Request, Approve, Save — учебные примеры. Свежие проверки: локальные планы и форматы; перенос класса с ACT из S3 через «Файл пакета» и одиночного ACT через S3 на PostgreSQL и Oracle. Клиенты Паруса не проверялись.