Integreerimisviisid 1C-ga

Millised on peamised nõuded äri rakendustele? Kõige olulisemateks on järgmised ülesanded:

• Rakenduse tööloogika kergesti muutmine/kohandamine muutuvaid äriülesandeid silmas pidades.
• Lihtsus teiste rakendustega integreerimisel.

Esimese ülesande lahendamine 1C-s on lühidalt kirjeldatud jaotises „Kohandamine ja toetamine“; me naaseme selle huvitava teema juurde ühes tulevases artiklis. Täna keskendume teisele ülesandele, integreerimisele. selle artikliIntegreerimisülesanded

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

Integreerimisülesanded võivad olla erinevad. Mõned neist, näiteks töötajate nimekirja edastamine panga jaoks palkade plastikkaartide vormistamiseks, nõuavad vaid lihtsat interaktiivset andmevahetust. Suuremate probleemide korral võib osutuda vajalikuks täielikult automatiseeritud andmevahetus, mis võib hõlmata ka välist süsteemi äriloogikaga pöördumist. On ka spetsiifilisemaid ülesandeid, nagu integreerimine välistesse seadmetesse (nt kaubandusseadmed, mobiilsed skannerid jne) või pärand- või kitsalt spetsialiseeritud süsteemidesse (nt RFID-siltide tuvastamissüsteemid). Iga ülesande puhul on äärmiselt oluline valida kõige sobivam integreerimismehhanism.

Integreerimisvõimalused 1C-ga

On olemas erinevaid lähenemisviise 1C rakenduste integreerimise rakendamiseks; millest valida, sõltub ülesande nõuetest.

1. Rakendamine põhineb integreerimismehhanismidel, pakutava platvormi, oma spetsialiseeritud API rakenduse küljel 1C (näiteks Web- või HTTP-teenuste komplekti, mis kutsub kolmandate osapoolte rakendusi 1C rakendusega andmete vahetamiseks). Selle lähenemise eeliseks on API vastupidavus 1C rakenduse rakenduse elluviimise muudatustele. Lähenemise eripära on vajalik muuta 1C tüüplahenduse lähtekoodi, mis võib potentsiaalselt nõuda pingutusi lähtekoodide ühendamisel, kui liikuda uuele konfiguratsiooniversioonile. Sel juhul võib appi tulla uus progressiivne funktsionaalsus — konfiguratsiooni laiendused. Laiendused on põhimõtteliselt pistikprogrammi mehhanism, mis võimaldab luua rakenduste lahenduste täiustusi, muutmata ise rakenduste lahendusi. Integratsiooni API viimine konfiguratsiooni laiendusse aitab vältida keerukusi konfiguratsioonide ühinemisel, kui liikuda uuele tüüplahenduse versioonile.
2. Platvormi integreerimismehanismide kasutamine, mis tagavad juurdepääsu rakenduse objekti mudelile väljastpoolt ning ei nõua rakenduse muutmist või laienduste loomist. Selle lähenemise pluss on, et 1C rakendust ei pea muutma. Miinus on see, et kui 1C rakendust on muudetud, võivad integraalrakenduses olla vajalikud täiendavad kohandused. Sellise lähenemise näiteks on OData protokolli kasutamine, mis on rakendatud 1C:Ettevõtte platvormi poolel (täiendav teave selle kohta on allpool).
3. Valmis rakendusprotokollide kasutamine, mis on rakendatud 1C tüüpilistes lahendustes. Paljud 1C ja partnerite tüüpilised lahendused rakendavad platvormi toetatavate integreerimismehanismide põhjal oma rakendusprotokolle, mis on suunatud konkreetsetele ülesannetele. Nende mehhanismide kasutamisel ei ole vaja kirjutada 1C rakenduses koodi, kuna kasutame rakenduse tavapäraseid võimalusi. 1C rakenduse poolel on meil vaja teha vaid teatud seadistusi.

Integreerimismehanismid 1C:Ettevõtte platvormis

Failide importimine/eksportimine

Kujutame ette ülesande, milleks on kahe suunalise andmevahetuse tagamine 1C rakenduse ja mõne muu rakenduse vahel. Näiteks peame sünkroniseerima kaupade nimekirja (Nomenklatuuri register) 1C rakenduse ja mingi muu rakenduse vahel.

Selle ülesande lahendamiseks on võimalik kirjutada laiendus, mis eksportib Nomenklatuuri registri teatud formaadis faili (teksti, XML, JSON jne) ja oskab seda formaati lugeda.

Platvormil on rakendatud mehhanism rakendusobjektide serialiseerimiseks XML-i nii otse, kasutades globaalse konteksti meetodeid ЗаписатьXML/ЧтениеXML, kui ka abitoote XDTO (XML Data Transfer Objects) abil.

Iga objekt 1C:Ettevõtte süsteemis saab serialiseerida XML-esitlusse ja vastupidi.

See funktsioon tagastab objekti esitlemise XML-is:

Funktsioon Objekti_XML(Objekt)
    ЗаписьXML = Uus ЗаписьXML();
    ЗаписьXML.УстановитьСтроку();
    ЗаписатьXML(ЗаписьXML, Objekt);
    Tagasta ЗаписьXML.Закрыть();
LõppFunktsioon

Niimoodi näeb välja Nomenklatuuri registri eksport XML-i abil XDTO kaudu:

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

Lihtsa ümbertegemise kaudu ekspordime registri JSON-iks. Kaubad salvestatakse massiivi; mitmekesisuse huvides toome ingliskeelse süntaksi versiooni:

&AtServer
Procedure ExportJSONOnServer()
	NewXDTOSerializer  = XDTOSerializer;
	NewJSONWriter = New JSONWriter();
	NewJSONWriter.OpenFile("C:DataNomenklatuur.json", "UTF-8");
	
	NewJSONWriter.WriteStartObject();
	NewJSONWriter.WritePropertyName("KataloogNomenklatuur");
	NewJSONWriter.WriteStartArray();
	
	Selection = Catalogs.Nomenkatuur.Select();	
	
	While Selection.Next() Do 
		NomenclatureObject = Selection.GetObject();
		
		NewJSONWriter.WriteStartObject();
		
		NewJSONWriter.WritePropertyName("Nomenkatuur");
		NewXDTOSerializer.WriteJSON(NewJSONWriter, NomenclatureObject, XMLTypeAssignment.Implicit);
		
		NewJSONWriter.WriteEndObject();
	EndDo;
	
	NewJSONWriter.WriteEndArray();
	NewJSONWriter.WriteEndObject();
	NewJSONWriter.Close();	
EndProcedure

Järgmiseks tuleb andmed edastada lõppkasutajale. 1C:Enterprise platvorm toetab peamisi internetiprotokolle nagu HTTP, FTP, POP3, SMTP, IMAP, sealhulgas nende turvalisi versioone. Samuti saab andmete edastamiseks kasutada HTTP ja/või veebiteenuseid.

HTTP- ja veebiteenused

1C rakendused saavad rakendada oma HTTP- ja veebiteenuseid ning kutsuda esile teiste rakenduste loodud HTTP- ja veebiteenuseid.

REST liides ja OData protokoll

Alates versioonist 8.3.5 suudab 1C:Enterprise platvorm automaatselt luua REST liidest kogu rakenduse lahenduse jaoks. Iga seadistuse objekt (register, dokument, andmete register jne) saab muuta kättesaadavaks andmete saamiseks ja muutmiseks REST liidese kaudu. Access protokollina kasutab platvorm protokolli OData versioon 3.0. OData teenuste avaldamine toimub Konfiguratori menüüst „Halduse -> Avaldamine veebiserverisse”, ruut „Avalda OData standardliides” peab olema märgitud. Toetatakse formaate atom/XML ja JSON. Pärast rakenduse avaldamist veebiserveris saavad kolmandate osapoolte süsteemid sellele ligi pääseda REST liidese kaudu HTTP-päringute abil. OData protokolliga 1C rakenduse kasutamiseks ei ole 1C poolset programmeerimist vajalik.

Seega URL vormis http:////odata/standard.odata/Catalog_Номенклатура tagastab meile Nomenklatuuri katalooge sisu XML formaadis — elementide entry kogumi (sõnumi pealkiri on lühiduse tõttu välja jäetud):

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