Merge pull request #175 from vkislitsin/feature/export-file-list

Реализован параметр ПутьКСпискуОбъектовВыгрузки для выгрузки в файлы
oscript-library · Jan 11, 2025 · fa6e915 · fa6e915
2 parents 8538d61 + ed36562
commit fa6e915
Show file tree

Hide file tree

Showing 2 changed files with 45 additions and 6 deletions.
diff --git a/readme.md b/readme.md
@@ -136,7 +136,7 @@
 
 - Процедура **ВыгрузитьКонфигурациюВФайл**(Знач ФайлКонфигурации) - выгрузка конфигурацию в файл. Вызывает команду `/DumpCfg`.
 
-- Процедура **ВыгрузитьКонфигурациюВФайлы**(Знач КаталогВыгрузки, Знач ФорматВыгрузки = "", Знач ТолькоИзмененные = Ложь, Знач ПутьКФайлуВерсийДляСравнения = "") - выгрузка конфигурации в файлы. Вызывает команду `/DumpConfigToFiles`.
+- Процедура **ВыгрузитьКонфигурациюВФайлы**(Знач КаталогВыгрузки, Знач ФорматВыгрузки = "", Знач ТолькоИзмененные = Ложь, Знач ПутьКФайлуВерсийДляСравнения = "", Знач ПутьКСпискуОбъектовВыгрузки = "") - выгрузка конфигурации в файлы. Вызывает команду `/DumpConfigToFiles`.
 
 - Процедура **ВыгрузитьИзмененияКонфигурацииВФайл**(Знач КаталогВыгрузки, Знач ПутьКФайлуИзменений, Знач ПутьКФайлуВерсийДляСравнения = "", Знач ФорматВыгрузки = "") - выгрузка изменений в файлах конфигурации в файл относительно файла версий в текущем каталоге выгрузки. Вызывает команду `/DumpConfigToFiles`.
 
@@ -146,7 +146,7 @@
 
 - Процедура **ВыгрузитьРасширениеВФайл**(Знач ПутьФайлРасширения, Знач ИмяРасширения) - выгрузка конфигурации расширения в файл. Вызывает команду `/DumpConfigToFiles` с ключом *-Extension*.
 
-- Процедура **ВыгрузитьРасширениеВФайлы**(Знач КаталогВыгрузки, Знач ИмяРасширения = "-AllExtensions", Знач ФорматВыгрузки = "", Знач ТолькоИзмененные = Ложь, Знач ПутьКФайлуВерсийДляСравнения = "") - выгрузка конфигурации расширения в файлы. Вызывает команду `/DumpConfigToFiles` с ключом *-Extension* или *-AllExtensions*.
+- Процедура **ВыгрузитьРасширениеВФайлы**(Знач КаталогВыгрузки, Знач ИмяРасширения = "-AllExtensions", Знач ФорматВыгрузки = "", Знач ТолькоИзмененные = Ложь, Знач ПутьКФайлуВерсийДляСравнения = "", Знач ПутьКСпискуОбъектовВыгрузки = "") - выгрузка конфигурации расширения в файлы. Вызывает команду `/DumpConfigToFiles` с ключом *-Extension* или *-AllExtensions*.
 
 - Процедура **ЗагрузитьКонфигурациюИзФайла**(Знач ПутьФайлКонфигурации, Знач ОбновитьКонфигурациюИБ = Ложь) - загрузка конфигурации из файла. Вызывает команду `/LoadCfg`.
 

diff --git a/src/v8runner.os b/src/v8runner.os
@@ -669,9 +669,24 @@
 //	                               По завершении выгрузки файл версий обновляется
 //   ПутьКФайлуИзменений - Строка - Указывает путь к файлу,в который будут выведены изменения текущей конфигурации. Изменения вычисляются относительно файла версий в текущем каталоге выгрузки.
 //   ПутьКФайлуВерсийДляСравнения - Строка - Указывает путь к файлу, который будет использован для сравнения изменений.
+//   ПутьКСпискуОбъектовВыгрузки  - Строка - Указывает путь к файлу, в котором перечислены объекты конфигурации, которые требуется выгрузить. При запуске в режиме агента путь к выгружаемым файлам должен быть относительным.
+//                                Указываемый файл должен удовлетворять следующим требованиям:
+//                                - Файл должен быть в кодировке UTF-8.
+//                                - Имена объектов должны быть указаны через перенос (поддерживаются символы переноса \r\n ("следующая строка") и \r ("возврат каретки")).
+//                                - Файл не должен содержать пустые строки между именами объектов.
+//                                - Объектами для выгрузки могут быть перечисленные в файле "Configuration.xml" - корневой объект <Configuration> и элементы списка <ChildObjects>.
+//                                - Пример списка:
+//                                  Configuration
+//                                  CommonModule.ЗагрузкаВыпискиПоБанковскомуСчету
+//                                  Catalog.Контрагенты
+//                                  Document.СписаниеСРасчетногоСчета
 //
 //   Для того, чтобы работали функции 8.3.10, необходимо явно указать версию.
-Процедура ВыгрузитьКонфигурациюВФайлы(Знач КаталогВыгрузки, Знач ФорматВыгрузки = "", Знач ТолькоИзмененные = Ложь, Знач ПутьКФайлуВерсийДляСравнения = "") Экспорт
+Процедура ВыгрузитьКонфигурациюВФайлы(Знач КаталогВыгрузки, 
+                                      Знач ФорматВыгрузки = "",
+                                      Знач ТолькоИзмененные = Ложь,
+                                      Знач ПутьКФайлуВерсийДляСравнения = "",
+                                      Знач ПутьКСпискуОбъектовВыгрузки = "") Экспорт
 
 	Если НЕ ЗначениеЗаполнено(ФорматВыгрузки) Тогда
 		ФорматВыгрузки = РежимВыгрузкиКонфигурации.Иерархический;
@@ -700,6 +715,10 @@
 
 			КонецЕсли;
 
+		ИначеЕсли ЗначениеЗаполнено(ПутьКСпискуОбъектовВыгрузки) Тогда
+
+			Параметры.Добавить(СтрШаблон("-listFile %1", ОбернутьВКавычки(ПутьКСпискуОбъектовВыгрузки)));
+
 		КонецЕсли;
 
 	КонецЕсли;
@@ -853,7 +872,7 @@
 
 КонецПроцедуры
 
-// Загрузка расширения конфигурации из файлов
+// Выгрузка расширения конфигурации в файлы
 //
 // Параметры:
 //   КаталогВыгрузки 	- Строка - Путь к каталогу, содержащий XML-файлы конфигурации;
@@ -864,10 +883,26 @@
 //                                          ( Реализовано в версиях 8.3.7.1759 и 8.3.8.1652.  http://v8.1c.ru/o7/201507xml/index.htm)
 //   ТолькоИзмененные   - Булево - указывает, что выгрузка будет обновлена (будут выгружены только файлы, версии которых отличаются от ранее выгруженных).
 //                                 Файл версий (ConfigDumpInfo.xml) будет получен из текущего каталога выгрузки.
-//	                               По завершении выгрузки файл версий обновляется
+//                                 По завершении выгрузки файл версий обновляется
 //   ПутьКФайлуВерсийДляСравнения - Строка - Указывает путь к файлу, который будет использован для сравнения изменений.
 //                                  (Реализовано начиная с версии 8.3.10)
-Процедура ВыгрузитьРасширениеВФайлы(Знач КаталогВыгрузки, Знач ИмяРасширения = "-AllExtensions", Знач ФорматВыгрузки = "", Знач ТолькоИзмененные = Ложь, Знач ПутьКФайлуВерсийДляСравнения = "") Экспорт
+//   ПутьКСпискуОбъектовВыгрузки  - Строка - Указывает путь к файлу, в котором перечислены объекты конфигурации, которые требуется выгрузить. При запуске в режиме агента путь к выгружаемым файлам должен быть относительным.
+//                                 Указываемый файл должен удовлетворять следующим требованиям:
+//                                 - Файл должен быть в кодировке UTF-8.
+//                                 - Имена объектов должны быть указаны через перенос (поддерживаются символы переноса \r\n ("следующая строка") и \r ("возврат каретки")).
+//                                 - Файл не должен содержать пустые строки между именами объектов.
+//                                 - Объектами для выгрузки могут быть перечисленные в файле "Configuration.xml" - корневой объект <Configuration> и элементы списка <ChildObjects>.
+//                                 - Пример списка:
+//                                   Configuration
+//                                   CommonModule.ЗагрузкаВыпискиПоБанковскомуСчету
+//                                   Catalog.Контрагенты
+//                                   Document.СписаниеСРасчетногоСчета
+Процедура ВыгрузитьРасширениеВФайлы(Знач КаталогВыгрузки,
+                                    Знач ИмяРасширения = "-AllExtensions",
+                                    Знач ФорматВыгрузки = "",
+                                    Знач ТолькоИзмененные = Ложь,
+                                    Знач ПутьКФайлуВерсийДляСравнения = "",
+                                    Знач ПутьКСпискуОбъектовВыгрузки = "") Экспорт
 
 	Если НЕ ЗначениеЗаполнено(ФорматВыгрузки) Тогда
 		ФорматВыгрузки = РежимВыгрузкиКонфигурации.Иерархический;
@@ -903,6 +938,10 @@
 
 			КонецЕсли;
 
+		ИначеЕсли ЗначениеЗаполнено(ПутьКСпискуОбъектовВыгрузки) Тогда
+
+			Параметры.Добавить(СтрШаблон("-listFile %1", ОбернутьВКавычки(ПутьКСпискуОбъектовВыгрузки)));
+
 		КонецЕсли;
 
 	КонецЕсли;