cc-1c-skills/docs/build-spec.md

Пакетный режим конфигуратора 1С

Общие сведения

Конфигуратор 1С:Предприятия 8.3 поддерживает пакетный (безоконный) режим для автоматизации операций с конфигурациями, информационными базами и внешними обработками. Все операции выполняются через командную строку 1cv8.exe.

Два режима запуска:

Режим	Назначение
DESIGNER	Конфигуратор — работа с конфигурацией, сборка EPF, обновление БД
ENTERPRISE	Предприятие — запуск обработок, навигация по ссылкам
CREATEINFOBASE	Создание новой информационной базы

Путь к 1cv8.exe зависит от версии платформы: C:\Program Files\1cv8\8.3.27.1859\bin\1cv8.exe.

Подключение к информационной базе

Параметр	Описание
/F <каталог>	Файловая база — каталог с файлом 1Cv8.1CD
/S <адрес>	Серверная база — формат server/ibname
/IBName <имя>	По имени из списка баз (в кавычках если содержит пробелы)
/IBConnectionString	Полная строка соединения

Примеры:

1cv8.exe DESIGNER /F "C:\Bases\MyBase" ...
1cv8.exe DESIGNER /S server-pc/accounting ...
1cv8.exe DESIGNER /IBName "Бухгалтерия предприятия" ...

Аутентификация

Параметр	Описание
/N<имя>	Имя пользователя (без пробела после /N)
/P<пароль>	Пароль (без пробела после /P). Можно опустить если пароля нет
/WA-	Запретить аутентификацию ОС
/WA+	Обязательная аутентификация ОС (по умолчанию)

Важно: между /N и именем, а также между /P и паролем пробела нет: /NАдмин /PSecret123.

Общие параметры пакетного режима

Параметр	Описание
/DisableStartupDialogs	Подавляет интерактивные диалоги. Обязательно для пакетного режима — без него конфигуратор может зависнуть в ожидании ввода
/DisableStartupMessages	Подавляет стартовые предупреждения (несоответствие конфигурации БД и т.п.)
/Out <файл> [-NoTruncate]	Файл для вывода служебных сообщений (UTF-8). -NoTruncate — не очищать файл перед записью
/DumpResult <файл>	Записать числовой код результата в файл (0 — успех, 1 — ошибка, 101 — ошибки проверки)
/Visible	Показать окно конфигуратора (по умолчанию скрыто в пакетном режиме)

Создание информационной базы

1cv8.exe CREATEINFOBASE <строка_соединения> [/AddToList [<имя>]] [/UseTemplate <файл>] [/DumpResult <файл>]

Файловая база

1cv8.exe CREATEINFOBASE File="C:\Bases\EmptyDB"

Серверная база

1cv8.exe CREATEINFOBASE Srvr="server-pc";Ref="new_db"

Параметры

Параметр	Описание
File="<путь>"	Строка соединения для файловой базы
Srvr="<сервер>";Ref="<имя>"	Строка соединения для серверной базы
/AddToList [<имя>]	Добавить в список баз. Имя — необязательно
/UseTemplate <файл>	Создать по шаблону (.cf или .dt)
/DumpResult <файл>	Записать результат (0 — успех)

Работа с конфигурацией — бинарные файлы (CF)

Выгрузка конфигурации в CF-файл

1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /DumpCfg config.cf /Out log.txt

/DumpCfg <файл> [-Extension <имя>] — сохранить конфигурацию в .cf-файл.

Загрузка конфигурации из CF-файла

1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /LoadCfg config.cf /Out log.txt

/LoadCfg <файл> [-Extension <имя>] [-AllExtensions] — загрузить конфигурацию из .cf-файла.

Параметр	Описание
-Extension <имя>	Работа с расширением (указать имя)
-AllExtensions	Работа со всеми расширениями (файл — архив расширений)

После /LoadCfg конфигурация загружается в «основную» конфигурацию конфигуратора. Для применения к БД необходим /UpdateDBCfg.

Работа с конфигурацией — XML-исходники

Выгрузка /DumpConfigToFiles

1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /DumpConfigToFiles <каталог> [параметры] /Out log.txt

Полная сигнатура:

/DumpConfigToFiles <каталог> [-Extension <имя>] [-AllExtensions]
    [-update] [-force] [-getChanges <файл>]
    [-configDumpInfoForChanges <файл>] [-listFile <файл>]
    [-configDumpInfoOnly] [-Server] [-Format <формат>]
    [-Archive <файл>] [-ignoreUnresolvedReferences]

Режимы выгрузки

Полная выгрузка — все объекты конфигурации:

1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /DumpConfigToFiles "C:\src\config" /Out log.txt

Инкрементальная выгрузка — только изменённые объекты:

1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /DumpConfigToFiles "C:\src\config" -update -force /Out log.txt

Инкрементальная выгрузка с отслеживанием изменений:

1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /DumpConfigToFiles "C:\src\config" -update -getChanges "changes.txt" -configDumpInfoForChanges "old\ConfigDumpInfo.xml" /Out log.txt

Частичная выгрузка — выбранные объекты по списку:

1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /DumpConfigToFiles "C:\src\config" -listFile "dump_objects.txt" /Out log.txt

Обновление ConfigDumpInfo.xml — без выгрузки файлов:

1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /DumpConfigToFiles "C:\src\config" -configDumpInfoOnly /Out log.txt

Параметры выгрузки

Параметр	Описание
-update	Обновляющая (инкрементальная) выгрузка — только изменённые объекты
-force	Принудительная полная выгрузка. Используется с -update при несовпадении версий
-getChanges <файл>	Записать список изменённых файлов
-configDumpInfoForChanges <файл>	Файл ConfigDumpInfo.xml для определения изменений
-listFile <файл>	Файл со списком выгружаемых объектов (по одному на строку)
-configDumpInfoOnly	Выгрузить только ConfigDumpInfo.xml
-Extension <имя>	Выгрузить расширение
-AllExtensions	Выгрузить все расширения
-Server	Выгрузка на стороне сервера
-Format <формат>	Формат файлов (Hierarchical / Plain)
-Archive <файл>	Выгрузка в архивный файл
-ignoreUnresolvedReferences	Игнорировать неразрешённые ссылки

Формат listFile для выгрузки

Файл содержит имена объектов метаданных (одно на строку):

Справочник.Номенклатура
Справочник.Валюты
Документ.РеализацияТоваровУслуг
Отчет.АнализПродаж

Кодировка: UTF-8 с BOM.

Загрузка /LoadConfigFromFiles

1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /LoadConfigFromFiles <каталог> [параметры] /Out log.txt

Полная сигнатура:

/LoadConfigFromFiles <каталог> [-Extension <имя>] [-AllExtensions]
    [-updateConfigDumpInfo] [-listFile <файл>]
    [-Server] [-Archive <файл>] [-Format <формат>]

Режимы загрузки

Полная загрузка — замена всей конфигурации:

1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /LoadConfigFromFiles "C:\src\config" /Out log.txt

Частичная загрузка — выбранные файлы по списку:

1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /LoadConfigFromFiles "C:\src\config" -listFile "load_list.txt" -Format Hierarchical -partial -updateConfigDumpInfo /Out log.txt

Параметры загрузки

Параметр	Описание
-listFile <файл>	Файл со списком загружаемых файлов (по одному на строку)
-partial	Частичная загрузка — не заменять всю конфигурацию, а внести точечные изменения. Недокументированный, но рабочий параметр
-updateConfigDumpInfo	Обновить ConfigDumpInfo.xml после загрузки
-Extension <имя>	Загрузить в расширение
-AllExtensions	Загрузить все расширения
-Server	Загрузка на стороне сервера
-Archive <файл>	Загрузка из архивного файла
-Format <формат>	Формат файлов (Hierarchical / Plain)

Формат listFile для загрузки

Файл содержит относительные пути к файлам в каталоге выгрузки (один на строку):

Catalogs/Валюты.xml
Catalogs/Валюты/Ext/ObjectModule.bsl
Documents/РеализацияТоваровУслуг.xml
Documents/РеализацияТоваровУслуг/Forms/ФормаДокумента.xml

Кодировка: UTF-8 с BOM.

Важно: различие форматов listFile для dump и load:

• Выгрузка (/DumpConfigToFiles -listFile): имена объектов метаданных — Справочник.Номенклатура
• Загрузка (/LoadConfigFromFiles -listFile): относительные пути файлов — Catalogs/Валюты.xml

Обновление конфигурации БД

1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /UpdateDBCfg /Out log.txt

Полная сигнатура:

/UpdateDBCfg [-Dynamic<режим>] [-Server]
    [-WarningsAsErrors]
    [-BackgroundStart] [-BackgroundFinish]
    [-BackgroundCancel] [-BackgroundSuspend] [-BackgroundResume]
    [-Extension <имя>] [-AllExtensions]

Параметр	Описание
-Dynamic+	Использовать динамическое обновление
-Dynamic-	Не использовать динамическое обновление
-Server	Обновление на стороне сервера
-WarningsAsErrors	Предупреждения считать ошибками
-Extension <имя>	Обновить расширение
-AllExtensions	Обновить все расширения

Фоновое обновление

Параметр	Описание
-BackgroundStart	Начать фоновое обновление
-BackgroundFinish	Дождаться окончания и завершить
-BackgroundCancel	Отменить фоновое обновление
-BackgroundSuspend	Приостановить
-BackgroundResume	Возобновить

После /LoadCfg или /LoadConfigFromFiles необходимо выполнить /UpdateDBCfg чтобы изменения применились к базе данных.

Сборка и разборка внешних обработок (EPF/ERF)

Сборка (XML → EPF)

1cv8.exe DESIGNER /F <путь_к_базе> /DisableStartupDialogs /LoadExternalDataProcessorOrReportFromFiles <корневой_xml> <путь_к_epf> /Out <лог_файл>

Параметр	Описание
<корневой_xml>	Путь к корневому XML-файлу обработки (например, src\МояОбработка.xml)
<путь_к_epf>	Путь к выходному файлу .epf или .erf

Важно: первый аргумент — путь к корневому XML-файлу (не к каталогу). Если указать каталог, конфигуратор вернёт ошибку.

Разборка (EPF → XML)

1cv8.exe DESIGNER /F <путь_к_базе> /DisableStartupDialogs /DumpExternalDataProcessorOrReportToFiles <каталог_выгрузки> <путь_к_epf> [-Format Hierarchical] /Out <лог_файл>

Параметр	Описание
<каталог_выгрузки>	Каталог для XML-файлов
<путь_к_epf>	Исходный файл .epf или .erf
-Format Hierarchical	Иерархическая структура каталогов (по умолчанию)
-Format Plain	Плоская структура

Примечания по сборке

• Если база не указана — скрипт epf-build.ps1 автоматически создаёт временную базу. Для обработок со ссылочными типами (CatalogRef.*, DocumentRef.* и т.п.) генерируются заглушки метаданных. Временная база удаляется после сборки.
• Категории колонок регистров (Dimension/Resource/Attribute) угадываются по Form.xml — при round-trip через реальную базу привязки полей формы могут не сохраниться.

Примечания по разборке

• Разборка обязательно требует базу с конфигурацией, содержащей используемые типы.
• Dump в пустой базе безвозвратно теряет ссылочные типы — CatalogRef.XXX превращается в xs:string.

Запуск в режиме предприятия

1cv8.exe ENTERPRISE /F <база> [/N<имя> /P<пароль>] /DisableStartupDialogs [параметры]

Параметр	Описание
/Execute <файл.epf>	Запуск внешней обработки сразу после старта. При указании /Execute параметр /URL игнорируется
/URL <ссылка>	Навигационная ссылка (формат e1cib/...)
/C <строка>	Передача параметра в прикладное решение

Примеры:

1cv8.exe ENTERPRISE /F "C:\Bases\MyBase" /NАдмин /PSecret /DisableStartupDialogs /Execute "C:\scripts\process.epf"

1cv8.exe ENTERPRISE /IBName "Бухгалтерия" /NАдмин /DisableStartupDialogs /URL "e1cib/data/Справочник.Номенклатура"

Коды возврата

Код	Значение
0	Успешно
1	Ошибка
101	Ошибки при проверке конфигурации

Числовой код можно записать в файл через /DumpResult <файл>.

При работе с расширениями (-Extension, -AllExtensions): 0 — успех, 1 — ошибка.

ConfigDumpInfo.xml

ConfigDumpInfo.xml — служебный файл, создаваемый при выгрузке конфигурации в файлы (/DumpConfigToFiles). Содержит информацию о составе и версиях объектов конфигурации на момент выгрузки.

Назначение:

• Определение изменений при инкрементальной выгрузке (-update, -configDumpInfoForChanges)
• Синхронизация состояния выгрузки с конфигурацией ИБ

Использование:

• -configDumpInfoForChanges <файл> — передать предыдущий ConfigDumpInfo.xml для определения изменений
• -configDumpInfoOnly — обновить только этот файл без выгрузки объектов
• -updateConfigDumpInfo — обновить файл после частичной загрузки (/LoadConfigFromFiles)

Расположение: корень каталога выгрузки (рядом с Configuration.xml).

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

Переменная	Описание
V8_PATH	Каталог bin платформы 1С (например, C:\Program Files\1cv8\8.3.27.1859\bin)
V8_BASE	Путь к пустой ИБ для EPF-сборки (создаётся автоматически при первом запуске)