1c Db Run

/db-run - Запуск 1С:Предприятие

Запускает информационную базу в режиме 1С:Предприятие (пользовательский режим).

Когда EDT доступна

EDT-проект, загруженный в живой AI-EDT, запускается через launch_debugger action=launch, а не этим скриптом. Внешняя обработка или отчет - externalObjectName и при необходимости externalObjectProject, параметры - startupOption, пустой клиент проекта внешних объектов - enableExternalObjectDump=true. Реквизиты подключения кладутся один раз через infobase_admin operation=set_infobase_credentials.

Скрипт db-run.ps1 остается для случая без EDT (формат Конфигуратора, 7.7, headless-прогоны) и для отказа плагина. После отказа launch_debugger, debug_launch или start_client ворота edt-gate открывают окно на 15 минут; снятие - /quality release gate; переменная AI_EDT_GATE=off (любое значение кроме пустого и on) отключает ворота целиком.

Usage

Copy code
/db-run [database]
/db-run dev
/db-run dev /Execute process.epf
/db-run dev /C "параметр запуска"

Параметры подключения

Прочитай .v8-project.json из корня проекта. Возьми v8path (путь к платформе) и разреши базу:

1. Если пользователь указал параметры подключения (путь, сервер) - используй напрямую
2. Если указал базу по имени - ищи по id / alias / name в .v8-project.json
3. Если не указал - сопоставь текущую ветку Git с databases[].branches
4. Если ветка не совпала - используй default Если v8path не задан - автоопределение: Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1 Если файла нет - предложи /db-list add. Если использованная база не зарегистрирована - после выполнения предложи добавить через /db-list add.

Команда

powershellCopy code
powershell.exe -NoProfile -File skills/1c-db-run/scripts/db-run.ps1 <параметры>

Параметры скрипта

* - нужен либо -InfoBasePath, либо пара -InfoBaseServer + -InfoBaseRef

Важно

Скрипт запускает 1С в фоне (Start-Process без -Wait) - управление возвращается сразу.

Примеры

powershellCopy code
# Простой запуск
powershell.exe -NoProfile -File skills/1c-db-run/scripts/db-run.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"

# Запуск с обработкой
powershell.exe -NoProfile -File skills/1c-db-run/scripts/db-run.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -Execute "C:\epf\МояОбработка.epf"

# Открыть по навигационной ссылке
powershell.exe -NoProfile -File skills/1c-db-run/scripts/db-run.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -URL "e1cib/data/Справочник.Номенклатура"

# Серверная база с параметром запуска
powershell.exe -NoProfile -File skills/1c-db-run/scripts/db-run.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -CParam "ЗапуститьОбновление"

Дополнительные аргументы платформы

Аргумент, которого нет среди параметров навыка, передается ключом -AdditionalV8Arguments списком через запятую: -AdditionalV8Arguments "/UseHwLicenses+,/ClearCache". Разделитель запятая, а не пробел, потому что значение аргумента платформы само содержит пробелы.

Постоянный набор задается в .v8-project.json рядом с проектом:

jsonCopy code
{
  "v8args": ["/UseHwLicenses+"],
  "ibcmdargs": ["--verbose"]
}

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

Контроль запуска

Режим предприятия запускается без ожидания завершения, поэтому навык выдерживает контрольное окно и проверяет, что процесс жив. Ожидание прерывается, как только процесс завершился, поэтому полный интервал ждет только успешный запуск; на загруженной машине его увеличивают ключом -StartupCheckSeconds. Платформа с отвергнутыми параметрами завершается почти сразу - в этом случае навык возвращает ошибку, а не сообщение о запуске.