tools-only Пакетный режим конфигуратора 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 |
Плоская структура |
Примечания
- Пустая ИБ достаточна для сборки, если обработка не ссылается на объекты конфигурации.
- Если обработка использует ссылочные типы конфигурации (
CatalogRef.*,DocumentRef.*и т.п.) — в реквизитах, табличных частях или реквизитах форм — сборка в пустой базе упадёт с ошибкой XDTO. Необходима база с целевой конфигурацией.
Запуск в режиме предприятия
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-сборки (создаётся автоматически при первом запуске) |