Запись: модули
Инструменты записи для модулей 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.
- Прочитать код через
edt_module_text. В полный новый текст включить описание метода, директивы компиляции и комментарий после завершающего ключевого слова. Чтение одного метода может пропускать эти части;oldTextв dry-run показывает полный диапазон замены. - Проверить
edt_support_statusдля объекта и сохранить открытый редактор модуля. - Вызвать
edt_replace_methodбезapply. СравнитьoldTextиnewText, сохранитьsourceHash. Новый фрагмент содержит ровно один метод без окружающих областей, блоков препроцессора, переменных и операторов уровня модуля. - Передать тот же новый текст с
apply=true,force=trueиexpectedHash, равным полученномуsourceHash. После любого изменения модуля повторить dry-run. Apply возвращает диапазон строк и хеши. Тексты метода возвращаются при dry-run. - Перечитать сохраненный код и вызвать
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 без записи.
Отсутствующий или неоднозначный метод, несохраненный редактор и ошибка разбора исходного
модуля также блокируют запись. Операция не создает отсутствующий модуль.