Парус 8 · Конструктор отраслевых расширений
Действие определяет, что пользователь может сделать в разделе и как вызываются методы класса: например, согласовать текущую заявку, получить параметры и открыть связанный раздел.
ACT + Класс|ДействиеДействие в КОР
Действие класса задаёт способ и последовательность вызова методов при работе с разделом. Например, у класса «Заявки» действие «Согласовать» получает идентификатор текущей записи и вызывает метод сохранения результата. Стандартные действия Паруса — добавление/размножение, исправление, удаление и другие; нестандартные реализуют прикладную логику разработчика.
ACT — описание действия Паруса на Oracle или PostgreSQL. Holkas записывает его настройки, параметры, привязки методов и шаги; само согласование заявок при переносе не выполняется. Настройка транзакции и асинхронного запуска относится к будущей работе действия в Парусе.
Действие принадлежит классу, но имеет отдельный адрес ACT:Класс|Код действия. Выбор класса раскрывает доступное семейство источника, включая действия. Выбор одного действия не означает включения всех упомянутых доменов, методов и других классов.
Что входит в перенос
Справочник полей
42 поля · 4 группыВсе поля ACT и его частей: 16 реквизитов и 3 списка действия, 12 полей параметра, 1 поле привязки метода и 10 полей шага. Имена Git YAML — с заглавной буквы, JSON обоих ZIP — со строчной.
Как читать обозначения и правила
Наведите указатель, перейдите к значку клавишей Tab или нажмите его для пояснения.
Ключ узнаёт элемент внутри родителя; Часть ключа — составляющая адреса 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 прежней привязки: внешний ключ Паруса не даёт удалить привязку, пока на неё ссылается шаг.
Команды плана
Пять собственных кодов. Порядок самих действий класса задаёт CLS.ActPos; ACT.ParamPos отвечает только за параметры одного действия.
Действие и его части5 кодов
ACTНастройки действия
Create — адреса ещё нет; Update — изменились собственные реквизиты. Записываются настройки без исполнения действия. Изменения одних частей корневую команду не добавляют. Удаления целого ACT нет.
Ключ: Класс|Действие
ACT.ParamПараметр действия
Создаёт новый параметр, меняет поля совпавшего Name или удаляет параметр, отсутствующий в источнике. После Create/Update параметров появляется ACT.ParamPos.
Ключ: Класс|Действие|Имя параметра
ACT.MethodПривязка метода
Включает MET в действие или убирает привязку. Собственных изменяемых полей нет, Update не формируется; MET не удаляется.
Ключ: Класс|Действие|Код метода
ACT.StepШаг действия
Создаёт новую позицию, меняет свойства занятой позиции или удаляет лишний шаг. Изменение позиции не отдельное перемещение. Поздние поля проверяются по релизу приёмника.
Ключ: Класс|Действие|Позиция
ACT.ParamPosПорядок параметров
Возникает при хотя бы одном 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 правильно отсортировать команды перед применением. Ребро связывает две команды и указывает, какая должна выполниться раньше. Например, шаг «выполнить метод действия» ждёт включения метода в действие.
Create ACT.MethodCreate ACT.Step30 правил: части 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 в ZIPAction/Request%7CApprove.jsonСамо действие с parameters, methods, steps. manifest.json перечисляет ACT отдельно. Архив устроен так же, как у «Файла пакета».
Файл пакета
Отдельный JSON в ZIPAction/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. Клиенты Паруса не проверялись.