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

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

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

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

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

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

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

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

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

Механизми за интеграция в платформата 1C:Enterprise

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

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

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

Платформата реализира механизъм за сериализиране на обекти на приложения в XML както директно, чрез методите на глобалния контекст WriteXML/ReadXML, така и чрез използване на спомагателния обект XDTO (XML Data Transfer Objects).

Всеки обект в системата 1C:Enterprise може да бъде сериализиран в 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. Продуктите ще бъдат записани в масив; За разнообразие, ето английската версия на синтаксиса:

&AtServer
Procedure ExportJSONOnServer()
	NewXDTOSerializer  = XDTOSerializer;
	NewJSONWriter = New JSONWriter();
	NewJSONWriter.OpenFile("C:DataНоменклатура.json", "UTF-8");
	
	NewJSONWriter.WriteStartObject();
	NewJSONWriter.WritePropertyName("СправочникНоменклатура");
	NewJSONWriter.WriteStartArray();
	
	Selection = Catalogs.Номенклатура.Select();	
	
	While Selection.Next() Do 
		NomenclatureObject = Selection.GetObject();
		
		NewJSONWriter.WriteStartObject();
		
		NewJSONWriter.WritePropertyName("Номенклатура");
		NewXDTOSerializer.WriteJSON(NewJSONWriter, NomenclatureObject, XMLTypeAssignment.Implicit);
		
		NewJSONWriter.WriteEndObject();
	EndDo;
	
	NewJSONWriter.WriteEndArray();
	NewJSONWriter.WriteEndObject();
	NewJSONWriter.Close();	
EndProcedure

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

HTTP и уеб услуги

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

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

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

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

<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"/>
...

Като добавим низа „?$format=application/json“ към URL адреса, получаваме съдържанието на номенклатурния каталог във формат 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 кВт, режимы работы: тепло/холод"
}, …

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Корпоративен формат на данни

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

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

Форматът, използван за обмен на данни, е EnterpriseData, базиран на XML. Форматът е бизнес-ориентиран - структурите от данни, описани в него, съответстват на бизнес обекти (документи и елементи от директория), представени в програмите 1C, например: акт за изпълнение, касов ордер, контрагент, артикул и др.

Обменът на данни между приложението 1C и приложение на трета страна може да възникне:

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

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

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

Потвърждаване на съобщения

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

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

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

Когато прехвърляте данни от външно приложение към приложението 1C, картината е обърната. Външното приложение трябва съответно да попълни раздела за получаване на XML файла и да постави бизнес данните за синхронизиране от своя страна във формат EnterpriseData.

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

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

Персонализирани решения за интеграция

Има стандартно решение „1C: Преобразуване на данни“, което използва платформени механизми за конвертиране и обмен на данни между стандартни 1C конфигурации, но може да се използва и за интеграция с приложения на трети страни.

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

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

Има и такива стандарт за обмен на данни в проекти за заплати.

Друг

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

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