Skip to content

Commit e3d3df5

Browse files
committed
Merge branch 'release/v2.1.0'
2 parents 6ef501f + fc10400 commit e3d3df5

File tree

4 files changed

+90
-32
lines changed

4 files changed

+90
-32
lines changed

README.md

+27-6
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,8 @@
66

77
### Что к чему
88
----
9-
* v8files-extractor.os - скрипт для OneScript, получающий список помещаемых файлов при коммите, фильтрующий по расширению только внешние отчёты/обработки и запускающий внешнюю обработку для распаковки этих файлов. Так же позволяет собирать обработки из полученных исходников.
9+
* v8files-extractor.os - скрипт для OneScript, получающий список помещаемых файлов при коммите, фильтрующий по расширению только внешние отчёты/обработки, расширения и запускающий команды для распаковки этих файлов. Так же позволяет собирать обработки из полученных исходников.
1010
* [V8Reader.epf](http://infostart.ru/public/106310/) - внешняя обработка 1С, которая с помощью [v8unpack](http://svn2.assembla.com/svn/V8Unpack/track/) разбирает внешние обработки, определяет нормальные наименования для каталогов форм, файлов модулей объектов и т. д. и раскладывает их в нормальную структуру папок.
11-
* ibService - сервисная база данных на 1С для запуска V8Reader.epf
1211
* pre-commit - собственно командный файл, вызываемый git перед каждым помещением. Выполняет роль простой запускалки скрипта v8files-extractor.os
1312

1413
### Установка
@@ -37,7 +36,6 @@
3736
pre-commit
3837
V8Reader
3938
tools
40-
ibService
4139
v8files-extractor.os
4240
```
4341

@@ -61,13 +59,12 @@ git submodule update --init --recursive
6159
pre-commit
6260
V8Reader
6361
tools
64-
ibService
6562
v8files-extractor.os
6663
```
6764

6865
## Запуск
6966

70-
После установки достаточно для проверки сделать commit для любого файла epf/erf, и в вашем репозитории автоматически должна создаться папка *src*, полностью повторяющая структуру проекта, изменённые или добавленные файлы распакуются в папки с аналогичными наименованиями.
67+
После установки достаточно для проверки сделать commit для любого файла epf/erf/cfe, и в вашем репозитории автоматически должна создаться папка *src*, полностью повторяющая структуру проекта, изменённые или добавленные файлы распакуются в папки с аналогичными наименованиями.
7168

7269
## Командная строка запуска OneScript
7370

@@ -87,6 +84,8 @@ oscript v8files-extractor.os ?
8784
--compile inputPath outputPath [--recursive]
8885
Собрать внешний файл/обработку.
8986
Если указан параметр --recursive, скрипт будет рекурсивно искать исходные коды отчетов и обработок в указанном каталоге и собирать их, повторяя структуру каталога
87+
--install
88+
Установить precommit1c для текущего репозитория git
9089
```
9190

9291
## Ограничения
@@ -95,9 +94,31 @@ oscript v8files-extractor.os ?
9594

9695
Не стоит называть файлы с разным расширением epf и erf одинаковыми именами - каталоги с исходниками создаются только по наименованию без учёта расширения и возможен конфликт имен.
9796

97+
### Для корректной работы на 1С версии 8.3.9.2016 и старше
98+
99+
Начиная с версии 8.3.9.2016 1С встроила в платформу механизмы защиты открытия внешних отчетов и обработок. Как обойти данное ограничение написано на ИТС:
100+
> Защита считается отключенной, если строка соединения с информационной базой удовлетворяет одному из шаблонов, указанных в параметре DisableUnsafeActionProtection файла conf.cfg.
101+
102+
Т.о. в файл C:\Program Files (x86)\1cv8\conf\conf.cfg необходимо добавить строку `DisableUnsafeActionProtection=.*`
103+
Подробнее [на ИТС](http://its.1c.ru/db/v838doc#bookmark:dev:TI000001873)
104+
105+
## Известные проблемы
106+
107+
1. При использовании некоторых версий SourceTree (удобный клиент git) может возникать следующая ошибка:
108+
>`.git/hooks/pre-commit: line 4: oscript: command not found`
109+
Несколько вариантов решения:
110+
+ убедиться, что команда `oscript` доступна
111+
+ для проверки вызвать из командной строки или Win+R `cmd /k oscript`
112+
+ откатиться на предыдущую версию SourceTree
113+
+ рекомендуется
114+
+ указать полный путь к `oscript.exe` в файле `pre-commit` внутри своего репозитария.
115+
+ не рекомендуется, т.к. данную операцию нужно будеть делать для каждого репозитария
116+
98117
## Что внутри
99118

100-
Как это работает: v8files-extractor.os полностью повторяет иерархию папок относительно корня репозитория только в папке SRC (от слова source), для каждой изменённой внешней обработки создаётся своя папка и туда с помощью v8unpack распаковывается помещаемая обработка, с помощью v8reader определяются наименования макетов, форм, модуля обработки и переименовываются, переименования сохраняются в служебном файле renames.txt, те файлы, которые невозможно определить или же носят чисто служебный характер, переносятся в каталог *und*
119+
Как это работает: v8files-extractor.os полностью повторяет иерархию папок относительно корня репозитория только в папке SRC (от слова source), для каждой изменённой внешней обработки создаётся своя папка и туда с помощью v8unpack распаковывается помещаемая обработка, с помощью v8reader определяются наименования макетов, форм, модуля обработки и переименовываются, переименования сохраняются в служебном файле renames.txt, те файлы, которые невозможно определить или же носят чисто служебный характер, переносятся в каталог *und*.
120+
121+
Файлы расширений *.cfe распаковываются на исходники штатными средствами 1С.
101122

102123
## Лицензия
103124

packagedef

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11

22
Описание.Имя("precommit1c")
3-
.Версия("2.0.6")
3+
.Версия("2.1.0")
44
.ЗависитОт("logos")
55
.ЗависитОт("cmdline")
66
.ЗависитОт("tempfiles")

0 commit comments

Comments
 (0)