Конструктор скриптов (расширение)

30.03.23

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

Когда нужен динамически формируемый .bat файл и становится все сложно, мы используем "Конструктор скриптов". Разбираем реализацию расширения на примере конвертации хранилища 1с в Git в формате EDT.

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

Наименование Файл Версия Размер
Конструктор скриптов (расширение):
.cfe 62,42Kb
2
.cfe 62,42Kb 2 Скачать

Друзья, данное расширение предназначено для формирования текста команды для последующего выполнения через метод глобального контекста "ЗапуститьПриложение".

В расширении реализовано:

  • Склейка команд
  • Подстановка переменных
  • Переходы по условиям
  • Запуск регламентным заданием

 

Рассмотрим базовую функциональность на примере конвертации хранилища 1с в Git в формате EDT. Предполагаем что EDT и Git установлены, также выполнено создание проекта и выгружена первая версия хранилища, а структура каталогов проекта имеет следующий вид:

  1. D:\Workspace\Project\cs\repo - конвертируемое хранилище 1c
  2. D:\Workspace\Project\cs\gitsync - служебная папка с временными файлами
  3. D:\Workspace\Project\cs\cs_1_0 - рабочий каталог проекта (репозиторий Git)
  4. D:\Workspace\Base\cs_gitsync - пустая база 1с c конвертируемым расширением без подключения к хранилищу
  5. D:\Workspace\Base\cs_gitsync_bind - пустая база 1с c конвертируемым расширением с подключением к хранилищу
  6. D:\Workspace\Base\1CE\rosbr\cs_gitsync - пустой каталог для импорта конфигурации в EDT

 

Для конвертации хранилища, нам необходимо последовательно выполнить 10 шагов для каждой версии, воспользуемся конструктором скриптов:

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

Выполним построение отчета по истории хранилища /ConfigurationRepositoryReport с отбором версий без меток -DoNotIncludeVersionsWithLabels, т.е. предполагается что установленных меток в хранилище нет, будем брать первую версию без метки, а уже после выгрузки установим метку "uploaded to git" - признак выгрузки и в следующую итерацию версия уже не попадет.

Конструктор скриптов позволяет склеивать командные строки и повторно использовать в следующих командах ссылаясь на них. Введем 4 базовые командные строки (заготовки, такие строки не выполняются) и каждую склеим с предыдущей (3я колонка):

№1 Запуск в режиме конфигуратора с отключением стартовых диалогов и доменной авторизации и указанием языка
C:\Program Files\1cv8\8.3.22.1923\bin\1cv8" DESIGNER /WA- /DisableStartupDialogs /L ru /VL ru   

№2 Добавление ведения логов в файл
/Out "D:\Workspace\Project\cs\gitsync\log.txt" -NoTruncate

№3 Указание строки соединения с информационной базой 
/IBConnectionString "File=""D:\Workspace\Base\cs_gitsync"";" /N "" /P ""

№4 Указание параметров подключения к хранилищу
/ConfigurationRepositoryF "D:\Workspace\Project\cs\repo" /ConfigurationRepositoryN "gitsync" /ConfigurationRepositoryP ""

Введем командную строку №5, опишем параметры построения отчета по истории хранилища и укажем ссылку на строку №4. По цепочке связей выполнится склеивание всех предыдущих и добавление новой, при этом изменение любой строки приведет к изменению всех ссылающихся.
/ConfigurationRepositoryReport "D:\Workspace\Project\cs\gitsync\ConfigurationRepositoryReport.mxl" -DoNotIncludeVersionsWithLabels -Extension "КонструкторСкриптов"

 

2. Извлечь из отчета по истории хранилища номер версии, автора и комментарий.

Для извлечения свойств версии из файла mxl "D:\Workspace\Project\cs\gitsync\ConfigurationRepositoryReport.mxl" воспользуемся командой "Инициализация переменных" способной выполнять произвольный код.

Исполнение произвольного кода осуществляется с доступом к 2ум переменным "ВыполнениеПараметры" (структура, ключи которой можно использовать в качестве шаблонов подстановки), "КомандаПараметры" (массив переданных входящих параметров).

Произвольный код команды №6:

	// Выполним чтение свойств следующей версии к выгрузке

	// Инициализируем соответсиве свойств параметрам
	СвойствоПараметрИмяСоответствие = Новый Соответствие;
	СвойствоПараметрИмяСоответствие.Вставить("Версия:", "ХранилищеВерсияНомер");
	СвойствоПараметрИмяСоответствие.Вставить("Пользователь:", "ХранилищеВерсияАвтор");
	СвойствоПараметрИмяСоответствие.Вставить("Дата создания:", "ХранилищеВерсияДатаСоздания");
	СвойствоПараметрИмяСоответствие.Вставить("Время создания:", "ХранилищеВерсияВремяСоздания");
	СвойствоПараметрИмяСоответствие.Вставить("Версия конфигурации:", "ХранилищеКонфигурацияВерсия");
	СвойствоПараметрИмяСоответствие.Вставить("Комментарий:", "ХранилищеВерсияКомментарий");

	// Выполним чтение табличного документа
	ТабличныйДокументФайлИмя = КомандаПараметры[0];

	ТабличныйДокумент = Новый ТабличныйДокумент;
	ТабличныйДокумент.Прочитать(ТабличныйДокументФайлИмя);

	ЧтениеСтрокПродолжить = Истина;
	ТабличныйДокументСтрокиМассив = Новый Массив;

	Для Сч = 5 По 10 Цикл
		СвойствоОбластьИмя = СтрШаблон("R%1C1", Сч);
		ЗначениеОбластьИмя = СтрШаблон("R%1C2:R%1C%2", Сч, ТабличныйДокумент.ШиринаТаблицы);
		
		Свойство = ТабличныйДокумент.Область(СвойствоОбластьИмя).Текст;		
		Значение = ТабличныйДокумент.Область(ЗначениеОбластьИмя).Текст;		

		ПараметрИмя = СвойствоПараметрИмяСоответствие[Свойство];
		Если ЗначениеЗаполнено(ПараметрИмя) Тогда
			ВыполнениеПараметры.Вставить(ПараметрИмя, Значение);
			
		Иначе
			ОшибкаТекст = СтрШаблон("Ошибка разбора отчета по невыгруженным версиям хранилища: %1", ТабличныйДокументФайлИмя);
			ВызватьИсключение ОшибкаТекст;
			
		КонецЕсли;
	КонецЦикла;

По аналогии выполним формирование текста коммита и очистку служебных каталогов. Подробнее с содержимым можно ознакомиться установив расширение и выполнив заполнение по шаблону. Команда "Загрузить шаблон конвертации хранилища" расположена в группе "Еще" элемента справочника "Скрипты (КС)". Шаблон содержит в себе рассматриваемый пример.

 

3. Обновить конфигурацию указанной версией из хранилища.

Добавим команду №9 и установим шаблон подмены [ХранилищеВерсияНомер], который заполнится из переменной "ВыполнениеПараметры" инициализированной командой №6.

/ConfigurationRepositoryUpdateCfg -force -v [ХранилищеВерсияНомер] -Extension "КонструкторСкриптов"

 

4. Выгрузить загруженную из хранилища конфигурацию в файлы.

Добавим команду №10.

/DumpConfigToFiles "D:\Workspace\Project\cs\gitsync\ConfigDumpFiles" -force -Extension "КонструкторСкриптов"

 

5. Импортировать файлы конфигурации в новый проект EDT. 

Добавим команду №11.

cmd /C D:\Program\1CE\components\1c-enterprise-ring-0.11.8+4-x86_64\ring edt@2022.2.0:x86_64 workspace import --configuration-files "D:\Workspace\Project\cs\gitsync\ConfigDumpFiles" --workspace-location "D:\Workspace\Base\1CE\rosbr\cs_gitsync" --project-name "cs_gitsync" --version "8.3.22"

 

6. Переместить папки исходников импортированного в каталог Git.

Добавим команду №12.

cmd /C move "D:\Workspace\Base\1CE\rosbr\cs_gitsync\cs_gitsync\src" "D:\Workspace\Project\cs\cs_1_0\src"

 

7. Выполнить индексацию Git.

Добавим команды №13 и 14.

cmd /C cd /d "D:\Workspace\Project\cs\cs_1_0\" && git add --all ./

 

8. Выполнить коммит.

Добавим команду №15 и установим шаблон подмены [ХранилищеВерсияКомментарийФайлИмя], инициализированный командой №7.

cmd /C cd /d "D:\Workspace\Project\cs\cs_1_0\" && git commit -F "[ХранилищеВерсияКомментарийФайлИмя]" --allow-empty-message --cleanup=verbatim

 

9. Установить автора коммита.

Добавим команду №16 и установим шаблон подмены [ХранилищеВерсияАвтор], инициализированный командой №6.

cmd /C cd /d "D:\Workspace\Project\cs\cs_1_0\" && git commit --amend --author "[ХранилищеВерсияАвтор] <[ХранилищеВерсияАвтор]@rosbr.com>" --no-edit

 

10. Установить метку версии хранилища 1с "uploaded to git".   

Добавим команду №17 и установим шаблон подмены [ХранилищеВерсияНомер], инициализированный командой №6.

/IBConnectionString "File=""D:\Workspace\Base\cs_gitsync_bind"";" /N "" /P "" /ConfigurationRepositoryF "D:\Workspace\Project\cs\repo" /ConfigurationRepositoryN "gitsync" /ConfigurationRepositoryP "" /ConfigurationRepositorySetLabel -v "[ХранилищеВерсияНомер]" -name "uploaded to git" -Extension "КонструкторСкриптов"

 

 

На этом версия конфигурации хранилища выгружена в Git, остается только настроить регламентное задание. В форме списка справочника "Скрипты (КС)" в группе "Ещё" доступна команда "Инициализировать обработку регламентных заданий (КС)". Эта команда создает обработку "Обработка регламентных заданий (КС)" в дополнительных отчетах и обработках, в которой для каждого скрипта будет отдельная команда и расписание.  

 

Как видите, все просто, данная разработка в помощь!

Примеры и исходный код доступен на GitLab. 

 

 -----

Требования:

- Версия платформы >= 8.3.14, тестировалось на 8.3.14.2095

БСП >= 3.1, тестировалось на 3.1.1.91

- Отключенная настройка "Безопасный режим" в параметрах расширения

 -----

Ссылки:
Проект в GitLab
 

.bat Расширение

См. также

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

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

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

10000 руб.

02.09.2020    130332    704    390    

754

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

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

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

18000 руб.

06.10.2023    9180    26    6    

49

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

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

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

10000 руб.

10.11.2023    5316    14    2    

39

SALE! %

PowerTools

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

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

3600 2880 руб.

14.01.2013    179823    1093    0    

868

OneDebugger - инструмент для отладки кода без использования режима конфигуратора

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

Инструмент для написания и отладки кода в режиме «1С:Предприятие». Представляет собой консоль кода с возможностью пошаговой отладки, просмотра значений переменных любых типов, использования процедур и функций, просмотра стека вызовов, вычисления произвольных выражений на встроенном языке в контексте точки останова, синтаксического контроля и остановки по ошибке. В консоли используется удобный редактор кода с подсветкой, контекстной подсказкой, возможностью вызова конструкторов запроса и форматной строки.

5400 руб.

17.05.2024    5576    10    12    

37

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

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

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

15000 руб.

07.10.2021    15391    3    12    

38

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

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

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

5000 руб.

07.02.2018    100312    240    97    

299

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

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

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

2040 руб.

27.12.2017    28692    4    10    

17
Оставьте свое сообщение