# Набор скриптов для конвертации файлов 1С между различными форматами (Binary, XML, EDT) Цель - упростить использование инструментов конвертации до вызова одного скрипта с парой параметров. Скрипты расположены в каталоге [scripts](./scripts) ## Необходимые инструменты * [Платформа 1С:Предприятие 8.3](https://releases.1c.ru/project/Platform83) * [Java runtime environment 11](https://releases.1c.ru/project/Liberica11FullJDK) * [1C:Enterprise Development Tools (EDT)](https://releases.1c.ru/project/DevelopmentTools10) * Утилита ring (входит в состав EDT) ## Переменные среды * **V8_VERSION** - версия используемой платформы 1С:Предприятие (по умолчанию: `8.3.20.2290`) * **V8_TEMP** - путь к каталогу для создания временных файлов в процессе конвертации (по умолчанию: `%TEMP%\1c`) * **V8_CONVERT_TOOL** - инструмент для конвертации файлов конфигурации (по умолчанию: `designer`): * **designer** - для конвертации используется пакетный режим конфигуратора * **ibcmd** - для конвертации используется утилита администрирования автономного сервера * **V8_RING_TOOL** - путь к утилите ring из состава EDT (по умолчанию берется из переменной окружения `%PATH%`) ## Скрипты конвертации ### [conf2ib.cmd](./scripts/cf2ib.cmd) Выполняет загрузку конфигурации из указанного источника в файловую информационную базу. Источником может выступать: * Файл выгрузки конфигурации (cf) * Каталог выгрузки конфигурации в файлы (xml) * Каталог проекта 1C:Enterprise Development Tools (EDT) Параметры: * Путь к источнику конфигурации * Путь к файловой информационной базе ```txt Для указания инструмента конвертации необходимо установить переменную среды %V8_CONVERT_TOOL%. По умолчанию используется пакетный режим конфигуратора. ``` ```txt ЧТО-ТО ПОШЛО НЕ ТАК! В процессе тестирования выяснилось, что ibcm может не загрузить конфигурацию из файлов (XML), хотя конфигуратор прекрасно справляется. Проверялось на версии 8.3.20.2290 ``` ### [conf2cf.cmd](./scripts/conf2cf.cmd) Выполняет конвертацию конфигурации из указанного источника в бинарный CF-файл. Источником может выступать: * Файловая информационная база * Каталог выгрузки конфигурации в файлы (xml) * Каталог проекта 1C:Enterprise Development Tools (EDT) Параметры: * Путь к источнику конфигурации * Путь к файлу конфигурации (cf) ```txt Для указания инструмента конвертации необходимо установить переменную среды %V8_CONVERT_TOOL%. По умолчанию используется пакетный режим конфигуратора. ``` ```txt ЧТО-ТО ПОШЛО НЕ ТАК! В процессе тестирования выяснилось, что ibcm может не загрузить конфигурацию из файлов (XML), хотя конфигуратор прекрасно справляется. Проверялось на версии 8.3.20.2290 ``` ### [conf2xml.cmd](./scripts/conf2xml.cmd) Выполняет выгрузку конфигурации из указанного источника в формат выгрузки конфигуратора (XML). Источником может выступать: * Путь к файлу конфигурации (cf) * Файловая информационная база * Каталог проекта 1C:Enterprise Development Tools (EDT) Параметры: * Путь к источнику конфигурации * Путь к каталогу выгрузки файлов конфигурации ```txt Для указания инструмента конвертации необходимо установить переменную среды %V8_CONVERT_TOOL%. По умолчанию используется пакетный режим конфигуратора. ``` ### [conf2edt.cmd](./scripts/conf2edt.cmd) Выполняет выгрузку конфигурации из указанного источника в проект 1C:Enterprise Development Tools (EDT). Источником может выступать: * Путь к файлу конфигурации (cf) * Файловая информационная база * Каталог выгрузки конфигурации в файлы (xml) Параметры: * Путь к источнику конфигурации * Путь к каталогу проекта EDT ```txt Для указания инструмента конвертации необходимо установить переменную среды %V8_CONVERT_TOOL%. По умолчанию используется пакетный режим конфигуратора. ``` ### [dp2epf.cmd](./scripts/dp2epf.cmd) Выполняет конвертацию внешних отчетов и обработок в бинарный формат (epf/erf). Источником может выступать: * Путь к основному файлу внешнего отчета или обработки в формате выгрузки конфигуратора (XML) * Каталог внешних отчетов и обработок формате выгрузки конфигуратора (XML) * Каталог проекта 1C:Enterprise Development Tools (EDT) Параметры: * Путь к источнику внешних отчетов и обработок * Путь к каталогу для сохранения бинарных файлов внешних отчетов и обработок * Путь к информационной базе или конфигурации в любом из форматов (CF, XML, EDT) Для использования базовой конфигурации в различных форматах может потребовать наличия скрипта [conf2ib.cmd](./scripts/conf2ib.cmd) ### [dp2xml.cmd](./scripts/dp2xml.cmd) Выполняет конвертацию файлов внешних отчетов и обработок в формат выгрузки конфигуратора (XML). Источником может выступать: * Файл внешнего отчета или обработки (epf, erf) * Каталог, содержащий бинарные файлы внешних отчетов и обработок (epf, erf) * Каталог проекта 1C:Enterprise Development Tools (EDT) Параметры: * Путь к источнику внешних отчетов и обработок * Путь к каталогу для сохранения в формате выгрузки конфигуратора (XML) * Путь к информационной базе или конфигурации в любом из форматов (CF, XML, EDT) Для использования базовой конфигурации в различных форматах может потребовать наличия скрипта [conf2ib.cmd](./scripts/conf2ib.cmd) ### [dp2edt.cmd](./scripts/dp2edt.cmd) Выполняет конвертацию файлов внешних отчетов и обработок в проект 1C:Enterprise Development Tools (EDT). Источником может выступать: * Файл внешнего отчета или обработки (epf, erf) * Каталог, содержащий бинарные файлы внешних отчетов и обработок (epf, erf) * Каталог внешних отчетов и обработок формате выгрузки конфигуратора (XML) Параметры: * Путь к источнику внешних отчетов и обработок * Путь к каталогу проекта 1C:Enterprise Development Tools (EDT) * Путь к информационной базе или конфигурации в любом из форматов (CF, XML, EDT) Для использования базовой конфигурации в различных форматах может потребовать наличия скрипта [conf2ib.cmd](./scripts/conf2ib.cmd) ### [ext2cfu.cmd](./scripts/ext2cfu.cmd) Выполняет конвертацию расширения конфигурации из указанного источника в бинарный CFU-файл. Источником может выступать: * Каталог выгрузки расширения конфигурации в файлы (xml) * Каталог проекта 1C:Enterprise Development Tools (EDT) Параметры: * Путь к источнику расширения конфигурации * Путь к бинарному файлу расширения конфигурации (cfu) * Путь к информационной базе или конфигурации в любом из форматов (CF, XML, EDT) ```txt Для указания инструмента конвертации необходимо установить переменную среды %V8_CONVERT_TOOL%. По умолчанию используется пакетный режим конфигуратора. ``` Для использования базовой конфигурации в различных форматах может потребовать наличия скрипта [conf2ib.cmd](./scripts/conf2ib.cmd) ### [ext2xml.cmd](./scripts/ext2xml.cmd) Выполняет конвертацию расширения конфигурации в формат выгрузки конфигуратора (XML). Источником может выступать: * Файл выгрузки расширения конфигурации (cfu) * Каталог проекта 1C:Enterprise Development Tools (EDT) Параметры: * Путь к источнику расширения конфигурации * Путь к каталогу для сохранения в формате выгрузки конфигуратора (XML) * Путь к информационной базе или конфигурации в любом из форматов (CF, XML, EDT) ```txt Для указания инструмента конвертации необходимо установить переменную среды %V8_CONVERT_TOOL%. По умолчанию используется пакетный режим конфигуратора. ``` Для использования базовой конфигурации в различных форматах может потребовать наличия скрипта [conf2ib.cmd](./scripts/conf2ib.cmd) ### [ext2edt.cmd](./scripts/ext2edt.cmd) Выполняет конвертацию расширения конфигурации в проект 1C:Enterprise Development Tools (EDT). Источником может выступать: * Файл выгрузки расширения конфигурации (cfu) * Каталог выгрузки расширения конфигурации в файлы (xml) Параметры: * Путь к источнику расширения конфигурации * Путь к каталогу проекта 1C:Enterprise Development Tools (EDT) * Путь к информационной базе или конфигурации в любом из форматов (CF, XML, EDT) ```txt Для указания инструмента конвертации необходимо установить переменную среды %V8_CONVERT_TOOL%. По умолчанию используется пакетный режим конфигуратора. ``` Для использования базовой конфигурации в различных форматах может потребовать наличия скрипта [conf2ib.cmd](./scripts/conf2ib.cmd) ### [edt-validate.cmd](./scripts/edt-validate.cmd) Выполняет проверку проекта 1C:Enterprise Development Tools (EDT). Может использоваться для проектов конфигураций, расширений, внешних отчетов и отбработок. Проверяем проектом может выступать: * Путь к файловой информационной базе 1С * Файл конфигурации (cf) * Файл расширения конфигурации (cfu) * Каталог выгрузки конфигурации или расширения в файлы (xml) * Каталог файлов внешних отчетов и обработок (epf, erf) * Каталог внешних отчетов и обработок формате выгрузки конфигуратора (XML) * Каталог проекта 1C:Enterprise Development Tools (EDT) Параметры: * Проверяемый проект * Путь к файлу отчета о проверке * Путь к информационной базе или конфигурации в любом из форматов (CF, XML, EDT) Для работы с конфигурациями в различных форматах может потребовать наличия скрипта [conf2edt.cmd](./scripts/conf2edt.cmd)