Бром - интеграционный модуль для 1С:Предприятие

Быстрая установка и настройка

Бром состоит из двух компонент: из серверного модуля и клиентского модуля.

Для начала работы достаточно скачать и установить серверный модуль для 1С:Предприятие. Модуль устанавливается как расширение и подходит для любой конфигурации.

Как только серверный модуль установлен, подключите клиентскую библиотеку к вашему проекту и приступайте к работе! Создать клиента можно всего одной командой:

dynamic клиент = new БромКлиент(@"
	Публикация		= http://bromdemo.itworks.group/bromdemo;
	Пользователь	= bromuser;
	Пароль			= brompassword
");

$клиент = new БромКлиент("
	Публикация		= http://bromdemo.itworks.group/bromdemo;
	Пользователь	= bromuser;
	Пароль			= brompassword
");

клиент = БромКлиент("""
    Публикация		= http://bromdemo.itworks.group/bromdemo;
    Пользователь	= bromuser;
    Пароль			= brompassword
""")

Если клиентский модуль еще не реализован для языка программирования, который используется в Вашем проекте, Вы можете реализовать его самостоятельно, воспользовавшись механизмами SOAP-взаимодействия.

Простой доступ к данным объектов

Бром позволяет работать со ссылками на объекты базы данных 1С (справочники, документы и пр.). Ссылки можно использовать не только для передачи между клиентом и сервером, но и для получения доступа к данным самих объектов. Давайте получим данные элемента справочника номенклатура:

// Получаем ссылку на номенклатуру через поиск по наименованию
dynamic телевизор = клиент.Справочники.Номенклатура.НайтиПоНаименованию("Телевизор");

// Получаем данные номенклатуры через найденную ссылку
string артикул				= телевизор.Артикул;
dynamic производитель		= телевизор.Производитель;
string иннПроизводителя		= телевизор.Производитель.ИНН;

foreach (dynamic стр in телевизор.ДополнительныеРеквизиты) {
	Console.WriteLine("{0}: {1}", стр.Свойство, стр.Значение);
}

// Получаем ссылку на номенклатуру через поиск по наименованию
$телевизор = $клиент->Справочники->Номенклатура->НайтиПоНаименованию("Телевизор");

// Получаем данные номенклатуры через найденную ссылку
$артикул				= $телевизор->Артикул;
$производитель			= $телевизор->Производитель;
$иннПроизводителя		= $телевизор->Производитель->ИНН;

// Выводим на экран данные табличной части "ДополнительныеРеквизиты"
foreach ($телевизор->ДополнительныеРеквизиты as $стр) {
	echo("{$стр->Свойство}: {$стр->Значение} <br/>");
}

# Получаем ссылку на номенклатуру через поиск по наименованию
телевизор = клиент.Справочники.Номенклатура.НайтиПоНаименованию("Телевизор")

# Получаем данные номенклатуры через найденную ссылку
артикул				= телевизор.Артикул
производитель		= телевизор.Производитель
иннПроизводителя	= телевизор.Производитель.ИНН

# Выводим на экран данные табличной части "ДополнительныеРеквизиты"
for стр in телевизор.ДополнительныеРеквизиты:
	print("{0}: {1}".format(стр.Свойство, стр.Значение))

Ссылки предоставляют очень гибкий механизм взаимодействия с данными 1С:Предприятие. Более подробно работа с этими объектами описана в документации.

Создание и изменение объектов 1С

Бром позволяет создавать, редактировать и удалять объекты базы данных 1С просто и быстро:

// 1. СОЗДАНИЕ НОВОГО ДОКУМЕНТА

// Создаем контекст нового документа
dynamic докОбъект = клиент.Документы.ЗаказКлиента.СоздатьДокумент();

// Заполняем реквизиты
докОбъект.Дата			= DateTime.Today;
докОбъект.Контрагент	= клиент.Справочники.Контрагенты.НайтиПоКоду("000000001");

// Заполняем табличную часть "Товары"
dynamic стр = докОбъект.Товары.Добавить();
стр.Номенклатура	= клиент.Справочники.Номенклатура.НайтиПоНаименованию("Телевизор");
стр.Количество		= 2;

стр = докОбъект.Товары.Добавить();
стр.Номенклатура	= клиент.Справочники.Номенклатура.НайтиПоНаименованию("Пылесос");
стр.Количество		= 3;

// Записываем состояние объекта в режиме проведения
докОбъект.Записать(РежимЗаписиДокумента.Проведение);

// Получаем ссылку на созданный документ
dynamic докСсылка = докОбъект.Ссылка;

// 2. РЕДАКТИРОВАНИЕ СУЩЕСТВУЮЩЕГО ДОКУМЕНТА

// Получаем контекст объекта из ссылки
докОбъект = докСсылка.ПолучитьОбъект();

// Изменяем значение реквизита
докОбъект.Комментарий = "Этот документ был изменен из модуля Бром!";

// Записываем состояние объекта в режиме записи
докОбъект.Записать();

// 3. УДАЛЕНИЕ СУЩЕСТВУЮЩЕГО ДОКУМЕНТА

докОбъект.Удалить();

// 1. СОЗДАНИЕ НОВОГО ДОКУМЕНТА

// Создаем контекст нового документа
$докОбъект = $клиент->Документы->ЗаказКлиента->СоздатьДокумент();

// Заполняем реквизиты
$докОбъект->Дата			= new Дата();
$докОбъект->Контрагент		= $клиент->Справочники->Контрагенты->НайтиПоКоду("000000001");

// Заполняем табличную часть "Товары"
$стр = $докОбъект->Товары->Добавить();
$стр->Номенклатура	= $клиент->Справочники->Номенклатура->НайтиПоНаименованию("Телевизор");
$стр->Количество	= 2;

$стр = $докОбъект->Товары->Добавить();
$стр->Номенклатура	= $клиент->Справочники->Номенклатура->НайтиПоНаименованию("Пылесос");
$стр->Количество	= 3;

// Записываем состояние объекта в режиме проведения
$докОбъект->Записать(РежимЗаписиДокумента::Проведение());

// Получаем ссылку на созданный документ
$докСсылка = $докОбъект->Ссылка;

// 2. РЕДАКТИРОВАНИЕ СУЩЕСТВУЮЩЕГО ДОКУМЕНТА

// Получаем контекст объекта из ссылки
$докОбъект = $докСсылка->ПолучитьОбъект();

// Изменяем значение реквизита
$докОбъект->Комментарий = "Этот документ был изменен из модуля Бром!";

// Записываем состояние объекта в режиме записи
$докОбъект->Записать();

// 3. УДАЛЕНИЕ СУЩЕСТВУЮЩЕГО ДОКУМЕНТА

$докОбъект->Удалить();

# 1. СОЗДАНИЕ НОВОГО ДОКУМЕНТА

# Создаем контекст нового документа
докОбъект = клиент.Документы.ЗаказКлиента.СоздатьДокумент()

# Заполняем реквизиты
докОбъект.Дата			= datetime.today()
докОбъект.Контрагент	= клиент.Справочники.Контрагенты.НайтиПоКоду("000000001")

# Заполняем табличную часть "Товары"
стр = докОбъект.Товары.Добавить()
стр.Номенклатура	= клиент.Справочники.Номенклатура.НайтиПоНаименованию("Телевизор")
стр.Количество		= 2

стр = докОбъект.Товары.Добавить()
стр.Номенклатура	= клиент.Справочники.Номенклатура.НайтиПоНаименованию("Пылесос")
стр.Количество		= 3

# Записываем состояние объекта в режиме проведения
докОбъект.Записать(РежимЗаписиДокумента.Проведение)

# Получаем ссылку на созданный документ
докСсылка = докОбъект.Ссылка

# 2. РЕДАКТИРОВАНИЕ СУЩЕСТВУЮЩЕГО ДОКУМЕНТА

# Получаем контекст объекта из ссылки
докОбъект = докСсылка.ПолучитьОбъект()

# Изменяем значение реквизита
докОбъект.Комментарий = "Этот документ был изменен из модуля Бром!"

# Записываем состояние объекта в режиме записи
докОбъект.Записать()

# 3. УДАЛЕНИЕ СУЩЕСТВУЮЩЕГО ДОКУМЕНТА

докОбъект.Удалить()

Аналогичным образом могут быть созданы и отредактированы объекты других ссылочных коллекций 1С. Более подробную информацию по работе с объектами Вы найдете в документации.

Выполнение запросов 1С

Бром позволяет выполнять запросы к базе данных на языке запросов 1С:Предприятие:

// Создаем новый запрос
Запрос текЗапрос = клиент.СоздатьЗапрос(@"
	ВЫБРАТЬ
		Номенклатура.Код КАК Код,
		Номенклатура.Наименование КАК Наименование
	ИЗ
		Справочник.Номенклатура КАК Номенклатура
	ГДЕ
		Номенклатура.Ссылка В ИЕРАРХИИ(&Группы)
		И Номенклатура.ЭтоГруппа = ЛОЖЬ
");

// Передаем в качестве параметра массив ссылок на группы номенклатуры
текЗапрос.УстановитьПараметр("Группы", new object[] {
	клиент.Справочники.Номенклатура.НайтиПоНаименованию("Бытовая техника"),
	клиент.Справочники.Номенклатура.НайтиПоНаименованию("Мебель")
});

// Выполняем запрос и получаем таблицу значений
ТаблицаЗначений результат = (ТаблицаЗначений)текЗапрос.Выполнить();

// Выводим результаты на экран
foreach (dynamic стр in результат) {
	Console.WriteLine("Наименование: {0}", стр.Наименование);
}

// Создаем новый запрос
$текЗапрос = $клиент->СоздатьЗапрос("
	ВЫБРАТЬ
		Номенклатура.Код КАК Код,
		Номенклатура.Наименование КАК Наименование
	ИЗ
		Справочник.Номенклатура КАК Номенклатура
	ГДЕ
		Номенклатура.Ссылка В ИЕРАРХИИ(&Группы)
		И Номенклатура.ЭтоГруппа = ЛОЖЬ
");

// Передаем в качестве параметра массив ссылок на группы номенклатуры
$текЗапрос->УстановитьПараметр("Группы", array(
	$клиент->Справочники->Номенклатура->НайтиПоНаименованию("Бытовая техника"),
	$клиент->Справочники->Номенклатура->НайтиПоНаименованию("Мебель")
));

// Выполняем запрос и получаем таблицу значений
$результат = $текЗапрос->Выполнить();

// Выводим результаты на экран
foreach ($результат as $стр) {
	echo("Наименование: {$стр->Наименование} <br/>");
}

# Создаем новый запрос
текЗапрос = клиент.СоздатьЗапрос("""
	ВЫБРАТЬ
		Номенклатура.Код КАК Код,
		Номенклатура.Наименование КАК Наименование
	ИЗ
		Справочник.Номенклатура КАК Номенклатура
	ГДЕ
		Номенклатура.Ссылка В ИЕРАРХИИ(&Группы)
		И Номенклатура.ЭтоГруппа = ЛОЖЬ
""")

# Передаем в качестве параметра массив ссылок на группы номенклатуры
текЗапрос.УстановитьПараметр("Группы", [
	клиент.Справочники.Номенклатура.НайтиПоНаименованию("Бытовая техника"),
	клиент.Справочники.Номенклатура.НайтиПоНаименованию("Мебель")
])

# Выполняем запрос и получаем таблицу значений
результат = текЗапрос.Выполнить()

# Выводим результаты на экран
for стр in результат:
	print("Наименование: " + стр.Наименование)

Кроме простых запросов Бром умеет выполнять пакетные запросы, а также шаблонизированные запросы с возможностью допостроения. Подробнее об этом Вы сможете прочесть в документации.

Формирование сложных выборок

Бром позволяет формировать выборки из объектных коллекций 1С с учетом сложных отборов и сортировок. Выборки представляют собой перечисляемые множества ссылок на объекты, которые удовлетворяют заданным условиям. Например можно выбрать всю номенклатуру, входящую в группу "Мебель":

// Выборка номенклатуры из группы "Мебель"

// Получаем ссылку на группу
dynamic группаМебель = клиент.Справочники.Номенклатура.НайтиПоНаименованию("Мебель");

// Создаем селектор справочника "Номенклатура"
Селектор текСелектор = клиент.Справочники.Номенклатура.СоздатьСелектор();

// Указываем поля выборки, устанваливаем отборы и сортировки
текСелектор.
	Выбрать("Наименование, Код, Производитель, Производитель.ИНН").
	Где("ЭтоГруппа", false).
	Где("Ссылка", группаМебель, ВидСравнения.ВИерархии).
	Упорядочить("Производитель").
	Упорядочить("Наименование", НаправлениеСортирвки.Убывание);

// Выводим на экран результат выборки
foreach (dynamic текСсылка in текСелектор) {
	Console.WriteLine("Наименование: {0}; Код: {1}; Производитель: {2}; ИНН: {3}",
		текСсылка.Наименование,
		текСсылка.Код,
		текСсылка.Производитель,
		текСсылка.Производитель.ИНН
	);
}

// Сохраняем результат выборки в массив для последующего использования
Ссылка[] результат = текСелектор.ВыгрузитьРезультат();

// Выборка номенклатуры из группы "Мебель"

// Получаем ссылку на группу
$группаМебель = $клиент->Справочники->Номенклатура->НайтиПоНаименованию("Мебель");

// Создаем селектор справочника "Номенклатура"
$текСелектор = $клиент->Справочники->Номенклатура->СоздатьСелектор();

// Устанваливаем отборы и сортировки
$текСелектор->
	Выбрать("Наименование, Код, Производитель, Производитель.ИНН")->
	Где("ЭтоГруппа", false)->
	Где("Ссылка", $группаМебель, ВидСравнения::ВИерархии())->
	Упорядочить("Производитель")->
	Упорядочить("Наименование", НаправлениеСортирвки::Убывание());

// Выводим на экран результат выборки
foreach ($текСелектор as $текСсылка) {
	echo("
		Наименование: {$текСсылка->Наименование}; 
		Код: {$текСсылка->Код}; 
		Производитель: {$текСсылка->Производитель}; 
		ИНН: {$текСсылка->Производитель->ИНН}
	");
}

// Сохраняем результат выборки в массив для последующего использования
$результат = $текСелектор->ВыгрузитьРезультат();

# Выборка номенклатуры из группы "Мебель"

# Получаем ссылку на группу
группаМебель = клиент.Справочники.Номенклатура.НайтиПоНаименованию("Мебель")

# Создаем селектор справочника "Номенклатура"
текСелектор = клиент.Справочники.Номенклатура.СоздатьСелектор()

# Устанваливаем отборы и сортировки
текСелектор.\
	Выбрать("Наименование, Код, Производитель, Производитель.ИНН").\
	Где("ЭтоГруппа", False).\
	Где("Ссылка", группаМебель, ВидСравнения.ВИерархии).\
	Упорядочить("Производитель").\
	Упорядочить("Наименование", НаправлениеСортирвки.Убывание)

# Выводим на экран результат выборки
for текСсылка in текСелектор:
	print(
		"Наименование: {0}; Код: {1}; Производитель: {2}; ИНН: {3}".format(
			текСсылка.Наименование,
			текСсылка.Код,
			текСсылка.Производитель,
			текСсылка.Производитель.ИНН
		)
	)

# Сохраняем результат выборки в массив для последующего использования
результат = текСелектор.ВыгрузитьРезультат()

Более подробную информацию о формировании выборок Вы найдете в документации.

Вызов процедур и функций 1С

Бром позволяет вызывать процедуры и функции на стороне 1С. Доступны методы как глобального контекста, так методы серверных модулей:

// Вызываем функцию "ЧислоПрописью" глобального контекста 1С
string числоПрописью = клиент.ЧислоПрописью(2547);

// Вызываем функцию "НайтиПоНаименованию" модуля менеджера справочника "Номенклатура"
dynamic телевизорСсылка = клиен.Справочники.Номенклатура.НайтиПоНаименованию("Телевизор");

// Вызываем функцию "ПолучитьКурсВалюты" общего модуля "РаботаСКурсамиВалют"
dynamic доллар = клиент.Справочники.Валюты.НайтиПоКоду("840");
Структура курс = клиент.РаботаСКурсамиВалют.ПолучитьКурсВалюты(доллар, DateTime.Today);

// Вызываем функцию "ЧислоПрописью" глобального контекста 1С
$числоПрописью = $клиент->ЧислоПрописью(2547);

// Вызываем функцию "НайтиПоНаименованию" модуля менеджера справочника "Номенклатура"
$телевизорСсылка = $клиен->Справочники->Номенклатура->НайтиПоНаименованию("Телевизор");

// Вызываем функцию "ПолучитьКурсВалюты" общего модуля "РаботаСКурсамиВалют"
$доллар = $клиент->Справочники->Валюты->НайтиПоКоду("840");
$курс = $клиент->РаботаСКурсамиВалют->ПолучитьКурсВалюты($доллар, new Дата());

# Вызываем функцию "ЧислоПрописью" глобального контекста 1С
числоПрописью = клиент.ЧислоПрописью(2547)

# Вызываем функцию "НайтиПоНаименованию" модуля менеджера справочника "Номенклатура"
телевизорСсылка = клиен.Справочники.Номенклатура.НайтиПоНаименованию("Телевизор")

# Вызываем функцию "ПолучитьКурсВалюты" общего модуля "РаботаСКурсамиВалют"
доллар = клиент.Справочники.Валюты.НайтиПоКоду("840")
курс = клиент.РаботаСКурсамиВалют.ПолучитьКурсВалюты(доллар, datetime.today())

Вызываемые методы могут принимать и возвращать значения не только примитивных типов, но и сложные структурированные данные: Ссылки, Массивы, Структуры, ДвоичныеДанные, ТаблицыЗначений, ДеревьяЗначений, системные перечисления 1С и многое другое. Некоторые классы специално реализованы в клиентском модуле, для корректного взаимодействия с 1С:Предприятие.

Полный список сериализуемых типов описан в документации клиентских модулей.

Исполнение фрагментов кода на языке 1С

Бром позволяет исполнять произвольные фрагменты кода на стороне 1С:Предприятие. Фрагменты кода могут возвращать результат, а также принимать на вход параметр. Входные и выходные значения могут быть произвольного сериализуемого типа:

// Данный фрагмент кода принимает на вход массив чисел и возвращает их сумму
decimal суммаЧиселВМассиве = клиент.Выполнить(@"
	Результат = 0;
    Для Каждого Значение Из Параметр Цикл
        Результат = Результат + Значение;
    КонецЦикла;
", new double[] { 45, 67, 12.56, 11.9 });

Console.WriteLine(суммаЧиселВМассиве);

// Данный фрагмент кода переводит наименование элемента
// справочника в верхний регистр
клиент.Выполнить(@"
	ТекСсылка = Справочники.Номенклатура.НайтиПоНаименованию(""Бутылка"");
	ТекОбъект = ТекСсылка.ПолучитьОбъект();
	ТекОбъект.Наименование = ВРег(ТекОбъект.Наименование);
	ТекОбъект.Записать();
");

// Данный фрагмент кода принимает на вход массив чисел и возвращает их сумму
$суммаЧиселВМассиве = $клиент->Выполнить("
	Результат = 0;
    Для Каждого Значение Из Параметр Цикл
        Результат = Результат + Значение;
    КонецЦикла;
", array(45, 67, 12.56, 11.9));

echo($суммаЧиселВМассиве);

// Данный фрагмент кода переводит наименование элемента
// справочника в верхний регистр
$клиент->Выполнить("
	ТекСсылка = Справочники.Номенклатура.НайтиПоНаименованию(\"Бутылка\");
	ТекОбъект = ТекСсылка.ПолучитьОбъект();
	ТекОбъект.Наименование = ВРег(ТекОбъект.Наименование);
	ТекОбъект.Записать();
");

# Данный фрагмент кода принимает на вход массив чисел и возвращает их сумму
суммаЧиселВМассиве = клиент.Выполнить("""
	Результат = 0;
    Для Каждого Значение Из Параметр Цикл
        Результат = Результат + Значение;
    КонецЦикла;
""", [45, 67, 12.56, 11.9])

print(суммаЧиселВМассиве)

# Данный фрагмент кода переводит наименование элемента
# справочника в верхний регистр
клиент.Выполнить('''
	ТекСсылка = Справочники.Номенклатура.НайтиПоНаименованию(""Бутылка"");
	ТекОбъект = ТекСсылка.ПолучитьОбъект();
	ТекОбъект.Наименование = ВРег(ТекОбъект.Наименование);
	ТекОбъект.Записать();
''')

Более подробную информацию об исполнении фрагментов кода Вы найдете в документации. Там же преведен список сериализуемых типов данных для каждого варианта клиента.

Доступ к метаданным

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

// 1. Вывод списка справочников конфигурации

// Получаем узел коллекции справочников
dynamic узелСпискаСправочников = клиент.Метаданные.Справочники;

// Выводим список справочников на экран
foreach (dynamic ключЗначение in узелСпискаСправочников) {
	Console.WriteLine(ключЗначение.Key);
}

// 2. Вывод реквизитов справочника "Номенклатура"

// Получаем узел коллекции реквизитов справочника "Номенклатура"
dynamic узелСпискаРеквизитов = клиент.Метаданные.Справочники.Номенклатура.Реквизиты;

// Выводим список реквизитов на экран
foreach (dynamic ключЗначение in узелСпискаРеквизитов) {
	Console.WriteLine(ключЗначение.Key);
}

// 3. Проверка существования табличной части

if(клиент.Метаданные.Содержит("Справочники.Номенклатура.ТабличныеЧасти.ДополнительныеРеквизиты")){
	Console.WriteLine("Существует!");
}

// 1. Вывод списка справочников конфигурации

// Получаем узел коллекции справочников
$узелСпискаСправочников = $клиент->Метаданные->Справочники;

// Выводим список справочников на экран
foreach ($узелСпискаСправочников as $имя => $узел) {
	echo("{$узел->Имя()} <br/>");
}

// 2. Вывод реквизитов справочника "Номенклатура"

// Получаем узел коллекции реквизитов справочника "Номенклатура"
$узелСпискаРеквизитов = $клиент->Метаданные->Справочники->Номенклатура->Реквизиты;

// Выводим список реквизитов на экран
foreach ($узелСпискаРеквизитов as $имя => $узел) {
	echo("{$узел->Имя()} <br/>");
}

// 3. Проверка существования табличной части

if($клиент->Метаданные->Содержит("Справочники.Номенклатура.ТабличныеЧасти.ДополнительныеРеквизиты")){
	echo("Существует!");
}

# 1. Вывод списка справочников конфигурации

# Получаем узел коллекции справочников
узелСпискаСправочников = клиент.Метаданные.Справочники

# Выводим список справочников на экран
for узел in узелСпискаСправочников.values():
	print(узел.Имя())

# 2. Вывод реквизитов справочника "Номенклатура"

# Получаем узел коллекции реквизитов справочника "Номенклатура"
узелСпискаРеквизитов = клиент.Метаданные.Справочники.Номенклатура.Реквизиты

# Выводим список реквизитов на экран
for узел in узелСпискаРеквизитов.values():
	print(узел.Имя())

# 3. Проверка существования табличной части

if клиент.Метаданные.Содержит("Справочники.Номенклатура.ТабличныеЧасти.ДополнительныеРеквизиты"):
	print("Существует!")

Более подробную информацию о работе с метаданными Вы найдете в документации.