1
0
mirror of https://github.com/bia-technologies/precommit4onec.git synced 2024-11-24 08:32:25 +02:00
precommit4onec/README.md

50 lines
4.4 KiB
Markdown
Raw Normal View History

2017-09-08 17:38:29 +02:00
# Утилита для автоматической обработки исходных файлов конфигурации, внешних отчетов и обработок для платформы 1С:Предприятие при помещении в репозиторий git
2017-09-08 17:38:29 +02:00
Данное решение базируется на идеях проекта [precommit1c](https://github.com/xDrivenDevelopment/precommit1c/releases), но является самостоятельным решением.
## Почему не precommit1c
Указанным продуктом пользовались долгое время, он очень хорош, но потребность в развитии и невозможность реализации некоторых сценариев работы в публичной версии сподвигли к реализации нового решения.
Особенности данного решения:
- Возможность расширения функциональности под свои нужды без потери совместимости с публичной версией
- Централизованная установка и обновление скриптов без необходимости утяжелять репозиторий проекта
- Максимально использует возможности платформы 1С:Предприятие последних версий (тестировалось на 8.3.10+, возможно на версия 8.3.8-9 тоже будет работать)
- Возможность хранить внешние отчеты, обработки и расширения с одинаковыми именами
- Корректно обрабатывается удаление файлов
## Установка
2017-09-08 17:38:29 +02:00
Установка на компьютер стандартна
- `opm install precommit4onec` или
- распаковать в нужный каталог архив скаченный из репозитория
## Использование
2017-09-08 17:38:29 +02:00
Перед использование необходима установка скрипта в репозиторий.
Для выполнения установки в конкретный репозиторий необходимо выполнить команду
`precommit4onec install repo_name`.
Для выполнения установки во все репозитории каталога необходимо выполнить команду
`precommit4onec install folder_reps -к`.
После этого при каждом коммите будет выполняться скрипт, выполняющий имеющиеся сценарии обработки файлов.
В комплекте присутствуют следующие сценарии обрабоботки данных
- `РазборОтчетОбработокРасширений` - при выполнении данного сценария файлы внешних отчетов, обработок и расширений средствами платформы будут разложены на исходные файлы и помещены в каталог исходных файлов репозиторий в подкаталоги, соответствующие расширениям. Например внешний отчет `ВнешнийОтчет1.erf` будет разложен в каталог `src\erf\ВнешнийОтчет1`
- `РазборОбычныхФормНаИсходники` - при выполнении данного сценария обычные формы раскладываются на исходные файлы с помощью инструмента `v8unpack`
## Расширение функциональности
Для добавлния своих сценариев обработки файлов необходимо создать новый сценарий в каталоге `СценарииОбработки` скрипта используя соответствующий шаблон. Новый сценарий автоматически подключится.
## Ссылки
- [Шаблон скрипта](https://github.com/oscript-library/oscript-app-template)
- [precommit1c](https://github.com/xDrivenDevelopment/precommit1c/releases)
2017-09-08 17:38:29 +02:00
- [Библиотека os-скриптов](https://github.com/oscript-library)