Методе интеграције са 1Ц

Који су најважнији захтеви за пословне апликације? Неки од најважнијих задатака су следећи:

• Лакоћа промене/прилагођавања логике апликације променама пословних задатака.
• Једноставна интеграција са другим апликацијама.

Како се први задатак решава у 1Ц укратко је описано у одељку „Прилагођавање и подршка“. овај чланак; Вратићемо се на ову занимљиву тему у наредном чланку. Данас ћемо говорити о другом задатку, интеграцији.

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

Задаци интеграције могу бити различити. За решавање неких проблема довољна је једноставна интерактивна размена података - на пример, преношење списка запослених у банку за издавање платних пластичних картица. За сложеније задатке може бити неопходна потпуно аутоматизована размена података, вероватно у вези са пословном логиком екстерног система. Постоје задаци који су по природи специјализовани, као што је интеграција са спољном опремом (на пример, малопродајна опрема, мобилни скенери, итд.) или са старим или високо специјализованим системима (на пример, са системима за препознавање РФИД ознака). Изузетно је важно одабрати најприкладнији механизам интеграције за сваки задатак.

Опције интеграције са 1Ц

Постоје различити приступи имплементацији интеграције са 1Ц апликацијама; који ће изабрати зависи од захтева задатка.

1. На основу имплементације интеграционих механизамакоји обезбеђује платформа, сопствени специјализовани АПИ на страни 1Ц апликације (на пример, скуп веб или ХТТП услуга који ће позвати апликације трећих страна за размену података са 1Ц апликацијом). Предност овог приступа је отпор АПИ-ја на промене у имплементацији на страни апликације 1Ц. Посебност приступа је у томе што је неопходно променити изворни код стандардног 1Ц решења, што потенцијално може захтевати напор приликом спајања изворних кодова приликом преласка на нову верзију конфигурације. У овом случају, нова прогресивна функционалност може доћи у помоћ - проширења конфигурације. Екстензије су, у суштини, механизам додатака који вам омогућава да креирате додатке апликативним решењима без промене самих апликативних решења. Премештање АПИ-ја за интеграцију у проширење конфигурације ће вам омогућити да избегнете потешкоће приликом спајања конфигурација када пређете на нову верзију стандардног решења.
2. Коришћење механизама интеграције платформе који обезбеђују екстерни приступ објектном моделу апликације и не захтевају модификацију апликације или креирање екстензије. Предност овог приступа је у томе што нема потребе да мењате 1Ц апликацију. Минус - ако је апликација 1Ц побољшана, можда ће бити потребна побољшања у интегрисаној апликацији. Пример оваквог приступа је коришћење ОДата протокола за интеграцију, имплементираног на страни платформе 1Ц:Ентерприсе (више о томе у наставку).
3. Коришћење готових апликативних протокола имплементираних у стандардна 1Ц решења. Многа стандардна решења компаније 1Ц и партнера имплементирају сопствене апликационе протоколе, фокусиране на специфичне задатке, на основу механизама интеграције које пружа платформа. Када користите ове механизме, нема потребе за писањем кода на страни апликације 1Ц, јер Користимо стандардне могућности апликативног решења. На страни апликације 1Ц, потребно је само да извршимо одређена подешавања.

Механизми интеграције у платформу 1Ц: Ентерприсе

Увоз/извоз датотека

Претпоставимо да смо суочени са задатком двосмерне размене података између 1Ц апликације и произвољне апликације. На пример, потребно је да синхронизујемо листу производа (каталог номенклатуре) између апликације 1Ц и произвољне апликације.

Да бисте решили овај проблем, можете написати екстензију која преузима именик Номенклатуре у датотеку одређеног формата (текст, КСМЛ, ЈСОН, ...) и може да чита овај формат.

Платформа имплементира механизам за серијализацију објеката апликације у КСМЛ-у, како директно, преко ВритеКСМЛ/РеадКСМЛ метода глобалног контекста, тако и користећи помоћни објекат КСДТО (КСМЛ Дата Трансфер Објецтс).

Сваки објекат у систему 1Ц:Ентерприсе може бити серијализован у КСМЛ репрезентацију и обрнуто.

Ова функција ће вратити КСМЛ приказ објекта:

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

Овако ће изгледати извоз именика Номенклатуре у КСМЛ користећи КСДТО:

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

Једноставним изменом кода извозимо директоријум у ЈСОН. Производи ће бити уписани у низ; За разноликост, ево енглеске верзије синтаксе:

&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

Затим остаје само да се подаци пренесу до крајњег потрошача. Платформа 1Ц:Ентерприсе подржава главне Интернет протоколе ХТТП, ФТП, ПОП3, СМТП, ИМАП, укључујући њихове безбедне верзије. Такође можете да користите ХТТП и/или Веб услуге за пренос података.

ХТТП и веб услуге

1Ц апликације могу да имплементирају сопствене ХТТП и веб услуге, као и да позивају ХТТП и веб услуге које имплементирају апликације трећих страна.

РЕСТ интерфејс и ОДата протокол

Почевши од верзије 8.3.5, платформа 1Ц:Ентерприсе може аутоматски креирајте РЕСТ интерфејс за целокупно апликативно решење. Било који објекат конфигурације (директориј, документ, регистар информација, итд.) може бити доступан за пријем и модификовање података преко РЕСТ интерфејса. Платформа користи протокол као приступни протокол ОДата верзија 3.0. Објављивање ОДата услуга се врши из менија Конфигуратора „Администрација -> Објављивање на веб серверу“, мора бити означено поље за потврду „Објави стандардни ОДата интерфејс“. Атом/КСМЛ и ЈСОН формати су подржани. Након што се апликативно решење објави на веб серверу, системи трећих страна могу му приступити преко РЕСТ интерфејса користећи ХТТП захтеве. За рад са 1Ц апликацијом преко ОДата протокола, програмирање на страни 1Ц није потребно.

Дакле, УРЛ као http://<сервер>/<конфигурация>/odata/standard.odata/Catalog_Номенклатура ће нам вратити садржај каталога номенклатуре у КСМЛ формату – колекцију елемената уноса (наслов поруке је изостављен ради краткоће):

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

Додавањем стринга „?$формат=апплицатион/јсон“ у УРЛ, добијамо садржај каталога номенклатуре у ЈСОН формату (УРЛ обрасца 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Ц апликације који вам омогућава интеракцију са било којом базом података компатибилном са ОДБЦ, како за читање тако и за писање. Спољни извори података доступни су и на Виндовс-у и на Линук-у.

Механизам размене података

Механизам размене података је намењен како за креирање географски дистрибуираних система заснованих на 1Ц:Ентерприсе, тако и за организовање размене података са другим информационим системима који нису засновани на 1Ц:Ентерприсе.

Овај механизам се активно користи у имплементацији 1Ц, а спектар задатака који се решавају уз његову помоћ је веома широк. Ово укључује размену података између 1Ц апликација инсталираних у филијалама организације, и размену између 1Ц апликације и веб локације онлајн продавнице, и размену података између 1Ц серверске апликације и мобилног клијента (направљеног помоћу мобилне платформе 1Ц: Ентерприсе), и много тога више.

Један од кључних концепата у механизму размене података је план размене. План размене је посебна врста објекта платформе апликације 1Ц, која одређује, посебно, састав података који ће учествовати у размени (који директоријуми, документи, регистри итд.). План размене такође садржи информације о учесницима размене (тзв. чворови размене).
Друга компонента механизма размене података је механизам регистрације промена. Овај механизам аутоматски прати систем за промене у подацима који се морају пренети крајњим корисницима као део плана размене. Користећи овај механизам, платформа прати промене које су се десиле од последње синхронизације и омогућава вам да минимизирате количину података пренетих током следеће сесије синхронизације.

Размена података се одвија коришћењем КСМЛ порука одређене структуре. Порука садржи податке који су се променили од последње синхронизације са чвором и неке сервисне информације. Структура поруке подржава нумерисање порука и омогућава вам да примите потврду од чвора примаоца да су поруке примљене. Таква потврда је садржана у свакој поруци која долази од пријемног чвора, у облику броја последње примљене поруке. Нумерисање порука омогућава платформи да разуме који су подаци већ успешно пренети до пријемног чвора и да избегне поновни пренос тако што ће пренети само податке који су се променили од када је чвор који шаље последњу поруку са потврдом за податке примљене од пријемног чвора. Ова оперативна шема обезбеђује гарантовану испоруку чак и са непоузданим каналима преноса и губитком поруке.

Екстерне компоненте

У великом броју случајева, када се решавају проблеми интеграције, морају се суочити са специфичним захтевима, на пример, протоколима интеракције, форматима података, који нису предвиђени у платформи 1Ц:Ентерприсе. За такав низ задатака, платформа обезбеђује технологија екстерних компоненти, који вам омогућава да креирате динамички модуле који се додају који проширују функционалност 1Ц: Ентерприсе.

Типичан пример задатка са сличним захтевима би била интеграција 1Ц апликативног решења са малопродајном опремом, од вага до каса и скенера бар кодова. Екстерне компоненте се могу повезати и на страни сервера 1Ц:Ентерприсе и на страни клијента (укључујући, али не ограничавајући се на, веб клијента, као и следећа верзија мобилне платформе 1Ц: Предузеће). Технологија спољних компоненти обезбеђује прилично једноставан и разумљив софтверски (Ц++) интерфејс за интеракцију компоненти са платформом 1Ц: Ентерприсе, који мора да имплементира програмер.

Могућности које се отварају при коришћењу спољних компоненти су веома широке. Можете имплементирати интеракцију користећи одређени протокол за размену података са спољним уређајима и системима, уградити специфичне алгоритме за обраду података и формата података итд.

Застарели механизми интеграције

Платформа обезбеђује механизме интеграције који се не препоручују за употребу у новим решењима; остављени су из разлога компатибилности унатраг, а такође и у случају да друга страна не може да ради са модернијим протоколима. Један од њих је рад са датотекама у ДБФ формату (подржан на уграђеном језику помоћу КСБасе објекта).

Још један застарели механизам интеграције је употреба ЦОМ технологије (доступна само на Виндовс платформи). Платформа 1Ц:Ентерприсе пружа две методе интеграције за Виндовс користећи ЦОМ технологију: сервер за аутоматизацију и екстерну везу. Они су веома слични, али једна од основних разлика је у томе што се у случају сервера за аутоматизацију покреће пуноправна 1Ц:Ентерприсе 8 клијентска апликација, а у случају екстерне везе, релативно мали ЦОМ у процесу. сервер је покренут. То јест, ако радите преко Аутоматион сервера, можете користити функционалност клијентске апликације и обављати радње сличне интерактивним радњама корисника. Када користите екстерну везу, можете користити само функције пословне логике, а оне се могу извршавати и на клијентској страни везе, где се креира ЦОМ сервер у процесу, и можете позвати пословну логику на серверу 1Ц:Ентерприсе страна.

ЦОМ технологија се такође може користити за приступ спољним системима из кода апликације на платформи 1Ц:Ентерприсе. У овом случају, апликација 1Ц делује као ЦОМ клијент. Али треба подсетити да ће ови механизми радити само ако 1Ц сервер ради у Виндовс окружењу.

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

Формат података предузећа

У низу 1Ц конфигурација (листа испод), на основу механизма размене података платформе описаног изнад, имплементиран је готов механизам за размену података са спољним апликацијама, који не захтева промену изворног кода конфигурација (припрема података размена се врши у подешавањима апликативних решења):

• „1Ц:ЕРП Ентерприсе Манагемент 2.0“
• "Сложена аутоматизација 2"
• „Рачуноводство предузећа“, издање 3.0
• „Рачуноводство предузећа ЦОРП“, издање 3.0
• „Малопродаја“, издање 2.0
• „Основно управљање трговином“, 11. издање
• Управљање трговином, издање 11
• „Плате и управљање кадровима ЦОРП“, издање 3

Формат који се користи за размену података је ЕнтерприсеДата, заснован на КСМЛ-у. Формат је пословно оријентисан - структуре података описане у њему одговарају пословним субјектима (документима и елементима именика) представљеним у 1Ц програмима, на пример: акт завршетка, налог за пријем готовине, друга страна, ставка итд.

Може доћи до размене података између апликације 1Ц и апликације треће стране:

• преко наменског директоријума датотека
• преко ФТП директоријума
• преко веб сервиса који је распоређен на страни апликације 1Ц. Датотека података се прослеђује као параметар веб методама
• путем е-маила

У случају размене путем веб услуге, апликација треће стране ће покренути сесију размене података позивањем одговарајућих веб метода апликације 1Ц. У другим случајевима, иницијатор сесије размене биће апликација 1Ц (постављањем датотеке са подацима у одговарајући директоријум или слањем датотеке са подацима на конфигурисану адресу е-поште).
Такође на страни 1Ц можете да конфигуришете колико често ће се синхронизација дешавати (за опције са разменом датотека преко директоријума и е-поште):

• према распореду (са одређеном фреквенцијом)
• ручно; корисник ће морати ручно да покрене синхронизацију сваки пут када му затреба

Потврђивање порука

1Ц апликације чувају евиденцију послатих и примљених порука за синхронизацију и очекују исто од апликација трећих страна. Ово вам омогућава да користите механизам нумерисања порука описан горе у одељку „Механизам размене података“.

Током синхронизације, 1Ц апликације преносе само информације о променама које су се десиле код пословних субјеката од последње синхронизације (да би се смањила количина пренетих информација). Током прве синхронизације, 1Ц апликација ће све пословне субјекте (на пример, ставке референтне књиге артикала) у ЕнтерприсеДата формату учитати у КСМЛ датотеку (пошто су сви „нови“ за спољну апликацију). Апликација треће стране мора да обради информације из КСМЛ датотеке примљене од 1Ц и, током следеће сесије синхронизације, у датотеку послату 1Ц, у посебан КСМЛ одељак, стави информацију да је порука од 1Ц са одређеним бројем успешно послата примљен. Порука о пријему је сигнал апликацији 1Ц да су сви пословни субјекти успешно обрађени од стране екстерне апликације и да више нема потребе за преносом информација о њима. Поред признанице, КСМЛ датотека из апликације треће стране може да садржи и податке за синхронизацију од стране апликације (на пример, документе за продају робе и услуга).

Након пријема поруке о пријему, апликација 1Ц означава све промене пренете у претходној поруци као успешно синхронизоване. Само несинхронизоване промене пословних субјеката (креирање нових ентитета, промена и брисање постојећих) биће послате спољној апликацији током следеће сесије синхронизације.

Приликом преноса података из спољне апликације у апликацију 1Ц, слика је обрнута. Екстерна апликација мора у складу са тим попунити одељак о пријему КСМЛ датотеке и поставити пословне податке за синхронизацију са своје стране у формат ЕнтерприсеДата.

Поједностављена размена података без руковања

За случајеве једноставне интеграције, када је довољно само пренети информације из апликације треће стране у апликацију 1Ц и обрнути пренос података из апликације 1Ц у апликацију треће стране није потребан (на пример, интеграција онлајн продавница која преноси информације о продаји у 1Ц: Рачуноводство), постоји поједностављена опција рада преко веб услуге (без потврде), која не захтева подешавања на страни апликације 1Ц.

Прилагођена интеграцијска решења

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

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

Стандард "Клијент банка", који су развили стручњаци 1Ц пре више од 10 година, заправо је постао индустријски стандард у Русији. Следећи корак у овом правцу је технологија ДирецтБанк, који вам омогућава да шаљете платна документа у банку и примате изводе из банке директно из програма система 1Ц: Ентерприсе притиском на једно дугме у програму 1Ц; не захтева инсталирање и покретање додатних програма на клијентском рачунару.

Такође постоје стандард за размену података у платним пројектима.

Други

Вредно помена протокол размене између система 1Ц:Ентерприсе и веб странице, стандард размене комерцијалних информација ЦоммерцеМЛ (развијено заједно са Мицрософт, Интел, Прице.ру и другим компанијама), стандард за размену података за прибављање трансакција.

Извор: ввв.хабр.цом