Integrationsmethoden mit 1C

Welche wesentlichen Anforderungen gelten für Geschäftsapplikationen? Zu den wichtigsten zählen folgende Aufgaben:

• Die Anpassungsfähigkeit der Logik der Anwendung an sich ändernde Geschäftsanforderungen.
• Die einfache Integration mit anderen Anwendungen.

Wie die erste Aufgabe in 1C gelöst wird, wurde kurz im Abschnitt "Anpassung und Support" beschrieben; wir werden in einem der nächsten Artikel auf dieses interessante Thema zurückkommen. Heute geht es jedoch um die zweite Aufgabe, die Integration. dieses Artikels; wir werden dieses interessante Thema in einem der zukünftigen Artikel erneut aufgreifen. Heute sprechen wir jedoch über die zweite Aufgabe, die Integration.

Integrationsaufgaben

Integrationsaufgaben können unterschiedlich sein. Für einige reicht ein einfacher interaktiver Datenaustausch aus – beispielsweise um einer Bank eine Liste von Mitarbeitern zur Ausstellung von Gehaltskarten zu übermitteln. Für komplexere Anforderungen kann ein vollautomatisierter Datenaustausch notwendig sein, möglicherweise unter Einbeziehung der Geschäftslogik eines externen Systems. Es gibt auch spezialisierte Aufgaben, wie etwa die Integration mit externen Geräten (zum Beispiel Verkaufsstationen, mobilen Scannern usw.) oder mit ererbten oder spezialisierten Systemen (zum Beispiel mit RFID-Tag-Erkennungssystemen). Es ist von entscheidender Bedeutung, für jede Aufgabe den passendsten Integrationsmechanismus auszuwählen.

Integrationsmöglichkeiten mit 1C

Es gibt verschiedene Ansätze zur Implementierung der Integration mit 1C-Anwendungen, welcher davon gewählt wird, hängt von den Anforderungen der Aufgabe ab.

1. Implementierung basierend auf Integrationsmechanismen, bereitgestellt von der Plattform, einer eigenen spezialisierten API auf der Seite der 1C-Anwendung (zum Beispiel einem Satz von Web- oder HTTP-Diensten, die externe Anwendungen anrufen, um Daten mit der 1C-Anwendung auszutauschen). Der Vorteil dieses Ansatzes liegt in der Robustheit der API gegenüber Änderungen in der Implementierung auf der Seite der 1C-Anwendung. Eine Besonderheit des Ansatzes ist, dass der Quellcode der typischen 1C-Lösung geändert werden muss, was potenziell Aufwand beim Zusammenführen von Quellcodes bei der Migration auf eine neue Konfigurationsversion erfordern könnte. In diesem Fall kann die neue, fortschrittliche Funktionalität hilfreich sein — Konfigurationserweiterungen. Erweiterungen sind im Wesentlichen ein Plugin-Mechanismus, der es ermöglicht, Ergänzungen zu Anwendungsanwendungen zu erstellen, ohne die Anwendungen selbst zu ändern. Die Auslagerung der Integrations-API in eine Konfigurationserweiterung wird helfen, Schwierigkeiten beim Zusammenführen von Konfigurationen zu vermeiden, wenn auf eine neue Version der typischen Lösung migriert wird.
2. Der Einsatz von Integrationsmechanismen der Plattform, die externen Zugriff auf das Objektmodell der Anwendung ermöglichen, ohne dass Anpassungen der Anwendung oder die Erstellung von Erweiterungen erforderlich sind. Der Vorteil dieses Ansatzes liegt darin, dass die 1C-Anwendung nicht verändert werden muss. Der Nachteil ist, dass, wenn die 1C-Anwendung bereits angepasst wurde, möglicherweise Anpassungen in der zu integrierenden Anwendung notwendig sind. Ein Beispiel für diesen Ansatz ist die Verwendung des OData-Protokolls zur Integration, das auf der 1C:Enterprise-Plattform implementiert ist (näheres dazu weiter unten).
3. Die Nutzung vorgefertigter Anwendungsschnittstellen, die in den Standardlösungen von 1C implementiert sind. Viele Standardlösungen von 1C und Partnern basieren auf den von der Plattform bereitgestellten Integrationsmechanismen und realisieren eigene Anwendungsschnittstellen, die auf spezifische Aufgaben ausgerichtet sind. Bei der Verwendung dieser Mechanismen ist keine Programmierung auf der Seite der 1C-Anwendung erforderlich, da wir die integrierten Funktionen der Anwendungslösung nutzen. Auf der Seite der 1C-Anwendung müssen lediglich bestimmte Einstellungen vorgenommen werden.

Integrationsmechanismen in der 1C:Enterprise-Plattform

Import/Export von Dateien

Stellen wir uns vor, wir müssen einen bidirektionalen Datenaustausch zwischen der 1C-Anwendung und einer beliebigen Anwendung realisieren. Zum Beispiel müssen wir die Produktliste (Stammdaten Nomenklatur) zwischen der 1C-Anwendung und einer beliebigen Anwendung synchronisieren.

Um eine solche Aufgabe zu lösen, kann man eine Erweiterung schreiben, die das Stammdatenverzeichnis Nomenklatur in eine Datei eines bestimmten Formats (Text, XML, JSON, …) exportiert und dieses Format lesen kann.

In der Plattform ist ein Mechanismus zur Serialisierung von Anwendungsobjekten in XML implementiert, sowohl direkt über die Methoden des globalen Kontexts ЗаписатьXML/ЧтениеXML als auch mithilfe des Hilfsobjekts XDTO (XML Data Transfer Objects).

Jedes Objekt im System 1C:Unternehmen kann in eine XML-Darstellung serialisiert werden und umgekehrt.

Diese Funktion gibt die Darstellung des Objekts im XML-Format zurück:

Funktion Objekt_Im_XML(Objekt)
    ЗаписьXML = Neuer ЗаписьXML();
    ЗаписьXML.УстановитьСтроку();
    ЗаписатьXML(ЗаписьXML, Objekt);
    Rückgabe ЗаписьXML.Закрыть();
EndeFunktion

So wird der Export des Stammdatenverzeichnisses Nomenklatur in XML mithilfe von XDTO aussehen:

&AufDemServer
Prozedur ExportXMLAufServer()	
	NeuerSerialisiererXDTO  = SerialisiererXDTO;
	NeueAufzeichnungXML = Neuer AufzeichnungXML();
	NeueAufzeichnungXML.ÖffneDatei("C:DataNomenklatur.xml", "UTF-8");
	
	NeueAufzeichnungXML.SchreibeErklärungXML();
	NeueAufzeichnungXML.SchreibeElementbeginn("VerzeichnisNomenklatur");
	
	Auswahl = Verzeichnisse.Nomenklatur.Auswählen();
	
	Während Auswahl.Nächster() Schleife 
		ObjektNomenklatur = Auswahl.HoleObjekt();
		NeuerSerialisiererXDTO.SchreibeXML(NeueAufzeichnungXML, ObjektNomenklatur, ZielTypXML.Eindeutig);
	EndeSchleife;
	
	NeueAufzeichnungXML.SchreibeElementende();
	NeueAufzeichnungXML.Schließe();	
EndeProzedur

Durch eine einfache Anpassung des Codes exportieren wir das Verzeichnis im JSON-Format. Die Produkte werden in einem Array gespeichert; zur Abwechslung geben wir die englische Syntaxvariante an:

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

Anschließend müssen die Daten nur noch an den Endverbraucher übergeben werden. Die Plattform 1C:Enterprise unterstützt die gängigen Internetprotokolle HTTP, FTP, POP3, SMTP, IMAP, einschließlich ihrer sicheren Versionen. Zudem können zur Übertragung von Daten HTTP und/oder Webdienste verwendet werden.

HTTP- und Webdienste

1C-Anwendungen können ihre eigenen HTTP- und Webdienste implementieren und auch HTTP- sowie Webdienste aufrufen, die von Drittanwendungen bereitgestellt werden.

REST-Interfaces und das OData-Protokoll

Seit Version 8.3.5 kann die Plattform 1C:Enterprise automatisch ein REST-Interface erstellen für die gesamte Anwendungslösung. Jedes Konfigurationselement (Verzeichnis, Dokument, Informationsregister usw.) kann über die REST-Schnittstelle für den Zugriff auf und die Modifikation von Daten verfügbar gemacht werden. Die Plattform verwendet das Protokoll OData Version 3.0. Die Veröffentlichung von OData-Diensten erfolgt über das Menü Konfigurator "Verwaltung -> Veröffentlichung auf dem Webserver"; das Kontrollkästchen "Standard OData-Schnittstelle veröffentlichen" muss aktiviert sein. Die Formate Atom/XML und JSON werden unterstützt. Nachdem die Anwendungslösung auf dem Webserver veröffentlicht wurde, können externe Systeme über die REST-Schnittstelle mittels HTTP-Anfragen darauf zugreifen. Für die Arbeit mit der 1C-Anwendung über das OData-Protokoll ist keine Programmierung auf der 1C-Seite erforderlich.

So wird eine URL im Format http:////odata/standard.odata/Catalog_Номенклатура uns den Inhalt des Katalogs Nomenklatur im XML-Format zurückgeben — eine Sammlung von Einträgen (die Nachrichtensyntax wurde der Einfachheit halber weggelassen):

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