Начини на интеграция с 1С

Какви са основните изисквания за бизнес приложенията? Най-важните от тях са следните задачи:

• Лесно изменение/адаптиране на логиката на приложение за променящите се бизнес нужди.
• Лесна интеграция с други приложения.

Начинът, по който 1С решава първата задача, е кратко описан в раздела „Кастомизация и поддръжка“; тази статияще се върнем към тази интересна тема в една от бъдещите статии. Днес обаче ще говорим за втората задача, а именно интеграцията.

Интеграционни задачи

Интеграционните задачи могат да бъдат различни. За решаване на някои от тях е достатъчен прост интерактивен обмен на данни – например, за предаване в банката на списъка с персонал за издаване на кредитни карти за заплати. За по-сложни задачи може да се наложи напълно автоматизиран обмен на данни, възможно с обращение към бизнес логиката на външната система. Има и задачи със специализиран характер, като интеграция с външно оборудване (например, търговско оборудване, мобилни сканиращи устройства и т.н.) или с наследени или тясно специализирани системи (например, системи за разпознаване на RFID етикети). Изключително важно е за всяка задача да се избере най-подходящият механизъм за интеграция.

Възможности за интеграция с 1С

Съществуват различни подходи за реализиране на интеграция с приложения 1С, а кой от тях да изберете зависи от изискванията на задачата.

1. Реализация на база механизми за интеграция, предоставяни от платформата, или собствено специализирано API на страната на приложението 1С (например, набор от Web или HTTP услуги, които ще извикват външни приложения за обмен на данни с приложението 1С). Предимството на този подход е устойчивостта на API на промените в реализацията на приложението 1С. Спецификата на подхода е, че трябва да се променя изходният код на типичното решение на 1С, което потенциално може да изисква усилия при сливане на изходните кодове при преминаване към нова версия на конфигурацията. В този случай новата прогресивна функционалност – разширения на конфигурацията. Разширенията по същество представляват механизъм за плъгини, който позволява създаването на допълнения към приложните решения, без да е необходимо да се променят самите приложения. Изваждането на интеграционния API в разширение на конфигурацията ще избегне сложностите при сливането на конфигурации при преминаване към нова версия на стандартното решение.
2. Използване на интеграционни механизми на платформата, които предоставят външен достъп до обектната модель на приложението и не изискват модификация на приложението или създаване на разширение. Плюсът на този подход е, че не е необходимо да променяте приложението 1С. Минусът е, че ако приложението 1С е било модифицирано, може да се наложат доработки в интегрираното приложение. Пример за такъв подход е използването на протокола OData за интеграция, реализиран на страната на платформата 1С:Предприятие (повече за него по-долу).
3. Използване на готови приложни протоколи, реализирани в стандартните решения на 1С. Много стандартни решения от 1С и партньорите им реализират свои собствени приложни протоколи, ориентирани към конкретни задачи, въз основа на интеграционните механизми, предоставяни от платформата. При използване на тези механизми не е необходимо писане на код на страната на приложението 1С, тъй като ползваме стандартните функции на приложното решение. Отстраната на приложението 1С просто трябва да извършим определени настройки.

Интеграционни механизми в платформата 1С:Предприятие

Импорт/експорт на файлове

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

За решаване на такава задача може да напишем разширение, което ще експортира справочника Номенклатура в файл с определен формат (текстов, XML, JSON и т.н.) и ще може да чете този формат.

В платформата е реализиран механизъм за сериализация на приложни обекти в XML, както директно, чрез методите на глобалния контекст ЗаписатьXML/ЧтениеXML, така и посредством помощен обект XDTO (XML Data Transfer Objects).

Всеки обект в системата 1С:Предприятие може да бъде сериализиран в XML представяне и обратно.

Тази функция ще върне представенето на обекта в XML вид:

Функция Обект_В_XML(Обект)
    ЗаписXML = Нов ЗаписXML();
    ЗаписXML.УстановиСтрока();
    ЗапишиXML(ЗаписXML, Обект);
    Върни ЗаписXML.Затвори();
КрайНаФункцията

така ще изглежда експортирането на справочника Номенклатура в XML чрез XDTO:

&НаСървъра
Процедура ЕкспортXMLНаСървъра()	
	НовСериализаторXDTO = СериализаторXDTO;
	НоваЗаписXML = Нов ЗаписXML();
	НоваЗаписXML.отвориФайл("C:DataНоменклатура.xml", "UTF-8");
	
	НоваЗаписXML.ЗаписваОбявлениеXML();
	НоваЗаписXML.ЗаписваНачалоЕлемент("СправочникНоменклатура");
	
	Изборка = Справочници.Номенклатура.Избери();
	
	Докато Изборка.Следващ() Цикъл 
		ОбектНоменклатура = Изборка.ПолучаваОбект();
		НовСериализаторXDTO.ЗаписваXML(НоваЗаписXML, ОбектНоменклатура, НазначениеТипаXML.Явно);
	КрайНаЦикъла;
	
	НоваЗаписXML.ЗаписваКрайЕлемент();
	НоваЗаписXML.Затвори();	
КрайНаПроцедурата

Чрез несложна модификация на кода експортираме справочника в JSON. Стоките ще бъдат записани в масив; за разнообразие нека представим англоезичния вариант на синтаксиса:

&НаСървъра
Процедура ЕкспортJSONНаСървъра()
	НовXDTOSериализатор = XDTOSerializer;
	НовJSONЗаписвач = Нов JSONWriter();
	НовJSONЗаписвач.отвориФайл("C:DataНоменклатура.json", "UTF-8");
	
	НовJSONЗаписвач.ЗаписваНачалоОбект();
	НовJSONЗаписвач.ЗаписваИмеСвойство("СправочникНоменклатура");
	НовJSONЗаписвач.ЗаписваНачалоМасив();
	
	Изборка = Справочници.Номенклатура.Избери();	
	
	Докато Изборка.Следващ() Прави 
		ОбектНоменклатура = Изборка.ПолучаваОбект();
		
		НовJSONЗаписвач.ЗаписваНачалоОбект();
		
		НовJSONЗаписвач.ЗаписваИмеСвойство("Номенклатура");
		НовXDTOSериализатор.ЗаписваJSON(НовJSONЗаписвач, ОбектНоменклатура, XMLТипНазначение.Непряко);
		
		НовJSONЗаписвач.ЗаписваКрайОбект();
	КрайНаПравенето;
	
	НовJSONЗаписвач.ЗаписваКрайМасив();
	НовJSONЗаписвач.ЗаписваКрайОбект();
	НовJSONЗаписвач.Затвори();	
КрайНаПроцедурата

След това остава само да предадем данните на крайния потребител. Платформата 1С:Предприятие поддържа основните интернет протоколи HTTP, FTP, POP3, SMTP, IMAP, включително техните защитени версии. Също така, за предаване на данни могат да се използват HTTP и/или Web услуги.

HTTP и уеб услуги

Приложенията 1С могат да реализират свои HTTP и уеб услуги, както и да извикват HTTP и уеб услуги, реализирани от трети приложения.

REST интерфейс и протокол OData

Започвайки от версия 8.3.5, платформата 1С:Предприятие може автоматично да генерира REST интерфейс за цялото приложение. Всеки обект на конфигурацията (справочник, документ, регистър с данни и т.н.) може да бъде направен достъпен за получаване и модифициране на данни чрез REST интерфейс. Като протокол за достъп платформата използва протокол OData версии 3.0. Публикация на OData услуги се извършва от менюто на Конфигуратора „Администриране -> Публикация на уеб сървър“, опцията „Публикувай стандартния интерфейс OData“ трябва да бъде отбелязана. Поддържат се формати atom/XML и JSON. След като приложението бъде публикувано на уеб сървъра, външни системи могат да се свързват с него чрез REST интерфейс с помощта на HTTP заявки. За работа с приложението 1С чрез OData протокола не е нужно програмиране от страната на 1С.

Така, URL вида http:////odata/standard.odata/Catalog_Номенклатура ще ни върне съдържанието на каталога Номенклатура във формат XML — колекция от елементи entry (заглавието на съобщението е пропуснато за краткост):

http://server/Config/odata/standard.odata/Catalog_Номенклатура(guid'35d1f6e4-289b-11e6-8ba4-e03f49b16074')