Методи на интеграција со 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')" data-gt-translate-attributes='["title"]' 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
• „Сметководство за претпријатие на CORP“, издание 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: Сметководство), постои поедноставена опција за работа преку веб-услуга (без потврда), за која не се потребни поставки на страната на апликацијата 1C.

Прилагодени решенија за интеграција

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

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

Стандард „Клиент банка“, развиен од специјалисти на 1C пред повеќе од 10 години, всушност стана индустриски стандард во Русија. Следниот чекор во оваа насока е технологијата DirectBank, кој ви овозможува да испраќате документи за плаќање до банката и да добивате изјави од банката директно од програмите на системот 1C: Enterprise со притискање на едно копче во програмата 1C; не бара инсталирање и извршување на дополнителни програми на клиентскиот компјутер.

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

Останати

Вреди да се спомене протокол за размена помеѓу системот 1C: Enterprise и веб-страницата, стандард за размена на комерцијални информации CommerceML (развиен заедно со Microsoft, Intel, Price.ru и други компании), стандард за размена на податоци за стекнување трансакции.

Извор: www.habr.com