🥇Методи за интеграция с 1С

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

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

Това как 1С решава първата задача е кратко описано в секцията «Кастомизация и поддръжка» тази статия; ще се върнем отново към тази интересна тема в една от бъдещите статии. Днес темата е за втората задача, интеграцията.

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

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

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

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

Реализация на базата на интеграционни механизми, предоставени от платформата, или собствено специализирано API от страната на приложението 1С (например, набор от Web или HTTP услуги, които ще извикват външни приложения за обмен на данни с приложението 1С). Предимството на този подход е устойчивостта на API на промените в реализацията от страната на приложението 1С. Специфика на подхода е, че е необходимо да се променя изходният код на типовото решение 1С, което потенциално може да изисква усилия при сливането на изходните кодове при преминаване към нова версия на конфигурацията. В този случай може да помогне новата прогресивна функционалност — разширения на конфигурациятаРазширенията са по същност механизми за добавки, които позволяват създаването на добавки за приложения, без да променят самите приложения. Изнасянето на интеграционния API в разширение на конфигурацията ще избегне усложненията при обединяване на конфигурациите при преминаване към нова версия на стандартното решение.
Използването на механизми за интеграция на платформата, които предоставят достъп отвън до обектната модел на приложението и не изискват префикс на приложението или създаването на разширение. Плюс на този подход — не е необходимо да се променя приложението 1С. Минус — ако приложението 1С е било уточнено, може да се наложи разширение в интегрираното приложение. Пример за такъв подход — използването на протокола OData за интеграция, реализиран от страната на платформата 1С:Предприятие (повече за него по-долу).
Използването на готови приложни протоколи, реализирани в типичните решения на 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ериализатор  = XDTOSериализатор;
	Нов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 и/или уеб услуги.

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 (заглавието на съобщението е пропуснато за краткост):

<entry>
	<id>http://server/Config/odata/standard.odata/Catalog_Номенклатура(guid'35d1f6e4-289b-11e6-8ba4-e03f49b16074')</id>
	<category term="StandardODATA.Catalog_Номенклатура" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme"/>
	<title type="text"/>
	<updated>2016-06-06T16:42:17</updated>
	<author/>
	<summary/>
	<link rel="edit" href="Catalog_Номенклатура(guid'35d1f6e4-289b-11e6-8ba4-e03f49b16074')" title="edit-link"/>
	<content type="application/xml">
		<m:properties>
			<d:Ref_Key>35d1f6e4-289b-11e6-8ba4-e03f49b16074</d:Ref_Key>
			<d:DataVersion>AAAAAgAAAAA=</d:DataVersion>
			<d:DeletionMark>false</d:DeletionMark>
			<d:Code>000000001</d:Code>
			<d:Description>Кондиционер Mitsubishi</d:Description>
			<d:Описание>Мощност 2,5 кВт, режим на работа: топло/студено</d:Описание>
		</m:properties>
	</content>
</entry>
<entry>
	<id>http://server/Config/odata/standard.odata/Catalog_Номенклатура(guid'35d1f6e5-289b-11e6-8ba4-e03f49b16074')</id>
	<category term="StandardODATA.Catalog_Номенклатура" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme"/>
...

Добавяйки към URL-а стринга «?$format=application/json», получаваме съдържанието на каталога Номенклатура в JSON формат (URL адрес от типа http://<сървър>/<конфигурация>/odata/standard.odata/Catalog_Номенклатура?$format=application/json ):

{
"odata.metadata": "http://server/Config/odata/standard.odata/$metadata#Catalog_Номенклатура",
"value": [{
"Ref_Key": "35d1f6e4-289b-11e6-8ba4-e03f49b16074",
"DataVersion": "AAAAAgAAAAA=",
"DeletionMark": false,
"Code": "000000001",
"Description": "Кондиционер Mitsubishi",
"Описание": "Мощност 2,5 кВт, режим на работа: топло/студено"
},{
"Ref_Key": "35d1f6e5-289b-11e6-8ba4-e03f49b16074",
"DataVersion": "AAAAAwAAAAA=",
"DeletionMark": false,
"Code": "000000002",
"Description": "Кондиционер Daikin",
"Описание": "Мощност 3 кВт, режим на работа: топло/студено"
}, …

Външни източници на данни

В някои случаи обменът на данни чрез външни източници на данни може да се окаже оптималното решение. Външните източници на данни са приложен обект на конфигурация 1С, който позволява взаимодействие с всяка ODBC-съвместима база данни както за четене, така и за писане. Външните източници на данни са налични както в Windows, така и в Linux.

Механизмът за обмен на данни

Механизмът за обмен на данни е предназначен както за създаване на териториално разпределени системи на базата на 1С:Предприятие, така и за организиране на обмен на данни с други информационни системи, не основани на 1С:Предприятие.

Този механизъм активно се използва в внедренията на 1С, а спектърът от задачи, решавани с негова помощ, е доста широк. Това е обмен на данни между приложения на 1С, инсталирани в клоновете на организацията, обмен между приложението на 1С и сайта на интернет магазина, както и обмен на данни между сървърното приложение на 1С и мобилния клиент (създаден с помощта на мобилната платформа 1С:Предприятие) и много други.

Едно от ключовите понятия в механизма за обмен на данни е планът за обмен. Планът за обмен е особен тип обект на приложната платформа 1С, който определя, в частност, състава на данните, които ще участват в обмена (какви именно справочници, документи, регистри и т.н.). Планът за обмен съдържа също информация за участниците в обмена (т.нар. възли за обмен).
Втората съставка на механизма за обмен на данни е механизмът за регистрация на изменения. Този механизъм автоматично следи промените в системата, които трябва да бъдат предадени на крайните потребители в рамките на плана за обмен. С помощта на този механизъм платформата проследява измененията, настъпили от последната синхронизация, и позволява минимизиране на обема на данните, предавани в рамките на следващата сесия на синхронизация.

Обменът на данни се осъществява чрез XML съобщения с определена структура. Съобщението съдържа данни, които са се променили след последната синхронизация с възела, и някоя служебна информация. Структурата на съобщенията поддържа номериране на съобщенията и позволява получаване на потвърждения от получаващия възел за приема на съобщения. Такова потвърждение е включено във всяко съобщение, постъпващо от получаващия възел, под формата на номера на последното прието съобщение. Номерирането на съобщенията помага на платформата да разбере кои данни вече са били успешно предадени на получаващия възел и да избегне повторна предаване, изпращайки само данните, които са се променили след получаване на последното съобщение от изпращащия възел с потвърждение за получените данни. При такава схема на работа се осигурява гарантирано доставяне дори при ненадеждни канали за предаване и загуба на съобщения.

Външни компоненти

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

Типичен пример за задача с подобни изисквания може да бъде интеграцията на приложно решение 1С с търговско оборудване, започвайки от везни и стигайки до касови апарати и скенери за баркодове. Външните компоненти могат да бъдат свързани както на страна на сървъра на 1С:Предприятие, така и на клиентската част (включително, в това число, и уеб клиента, а също така следващата версия на мобилната платформа 1С:Предприятие). Технологията за външни компоненти предвижда достатъчно прост и понятен софтуерен (C++) интерфейс за взаимодействие на компонента с платформата 1С:Предприятие, който трябва да бъде реализиран от разработчика.

Възможностите, които се откриват при използването на външни компоненти, са доста широки. Може да се реализира взаимодействие по специфичен протокол за обмен на данни с външни устройства и системи, да се вградят специфични алгоритми за обработка на данни и формати на данни и т.н.

Остарели интеграционни механизми

В платформата са налични интеграционни механизми, които не се препоръчват за използване в нови решения; те са оставени от съображения за съвместимост, както и за случаи, в които другата страна не може да работи с по-съвременни протоколи. Един от тях е работа с файлове с формат DBF (поддържа се във вградения език чрез обекта XBase).

Друг остарял интеграционен механизъм е използването на технологията COM (достъпна само на платформата Windows). Платформата 1C:Предприятие предоставя два начина на интеграция за Windows, използващи технологията COM: Automation-сървър и Външна връзка. Те са много сходни, но едно от основните различия е, че в случая на Automation-сървъра се стартира пълноценно клиентско приложение 1C:Предприятие 8, а в случая на външната връзка се стартира относително малък вътрешнопроцесен COM-сървър. Тоест в случая на работа през Automation сървър може да се използва функционалността на клиентското приложение и да се извършват действия, аналогични на интерактивните действия на потребителя. При използване на външната връзка могат да се използват само функции на бизнес логиката, които могат да бъдат изпълнявани както на клиентската страна на връзката, където се създава вътрешнопроцесен COM-сървър, така и да се извиква бизнес логика на страната на сървера 1C:Предприятие.

Също така технологията COM може да се използва за обращение към външни системи от кода на приложението на платформата 1C:Предприятие. В този случай приложението 1C действа като COM-клиент. Но следва да се припомни, че тези механизми ще работят само в случай, че сървърът 1C функционира в среда Windows.

Интеграционните механизми, реализирани в стандартните конфигурации

Формат EnterpriseData

В редица конфигурации 1C (списък по-долу) на базата на описания по-горе платформен механизъм за обмен на данни е реализиран готов механизъм за обмен на данни с външни приложения, който не изисква промяна на изходния код на конфигурациите (подготовката за обмен на данни се извършва в настройките на приложните решения):

«1C:ERP Управление на предприятието 2.0»
«Комплексна автоматизация 2»
«Счетоводство на предприятието», редакция 3.0
«Счетоводство на предприятието КОРП», редакция 3.0
«Търговия на дребно», редакция 2.0
„Управление търговията базова“, версия 11
„Управление търговията“, версия 11
„Заплата и управление на персонала КОРП“, версия 3

За обмен на данни се използва формат EnterpriseData, базиран на XML. Форматът е ориентиран към бизнеса – описаните в него структури от данни съответстват на бизнес-субекти (документи и елементи на справочници), представени в програмите 1С, например: акт за извършени услуги, приходен касов ордер, контрагент, номенклатура и т.н.

Обменът на данни между приложението 1С и външно приложение може да се случва:

чрез отделен файлов каталог
чрез FTP каталог
чрез уеб услуга, разположена на страната на приложението 1С. Файлът с данни се предава като параметър на уеб методите
чрез електронна поща

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

по график (с определена периодичност)
ръчно; потребителят трябва ръчно да стартира синхронизация всеки път, когато му е необходимо

Квитиране на съобщения

Приложенията 1С водят отчет на изпратените и получените съобщения за синхронизация и очакват същото от външните приложения. Това позволява използването на механизма за номериране на съобщения, описан по-горе в раздела „Механизъм за обмен на данни“.

Приложения 1С при синхронизации предават само информация за промените, настъпили в бизнес-съществата от последната синхронизация (за да се минимизира обемът на предаваната информация). При първата синхронизация приложението 1С ще експортира всички бизнес-същества (например, елементи от справочника на номенклатурата) в формат EnterpriseData в XML файл (тъй като всички те са "нови" за външното приложение). Външното приложение трябва да обработи информацията от полученото от 1С XML и при следващата сесия на синхронизация да постави в файла, изпращан на 1С, в специална секция XML, информация, че съобщението от 1С с определен номер е успешно прието. Съобщението-квитанция е за приложението 1С сигнал, че всички бизнес-същества са успешно обработени от външното приложение и информацията за тях да не бъде предавана повече. Освен квитанцията, XML файлът от външното приложение може да съдържа и данни за синхронизация от страна на приложението (например, документи за реализация на стоки и услуги).

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

При предаване на данни от външното приложение към приложението 1С картината се променя обратно. Външното приложение трябва да попълни секция-квитанция в XML файла по подходящ начин и да постави бизнес-данни за синхронизация от своя страна в формат EnterpriseData.

Оптимизирана обмен на данни без квитиране

За случаи на проста интеграция, когато е достатъчно само да се предаде информация от външното приложение към приложението 1С и обратна доставка на данни от приложението 1С към външното приложение не е необходима (например интеграция на онлайн магазин, който предава информация за продажбите в "1С:Бухгалтерия"), съществува опростена версия на работа чрез уеб-сервис (без квитиране), която не изисква настройки от страна на приложението 1С.

Специализирани интеграционни решения

Има стандартно решение «1С: Конвертиране на данни», което използва механизмите на платформата за конвертиране и обмен на данни между стандартни конфигурации на 1С, но също така може да се използва за интеграция с външни приложения.

Интеграция с банкови решения

Стандарт «Клиент банк», разработен от специалисти на 1С преди повече от 10 години, всъщност стана индустриален стандарт в Русия. Следващата стъпка в тази посока е технологията DirectBank, която позволява да се изпращат платежни документи в банката и да се получават извлечения от банката директно от програмите на системата «1С: Предприятие» с натискането на един бутон в програмата «1С»; при това не е необходимо инсталиране и стартиране на допълнителни програми на клиентския компютър.

Съществува също стандарт за обмен на данни в проектите за заплати.

Други

Заслужават да се споменат протоколът за обмен между системата 1С: Предприятие и сайта, стандартът за обмен на търговска информация CommerceML (разработен съвместно с Microsoft, Intel, Price.ru и други компании), стандарт за обмен на данни за операциите с еквайринг.

Източник: habr.com