Metode integracije s 1C

Koji su najvažniji zahtjevi za poslovne aplikacije? Među najvažnijima su sljedeći zadaci:

• Lakoća promjene/adaptacije logike rada aplikacije uz promjenjive poslovne zadatke.
• Lakoća integracije s drugim aplikacijama.

Način na koji se u 1C rješava prvi zadatak kratko je opisan u odjeljku „Prilagodba i podrška“ ovog članka; ponovno ćemo se vratiti na ovu zanimljivu temu u jednom od budućih članaka. Danas ćemo govoriti o drugom zadatku, integraciji.

Integracijski zadaci

Integracijski zadaci mogu biti različiti. Za neke je dovoljno jednostavno interaktivno razmjenjivanje podataka – na primjer, za slanje popisa zaposlenika banci za izdavanje plaćanjskih kartica. Za složenije zadatke može biti potreban potpuno automatiziran prijenos podataka, moguće uz pozivanje poslovne logike vanjskog sustava. Postoje zadaci specijalizirane prirode, kao što je integracija s vanjskom opremom (na primjer, trgovinskom opremom, mobilnim skenerima itd.) ili s naslijeđenim ili specijaliziranim sustavima (na primjer, sa sustavima prepoznavanja RFID oznaka). Izuzetno je važno za svaki zadatak odabrati najprikladniji mehanizam integracije.

Mogućnosti integracije s 1C

Postoje različiti pristupi za ostvarenja integracije s 1C aplikacijama, a koji od njih odabrati ovisi o zahtjevima zadatka.

1. Implementacija temeljem mehanizama integracije, koje pruža platforma, ili vlastitog specijaliziranog API-ja sa strane aplikacije 1C (na primjer, skupa Web- ili HTTP-servisa koji će pozivati vanjske aplikacije za razmjenu podataka s aplikacijom 1C). Prednost ovog pristupa je otpornost API-ja na promjene implementacije sa strane aplikacije 1C. Osobina pristupa je da je potrebno mijenjati izvorni kod tipičnog rješenja 1C, što potencijalno može zahtijevati napore prilikom spajanja izvornih kodova pri prelasku na novu verziju konfiguracije. U tom slučaju može pomoći nova progresivna funkcionalnost — proširenja konfiguracije. Ekstenzije su, u suštini, mehanizam dodataka koji omogućava stvaranje dodataka aplikacijskim rešenjima bez promene samih aplikacijskih rešenja. Izdvajanje integracijskog API-ja u ekstenziju konfiguracije omogućava izbegavanje složenosti prilikom spajanja konfiguracija prilikom prelaska na novu verziju standardnog rešenja.
2. Korišćenje mehanizama integracije platforme, koji omogućavaju spoljašnji pristup objektnoj modelu aplikacije i ne zahtevaju doradu aplikacije ili kreiranje ekstenzije. Prednost ovog pristupa je to što nije potrebno menjati aplikaciju 1C. Nedostatak je što, ako je aplikacija 1C doradjena, možda će biti potrebne dorade u integriranoj aplikaciji. Primer ovog pristupa je korišćenje OData protokola za integraciju, koji je implementiran na strani platforme 1C:Preduzeće (više o tome u nastavku).
3. Korišćenje gotovih aplikativnih protokola, implementiranih u standardnim rešenjima 1C. Mnoge standardne solucije od 1C i partnera implementiraju, na osnovu mehanizama integracije koje pruža platforma, sopstvene aplikativne protokole usmerene ka specifičnim zadacima. Kada se koriste ovi mehanizmi, nije potrebno pisanje koda sa strane aplikacije 1C, jer se koriste ugrađene mogućnosti aplikativnog rešenja. Na strani aplikacije 1C potrebno je samo izvršiti određene postavke.

Mehanizmi integracije u platformi 1C:Preduzeće

Uvoz/izvoz fajlova

Pretpostavimo da imamo zadatak dvosmerne razmene podataka između aplikacije 1C i proizvoljne aplikacije. Na primer, potrebno je uskladiti spisak proizvoda (referentni okvir Nomenklatura) između aplikacije 1C i proizvoljne aplikacije.

Za rešavanje ovog zadatka može se napisati ekstenzija koja izvozi referentni okvir Nomenklatura u fajl određenog formata (tekstualni, XML, JSON, …) i koja može da čita ovaj format.

Platforma ima implementiran mehanizam za serializaciju aplikativnih objekata u XML, kako direktno, putem metoda globalnog konteksta ZapisatiXML/ČitatiXML, tako i pomoću pomoćnog objekta XDTO (XML Data Transfer Objects).

Svaki objekat u sistemu 1C:Preduzeće može biti serializovan u XML reprezentaciju i obrnuto.

Ova funkcija će vratiti reprezentaciju objekta u obliku XML:

Funkcija Objekat_U_XML(Objekat)
    ZapisXML = Novi ZapisXML();
    ZapisXML.PostaviNiz();
    ZapišiXML(ZapisXML, Objekat);
    Vrati ZapisXML.Zatvori();
KrajFunkcije

ovako će izgledati eksport biblioteke Nomenklatura u XML pomoću XDTO:

&NaServeru
Procedura EksportXMLNaServeru()	
	NoviSeraializatorXDTO  = SeraializatorXDTO;
	NovaZapisXML = Novi ZapisXML();
	NovaZapisXML.OtvoriDatoteku("C:DataNomenklatura.xml", "UTF-8");
	
	NovaZapisXML.ZapišiObjavuXML();
	NovaZapisXML.ZapišiPočetakElementa("BibliotekaNomenklatura");
	
	Selekcija = Biblioteke.Nomenklatura.Izaberi();
	
	Dok Selekcija.Sledeći() Ciklus 
		ObjekatNomenklatura = Selekcija.PružiObjekat();
		NoviSeraializatorXDTO.ZapišiXML(NovaZapisXML, ObjekatNomenklatura, NamenaTipaXML.Jasno);
	KrajCiklusa;
	
	NovaZapisXML.ZapišiKrajElementa();
	NovaZapisXML.Zatvori();	
KrajProcedure

Jednostavnom modifikacijom koda izvezemo biblioteku u JSON. Proizvodi će biti zapisani u niz; kao raznovrsni primer, daćemo englesku varijantu sintakse:

&NaServeru
Procedura EksportJSONNaServeru()
	NoviXDTOSeraializator  = XDTOSeraializator;
	NoviJSONPisac = Novi JSONPisac();
	NoviJSONPisac.OtvoriDatoteku("C:DataNomenklatura.json", "UTF-8");
	
	NoviJSONPisac.ZapišiPočetakObjekta();
	NoviJSONPisac.ZapišiImenskiDeo("BibliotekaNomenklatura");
	NoviJSONPisac.ZapišiPočetakNiza();
	
	Selekcija = Biblioteke.Nomenklatura.Izaberi();	
	
	Dok Selekcija.Sledeći() Uradi 
		ObjekatNomenklatura = Selekcija.PružiObjekat();
		
		NoviJSONPisac.ZapišiPočetakObjekta();
		
		NoviJSONPisac.ZapišiImenskiDeo("Nomenklatura");
		NoviXDTOSeraializator.ZapišiJSON(NoviJSONPisac, ObjekatNomenklatura, XMLTipNabavke.Implicit);
		
		NoviJSONPisac.ZapišiKrajObjekta();
	KrajUradi;
	
	NoviJSONPisac.ZapišiKrajNiza();
	NoviJSONPisac.ZapišiKrajObjekta();
	NoviJSONPisac.Zatvori();	
KrajProcedure

Nakon toga ostaje samo da se podaci prenesu krajnjem korisniku. Platforma 1C:Preduzeće podržava osnovne internet protokole HTTP, FTP, POP3, SMTP, IMAP, uključujući njihove sigurnosne verzije. Takođe se za prenos podataka može koristiti HTTP i/ili Web-servisi.

HTTP i web-servisi

Aplikacije 1C mogu implementirati svoje HTTP i web-servise, kao i pozivati HTTP i web-servise implementirane od strane drugih aplikacija.

REST interfejs i protokol OData

Počevši od verzije 8.3.5, platforma 1C:Preduzeće može automatski formirati REST interfejs za cela aplikativna rešenja. Bilo koji objekat konfiguracije (biblioteka, dokument, registar informacija itd.) može biti dostupan za dobijanje i modifikaciju podataka putem REST interfejsa. Kao protokol pristupa platforma koristi protokol OData verzije 3.0. Objavljivanje OData servisa vrši se iz menija Konfiguratora „Administracija -> Objavljivanje na web-serveru“, opcija „Objaviti standardno OData sučelje“ mora biti označena. Podržani su formati atom/XML i JSON. Nakon što je aplikativno rešenje objavljeno na web-serveru, vanjski sistemi mogu mu pristupiti putem REST sučelja koristeći HTTP zahteve. Za rad s aplikacijom 1C putem OData protokola programiranje na strani 1C nije potrebno.

Tako, URL oblik http:////odata/standard.odata/Catalog_Номенклатура vratiti će nam sadržaj kataloga Nomenklatura u XML formatu — kolekcija elemenata entry (naslov poruke je izostavljen zbog sažetosti):

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