Помощник выполнения команд Конфигуратора (v8runner.os)

Назначение

Скрипт v8runner.os предназначен для инкапсуляции запуска команд Конфигуратора и 1С:Предприятия с помощью командной строки.

Как правило, запуск той или иной команды конфигуратора в автоматическом режиме достаточно сложен. Нужно помнить синтаксис каждой команды, постоянно сверяться со справкой, обрабатывать выходные сообщения Конфигуратора и т.п.

Скрипт v8runner упрощает эти задачи и позволяет запускать Конфигуратор программно, в объектной манере.

Принцип работы

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

#Использовать v8runner
Конфигуратор = Новый УправлениеКонфигуратором();

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

Контекст указывается в формате параметра командной строки конфигуратора - так, как в Конфигураторе задается нужная информационная база. Например, для формата строки соединения:

Конфигуратор.УстановитьКонтекст("/IBConnectionString""Srvr=someserver:2041; Ref='database'""","Admin", "passw0rd");

В более простой форме - для файловой базы можно указать через ключ /S:

Конфигуратор.УстановитьКонтекст("/FC:\1cdb\mydatabase","Admin", "passw0rd");

Далее, вы вызываете методы объекта "Конфигуратор", соответствующие командам конфигуратора. Все команды будут выполняться над заданной базой. Теперь, объект Конфигуратор настроен на некий "контекст" - информационную базу, с которой и будут производиться все операции.

Временный контекст

Если контекст явно не задан, то автоматически будет создана временная ИБ. Например, если для какого-то действия достаточно временной базы, то контекст можно не указывать.

Конфигуратор = Новый УправлениеКонфигуратором();
Конфигуратор.ЗагрузитьКонфигурациюИзФайла("C:\source.cf");
Конфигуратор.ВыполнитьСинтаксическийКонтроль();

// удаление временной базы
УдалитьФайлы(Конфигуратор.ПутьКВременнойБазе());

В приведенном примере файл C:\source.cf будет загружен в автоматически созданную временную базу. После чего будет выполнен полный синтаксический контроль конфигурации.

Параметры запуска

В обращении к Конфигуратору используется понятие "Параметров запуска". Это массив параметров командной строки для платформы 1С. Перед запуском платформы v8runner автоматически составит из этого массива командную строку платформы.

УправлениеКонфигуратором = Новый УправлениеКонфигуратором();

// в ПараметрахЗапуска уже добавлены ключи DESIGNER, строка соединения с ИБ, пользователь и пароль
ПараметрыЗапуска = УправлениеКонфигуратором.ПолучитьПараметрыЗапуска();
ПараметрыЗапуска.Добавить("/LoadCfg""C:\source.cf"""); 

Попытка
    УправлениеКонфигуратором.ВыполнитьКоманду(ПараметрыЗапуска);
Исключение
    // вывод log-файла с сообщениями от платформы.
    Сообщить(УправлениеКонфигуратором.ВыводКоманды());
КонецПопытки

Методы класса v8runner

Основные функции

  • Процедура УстановитьКонтекст(Знач СтрокаСоединения, Знач Пользователь, Знач Пароль)
  • Функция ПолучитьКонтекст()
  • Процедура ИспользоватьКонтекст(Знач Контекст)
  • Функция ПолучитьВерсиюИзХранилища(Знач СтрокаСоединения, Знач ПользовательХранилища, Знач ПарольХранилища, Знач НомерВерсии = Неопределено)
  • ОтключитьсяОтХранилища()
  • Процедура ЗагрузитьКонфигурациюИзФайла(Знач ФайлКонфигурации, Знач ОбновитьКонфигурациюИБ = Ложь)
  • Процедура ОбновитьКонфигурациюБазыДанных()
  • Процедура ОбновитьКонфигурацию(Знач КаталогВерсии, Знач ИспользоватьПолныйДистрибутив = Ложь)
  • Процедура СоздатьФайловуюБазу(Знач КаталогБазы)
  • Процедура ВыполнитьКоманду(Знач Параметры)
  • Функция ПолучитьПараметрыЗапуска()
  • Процедура ВыполнитьСинтаксическийКонтроль(ТонкийКлиент = Истина, ВебКлиент = Истина, Сервер = Истина, ВнешнееСоединение = Истина, ТолстыйКлиентОбычноеПриложение = Истина)
  • Функция ПутьКВременнойБазе()
  • Процедура ЗагрузитьРасширениеИзФайла(Знач ПутьФайлРасширения, Знач ИмяРасширения, Знач ОбновитьКонфигурациюИБ = Ложь)
  • Процедура ВыгрузитьРасширениеВФайл(Знач ПутьФайлРасширения, Знач ИмяРасширения)
  • Процедура ЗагрузитьРасширениеИзФайлов(Знач КаталогЗагрузки, Знач ИмяРасширения = "–AllExtensions", Знач ПутьКСпискуФайловЗагрузки = "", Знач ФорматВыгрузки = "", Знач ОбновитьФайлВерсий = Истина)
  • Процедура ВыгрузитьРасширениеВФайлы(Знач КаталогВыгрузки, Знач ИмяРасширения = "–AllExtensions", Знач ФорматВыгрузки = "", Знач ТолькоИзмененные = Ложь, Знач ПутьКФайлуВерсийДляСравнения = "")
  • Процедура ПолучитьОтчетОСравненииКонфигурацииСФайлом(Знач ПутьКФайлуКонфигурации, Знач ПутьКОтчету, Знач ТипОтчета = Неопределено, Знач ФорматОтчета = "txt", Знач ИмяРасширения = "")
  • Функция КонфигурацияИФайлИдентичны(Знач ПутьКФайлуКонфигурации, Знач ИмяРасширения = "")

Вспомогательные и настроечные функции

  • Функция ПолучитьПутьКВерсииПлатформы(Знач ВерсияПлатформы)
  • Процедура УстановитьКлючРазрешенияЗапуска(Знач Ключ)
  • Функция ВыводКоманды()
  • Функция КаталогСборки(Знач Каталог = "")
  • Функция ПутьКПлатформе1С(Знач Путь = "")
  • Процедура УстановитьКодЯзыка(Знач КодЯзыка)
  • Процедура УстановитьКодЯзыкаСеанса(Знач КодЯзыкаСеанса)

Доступные версии пакета

1.4.0
Изменен: 23.10.2019 18:03:40
1.3.0
Изменен: 11.03.2019 11:59:00
1.2.0
Изменен: 02.01.2019 19:48:29
1.1.3
Изменен: 02.01.2019 19:48:29
1.1.2
Изменен: 02.01.2019 19:48:29
1.1.1
Изменен: 02.01.2019 19:48:29
1.1.0
Изменен: 02.01.2019 19:48:29
1.0.1
Изменен: 02.01.2019 19:48:29
1.0.0
Изменен: 02.01.2019 19:48:29
0.13.0
Изменен: 02.01.2019 19:48:29
0.12.0
Изменен: 02.01.2019 19:48:29
0.11.2
Изменен: 02.01.2019 19:48:29
0.11.1
Изменен: 02.01.2019 19:48:29
0.11.0
Изменен: 02.01.2019 19:48:29
0.10.1
Изменен: 02.01.2019 19:48:29
0.8.0
Изменен: 02.01.2019 19:48:29
0.7.1
Изменен: 02.01.2019 19:48:29
0.7.0
Изменен: 02.01.2019 19:48:29
0.6.0
Изменен: 02.01.2019 19:48:29
0.5.2
Изменен: 02.01.2019 19:48:29
0.5.1
Изменен: 02.01.2019 19:48:29
0.5.0
Изменен: 02.01.2019 19:48:29
0.4.1
Изменен: 02.01.2019 19:48:29
0.3.2
Изменен: 02.01.2019 19:48:29
0.2.1
Изменен: 02.01.2019 19:48:29
В разработке

Репозиторий

https://github.com/oscript-library/v8runner

Актуальная версия

v8runner-1.4.0