Описание инструментов MCP:RSV Server

Создаёт любой объект метаданных со всеми свойствами по умолчанию (такими же, как при создании через мастер EDT). Поддерживаемые типы (более 30): справочники, документы, обработки, отчёты, перечисления, регистры (сведений, накопления, бухгалтерии, расчёта), планы счетов, планы видов характеристик и расчёта, бизнес-процессы, задачи, планы обмена, общие модули, общие формы, общие команды, подсистемы, роли, константы, параметры сеансов, регламентные задания, функциональные опции и параметры функциональных опций, определяемые типы, XDTO-пакеты, подписки на события и другие. При создании регистров можно сразу задать измерения, ресурсы и документы-регистраторы. Для справочников, документов, обработок и отчётов — сразу же реквизиты и табличные части с колонками (параметры attributes и tabularSections). Для общих модулей — флаги контекста исполнения (server, serverCall, clientManagedApplication, privileged, global, returnValuesReuse и др.) прямо в вызове: агент получает модуль с нужными галочками, без ручной правки в EDT. Для подписки на событие — источник (один тип или массив типов), имя события (ОбработкаПроведения / Posting, ПриЗаписи / OnWrite и т.д.) и обработчик ОбщийМодуль.Метод; сразу после создания в указанный общий модуль автоматически дописывается процедура-заглушка с правильной сигнатурой (первым параметром идёт Источник, остальные — по описанию события) и пометкой Экспорт — агенту остаётся только написать тело. Для подсистем поддерживается путь с родителем: Subsystem.Продажи.Subsystem.Документы создаёт «Документы» как вложенную подсистему внутри «Продажи», на любую глубину вложенности. Для HTTP-сервиса — корневой URL (rootURL) и сразу массив URL-шаблонов через urlTemplates, каждый шаблон со своими HTTP-методами и именами обработчиков: пустой сервис → готовый REST-API за один вызов, с процедурами-заглушками в модуле сервиса. Для регламентного задания — сразу все свойства (метод, использование, ключ, предопределённость, повторы при аварийном завершении) и готовое расписание, описываемое теми же понятиями, что окно «Расписание» в свойствах задания: периодичность в днях и неделях, дни недели, месяцы, повтор в течение дня и дневные интервалы; типовые случаи — «каждый день в 03:00», «по будням каждые 30 минут» — собраны в справке help topic=schedule, а если указанного общего модуля в конфигурации нет — ранний отказ с подсказкой вместо ошибки при обновлении базы. Всё создаётся одним вызовом — справочник с пятью реквизитами не требует шести отдельных запросов. Обязательные параметры для специфичных типов проверяются на входе — например, функциональная опция не создастся без ссылки на константу-хранилище; подписка — без указания события, которое реально есть у всех указанных источников.

Изменение свойств объекта: иерархия, тип кода, длина кода, длина наименования (descriptionLength), проведение, формы по умолчанию, периодичность регистра, картинка подсистемы и т.д. Картинки принимаются в двух форматах: стандартные (CreateFolder) и общие картинки конфигурации (CommonPicture.МояКартинка). Поддерживает и ссылочные свойства: owners — сделать справочник подчинённым (например, плану видов характеристик), characteristicExtValues — привязать к плану видов характеристик справочник дополнительных значений характеристик, extDimensionTypes — связать план счетов с планом видов характеристик, где описаны виды субконто (вместе с maxExtDimensionCount — лимит видов субконто на счёт), distributedInfoBase — пометить план обмена как распределённую информационную базу (РИБ). Пакетный режим, русские и английские значения. При неизвестном имени свойства инструмент подсказывает самые близкие по написанию существующие свойства — защита от опечаток и созвучных имён. Расписание существующего регламентного задания задаётся, заменяется и снимается этой же операцией — ошибочные значения (день недели 8, время «25:00») отклоняются с точным указанием причины и не портят текущее расписание.

Добавление реквизитов на объекты всех типов, у которых они вообще бывают: справочники, документы, обработки, отчёты, все 4 вида регистров, планы счетов, планы видов характеристик и расчёта, бизнес-процессы, задачи, планы обмена. Тип данных можно не указывать — по умолчанию ставится Строка длиной 10, как при нажатии кнопки «+ Реквизит» в EDT. Принимаются все примитивы (включая ХранилищеЗначения, ДвоичныеДанные, УникальныйИдентификатор, ТабличныйДокумент), ссылочные типы и определяемые типы (DefinedType.X / ОпределяемыйТип.X). Имена типов работают и по-русски, и по-английски. Пакетный режим. Идемпотентно: повторный вызов с тем же именем не создаёт дубль — возвращается alreadyExists: true и skipped: [...]. Если при повторе переданы другие свойства (длина, тип, заголовок), существующий реквизит не переписывается молча — в ответе появляется propertyMismatch с парами requested / existing и подсказкой, что для обновления свойств используется setObjectProperty. То же поведение у addTabularSection, addTabularSectionAttribute, addEnumValue, addRegisterField.

Составной тип сразу при создании. Реквизит «и контрагент, и физлицо» заводится одним вызовом — список типов передаётся параметром types, у каждого своя длина строки, точность числа и состав даты. Работает и внутри пакетного создания объекта через createObject, и для колонок табличных частей, полей регистров и реквизитов формы. Принимаются обобщённые записи «СправочникСсылка», «ДокументСсылка», «ЛюбаяСсылка» (и их английские варианты), а также ссылка на сам создаваемый объект — например, договор с реквизитом «главный договор» собирается за один вызов. Признак «Неотрицательное» для числового реквизита задаётся тут же параметром nonNegative.

Создание табличной части сразу с колонками. Тип колонки опциональный — как в addObjectAttribute.

Добавление колонок в уже существующую табличную часть. Тот же унифицированный формат типов.

Задаёт тип значения у уже существующего элемента: тип значения характеристик плана видов характеристик, тип реквизита или колонки табличной части, измерения либо ресурса регистра, значения константы. Принимает один тип или составной (несколько типов сразу) с уточнением длины строки, разрядности и точности числа, состава даты. В расширении ссылочные типы (CatalogRef.X и подобные) заимствуются автоматически.

Меняет тип уже существующего реквизита без удаления и пересоздания — сохраняет его порядок в списке и все ссылки на него. Решает типичную задачу «поменяй тип реквизита Артикул на число» одним действием, без потери привязок на формах и в коде.

Правка состава типов, а не только замена. К уже заданному составному типу можно добавить один тип или убрать отдельный (removeTypes), не перечисляя весь состав заново: «добавь в критерий отбора ещё один вид документа» — один вызов. Полная замена состава делается явным replace, поэтому случайно стереть остальные типы нельзя. Работает для реквизитов и колонок табличных частей, критериев отбора, констант, параметров сеанса, общих реквизитов, определяемых типов, планов видов характеристик, измерений и ресурсов регистров, реквизитов форм — в конфигурации, расширении и внешней обработке. Этой же операцией ставится признак «Неотрицательное» (nonNegative) у числового реквизита.

Колонка формы под табличной частью. Тип колонки, существующей только на форме, меняется по пути «реквизит формы → табличная часть → колонка» — колонку не нужно удалять и создавать заново, настройки связанного с ней элемента формы сохраняются.

Удаление реквизита объекта. Работает как правый клик → «Удалить» в дереве объектов EDT плюс автоматически чистит связанные элементы форм: поля, которые ссылались на удалённый реквизит, убираются со всех форм объекта. После операции формы валидны, обновление конфигурации базы данных проходит без ошибок. Поддерживаются справочники, документы, планы видов характеристик, задачи, бизнес-процессы, планы обмена, регистры (для ресурсов и измерений регистра — отдельная операция removeRegisterField).

Удаление табличной части целиком вместе со всеми её реквизитами. Все таблицы на формах объекта, привязанные к этой ТЧ, удаляются со всеми колонками автоматически. Если нужно убрать только один реквизит, оставив ТЧ — используйте removeTabularSectionAttribute.

Удаление одного реквизита (колонки) табличной части. Саму ТЧ оставляет. Колонки таблиц на формах, ссылавшиеся на удалённый реквизит, убираются автоматически — сама таблица и остальные колонки остаются.

Удаление объекта метаданных целиком — со всеми реквизитами, табличными частями, формами, командами, макетами. Перед удалением плагин автоматически чистит входящие ссылки: при удалении регистра он снимается со всех документов, где был указан как регистратор; при удалении документа очищается список его регистров-движений; объект убирается из состава всех подсистем. По правилам безопасности эта операция требует явного подтверждения от пользователя — AI-ассистент не вызывает её самостоятельно «для порядка» и обязан перечислить, что именно будет удалено и какие ссылки разорвутся, прежде чем выполнять.

Принимает и внешнюю обработку или внешний отчёт — удаляется сам объект вместе со своими формами, макетами и модулями, а проект внешних обработок остаётся на месте. Как и у остальных операций, доступен режим предпросмотра: сначала видно, что именно уйдёт, и только потом изменение применяется.

Создание объектной команды (Catalog/Document/... — кнопка «Добавить → Команда» в дереве объекта в EDT). Одной операцией: объект Command в дереве владельца + файл CommandModule.bsl со стандартной заглушкой Процедура ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды) (русский ScriptVariant) или CommandProcessing(...) (английский) — тело пустое, заполняется через write_module_source. Принимает параметры команды: commandParameterType (FQN-строка или массив для составного типа), parameterUseMode (Single/Multiple), group (группа размещения), representation, picture, tooltip, modifiesData, shortcut. Имя картинки проверяется до записи: при опечатке плагин возвращает success=false с подсказкой о близких именах в реестре платформы. Дальше команду можно положить в командную панель или навигационную панель формы через addFormCommandInterfaceItem. Общая команда (CommonCommand) создаётся через createObject с тем же набором параметров.

Обратная операция к createObjectCommand: удаление команды объекта или общей команды (CommonCommand). Стирает CommandModule.bsl с диска и убирает ссылку из .mdo-файла владельца. Если команда размещена в командной панели или навигационной панели какой-то формы (через addFormCommandInterfaceItem) — перед удалением её нужно убрать из формы операцией removeFormCommandInterfaceItem, иначе ссылка в форме станет битой.

Переименование справочника, документа, формы, реквизита, табличной части и других элементов конфигурации — тем же механизмом, что «Рефакторинг → Переименовать» в EDT. Вместе с именем обновляются файлы и папки проекта, синоним (если он совпадал с именем), ссылки в других объектах, пути к данным на формах; заимствованные копии в расширениях переименовываются синхронно. Попытка сменить имя через setObjectProperty тоже выполняется как полноценное переименование — проект не расходится сам с собой. Часть мест переименование в принципе не может обновить само (строки запросов, алиасы, пути колонок динамических списков) — после операции такие оставшиеся упоминания старого имени возвращаются списком прямо в ответе: файл, строка, текст и подсказка, чем какое место чинить.

Имя конфигурации и расширения. Переименовать можно и сам корень — конфигурацию или расширение целиком. Это нужно, чтобы завести копию доработки: два расширения с одинаковым именем в одной информационной базе не уживаются. На большой конфигурации переименование идёт в фоне, а результат забирается повторным вызовом с теми же параметрами.

Заполнение справочной информации объекта — той самой, что пользователь 1С:Предприятия открывает кнопкой «?» (F1) в формах справочника, документа, отчёта. AI описывает, как работать с объектом, обычным текстом или markdown, а плагин превращает это в страницу справки в фирменном стиле платформы: заголовки, списки, таблицы, ссылки, оглавление. Работает для всех прикладных объектов и для конфигурации в целом, поддерживает многоязычные конфигурации и включение раздела в общее содержание справки. Оформление страницы задаётся параметром css — просьба «сделай шрифт крупнее» закрывается одним вызовом; стили, присланные внутри самого текста справки, тоже применяются. Проверить результат можно чтением через get_object_help с параметром raw — страница вернётся как есть, с разметкой и оформлением.

Правка на месте, без пересылки всей страницы. Параметр mode задаёт, что делать с уже существующей справкой: replace — заменить страницу целиком (по умолчанию), append — дописать в конец, prepend — дописать в начало, replaceFragment — заменить найденный фрагмент. Заменяемый кусок задаётся параметром find дословным текстом страницы; если он не найден или встречается несколько раз, операция отказывает и страницу не трогает — угадывать, какое из мест менять, она не станет. Добавить в большую страницу одно предложение больше не значит вычитать её целиком, собрать заново и отдать обратно одним куском. Большое содержимое можно передать файлом (htmlFile) вместо параметра.

Оформление не копится. При правке на месте стили раскладываются только по новому куску, поэтому страница не разрастается с каждым вызовом. Одно и то же свойство попадает в тег один раз, и побеждает то значение, которое победило бы в браузере: заданное точнее, а помеченное !important обычным не перебивается; собственное оформление автора, написанное прямо в теге, по-прежнему главнее. Если ровно те же правила на странице уже есть, второй такой же блок в заголовок не добавляется — об этом сказано в ответе.

Расширения. Записать справку заимствованному объекту базовой конфигурации нельзя, и операция отказывает сразу, объясняя причину: платформа не относит справочную информацию к свойствам, которые расширение вправе менять, поэтому такая страница не попала бы ни в файл поставки, ни в информационную базу, а пользователь продолжал бы видеть справку базовой конфигурации. Собственным объектам расширения справка ставится как обычно.

Создание предопределённых элементов: элементы и группы справочников, счета и субсчета планов счетов, виды характеристик, виды расчёта. Вся иерархия (группа с вложенными элементами, счёт с субсчетами) создаётся одним вызовом. Для счетов можно сразу задать вид (активный / пассивный / активно-пассивный) и признак забалансового. Повторный вызов ничего не дублирует.

Удаление предопределённого элемента — элемента или группы справочника, счёта плана счетов (вместе с его субсчетами), вида характеристик или расчёта. Обратная операция к addPredefined: создание, чтение и удаление предопределённых элементов работают симметрично, так что агент свободно правит уже настроенный объект, а не только создаёт с нуля.

Добавление и удаление полей всех 4 видов регистров (сведений, накопления, бухгалтерии, расчёта): ресурсы, измерения, реквизиты. А также признаки учёта и признаки учёта субконто для плана счетов (тип по умолчанию — Булево, как в мастере EDT). Вид поля задаётся на русском или английском. Для реквизитов/ресурсов/измерений тип данных опциональный (по умолчанию Строка длиной 10).

Добавление значений в перечисление. Одиночный и пакетный режим.

Включение и исключение объектов из состава подсистемы. Идемпотентно.

Переносит уже существующую подсистему (раздел командного интерфейса) внутрь другой — параметр parent — или обратно на верхний уровень. Вместе с подсистемой переезжают её состав, свойства и вложенные подсистемы, на любую глубину. Ту же иерархию можно задать сразу при создании: createObject принимает путь вида Subsystem.Продажи.Subsystem.Документы. Работает и в расширении — в том числе когда свой раздел вкладывается в заимствованный типовой.

Состав функциональной опции. Наполняет состав опции — как вкладка «Состав» в редакторе: объекты целиком, отдельные реквизиты, табличные части, команды. Те же операции наполняют список «Использование» параметра функциональных опций (справочники и измерения регистров). Сама опция — с хранилищем в константе или реквизите справочника — и параметр создаются через createObject; хранилище существующей опции меняется через setObjectProperty (свойство location). При чтении через get_object_details видны состав опции, использование параметра и обратный поиск — в состав каких опций входит сам объект или его реквизиты, без перебора всех опций конфигурации.

Назначение прав роли на объект метаданных целиком или на его вложенный элемент: реквизит (Catalog.Клиенты.Attribute.Паспорт), табличную часть (Document.Заказ.TabularSection.Товары), колонку ТЧ (Document.Заказ.TabularSection.Товары.Attribute.Цена), команду объекта (Catalog.Товары.Command.ОткрытьОтчёт), измерение или ресурс регистра. Одним вызовом можно, например, закрыть отдельному реквизиту с персональными данными право просмотра для роли оператора, оставив доступ ко всему справочнику в целом. Набор допустимых прав для каждого типа цели платформа определяет сама. Русские и английские имена прав (Чтение/Read, Добавление/Insert и др.). Пакетный режим, идемпотентно. Ведёт себя ровно как редактор прав в EDT: вместе с правом автоматически проставляются зависимые (дали «Изменение» — «Чтение» встанет само; сняли «Чтение» — снимутся и зависящие от него), что добавилось автоматически — видно в ответе. Права ставятся и на конфигурацию целиком: запуск тонкого клиента, веб-клиента, администрирование и т.п. Полный состав роли — флаги, права по объектам, ограничения и шаблоны — читается через get_object_details.

Лечение прав ролей, потерявших смысл. Права роли хранятся отдельно от самой роли, поэтому в проекте накапливаются записи, указывающие в пустоту: права на объекты, которых в проекте больше нет, и права ролей, которых больше нет самих. Берутся они от прежних версий конфигурации, от переключения веток в системе контроля версий, от удаления файлов мимо среды разработки. Для проекта это тихая мина: обновление информационной базы после такого перестаёт проходить — платформа выгружает права по каждой роли отдельно, не находит роль и прерывает обновление, не называя виновника. Перезапуск среды и удаление лишних объектов не помогают.

Операция снимает такие записи по всему проекту или по одной роли (objectName вида Role.Кладовщик; без него проверяются все роли). Права на живые объекты не трогаются ни при каких условиях. Режим предпросмотра (dryRun) показывает находки, ничего не меняя. В ответе — сколько ролей проверено, сколько записей снято и по каким ролям. Отдельно искать причину не нужно: отказ sync_database сам называет виноватые роли поимённо и даёт готовый вызов лечения.

Задаёт состав определяемого типа (ОпределяемыйТип) одним вызовом. Принимает массив FQN входящих типов: ["CatalogRef.Пользователи", "CatalogRef.ВнешниеПользователи"] — у каждого типа можно сразу указать разрядность: число 15 знаков с 3 после запятой, строка на 150 символов, дата «только время». Если хотя бы один тип из списка не распознан, состав не меняется вовсе — вместо частично применённого списка возвращается понятная ошибка. После этого определяемый тип можно указывать как тип реквизита через type: "DefinedType.X".

Дописывает процедуру-заглушку обработчика в общий модуль по уже существующей подписке. При создании подписки через createObject заглушка пишется автоматически, если общий модуль уже существует. Отдельный вызов нужен, когда модуль создали позже подписки, либо когда изменилось имя метода в обработчике и нужна свежая заглушка. Плагин сам берёт из подписки источник, событие и обработчик, вычисляет сигнатуру и пишет процедуру. Идемпотентно: если метод уже есть, возвращается handlerAlreadyExists: true и ничего не меняется. Параметр force: true перезаписывает существующий блок Процедура…КонецПроцедуры свежей заглушкой. Режим предпросмотра (dryRun: true) возвращает планируемую сигнатуру без записи.

Субконто на счетах плана счетов. Назначает предопределённому счёту (или субсчёту) вид субконто — то, что в EDT редактируется в табличной части «Виды субконто» счёта; обратная операция убирает его. Субконто можно пометить оборотным (turnover). После назначения по счёту в движениях документа заполняется аналитика (СубконтоДт/СубконтоКт), а в отчётах доступны итоги в разрезе субконто. Виды субконто берутся из плана видов характеристик, связанного с планом счетов через setObjectProperty extDimensionTypes; число субконто на счёт ограничено свойством maxExtDimensionCount. Если чего-то не хватает (не задан план видов характеристик, нет такого счёта или вида субконто, превышен лимит) — операция честно сообщает об этом и подсказывает, что сделать, а не оставляет счёт в половинном состоянии. Идемпотентно: повторное назначение того же вида субконто не дублируется.

Состав плана обмена. Наполняет состав плана обмена — указывает, какие справочники, документы и регистры участвуют в обмене, и задаёт каждому авторегистрацию изменений: Allow (изменения объекта автоматически попадают в очередь на выгрузку узлам) или Deny. Объекты добавляются по одному или списком: единый параметр content с общей авторегистрацией autoRecord, либо массив items с разной авторегистрацией по объектам. Повторное добавление того же объекта не дублирует строку, а обновляет его авторегистрацию; обратная операция убирает объект из состава (сам объект не удаляется). После наполнения в плане обмена можно заводить узлы и регистрировать изменения для обмена данными. Распределённая ИБ (РИБ) включается через setObjectProperty distributedInfoBase.

Добавление и удаление URL-шаблонов внутри HTTP-сервиса. Шаблон — это путь, по которому сервис принимает входящие запросы, например /users/{id}; параметры в фигурных скобках доступны обработчику через ПараметрыURL. Удаление шаблона забирает с собой все его HTTP-методы.

HTTP-методы внутри URL-шаблона: GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD и другие. При создании метода в модуль HTTP-сервиса автоматически дописывается процедура-заглушка обработчика с правильной сигнатурой и пометкой Экспорт — после обновления информбазы сервис уже отвечает (пустым ответом), тело обработчика дописывается через write_module_source.

Создаёт форму через встроенный генератор EDT. Все типы: форма элемента, списка, выбора, группы, записи регистра, общая. Параметр setAsDefault=true назначает форму основной.

Удаляет одну форму объекта, не трогая сам объект, его данные и остальные формы — тем же механизмом, что удаление формы в дереве объектов EDT. Типовой сценарий: после восстановления рабочей формы убрать старую сломанную, чтобы она не путала ни разработчика, ни агента. Форму, назначенную формой по умолчанию, операция удалять отказывается — сначала нужно назначить другую; при этом пустое значение свойства «форма по умолчанию» в setObjectProperty честно очищает его. В ответе видно, какие формы у объекта остались.

Реквизиты формы (фильтры, временные таблицы, динамические списки). Колонки можно добавлять в существующие реквизиты-таблицы без пересоздания.

Параметр открытия формы — «вход» формы: значение, которое передают в форму в момент её открытия (например, открыть форму заказа сразу с нужным заказом, чтобы оно пришло в обработчик ПриСозданииНаСервере). Это не то же самое, что реквизит формы: реквизит хранит данные внутри формы, а параметр принимает их при открытии. Создаётся с нужным типом и, при необходимости, признаком «ключевой».

Удаление реквизита формы по имени. Параметр deleteDataItems переключает поведение: при true (по умолчанию) удаляется и сам реквизит, и связанные элементы формы — таблица с колонками и поля, которые на него ссылались; при false сами элементы остаются на форме с сохранёнными привязками к удалённому реквизиту. В ответе появляется поле preservedDataPaths со списком сохранённых ссылок (Table:ТаблицаСводка → /Сводка, FormField:Колонка1 → /Сводка/Колонка1 и т.д.) — полезно для типичного сценария «удалить реквизит и пересоздать его с другой структурой колонок» за два вызова, без необходимости пересоздавать таблицу и поля вручную.

Таблица динамического списка со всеми свойствами, которые появляются у таблицы списка в мастере EDT: строка поиска, автообновление, быстрый отбор над колонками, режим отображения «Список». Список создаётся из справочника, документа или регистра либо из произвольного запроса; колонки задаются вручную или подбираются автоматически по полям источника. Готовый список настраивается как отчёт — отбор, порядок, группировка, условное оформление, выбранные и вычисляемые поля, параметры; у него можно поменять запрос, основную таблицу, ключи и режимы работы, а также добавлять, переименовывать и удалять колонки. Путь колонки принимается и привычным Список.Поле, и ровно так, как он показан в просмотре формы — [Список, Поле]. В расширении все объекты, на которые опирается запрос списка (основная таблица и таблицы соединений), заимствуются автоматически. Типовой сценарий — в справке через help topic=dynamicListSettings.

Универсальная установка свойств любого элемента: видимость, доступность, заголовок, цвет, шрифт, картинка, представление, расположение заголовка, размеры, выравнивание, направление раскладки и десятки других. Свойством view можно сменить вид уже существующего поля — сделать его полем HTML-документа, картинки, календарём, индикатором и т.д. (тот же набор видов, что у fieldType при создании, с той же проверкой совместимости с типом реквизита). Пакетный режим: за один вызов можно установить сразу несколько свойств одного элемента. Для кнопок — защита от типичной ошибки «установил картинку, а её не видно»: если указывается только picture на кнопке с текстом и дефолтным режимом представления, операция возвращает предупреждение с подсказкой, какой representation задать. При установке format или editFormat (форматная строка для числовых, датовых и булевых полей) в ответе появляется поле formatHelp — короткая подсказка с типовой ловушкой (параметр ЧН не указан — ноль скрывается; ЧН=0 — ноль показывается как «0») и указатель на справочник get_platform_docs typeName=ФорматнаяСтрока.

Задаёт состав автокомандной панели: какие стандартные команды скрыть из автозаполнения — как «Состав команд» панели в редакторе формы EDT, где снятая галочка означает, что команда в 1С:Предприятии не показывается. Настраивается панель самой формы (без elementName) или панель таблицы на форме. Параметр commands — полный список исключённых, а не добавка к нему: каждый вызов заменяет состав целиком, а пустой список снимает все исключения. Текущий состав виден в просмотре формы через get_form_image. Незнакомое имя команды отклоняется со списком доступных. Работает в конфигурациях, расширениях (у заимствованной формы исключения не перезатираются обновлением из базы) и во внешних обработках и отчётах.

Назначает функциональные опции реквизиту или команде формы — то самое свойство «Функциональные опции» из палитры редактора форм. Передаётся полный список опций; пустой список — очистить. Назначения видны при чтении формы: get_form_image показывает блок functionalOptions, так что причина «элемент на форме есть, а в 1С не виден» не прячется.

Поиск среди 763 стандартных картинок EDT по имени. Для общих картинок конфигурации (из раздела «Общие → Общие картинки») поиск не нужен — используйте формат CommonPicture.ИмяКартинки напрямую в setProperty или setObjectProperty. Картинка находится и по русскому названию, и по английскому, и по представлению общей картинки конфигурации; в ответе показаны оба названия сразу — первым то, которое будет видно в форме (например «Печать» и StdPicture.Print).

Возвращает полям формы нормальные подписи вместо технических имён — ровно те, что подставил бы редактор форм при добавлении поля вручную. Одним вызовом обрабатывается одна форма, все формы объекта или весь проект (maxForms и offset — порциями, если форм много). Подписи, заданные разработчиком руками, не трогаются. Есть отчёт без изменений — сначала видно, что именно будет исправлено, и только потом правка применяется. Параметр fixLanguage заодно чинит частую причину расхождения «в редакторе имена, в программе подписи» — язык расширения, заведённый без кода языка.

Создаёт обработчик команды кнопки с правильной директивой. Поддерживает обычные формы и заимствованные (обработчики Перед, После, Вместо).

Назначает обработчик события на форму или элемент формы — ПриОткрытии, ПриСозданииНаСервере, ПриИзменении, ОбработкаВыбора и десятки других. Имя процедуры-обработчика подставляется автоматически по правилам платформы (например, ИмяПоляПриИзменении) либо задаётся явно. Если процедуры-обработчика ещё нет в модуле формы — в неё автоматически дописывается заглушка с правильной сигнатурой по описанию события и нужной директивой компиляции (&НаКлиенте, &НаСервере). Агент после назначения сразу получает рабочий каркас, в который остаётся вписать тело.

Добавляет ссылку на существующую команду в командный интерфейс формы — в навигационную панель (горизонтальная линейка ссылок под заголовком формы, выше штатной командной панели) или в панель команд формы (кнопки команд рядом с автокомандной панелью). Принимает FQN команды любого вида: объектная (Catalog.X.Command.Y / Document.X.Command.Y), общая (CommonCommand.Y), стандартная команда формы (Form.StandardCommand.Refresh). Параметр group задаёт группу размещения внутри панели; visible и index — видимость и порядок. Категория группы должна совпадать с типом панели (для navigation — FormNavigationPanel*, для commandBar — FormCommandBar*); иначе плагин сразу вернёт понятную ошибку, не оставляя форму в битом состоянии. Сама команда должна существовать в проекте до этого вызова — создаётся через createObjectCommand или createObject CommonCommand.

Обратная операция: убирает ссылку на команду из командного интерфейса формы. Сама команда (объектная или общая) при этом не удаляется — стирается только её пункт в выбранной панели.

Меняет одно из свойств существующего пункта-ссылки в панели формы: group (группа размещения), visible (видимость) или index (позиция в группе). Категория новой группы должна соответствовать типу панели (как и в addFormCommandInterfaceItem); иначе плагин откажет до записи.

Добавляет на любую форму (обработки, отчёта, общей формы, формы документа) реквизит-композитор настроек компоновки данных с UI-таблицами — как галочка «Настройки на форме» в мастере EDT, но доступно не только отчётам. Ставит сразу: реквизит типа КомпоновщикНастроек, таблицу «Структура» (дерево группировок), группу пользовательских настроек и привязку ExtInfo формы. Опциональный параметр standardItems регулирует, какие UI-таблицы вывести: только структура (по умолчанию), алиас full — полный набор (группировки + отборы + сортировка + условное оформление), либо произвольный список. Ответ операции содержит готовый BSL-пример для обработчика ПриСозданииНаСервере — с корректной передачей схемы через временное хранилище и правильным вызовом ПолучитьМакет в зависимости от того, где лежит макет (обработка / справочник / отчёт / общий). Полный сценарий сборки от объекта до BSL-кода формирования результата — в справочнике через help topic=composerWorkflow.

Создание макета. Поддерживаемые типы: табличный документ (по умолчанию), текстовый документ, схема компоновки данных, макет оформления компоновки, двоичные данные, активный документ, HTML-документ, географическая схема, графическая схема, внешняя компонента. Принимает русские имена типов (Табличный, Текстовый, СКД, Двоичные данные, …) и английские. Сразу наполняет содержимым: текстовому макету можно передать текст, HTML-макету — HTML-разметку, а внешней компоненте, двоичному макету и графической/географической схеме — путь к файлу-источнику на диске. Без содержимого макет создаётся пустым, конфигурация остаётся рабочей.

Чтение и замена содержимого уже созданного макета. Закрывает сценарий «поправить кусок текста в макете»: агент читает текущее содержимое (getTemplateContent), меняет нужное и записывает обратно (setTemplateContent). Работает для текстового и HTML-макета (по тексту/разметке) и для бинарных макетов и графической схемы (заменой файла-источника). Для табличного макета getTemplateContent возвращает полную карту: все ячейки с текстами и параметрами, объединения, именованные области, ширины колонок и высоты строк. Вместе с ячейкой приходит и её оформление — шрифт, цвета текста и фона, выравнивание, границы, размещение текста, формат данных, отступ, поворот, узор, защита и заполнение, — так что собственную правку можно сверить чтением, а не глазами в EDT. Цвета возвращаются в привычной записи цвета, а не служебными номерами; оформленные ячейки без текста показываются наравне с остальными. Высоты строк приходят с расшифровкой словами — жёсткая высота или автоподбор и до какого предела; ширины колонок — вместе с признаком автоподбора и весовым коэффициентом. У именованной области указан её вид — строки, колонки или прямоугольник. Операции правки (setTemplateCell/drawTemplate) сообщают, что именно они задели из существующего — прежний текст ячейки, пересечения с уже существующими объединениями. Вместе с режимом dryRun это даёт безопасную точечную правку: посмотрел карту → прогнал изменение вхолостую → применил. Схема компоновки данных правится своими СКД-командами.

Макет адресуется одним полным именем — CommonTemplate.Компонента для общего макета, Document.Заказ.Template.Печатная для макета объекта; прежний способ «владелец плюс имя макета» тоже работает. У текстового и HTML-макета есть режим дописывания (append): текст добавляется в конец, не нужно вычитывать содержимое и склеивать его вручную.

Ставит текст в одну ячейку табличного макета — как ввод текста в ячейку в редакторе макета EDT. Параметры: row, column и text (без текста ячейка очищается). Для оформления ячейки и пометки её параметром печати служит drawTemplate.

Объединение диапазона ячеек табличного макета (от столбца A строки N до столбца B строки M).

Пакетное заполнение макета одним вызовом: ячейки (cells), объединения (merges), ширины колонок (columnWidths), высоты строк (rowHeights) и именованные области (areas: Шапка, СтрокаТовара, Подвал — на эти имена ссылается код печати через Макет.ПолучитьОбласть("Шапка")). За один вызов можно собрать целый бланк.

Оформление ячейки. У каждой ячейки задаются текст (text), пометка параметром печати (parameter), цвет текста и фона (textColor, backColor), шрифт (font — жирный, курсив, подчёркнутый, зачёркнутый, размер, гарнитура), выравнивание (horizontalAlign, verticalAlign), границы и их стиль (border), размещение текста (textPlacement), формат данных (dataFormat), отступ (indent), поворот текста (textOrientation — градусы, для вертикальных заголовков узких колонок), узор заливки и его цвет (pattern, patternColor), выделение отрицательных значений (markNegatives) и защита ячейки от редактирования в пользовательском режиме (protection). Формат задаётся привычной строкой формата платформы — ЧЦ=15; ЧДЦ=2, ДФ=dd.MM.yyyy, — поэтому сумму и дату не нужно форматировать кодом при заполнении.

Перенос текста по словам. textPlacement принимает значения Wrap (переносить по словам), Cut (обрезать), Block (забивать) и Auto (выходить на свободные соседние ячейки) — русские написания тоже принимаются. Есть тонкость самой платформы: перенос она применяет к ячейкам, заполняемым текстом, а у ячейки-параметра — из них и состоит печатная форма — переносит только при выравнивании по ширине. Ответ прямо перечисляет ячейки, у которых перенос не сработает, и называет два рабочих способа его получить.

Высота строки: три способа задания. В rowHeights у строки задают autoHeight — подбор высоты по содержимому без ограничения; autoHeight вместе с height — подбор, но не выше заданного предела; один height — жёстко заданная высота. Важно обратное: жёсткая высота автоподбор выключает, поэтому если нужно, чтобы текст помещался сам, высоту числом задавать не надо — иначе перенос по словам ничего не даст, текст перенесётся, а строка останется прежней. Ответ сообщает, у каких строк включён автоподбор, и напоминает, что расти строка будет только при включённом переносе, выравнивании по ширине, повёрнутом тексте или готовых переводах строк в самом тексте.

Ширина колонки. Кроме точного числа (width) колонке включается автоподбор ширины по содержимому (autoWidth) и задаётся весовой коэффициент (widthWeightFactor) — доля, в которой между колонками делится свободное место. Эти два свойства платформа сохраняет начиная с режима совместимости 8.3.10.

Неверное значение не проглатывается молча. Весь состав правки разбирается до того, как в макет внесено хоть одно изменение. Незнакомое имя свойства, нераспознанное значение, неверный диапазон объединения, невозможное сочетание высоты — вызов отклоняется целиком, макет остаётся нетронутым, а в ответе перечислены все найденные проблемы разом и допустимые значения по каждой. Если вызов ответил успехом, значит применилось всё, что было передано.

Задаёт именованную область макета для отдельного вызова Макет.ПолучитьОбласть("ИмяОбласти") в коде печатной формы. Вид области определяется тем, что передали: rowFrom и rowTo — диапазон строк, columnFrom и columnTo — диапазон колонок, row и column (с rows и cols) — прямоугольник ячеек. Полезно, когда макет уже собран в EDT вручную или другим инструментом, а нужно лишь добавить новую именованную область без полной перерисовки через drawTemplate.

Какой вид области выбирать. Все три вида платформа разрешает и поддерживает. Для секций печатной формы берут строчные области: вывод области кладёт её со следующей строки и всегда от первой колонки, а у прямоугольной области при выводе теряется горизонтальное смещение. Прямоугольные удобны для присоединения и для блоков внутри строки. Настоящее ограничение по виду области ровно одно: повторяемые при печати строки принимают только строчную область, а повторяемые колонки — только колоночную.

Читает состав командного интерфейса. Без имени подсистемы — панель разделов и команды основного раздела; с именем (subsystem, вложенные — через точку: Продажи.Дочерняя) — панель навигации и панель действий этого раздела, как команда «Командный интерфейс» на подсистеме в дереве конфигурации EDT. Возвращает ссылки команд, которые принимают остальные операции этого раздела.

Порядок разделов в панели разделов (передаётся полный список сверху вниз; пустой — сброс к порядку по умолчанию) и видимость раздела — для всех пользователей или по ролям (roles).

Команды основного раздела (того, что открывается кнопкой «Главное»): добавить команду, убрать, управлять её видимостью — в том числе по ролям.

Видимость команды в панелях конкретной подсистемы — для всех или по ролям. Типовой кейс: пункт дублируется в панели навигации раздела, потому что у справочника две команды с одинаковым заголовком (стандартная команда открытия списка и собственная) — лишняя скрывается одним вызовом.

Перестановки — как перетаскивание в редакторе командного интерфейса: перенос команды в другую группу панели («Важное», «Обычное», «См. также», «Создать», «Отчёты», «Сервис» или своя группа) и полный порядок команд внутри группы. Обе операции работают и для основного раздела, и для любой подсистемы; вызов без параметров настройки — сброс к умолчанию.

Создаёт сам проект расширения — так же, как мастер EDT: имя, префикс имён, назначение (адаптация / дополнение / исправление), синоним и привязка к базовой конфигурации. Единственная конфигурация рабочей области выбирается базой автоматически. Сразу после создания в расширении работают заимствование объектов и создание собственных — AI проходит путь «создал расширение → заимствовал → доработал» без участия человека.

Заимствовать один объект из базовой конфигурации. По умолчанию — только сам объект. С параметром recursive=true — объект вместе со всеми дочерними элементами (реквизиты, табличные части, формы, команды).

Заимствовать несколько объектов базы одним вызовом по явному списку — например, пять справочников и два документа. Альтернатива многократному вызову adoptObject и альтернатива recursive=true, когда хочется именно эти объекты без их форм и реквизитов. В ответе — результат по каждому объекту отдельно (заимствован, уже был, не удалось). Ошибка на одном объекте не прерывает обработку остальных.

Заимствовать конкретный дочерний элемент: реквизит, табличную часть, форму, команду, измерение, ресурс. Форма заимствуется сразу в рабочем для базы виде — вместе со всем необходимым; состав добавленного перечислен в ответе, ничего не появляется молча.

Заимствовать элемент внутри заимствованной формы (главный реквизит, команду, параметр); пустое имя элемента означает главный реквизит формы. Вместе с главным реквизитом в расширение приходит всё, на что ссылается форма, — реквизиты шапки, табличные части с колонками и объекты верхнего уровня их типов. Что именно вернулось в состав, операция перечисляет поимённо, а формулировка «дополнительных объектов не потребовалось» появляется только тогда, когда состав действительно не менялся.

Обновить заимствованный объект или форму из основной конфигурации — когда база изменилась после заимствования и копия в расширении устарела (у формы это видно по признаку baseFormStale в просмотре формы). Изменения базы добавляются слиянием, доработки расширения — модуль, обработчики, свои элементы — сохраняются. Долгое обновление не обрывается: если ответ сообщает, что работа продолжается, повторный такой же вызов забирает готовый результат.

Снять заимствование одного дочернего элемента — например, убрать из расширения устаревшее значение перечисления, не трогая остальное. Снятие заимствования целого объекта — обычный removeObject: из расширения уходит только копия, сам объект в основной конфигурации не меняется.

Включает участие модуля заимствованного объекта в расширении — ту самую галочку «Объектный модуль» / «Модуль менеджера» / «Модуль набора записей» / «Модуль команды» / «Модуль значения» на вкладке «Расширение» в редакторе объекта в EDT. Без этой галочки файл модуля на диске есть, но платформа при исполнении в 1С:Предприятии его игнорирует. Параметр moduleType задаёт, какой именно модуль включаем. Операция идемпотентна. Отдельно вызывать нужно редко: обычно при записи кода через write_module_source активация происходит автоматически.

Подключает готовое расширение к информационной базе проекта. Источник — локальный файл .cfe, прямая ссылка или GitHub-репозиторий (берётся последний релиз). Повторный вызов безопасен: существующее расширение с этим именем штатно обновляется на месте. Подключается сразу с выключенным «Безопасным режимом» — расширение ставят, чтобы оно работало. Расширение живёт в базе — в проекты рабочей области ничего не добавляется, исходники не появляются. Отключать базу или закрывать EDT не нужно. Имя расширения указывать необязательно — если его не передали, берётся имя файла .cfe.

Показывает все расширения информационной базы — и установленные этой операцией, и опубликованные из проектов рабочей области. По каждому видны галочки «Безопасный режим» и «Защита от опасных действий», а также предупреждение о тех, у которых снята галочка «Используется».

Ставит и снимает галочку «Используется» у расширения информационной базы — то же, что кнопка в списке «Управление расширениями конфигурации». Выключенное расширение остаётся в базе, но платформа его не применяет: удобно, чтобы временно отключить доработку и проверить, как система ведёт себя без неё.

Ставит и снимает галочки «Безопасный режим» и «Защита от опасных действий» у расширения базы — прямо из EDT, без запуска 1С:Предприятия. Включённый безопасный режим — коварная ловушка: перехваты «Вместо», «Перед» и «После» молча не работают — ошибок нет, а выполняется код основной конфигурации, как будто расширения и не было. Страховка: если после обновления базы какое-то расширение осталось в безопасном режиме, sync_database сам предупредит об этом и подскажет, как снять галочки.

Удаляет расширение из информационной базы по имени. Удаление расширения, у которого есть собственные данные, требует монопольного доступа к базе — и разрешить его ответом на вопрос платформы нельзя, потому что здесь платформа диалога не ведёт. Отказ в этом случае называет держателей базы и предлагает рабочие выходы, включая временное выключение расширения через setExtensionActive: выключенное платформа не загружает, и монопольный доступ для этого не нужен.

Перемещение элемента в другой контейнер на конкретную позицию.

Удаление элемента по имени.

importProject — создаёт новый проект прямо из файла: .cf (конфигурация), .cfe (расширение), .epf / .erf (внешняя обработка и отчёт). Прислали файл от заказчика — одним вызовом получается готовый проект в рабочей области, с которым дальше работают все остальные инструменты. Для расширения указывается проект базовой конфигурации, к которому его привязать. На большой конфигурации загрузка идёт в фоне и результат забирается повторным вызовом; есть предварительный просмотр без изменений в рабочей области. Вместе с переименованием (renameObject у корня) и установкой в базу (installExtension, setExtensionActive) закрывается частый сценарий «сделать копию расширения под новым именем и включить её в базе» — минуты вместо ручного обхода.

syncExport — дожидается, пока все ранее запланированные записи проекта на диск завершатся. У EDT есть внутренние очереди записи — edit_metadata вносит изменения в модель, а реальная запись в .mdo и .bsl файлы происходит асинхронно. Обычные сценарии этого не требуют — операции ждут синхронизации сами. syncExport нужен в редких случаях: после серии быстрых правок перед запуском сборки проекта, перед коммитом в git из внешнего инструмента, перед чтением только что записанного файла каким-то скриптом за пределами плагина. Возвращает количество дождавшихся записей и время ожидания.