Integratiemethoden met 1C

Wat zijn de belangrijkste vereisten voor bedrijfsapplicaties? Enkele van de belangrijkste taken zijn:

• De mogelijkheid om de logica van de applicatie eenvoudig aan te passen aan veranderende zakelijke behoeften.
• Eenvoudige integratie met andere applicaties.

Hoe de eerste taak in 1C wordt aangepakt, is kort beschreven in de sectie 'Aanpassing en ondersteuning'. dit artikel; we zullen terugkomen op dit interessante onderwerp in een van de volgende artikelen. Vandaag bespreken we de tweede taak, integratie.

Integratietaken

Integratietaken kunnen variëren. Voor sommige taken is een eenvoudige interactieve gegevensuitwisseling voldoende, bijvoorbeeld voor het versturen van een lijst van medewerkers naar de bank voor de uitgifte van salariskaarten. Voor complexere taken kan een volledig geautomatiseerde gegevensuitwisseling nodig zijn, mogelijk met oproepen naar de businesslogica van een extern systeem. Er zijn ook specialistische taken, zoals integratie met externe apparatuur (bijvoorbeeld handelsapparatuur, mobiele scanners, enz.) of met verouderde of gespecialiseerd systemen (bijvoorbeeld systemen voor het herkennen van RFID-tags). Het is uiterst belangrijk om voor elke taak het meest geschikte integratiemechanisme te kiezen.

Integratiemogelijkheden met 1C

Er zijn verschillende benaderingen voor de implementatie van integratie met 1C-applicaties; welke te kiezen hangt af van de vereisten van de taak.

1. Implementatie op basis van integratiemechanismen, geleverd door het platform, of een eigen gespecialiseerd API aan de kant van de 1C-applicatie (bijvoorbeeld een reeks web- of HTTP-services die externe applicaties aanroepen voor gegevensuitwisseling met de 1C-applicatie). Een voordeel van deze benadering is de veerkracht van de API tegen veranderingen in de implementatie aan de kant van de 1C-applicatie. Een kenmerk van de benadering is dat de broncode van de standaardoplossing van 1C moet worden aangepast, wat potentieel inspanningen kan vergen bij het samenvoegen van de broncodes bij de overgang naar een nieuwe versie van de configuratie. In dit geval kan nieuwe, geavanceerde functionaliteit een uitkomst bieden — configuratie-uitbreidingen. Uitbreidingen zijn in wezen een pluginmechanisme dat het mogelijk maakt om aanvullende applicaties te creëren zonder de applicaties zelf aan te passen. Het verplaatsen van de integratie-API naar de configuratie-uitbreiding voorkomt complicaties bij het combineren van configuraties bij de overgang naar een nieuwe versie van de standaardoplossing.
2. Het gebruik van integratiemechanismen van het platform die externe toegang bieden tot het objectmodel van de applicatie en geen aanpassing van de applicatie of het maken van een uitbreiding vereisen. Het voordeel van deze aanpak is dat de 1C-applicatie niet hoeft te worden gewijzigd. Het nadeel is dat als de 1C-applicatie al is aangepast, er mogelijk verdere aanpassingen in de geïntegreerde applicatie nodig zijn. Een voorbeeld van deze aanpak is het gebruik van het OData-protocol voor integratie, geïmplementeerd aan de kant van het 1C:Enterprise-platform (meer hierover hieronder).
3. Gebruik maken van kant-en-klare applicatieprotocollen, geïmplementeerd in standaardoplossingen van 1C. Veel standaardoplossingen van 1C en partners implementeren hun eigen applicatieprotocollen op basis van de integratiemechanismen die door het platform worden geboden, gericht op specifieke taken. Bij het gebruik van deze mechanismen is er geen code vereist aan de kant van de 1C-applicatie, omdat we gebruikmaken van de standaardmogelijkheden van de applicatie. Aan de kant van de 1C-applicatie hoeven we slechts bepaalde instellingen uit te voeren.

Integratiemechanismen in het 1C:Enterprise-platform

Importeren/exporteren van bestanden

Stel dat we voor de taak staan van bidirectionele gegevensuitwisseling tussen de 1C-applicatie en een willekeurige applicatie. Bijvoorbeeld, we moeten de productlijst (referentie Catalogus) tussen de 1C-applicatie en een willekeurige applicatie synchroniseren.

Om deze taak op te lossen kan een uitbreiding worden geschreven die de referentie Catalogus in een bestand van een bepaald formaat (tekst, XML, JSON, …) exporteert en dit formaat kan inlezen.

Het platform heeft een mechanisme voor het serialiseren van applicatieobjecten in XML, zowel direct via de methoden van de globale context WriteXML/ReadXML, als met behulp van het hulpprogramma XDTO (XML Data Transfer Objects).

Elk object in het 1C:Enterprise-systeem kan worden.serialized naar een XML-weergave en omgekeerd.

Deze functie retourneert de weergave van het object in XML-vorm:

Functie Object_In_XML(Object)
    RecordXML = Nieuwe RecordXML();
    RecordXML.StelStringIn();
    SchrijfXML(RecordXML, Object);
    Retourneer RecordXML.Sluit();
EindeFunctie

Zo zal de export van de catalogus Nomenclatuur in XML eruitzien met behulp van XDTO:

&OpServer
Procedure ExporteerXMLOpServer()	
	NieuweSerializerXDTO  = SerializerXDTO;
	NieuweRecordXML = Nieuwe RecordXML();
	NieuweRecordXML.OpenBestand("C:DataNomenclatuur.xml", "UTF-8");
	
	NieuweRecordXML.SchrijfAankondigingXML();
	NieuweRecordXML.SchrijfStartElement("CatalogusNomenclatuur");
	
	Selectie = Catalogi.Nomenclatuur.Selecteren();
	
	Terwijl Selectie.Volgende() Doe 
		ObjectNomenclatuur = Selectie.KrijgObject();
		NieuweSerializerXDTO.SchrijfXML(NieuweRecordXML, ObjectNomenclatuur, ToewijzingXML.Type.Expliciet);
	EindeLoop;
	
	NieuweRecordXML.SchrijfEindeElement();
	NieuweRecordXML.Sluit();	
EindeProcedure

Met een eenvoudige aanpassing van de code exporteren we de catalogus naar JSON. De producten worden in een array geschreven; voor de variatie geven we de Engelstalige versie van de syntaxis:

&OpServer
Procedure ExporteerJSONOpServer()
	NieuweXDTOSerializer  = XDTOSerializer;
	NieuweJSONSchrijver = Nieuwe JSONSchrijver();
	NieuweJSONSchrijver.OpenBestand("C:DataNomenclatuur.json", "UTF-8");
	
	NieuweJSONSchrijver.SchrijfStartObject();
	NieuweJSONSchrijver.SchrijfEigenschapsnaam("CatalogusNomenclatuur");
	NieuweJSONSchrijver.SchrijfStartArray();
	
	Selectie = Catalogs.Nomenclatuur.Selecteren();	
	
	Terwijl Selectie.Volgende() Doe 
		NomenclatuurObject = Selectie.KrijgObject();
		
		NieuweJSONSchrijver.SchrijfStartObject();
		
		NieuweJSONSchrijver.SchrijfEigenschapsnaam("Nomenclatuur");
		NieuweXDTOSerializer.SchrijfJSON(NieuweJSONSchrijver, NomenclatuurObject, ToewijzingXML.Type.Impliciet);
		
		NieuweJSONSchrijver.SchrijfEindeObject();
	EindeDoe;
	
	NieuweJSONSchrijver.SchrijfEindeArray();
	NieuweJSONSchrijver.SchrijfEindeObject();
	NieuweJSONSchrijver.Sluit();	
EindeProcedure

Vervolgens hoeft u alleen nog de gegevens aan de eindgebruiker over te dragen. Het platform 1C:Enterprise ondersteunt de belangrijkste internetprotocollen HTTP, FTP, POP3, SMTP en IMAP, inclusief hun veilige versies. Daarnaast kunnen gegevens ook worden verzonden via HTTP en/of webservices.

HTTP- en webservices

1C-applicaties kunnen hun eigen HTTP- en webservices implementeren, evenals HTTP- en webservices aanroepen die door externe applicaties zijn geïmplementeerd.

REST-interface en het OData-protocol

Vanaf versie 8.3.5 kan het 1C:Enterprise-platform automatisch een REST-interface genereren voor de gehele applicatieoplossing. Elk configuratieobject (catalogus, document, register van gegevens, enz.) kan beschikbaar worden gesteld voor het ophalen en wijzigen van gegevens via de REST-interface. Het platform gebruikt het protocol OData versie 3.0. Publicatie van OData-diensten gebeurt vanuit het menu Configurator 'Beheer -> Publicatie op webserver', het selectievakje 'Publiceer standaard OData-interface' moet zijn aangevinkt. De formaten atom/XML en JSON worden ondersteund. Nadat de applicatieoplossing op de webserver is gepubliceerd, kunnen externe systemen deze benaderen via de REST-interface met behulp van HTTP-verzoeken. Voor het werken met de 1C-applicatie via het OData-protocol is programmeren aan de 1C-kant niet nodig.

Dus, een URL zoals http:////odata/standard.odata/Catalog_Artikel zal ons de inhoud van de catalogus Artikel in XML-formaat teruggeven — een verzameling entry-elementen (de berichtkop is ter vergadering weggelaten):

http://server/Config/odata/standard.odata/Catalog_Artikel(guid'35d1f6e4-289b-11e6-8ba4-e03f49b16074')