Перейти к содержимому
EDT-Bridge
Русский
Esc
↑↓navigate↵open⌘Jpreview
На этой странице

Запись: модули

Инструменты записи для модулей BSL: добавление, замена, перемещение и удаление методов, замена фрагментов модуля, маршруты HTTP-сервисов и быстрые исправления.

Эти инструменты изменяют модули BSL: добавляют, заменяют, перемещают и удаляют методы, заменяют фрагменты вне методов, добавляют маршруты HTTP-сервисов и применяют быстрые исправления EDT.

Для записи нужен токен; без apply=true инструмент возвращает план. Общие правила приведены в разделе План и применение.

Инструмент записи Что делает
edt_add_method · edt_delete_method Добавляет и удаляет процедуру или функцию в BSL модуля, обе операции идут по модели. Вставка отказывает, если результат перестает разбираться. Вырезание забирает прилегающий документирующий комментарий, а план возвращает точный текст, который уйдет, – поэтому и нужен force. Модуль адресуется по FQN, включая HTTPService.X и WebService.X.
edt_add_route Добавляет в HTTPService маршрут: шаблон URL и один HTTP-метод. Инструмент генерирует uuid шаблона и его метода, разрешает перечисление httpMethod и с параметром createHandler вставляет в модуль сервиса заготовку Функция <handler>(Запрос).
edt_apply_fix Применяет штатное исправление EDT к одному маркеру проверки (checkId в том виде, в каком его выдает edt_project_errors, сужение – fqn и line). Предпросмотр перечисляет варианты; применение выполняет вариант, повторяет проверку и возвращает измененные строки и remaining. hasFix=false означает, что у проверки нет штатного исправления. Исправлению модуля нужна клиентская EDT: EDT применяет его через редактор модуля, и мост в headless-режиме отказывает с requiresWorkbench=true. В клиентской EDT мост сохраняет этот редактор (editorSaved) и отказывает, если в редакторе уже есть несохраненные правки.
edt_replace_method Заменяет один существующий метод с разбором через EDT. Dry-run возвращает точные oldText/newText и sourceHash всего модуля. Для apply нужны этот хеш и force=true; устаревший источник, несохраненный редактор и некорректный фрагмент дают отказ. Имя и вид метода сохраняются, окружающий код не меняется.
edt_replace_module_fragment Заменяет точный фрагмент модуля вне методов: директивы компиляции, переменные модуля, области, блок #Если. Фрагмент должен встречаться один раз; edits применяет несколько фрагментов вместе, и область открывается и закрывается одним вызовом. Результат должен разбираться. При edits dry-run и apply возвращают previews в порядке замен. Для каждой замены указан номер строки на момент ее применения и короткий предпросмотр. Dry-run возвращает sourceHash. Для записи нужны этот хеш в expectedHash и токен.
edt_move_method Переносит метод внутри модуля с точным сохранением текста, документирующего комментария и директив. Принимает путь вложенной области и соседний метод, проверяет промежуточный и итоговый модуль парсером EDT. Для записи нужны apply=true, force=true.

Размещение метода

В edt_add_method можно передать один из параметров beforeMethod и afterMethod. region принимает полный путь вложенной области, например Public/Helpers; короткое имя должно быть уникальным. Соседний метод должен находиться непосредственно в выбранной области. Отсутствующая или неоднозначная цель дает отказ. План содержит insertLine, previousMethod и nextMethod. В edt_move_method действуют те же параметры места назначения. Для первого метода существующего пустого модуля модели передайте его fqn. Отсутствующий .bsl создается только при apply после проверки владельца и вида модуля; dry-run файл не создает. Так создается любой типизированный модуль существующего объекта, например ObjectModule и ManagerModule справочника или обработки, а также общий модуль и модуль формы. Произвольный отсутствующий modulePath отклоняется.

Замена существующего метода BSL

edt_replace_method меняет тело, параметры, признак экспорта, прилегающие комментарии и директивы метода одной операцией. Имя и вид метода должны остаться прежними. Для переименования с изменением вызовов используйте edt_rename.

  1. Прочитать код через edt_module_text. В полный новый текст включить описание метода, директивы компиляции и комментарий после завершающего ключевого слова. Чтение одного метода может пропускать эти части; oldText в dry-run показывает полный диапазон замены.
  2. Проверить edt_support_status для объекта и сохранить открытый редактор модуля.
  3. Вызвать edt_replace_method без apply. Сравнить oldText и newText, сохранить sourceHash. Новый фрагмент содержит ровно один метод без окружающих областей, блоков препроцессора, переменных и операторов уровня модуля.
  4. Передать тот же новый текст с apply=true, force=true и expectedHash, равным полученному sourceHash. После любого изменения модуля повторить dry-run. Apply возвращает диапазон строк и хеши. Тексты метода возвращаются при dry-run.
  5. Перечитать сохраненный код и вызвать edt_project_errors. Разбор проверяет синтаксис; операция не исправляет вызовы после изменения параметров и не подтверждает работу кода.

Предпросмотр:

{
  "projectName": "Demo",
  "fqn": "CommonModule.Api",
  "methodName": "Calculate",
  "methodText": "Function Calculate(Value) Export\n    Return Value + 1;\nEndFunction"
}

Запись с хешем из этого предпросмотра:

{
  "projectName": "Demo",
  "fqn": "CommonModule.Api",
  "methodName": "Calculate",
  "methodText": "Function Calculate(Value) Export\n    Return Value + 1;\nEndFunction",
  "expectedHash": "<sourceHash из dry-run>",
  "apply": true,
  "force": true
}

oldText и newText включают прилегающие комментарии и директивы: если их не передать в methodText, они будут удалены. sourceHash охватывает весь модуль UTF-8 вместе с BOM; resultHash соответствует предложенному или сохраненному результату. Новый фрагмент получает окончания строк исходного файла. Остальной текст и BOM сохраняются. Некорректные UTF-8 и Unicode дают отказ. При совпадении текста возвращается unchanged=true без записи. Отсутствующий или неоднозначный метод, несохраненный редактор и ошибка разбора исходного модуля также блокируют запись. Операция не создает отсутствующий модуль.

Последнее обновление 16 ноября 2026 г.

Эта страница была полезной?