Описание инструментов 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 за один вызов, с процедурами-заглушками в модуле сервиса. Всё создаётся одним вызовом — справочник с пятью реквизитами не требует шести отдельных запросов. Обязательные параметры для специфичных типов проверяются на входе — например, функциональная опция не создастся без ссылки на константу-хранилище; подписка — без указания события, которое реально есть у всех указанных источников.

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

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

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

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

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

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

Удаление реквизита объекта. Работает как правый клик → «Удалить» в дереве объектов 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, а плагин превращает это в страницу справки в фирменном стиле платформы: заголовки, списки, таблицы, ссылки, оглавление. Работает для всех прикладных объектов и для конфигурации в целом, поддерживает многоязычные конфигурации и включение раздела в общее содержание справки.

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

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

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

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

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

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

Задаёт состав определяемого типа (ОпределяемыйТип) одним вызовом. Принимает массив FQN входящих типов: ["CatalogRef.Пользователи", "CatalogRef.ВнешниеПользователи"]. После этого определяемый тип можно указывать как тип реквизита через 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 назначает форму основной.

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

Удаление реквизита формы по имени. Параметр 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=ФорматнаяСтрока.

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

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

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

Добавляет ссылку на существующую команду в командный интерфейс формы — в навигационную панель (горизонтальная линейка ссылок под заголовком формы, выше штатной командной панели) или в панель команд формы (кнопки команд рядом с автокомандной панелью). Принимает 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-документ, географическая схема, графическая схема, внешняя компонента. Принимает русские имена типов (Табличный, Текстовый, СКД, Двоичные данные, …) и английские.

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

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

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

Задаёт именованную область макета для отдельного вызова Макет.ПолучитьОбласть("ИмяОбласти") в коде печатной формы. Принимает три формы описания: прямоугольник ячеек (от строки/колонки на N строк/колонок), диапазон строк (с какой по какую) или диапазон столбцов (с какого по какой). Полезно, когда макет уже собран в EDT вручную или другим инструментом, а нужно лишь добавить новую именованную область без полной перерисовки через drawTemplate.

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

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

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

Заимствовать конкретный дочерний элемент: реквизит, табличную часть, форму, команду, измерение, ресурс.

Заимствовать элемент внутри заимствованной формы (главный реквизит, команду, параметр).

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

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

Показывает все расширения информационной базы — и установленные этой операцией, и опубликованные из проектов рабочей области.

Удаляет расширение из информационной базы по имени.

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

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

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