1
0
mirror of https://github.com/arkuznetsov/1CFilesConverter.git synced 2024-12-10 10:09:59 +02:00
Cкрипты для конвертации файлов 1С между различными форматами (Binary, XML, EDT)
Go to file
2023-07-26 18:08:01 +03:00
scripts refactor: Скрипты выгрузки конфигурации, внешних отчетов и обработок приведены к единой структуре. 2023-07-26 15:40:27 +03:00
tests test: Изменены имена файлов тестов для лучшего понимания назначения. 2023-07-26 18:08:01 +03:00
.gitattributes Инициализация проекта 2023-07-20 17:54:11 +03:00
.gitignore Инициализация проекта 2023-07-20 17:54:11 +03:00
README.md refactor: Убран параметр для указания используемого инструмента конвертации; 2023-07-26 11:50:52 +03:00

Набор скриптов для конвертации файлов 1С между различными форматами (Binary, XML, EDT)

Цель - упростить использование инструментов конвертации до вызова одного скрипта с парой параметров.

Скрипты расположены в каталоге scripts

Необходимые инструменты

Переменные среды

  • 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

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

Источником может выступать:

  • Файл выгрузки конфигурации (cf)
  • Каталог выгрузки конфигурации в файлы (xml)
  • Каталог проекта 1C:Enterprise Development Tools (EDT)

Параметры:

  • Путь к источнику конфигурации
  • Путь к файловой информационной базе

Для указания инструмента конвертации необходимо установить переменную среды %V8_CONVERT_TOOL%.
По умолчанию используется пакетный режим конфигуратора.


ЧТО-ТО ПОШЛО НЕ ТАК! В процессе тестирования выяснилось, что ibcm может не загрузить конфигурацию из файлов (XML), хотя конфигуратор прекрасно справляется.

Проверялось на версии 8.3.20.2290

conf2xml.cmd

Выполняет выгрузку конфигурации из указанного источника в формат выгрузки конфигуратора (XML).

Источником может выступать:

  • Файл выгрузки конфигурации (cf)
  • Файловая информационная база
  • Каталог проекта 1C:Enterprise Development Tools (EDT)

Параметры:

  • Путь к источнику конфигурации
  • Путь к каталогу выгрузки файлов конфигурации

Для указания инструмента конвертации необходимо установить переменную среды %V8_CONVERT_TOOL%.
По умолчанию используется пакетный режим конфигуратора.

conf2edt.cmd

Выполняет выгрузку конфигурации из указанного источника в проект 1C:Enterprise Development Tools (EDT).

Источником может выступать:

  • Файл выгрузки конфигурации (cf)
  • Файловая информационная база
  • Каталог выгрузки конфигурации в файлы (xml)

Параметры:

  • Путь к источнику конфигурации
  • Путь к каталогу проекта EDT

Для указания инструмента конвертации необходимо установить переменную среды %V8_CONVERT_TOOL%.
По умолчанию используется пакетный режим конфигуратора.

conf2cf.cmd

Выполняет выгрузку конфигурации из указанного источника в CF-файл конфигурации.

Источником может выступать:

  • Файловая информационная база
  • Каталог выгрузки конфигурации в файлы (xml)
  • Каталог проекта 1C:Enterprise Development Tools (EDT)

Параметры:

  • Путь к источнику конфигурации
  • Путь к CF-файлу конфигурации

Для указания инструмента конвертации необходимо установить переменную среды %V8_CONVERT_TOOL%.
По умолчанию используется пакетный режим конфигуратора.


ЧТО-ТО ПОШЛО НЕ ТАК! В процессе тестирования выяснилось, что ibcm может не загрузить конфигурацию из файлов (XML), хотя конфигуратор прекрасно справляется.

Проверялось на версии 8.3.20.2290

dp2xml.cmd

Выполняет конвертацию файлов внешних отчетов и обработок в формат выгрузки конфигуратора (XML).

Источником может выступать:

  • Бинарный файл внешнего отчета или обработки (epf, erf)
  • Каталог, содержащий бинарные файлы внешних отчетов и обработок (epf, erf)
  • Каталог проекта 1C:Enterprise Development Tools (EDT)

Параметры:

  • Путь к источнику внешних отчетов и обработок
  • Путь к каталогу для сохранения в формате выгрузки конфигуратора (XML)
  • Путь к информационной базе или конфигурации в любом из форматов (CF, XML, EDT)

Для использования базовой конфигурации в различных форматах может потребовать наличия скрипта conf2ib.cmd

dp2edt.cmd

Выполняет конвертацию файлов внешних отчетов и обработок в проект 1C:Enterprise Development Tools (EDT).

Источником может выступать:

  • Бинарный файл внешнего отчета или обработки (epf, erf)
  • Каталог, содержащий бинарные файлы внешних отчетов и обработок (epf, erf)
  • Каталог внешних отчетов и обработок формате выгрузки конфигуратора (XML)

Параметры:

  • Путь к источнику внешних отчетов и обработок
  • Путь к каталогу проекта 1C:Enterprise Development Tools (EDT)
  • Путь к информационной базе или конфигурации в любом из форматов (CF, XML, EDT)

Для использования базовой конфигурации в различных форматах может потребовать наличия скрипта conf2ib.cmd

dp2epf.cmd

Выполняет сборку внешних отчетов и обработок в бинарный формат (epf/erf).

Источником может выступать:

  • Путь к основному файлу внешнего отчета или обработки в формате выгрузки конфигуратора (XML)
  • Каталог внешних отчетов и обработок формате выгрузки конфигуратора (XML)
  • Каталог проекта 1C:Enterprise Development Tools (EDT)

Параметры:

  • Путь к источнику внешних отчетов и обработок
  • Путь к каталогу для сохранения бинарных файлов внешних отчетов и обработок
  • Путь к информационной базе или конфигурации в любом из форматов (CF, XML, EDT)

Для использования базовой конфигурации в различных форматах может потребовать наличия скрипта conf2ib.cmd

edt-validate.cmd

Выполняет проверку проекта 1C:Enterprise Development Tools (EDT). Может использоваться для проектов конфигураций, расширений, внешних отчетов и отбработок.

Проверяем проектом может выступать:

  • Путь к файловой информационной базе 1С
  • Файл выгрузки конфигурации (cf)
  • Каталог выгрузки конфигурации в файлы (xml)
  • Каталог бинарных файлов внешних отчетов и обработок (epf, erf)
  • Каталог внешних отчетов и обработок формате выгрузки конфигуратора (XML)
  • Каталог проекта 1C:Enterprise Development Tools (EDT)

Параметры:

  • Проверяемый проект
  • Путь к файлу отчета о проверке
  • Путь к информационной базе или конфигурации в любом из форматов (CF, XML, EDT)

Для работы с конфигурациями в различных форматах может потребовать наличия скрипта conf2edt.cmd