1c-batch

Пакетные операции с платформой 1С.

Запуск скриптов

Скрипты: .cursor/skills/1c-batch/scripts/

Запускать из корня проекта:

.cursor/skills/1c-batch/scripts/build-epf.bat src/epf/МояОбработка.xml build/МояОбработка.epf 

Работа с обработками

build-epf.bat — сборка обработки из XML

.cursor/skills/1c-batch/scripts/build-epf.bat <XML_FILE> <OUTPUT_FILE>

• •XML_FILE — корневой XML-файл обработки
• •OUTPUT_FILE — путь к результирующему файлу .epf или .erf

dump-epf.bat — разборка обработки в XML

.cursor/skills/1c-batch/scripts/dump-epf.bat <XML_FILE> <EPF_FILE>

• •XML_FILE — корневой XML-файл для выгрузки (папка создастся автоматически)
• •EPF_FILE — путь к исходной обработке .epf или .erf

Работа с конфигурацией

load-config.bat — загрузка конфигурации из XML

.cursor/skills/1c-batch/scripts/load-config.bat <XML_DIR> [FILES] [skipdbupdate] 

• •XML_DIR — папка с XML-файлами конфигурации
• •FILES — (опционально) список файлов через запятую для частичной загрузки
• •skipdbupdate — (опционально) пропустить обновление конфигурации БД

По умолчанию после загрузки выполняется обновление конфигурации БД.

Примеры:

REM Полная загрузка 
.cursor/skills/1c-batch/scripts/load-config.bat src/cf 
 
REM Частичная загрузка одного модуля 
.cursor/skills/1c-batch/scripts/load-config.bat src/cf "CommonModules/МойМодуль/Ext/Module.bsl" 
 
REM Частичная загрузка нескольких файлов 
.cursor/skills/1c-batch/scripts/load-config.bat src/cf "CommonModules/Мод1/Ext/Module.bsl,CommonModules/Мод2/Ext/Module.bsl" 

dump-config.bat — выгрузка конфигурации в XML

.cursor/skills/1c-batch/scripts/dump-config.bat <XML_DIR> [update] 

• •XML_DIR — папка для выгрузки
• •update — (опционально) инкрементальная выгрузка (только изменения)

Работа с расширениями

load-extension.bat — загрузка расширения из XML

.cursor/skills/1c-batch/scripts/load-extension.bat <XML_DIR> <EXT_NAME> [skipdbupdate] 

• •XML_DIR — папка с XML-файлами расширения
• •EXT_NAME — имя расширения в базе (если не существует — будет создано)
• •skipdbupdate — (опционально) пропустить обновление расширения в БД

По умолчанию после загрузки выполняется обновление расширения в БД.

dump-extension.bat — выгрузка расширения в XML

.cursor/skills/1c-batch/scripts/dump-extension.bat <XML_DIR> <EXT_NAME> [update] 

• •XML_DIR — папка для выгрузки
• •EXT_NAME — имя расширения в базе
• •update — (опционально) инкрементальная выгрузка (только изменения)

Запуск 1С

run-enterprise.bat — запуск предприятия

.cursor/skills/1c-batch/scripts/run-enterprise.bat [EPF_FILE] 

• •EPF_FILE — (опционально) обработка для автооткрытия

run-designer.bat — запуск конфигуратора

.cursor/skills/1c-batch/scripts/run-designer.bat 

Сценарии использования

Исправить ошибку в обработке

1. •Разобрать: .cursor/skills/1c-batch/scripts/dump-epf.bat src/epf/МояОбработка.xml D:/Исходная.epf
2. •Отредактировать BSL-файлы в src/epf/МояОбработка/
3. •Собрать: .cursor/skills/1c-batch/scripts/build-epf.bat src/epf/МояОбработка.xml build/МояОбработка.epf
4. •Проверить: .cursor/skills/1c-batch/scripts/run-enterprise.bat build/МояОбработка.epf

Загрузка изменённого модуля

После редактирования BSL-файла загрузить его в базу:

.cursor/skills/1c-batch/scripts/load-config.bat src/cf "CommonModules/МойМодуль/Ext/Module.bsl" 

Обновить расширение

1. •Выгрузить: .cursor/skills/1c-batch/scripts/dump-extension.bat src/cfe/МоёРасширение МоёРасширение
2. •Внести изменения
3. •Загрузить: .cursor/skills/1c-batch/scripts/load-extension.bat src/cfe/МоёРасширение МоёРасширение

Правила использования

При выгрузке конфигурации или расширения: если пользователь явно не указал тип выгрузки (полная или инкрементальная), спросить его перед выполнением:

• •Полная выгрузка — выгружает все объекты заново
• •Инкрементальная (update) — выгружает только изменённые объекты (быстрее)

Важно

• •Обработки: первый параметр — XML-файл, второй — выходной файл
• •Конфигурация/расширения: первый параметр — папка
• •При ошибке — код возврата 1
• •НЕ ЧИТАЙ СКРИПТЫ, А ТОЛЬКО ЗАПУСКАЙ ИХ

Конфигурация

Скрипты используют файл .1c-devbase.bat в корне проекта для настройки подключения к базе 1С.

Пример .1c-devbase.bat:

set "ONEC_PATH=C:\Program Files\1cv8\8.3.24.1467\bin\1cv8.exe"

REM Серверная база (приоритет):
set "ONEC_SERVER=server-1c"
set "ONEC_BASE=erp_dev"

REM Или файловая база:
REM set "ONEC_FILEBASE_PATH=D:\Bases\MyBase"

set "ONEC_USER=Администратор"
set "ONEC_PASSWORD="

Важно: Добавьте .1c-devbase.bat в .gitignore — файл содержит учётные данные.