Конвертация файлов 1С

20.03.24

Разработка - Инструментарий разработчика

Существует уже 3 формата хранения кода 1С: бинарный, XML, EDT. Разработка облегчает конвертацию между форматами для конфигураций, расширений, внешних обработок и отчетов. И немного магии автоматизации.

Скачать исходный код

Наименование Файл Версия Размер
1C files converter
.zip 236,24Kb
2
.zip 1.5.2 236,24Kb 2 Скачать

С чем живем

  • 3 формата хранения кода 1С: бинарный, XML, EDT
  • 3 вида компонент: конфигурации, расширения, внешние отчеты и обработки

Также есть неограниченное количество инструментов редактирования:

  • Конфигуратор
  • 1C: Enterprise Development tools (EDT)
  • Visual Studio Code (VSC)

и прочее.

Инструмент разработки может выбираться в зависимости от того, что в данный момент удобнее или быстрее. Но в итоге, основное хранилище исходников обычно имеет один единственный формат.

Чего бы хотелось

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

Что использовать

Для целей преобразования существуют следующие инструменты:

  • Конфигуратор (в т.ч. пакетный режим) - обеспечивает преобразование между бинарным форматом и XML
  • Утилита администрирования автономного сервера (ibcmd) - те же возможности что и у конфигуратора
  • Утилита ring (часть EDT и без EDT не работает) - позволяет выполнять конвертацию между форматом XML и EDT

Как видно не всякое преобразование возможно выполнить за 1 вызов простой команды. Также надо учитывать дополнительные требования наличия "базовой" конфигурации для преобразования расширений и внешних отчетов/обработок.

Что получилось сделать

Я сделал попытку упростить процесс конвертации форматов компонент 1С и ниже о том, что из этого вышло.

Инструмент реализован в виде набора CMD (bat)-скриптов. Почему так? Такое было настроение! И заодно получился небольшой справочный материал с примерами основных приемов, на случай если захочется подобное повторить (скорее всего нет! :-)).

Скрипты разделены исходя из обрабатываемых компонет и целевого формата результата.

 

4 скрипта конвертации конфигурации 1С.

Вход: Информационная база, CF-файл, XML-выгрузка, проект EDT:

  • conf2ib.cmd - в информационную базу
  • conf2cf.cmd - в CF-файл
  • conf2xml.cmd - в XML-выгрузку
  • conf2edt.cmd - в проект EDT

Пример:

conf2xml.cmd "c:\Projects\MyAmazingConfiguration\1cv8.cf" "c:\Repos\MyAmazingConfiguration\src\cf"

Отдельно в переменной среды V8_CONVERT_TOOL можно указать используемый инструмент для конвертации - "Утилита администрирования автономного сервера (ibcmd)" или "Пакетный режим конфигуратора (designer)". По умолчанию используется designer.

 

3 скрипта конвертации расширения конфигурации.

Вход: CFE-файл, XML-выгрузка, проект EDT.

  • ext2cfe.cmd- в CFE-файл
  • ext2xml.cmd- в XML-выгрузку
  • ext2edt.cmd - в проект EDT

Требуется указывать имя расширения для конвертации.

Для сохранности типов данных рекомендуется указывать базовую конфигурацию 4-м параметром.

Пример:

ext2xml.cmd "c:\Projects\MyExcellentExtention.cfe" "c:\Repos\MySuperProject\src\cfe" "MyExcellentExtention" "c:\Projects\MyAmazingConfiguration\1cv8.cf"

Отдельно в переменной среды V8_CONVERT_TOOL можно указать используемый инструмент для конвертации - "Утилита администрирования автономного сервера (ibcmd)" или "Пакетный режим конфигуратора (designer)". По умолчанию используется designer.

 

3 скрипта конвертации внешних отчетов и обработок.

Вход: Бинарный файл или каталог бинарных файлов (EPF, ERF), XML-выгрузка отчета/обработки или каталог, проект EDT.

  • dp2epf.cmd - в бинарные EPF/ERF-файлы
  • dp2xml.cmd- в XML-выгрузку
  • dp2edt.cmd- в проект EDT

Для сохранности типов реквизитов рекомендуется указывать базовую конфигурацию 3-м параметром.

Пример:

dp2xml.cmd "c:\Projects\MyWonderfullDataProcessors" "c:\Repos\MySuperProject\src\ext" "c:\Projects\MyAmazingConfiguration\1cv8.cf"

Для конвертации отчетов и обработок всегда используется "Пакетный режим конфигуратора (designer)".

 

Отдельно "до кучи" валидация средствами EDT - edt-validate.cmd

Вход: Любой из вышеперечисленных компонент в любом формате. 

Пример:

edt-validate.cmd "c:\projects\MyShadyConfig\1cv8.cf" "c:\tmp\validateResult.txt"
 
 Под катом описание параметров скриптов

Some kind of magic

Есть люди (не будем показывать пальцем), кто хранит и версионирует разработки для 1С в GIT. Для таких целей инструменты существуют давно и в ассортименте. Но с внешними отчетами и обработками есть нюанс - распространенные инструменты не позволяют увидеть, что было изменено в коде до выполнения комманды git commit.

Довольно давно "на просторах" попался инструмент watchman от организации запрещенной в РФ, который позволит нам разрешить вышеозначенную проблему, т.е. разобрать отчет или обработку на исходники непосредственно в момент сохранения изменений бинарного файла.

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

  • Подписаться на отслеживание изменений в каталоге
  • Назначить триггер в виде команды для события изменения файлов указанного типа
     

Я добавил пару скриптов для демонстрации работы с watchman.

Основной скрипт регистрации триггера settrigger.cmd - назначает триггер для обработки изменений файлов в указанном каталоге.

Пример:

settrigger.cmd "MyWonderfullDataProcessorsTrigger" "c:\Repos\MySuperProject\ext" "epf erf" dp2xml "c:\Repos\MySuperProject\src\ext"

В примере мы регистрируем триггер для отслеживания изменений файлов с расширениями "epf" и "erf" в каталоге "c:\Repos\MySuperProject\ext", где мы сохраняем бинарные файлы отчетов и обработок.
В момент изменения наш триггер срабатывает и запускается "разборка" измененного отчета/обработки на файлы XML в каталог "c:\Repos\MySuperProject\src\ext".
 

В итоге

Получился набор скриптов конвертации конфигураций, расширений, внешних отчетов и обработок 1С между различными форматами (бинарным, XML, EDT) с простым интерфейсом вызова.
Также есть рабочий пример автоматизации разбора "на лету" бинарных форматов компонент 1С в форматы для хранения в системе контроля версий.

Show must go on...

В дальнейшем, по желанию заинтересовавшихся или сам снервничаю, можно реализовать вариант этого набора скриптов для Linux или на OneScript.
Как обычно жду ваших issue, а лучше PR! :-)

Тестировалось на версии платформы 8.3.20.2290.

Ссылки

  • Проект на GitHub (там описание и over 70 тестов, где можно подсмотреть примеры)
  • Документация Watchman
     

UPD 1.5.2: Исправлены ошибки, подробности тут.

 

UPD 1.5.1: Исправлены ошибки, подробности тут.

 

UPD 1.5.0: В новой версии 1.5.0 добавлены примеры и шаблоны производных скриптов, подробности тут.

 

UPD 1.4.0: В новой версии 1.4.0 реализована выгрузка/загрузка расширений конфигурации в информационную базу, подробности тут.

 

UPD 1.3.0: В новой версии 1.3.0 реализованы возможности установки кодировки вывода команд и указания пути к рабочему каталогу автономного сервера, добавлен вывод сообщений конфигуратора в общий лог выполнения, подробности тут.

 

UPD 1.1.1: В новой версии 1.1.1 реализована возможность указания используемой версии EDT через переменную среды V8_EDT_VERSION, подробности тут.

 

UPD 1.1.0: В новой версии 1.1.0 реализована работа с серверными информационными базами, подробности тут.

конвертация EDT XML конфигурация расширение отчет обработка

См. также

Infostart Toolkit: Инструменты разработчика 1С 8.3 на управляемых формах

Инструментарий разработчика Роли и права Запросы СКД Платформа 1С v8.3 Управляемые формы Запросы Система компоновки данных Конфигурации 1cv8 Платные (руб)

Набор инструментов программиста и специалиста 1С для всех конфигураций на управляемых формах. В состав входят инструменты: Консоль запросов, Консоль СКД, Консоль кода, Редактор объекта, Анализ прав доступа, Метаданные, Поиск ссылок, Сравнение объектов, Все функции, Подписки на события и др. Редактор запросов и кода с раскраской и контекстной подсказкой. Доработанный конструктор запросов тонкого клиента. Продукт хорошо оптимизирован и обладает самым широким функционалом среди всех инструментов, представленных на рынке.

10000 руб.

02.09.2020    127585    688    389    

740

Infostart PrintWizard - создание и редактирование печатных форм в 1С 8.3

Пакетная печать Печатные формы Инструментарий разработчика Платформа 1С v8.3 Запросы 1С:Зарплата и кадры бюджетного учреждения 1С:Конвертация данных 1С:ERP Управление предприятием 2 1С:Управление торговлей 11 Платные (руб)

Инструмент, позволяющий абсолютно по-новому взглянуть на процесс разработки печатных форм. Благодаря конструктору можно значительно снизить затраты времени на разработку печатных форм, повысить качество и "прозрачность" разработки, а также навести порядок в многообразии корпоративных печатных форм.

18000 руб.

06.10.2023    8515    25    6    

47

Infostart УДиФ: Управление данными и формами 1С

Инструменты администратора БД Инструментарий разработчика Роли и права Платформа 1С v8.3 Конфигурации 1cv8 Россия Платные (руб)

Расширение позволяет без изменения кода конфигурации выполнять проверки при вводе данных, скрывать от пользователя недоступные ему данные, выполнять код в обработчиках. Не изменяет данные конфигурации, легко устанавливается практически на любую конфигурацию на управляемых формах.

10000 руб.

10.11.2023    4816    12    2    

38

PowerTools

Инструментарий разработчика Инструменты администратора БД Платформа 1С v8.3 Управляемые формы Конфигурации 1cv8 Россия Платные (руб)

Универсальный инструмент программиста для администрирования конфигураций. Сборник наиболее часто используемых обработок под единым интерфейсом.

3600 руб.

14.01.2013    179053    1086    0    

863

Бустер Конвертации данных 3 (Infostart Toolkit)

Инструментарий разработчика 8.3.14 1С:Конвертация данных Россия Платные (руб)

Расширение для конфигурации “Конвертация данных 3”. Добавляет подсветку синтаксиса, детальную контекстную подсказку, глобальный поиск по коду.

15000 руб.

07.10.2021    15145    3    12    

38

Многопоточность. Универсальный «Менеджер потоков» 2.1

Инструментарий разработчика Платформа 1С v8.3 Конфигурации 1cv8 Россия Платные (руб)

Восстановление партий или взаиморасчетов, расчет зарплаты, пакетное формирование документов или отчетов - теперь все это стало доступнее. * Есть желание повысить скорость работы медленных алгоритмов! Но... * Нет времени думать о реализации многопоточности? * о запуске и остановке потоков? * о поддержании потоков в рабочем состоянии? * о передаче данных в потоки и как получить ответ из потока? * об организации последовательности? Тогда ЭТО - то что надо!!!

5000 руб.

07.02.2018    100032    239    97    

298

1С HTML Шаблоны / HTML Templates

Инструментарий разработчика Платформа 1С v8.3 Конфигурации 1cv8 Платные (руб)

Быстрая и удобная обработка для работы с шаблонами HTML. Позволяет легко и быстро формировать код HTML.

2040 руб.

27.12.2017    28466    4    10    

16

[ЕХТ] Фреймворк для Расширений 1С

Инструментарий разработчика Платформа 1С v8.3 Управляемые формы Платные (руб)

"Фреймворк для Расширений 1С" это универсальное и многофункциональное решение, упрощающее разработку и поддержку создаваемых Расширений. Поставляется в виде комплекта из нескольких Расширений с открытым исходным кодом. Работает в любых Конфигурациях в режиме Управляемого приложения с режимом совместимости 8.3.12 и выше без необходимости внесения изменений в Конфигурацию.

3000 руб.

27.08.2019    18571    6    8    

40
Комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. PerlAmutor 129 29.08.23 10:05 Сейчас в теме
Жаль конечно, что компания 1С не сделала standalone утилиту для таких преобразований и приходится устанавливать кучу всего лишнего, а потом еще и через временную базу данных в TEMPDIR такое проворачивать.
2. ya.Avoronov 115 01.09.23 10:27 Сейчас в теме
Внутри CMD файлов нужно указывать версию EDT, если установлено несколько различных на ПК:

Было:
call %V8_RING_TOOL% edt workspace export --project "%V8_SRC_PATH%" --configuration-files "%XML_PATH%" --workspace-location "%WS_PATH%"


Стало:
call %V8_RING_TOOL% edt@2022.1.3:x86_64 workspace export --project "%V8_SRC_PATH%" --configuration-files "%XML_PATH%" --workspace-location "%WS_PATH%"
4. ktb 620 13.09.23 10:55 Сейчас в теме
(2) Угу, нужно добавить еще переменную среды для указания версии EDT (типа V8_EDT_VERSION), займусь на днях, либо можете сами сделать PR. :-)

Хм. не приходили оповещения о коментариях.
6. ktb 620 14.09.23 13:37 Сейчас в теме
(2) Добавил переменную среды для указания версии EDT (V8_EDT_VERSION). Нужно указывать только основной номер версии, например: 2023.1.4.
3. ya.Avoronov 115 01.09.23 10:41 Сейчас в теме
В моем случае conf2cf не удался.
1С:Предприятие 8.3 (8.3.21.1622)
edt@2022.1.3:x86_64

Ошибок и предупреждений больше, чем ответов:
Debug options:
    file:/C:/Program Files/1C/1CE/components/1c-edt-2022.1.3+14-x86_64/.options loaded
SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.
WARNING: An illegal reflective access operation has occurred
WARNING: Illegal reflective access by com._1c.g5.v8.bm.store.internal.StringRegistry (file:/C:/Program Files/1C/1CE/components/1c-edt-2022.1.3+14-x86_64/plugins/com._1c.g5.v8.bm.store_5.3.800.v202210121436.jar) to method sun.nio.ch.FileChannelImpl.setUninterruptible()
WARNING: Please consider reporting this to the maintainers of com._1c.g5.v8.bm.store.internal.StringRegistry
WARNING: Use --illegal-access=warn to enable warnings of further illegal reflective access operations
WARNING: All illegal access operations will be denied in a future release
Project export operation failed.
Reason: Export operation has error: java.lang.NullPointerException
java.lang.NullPointerException
1C:Enterprise Development Tools process execution failed.
Показать
5. ktb 620 13.09.23 14:35 Сейчас в теме
(3) Тут вопрос к EDT и ring, надо проверить, что в просто аналогичная команда ring выполняется корректно.
7. user1224013 15.03.24 16:37 Сейчас в теме
Просто EDT это мертворожденный баг.
1С надо написать нормальную новую среду на C++ с addons
или добавить аддоны в конфигуратор и все.

А формат EDT проектов это вообще баг бажный маразм
Оставьте свое сообщение