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

23.11.23

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

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

Скачать файлы

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

С чем живем

  • 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.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С для всех конфигураций на управляемых формах. В состав входят инструменты: Консоль запросов, Консоль СКД, Консоль кода, Редактор объекта, Анализ прав доступа, Метаданные, Поиск ссылок, Сравнение объектов, Все функции, Подписки на события и др. Редактор запросов и кода с раскраской и контекстной подсказкой. Доработанный конструктор запросов тонкого клиента. Продукт хорошо оптимизирован и обладает самым широким функционалом среди всех инструментов, представленных на рынке.

12000 руб.

02.09.2020    101845    564    385    

610

Онлайн-интенсив "DevOps для 1С". с 5 февраля по 19 марта 2024 г.

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

Данный онлайн-курс (интенсив) предусматривает изучение процессов, инструментов и методик DevOps, их применение при разработке на платформе 1С. 

25000 руб.

20.06.2023    11520    25    2    

142

PowerTools

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

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

3600 руб.

14.01.2013    173038    1042    0    

816

Infostart PrintWizard

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

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

18000 руб.

06.10.2023    3574    3    0    

17

Управление данными и формами (УДиФ)

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

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

10000 руб.

10.11.2023    1395    3    1    

20

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

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

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

5000 руб.

07.02.2018    97598    237    97    

287

Выполнение произвольного кода или запроса с параметрами через Web-сервис (замена COM-подключений)

Инструментарий разработчика Обмен между базами 1C Платформа 1С v8.3 Платные (руб)

В процессе работы в 1С часто возникает потребность получить данные из другой базы.  Обычно это делается через COM-соединение, и время выполнения запроса при этом оставляет желать лучшего. В данной публикации представлено универсальное решение, позволяющее практически моментально выполнить произвольный код или запрос с параметрами в другой информационной базе через Web-сервис.

2400 руб.

24.09.2019    22389    14    15    

27

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

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

Программист - это человек, непрерывно принимающий решения. Написание кода не является процессом принятия решения - это всего лишь трансляция ваших желаний. Если вас периодически тяготит написание сотен строк кода ради решения задач, то прошу обратить внимание. Данный продукт позволит существенно сократить время на рутинные операции при разработке. За счет библиотечной реализации сокращается объём кода, а его читаемость повышается. К библиотеке прилагается документация API и шаблоны кода для наиболее популярных методов.

4200 руб.

16.04.2021    13854    5    9    

12
Комментарии
В избранное Подписаться на ответы Сортировка: Древо развёрнутое
Свернуть все
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 605 13.09.23 10:55 Сейчас в теме
(2) Угу, нужно добавить еще переменную среды для указания версии EDT (типа V8_EDT_VERSION), займусь на днях, либо можете сами сделать PR. :-)

Хм. не приходили оповещения о коментариях.
6. ktb 605 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 605 13.09.23 14:35 Сейчас в теме
(3) Тут вопрос к EDT и ring, надо проверить, что в просто аналогичная команда ring выполняется корректно.
Оставьте свое сообщение