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

Настройка

Страница параметров EDT-Bridge в EDT, переменные окружения EDT_BRIDGE_* обвязки и плагина, граница записи.

Плагин читает настройки со страницы параметров EDT-Bridge в EDT, из переменных окружения EDT_BRIDGE_* и из свойств запуска -Dedt.bridge.*. Обвязка читает переменные окружения и флаги командной строки.

Настройки в самой EDT

Страница параметров плагина находится в разделе Окно ▸ Параметры ▸ EDT-Bridge. Здесь можно указать токен для моста, работающего внутри EDT с интерфейсом:

Параметр Что это
Токен для инструментов записи Общий секрет, который требует каждый инструмент записи. Пустой токен означает, что запись запрещена, а не что она открыта всем. Клиенту передается то же значение под именем EDT_BRIDGE_TOKEN.
Порт MCP-сервера По умолчанию 8770. Вступает в силу после перезапуска EDT, а до перезапуска работающий сервер держит прежний порт.
Разрешить выполнение произвольного кода BSL при отладке По умолчанию выключено. Этот переключатель закрывает edt_evaluate, который исполняет код против живой информационной базы. Только тестовые стенды.

Системные свойства -Dedt.bridge.* и переменные окружения EDT_BRIDGE_*, заданные при запуске, имеют приоритет над сохраненными параметрами. Обвязка использует их для управления headless EDT. Если токен указан при запуске, значение со страницы параметров не применяется.

Переменные окружения

Настройки у обвязки и у плагина называются одинаково, EDT_BRIDGE_*, но читают их разные стороны: обвязка при своем запуске, плагин внутри EDT. У большинства настроек обвязки есть флаг-двойник, он описан в Командах.

Читает обвязка edt-bridge-mcp

Переменная Флаг По умолчанию Что задает
EDT_BRIDGE_PORT --port 8770 порт, на котором обвязка ищет мост
EDT_BRIDGE_PORT_SCAN – 20 сколько портов подряд начиная с этого просматривать. Занятый порт плагин отдает следующему свободному, и в этом же окне мост потом ищется
EDT_BRIDGE_TOKEN – пусто токен инструментов записи. Передается в заголовке Authorization: Bearer и передается в JVM headless-экземпляра
EDT_BRIDGE_WORKSPACE --workspace – рабочая область EDT для автоматического запуска headless
EDT_BRIDGE_EDT_DIR --edt-dir самая свежая установка каталог установки EDT (папка с 1cedtcli и dropins). Без него берется установка с самым свежим eclipse.buildId в configuration/config.ini, а если его там нет – по версии в имени каталога. Если в ini нет -vm, а версия Java из PATH ниже требуемой, мост ищет подходящий JDK в JAVA_HOME, затем среди компонентов установщика 1С. В процессе EDT мост задает JAVA_HOME для выбранного JDK и ставит его первым в PATH
EDT_BRIDGE_START_TIMEOUT --start-timeout 360 сколько секунд ожидать запуск моста
EDT_BRIDGE_AUTOSTART --no-autostart включен 0 – не запускать EDT и только пересылать запросы. Отказ “not running” приходит, только когда порт никто не слушает. Если мост уже отвечал, а под тяжелыми вызовами стал отвечать медленно, вызов все равно уходит к нему и ждет своей очереди
EDT_BRIDGE_HEAP --heap из установки EDT наибольший размер кучи JVM для автоматически запущенной headless EDT: число с k, m или g, например 6g. Передается как -Xmx и заменяет значение из ini-файла установки
EDT_BRIDGE_VMARGS --vmargs – другие параметры JVM для автоматически запущенной headless EDT через пробел, например -XX:+ExitOnOutOfMemoryError -Xlog:gc:file=gc.log. Каждый параметр начинается с дефиса, порт моста задает EDT_BRIDGE_PORT
EDT_BRIDGE_WINDOW_WAIT – 90 сколько секунд команда gui ждет появления окна EDT. Загрузка большой рабочей области может занять несколько минут; если окно не появилось, команду можно повторить
EDT_BRIDGE_LANG – язык системы язык справки и сообщений обвязки (ru или en)
EDT_BRIDGE_NO_PLUGINS – выкл 1 – не искать плагины обвязки, оставить только штатные возможности
EDT_BRIDGE_TOOLSET – все инструменты набор инструментов или несколько через запятую: processor, report, extension. Обвязка перечисляет и вызывает только их инструменты, включая свои и инструменты плагинов. Неизвестное имя приводит к отказу в списке и в каждом вызове
EDT_BRIDGE_WRITE_PROJECTS, EDT_BRIDGE_READ_PROJECTS, EDT_BRIDGE_OUTPUT_DIR – – граница записи, которую ждет обвязка. EDT, запущенная обвязкой, получает ее по наследству, а вызов к EDT с другой границей получает отказ, пока они не совпадут
EDT_BRIDGE_PLUGIN_INDEX – – адрес реестра пакетов, который self-update передает pip для плагинов, установленных по имени проекта. У плагина, поставленного из git, источник свой

Читает плагин внутри EDT

Переменная Свойство запуска По умолчанию Что задает
EDT_BRIDGE_PORT -Dedt.bridge.port 8770 порт MCP-сервера. Если он занят, берется следующий свободный
EDT_BRIDGE_TOKEN -Dedt.bridge.token со страницы параметров общий секрет, который требует каждый инструмент записи
EDT_BRIDGE_ALLOW_EVALUATE – выключено 1 разрешает edt_evaluate – исполнение произвольного BSL против живой информационной базы. То же самое включается на странице параметров
EDT_BRIDGE_AGENT_IDLE_MINUTES -Dedt.bridge.agent-idle-minutes 30 через сколько минут простоя агент конфигуратора останавливается сам. off – держать вечно
EDT_BRIDGE_DUMP_INFOBASE – – файловая база (каталог, ее 1Cv8.1CD или File="...";) с базовой конфигурацией внешних объектов. Маршрут edt_dump_external_object через платформу на диске собирает в ее копии, и типы базовой конфигурации разрешаются; без нее сборка идет в пустой базе. edt_build_extension тоже импортирует расширение в ее копию: заимствованная форма, исключившая команды основного реквизита (Post, Write), и типы базовой конфигурации проверяются по этой конфигурации
EDT_BRIDGE_TEST_INFOBASE – – файловая база с тестовыми данными для edt_test_form и edt_unit_tests; каждый запуск работает со свежей копией ее 1Cv8.1CD; для edt_unit_tests в ней нужно расширение YAXUNIT
EDT_BRIDGE_TEST_PLATFORM – – каталог bin платформы с 1cv8 и ibcmd, которую запускают edt_test_form и edt_unit_tests
EDT_BRIDGE_TEST_USER – – пользователь базы для edt_test_form и edt_unit_tests, если в тестовой базе есть пользователи
EDT_BRIDGE_TEST_WEB_HTTPD – /usr/local/apache2/bin/httpd исполняемый файл Apache 2.4 для снимков веб-клиента с маской
EDT_BRIDGE_TEST_CACHE – ~/.cache/edt-bridge/test-manager где test-form и edt_test_form хранят готовую служебную базу каждой сборки платформы, чтобы ее создавала только первая проверка сборки; off готовит ее для каждой проверки. Образ стенда может нести уже заполненный каталог; см. Подготовка окружения
EDT_BRIDGE_PLATFORM – C:\Program Files\1cv8\8.5.1.1529\bin установка 1С:Предприятия 8.5, из которой edt_form_render берет значки и шрифты веб-клиента; по умолчанию самая новая из установленных. Параметр вызова platformPath важнее
EDT_BRIDGE_ASSET_CACHE – ~/.cache/edt-bridge/client-assets где edt_form_render хранит значки и шрифты, прочитанные из сборки платформы, чтобы файлы платформы читала только первая отрисовка сборки
EDT_BRIDGE_TOOLSET -Dedt.bridge.toolset все инструменты те же наборы на стороне моста: tools/list возвращает только их инструменты, вызов другого инструмента отклоняется с перечнем наборов, в которые он входит. edt_tool_help называет наборы любого инструмента, /status – действующие наборы. Описания и подсказки валидации отмечают инструменты вне действующих наборов при первом упоминании: (outside the active tool set 'report': a call of it is refused)
EDT_BRIDGE_WRITE_PROJECTS -Dedt.bridge.write.projects все проекты проекты, которые инструменты могут менять, через запятую; см. Граница записи
EDT_BRIDGE_READ_PROJECTS -Dedt.bridge.read.projects – проекты, которые инструменты могут только читать
EDT_BRIDGE_OUTPUT_DIR -Dedt.bridge.output.dir любой абсолютный каталог, в котором должны лежать файлы, записанные инструментами
EDT_BRIDGE_PII -Dedt.bridge.pii off redact или pseudonym убирает персональные данные из ответов с данными базы, в мосте и в обвязке; см. Персональные данные
EDT_BRIDGE_PII_SALT -Dedt.bridge.pii.salt своя на процесс секретная соль псевдонимов: с ней одинаковое значение получает одинаковый псевдоним в любом сеансе
EDT_BRIDGE_PII_RULES -Dedt.bridge.pii.rules – файл JSON со своими правилами: values (kind и pattern) и names (kind и шаблон имени поля pattern)

Граница записи

Набор инструментов ограничивает, какие инструменты работают, но не то, куда они пишут. Агента ограничивают три настройки: проекты, которые он может менять (EDT_BRIDGE_WRITE_PROJECTS), проекты только для чтения (EDT_BRIDGE_READ_PROJECTS) и каталог для файлов, которые пишут инструменты (EDT_BRIDGE_OUTPUT_DIR). Мост проверяет каждый вызов до запуска инструмента, поэтому клиент, который обращается к порту напрямую, упирается в ту же границу. Отказ называет разрешенное.

Если списки проектов заданы, инструмент с пометкой WRITE меняет только проект из первого списка, а читать любой инструмент может только проекты обоих списков; инструменту, который без проекта читает все проекты, нужен projectName. Новое расширение или внешний объект получает имя из первого списка. Файлы, которые пишут инструменты, – targetPath, logPath, outputPath, outPath и каталог новой базы – должны лежать в каталоге результатов; как только задана любая из настроек, файл больше никуда не пишется. modulePath не может выходить за пределы своего проекта. /status сообщает границу, которую держит мост.

Настройки попадают в EDT через окружение ее процесса: EDT, запущенная обвязкой, получает их по наследству. Если настройки есть у обвязки, а работающая EDT сообщает другую границу, обвязка отказывает в вызовах, пока EDT не перезапустят с теми же настройками.

Персональные данные

Если задана EDT_BRIDGE_PII, ответы с данными базы до отправки очищаются от персональных данных, и в плагине, и в обвязке. Какие инструменты это затрагивает, как фильтр находит данные, псевдонимы, свои правила и поля отфильтрованного ответа описаны на странице Персональные данные.

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

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