1 Themenübersicht
Durch den Business Integration Service (BIS) können Sie Daten aus den Datenbanken exportieren und in Datenbanken importieren. Exportierte Daten werden als Dateien in den Knowledge Store geschrieben und beim Import von dort gelesen. Als Dateitypen stehen XML (*.xml), „Text durch Trennzeichen getrennt“ (CSV, *.csv) und „Unicode-Text durch Tabulator getrennt“ (*.xls) zur Verfügung. Die Verwendung von XML wird empfohlen, weil beliebig komplexe Daten in einer einzigen Datei gespeichert werden können, das Schema der Datei vorgegeben und überprüft werden kann und Änderungen des Datenmodells problemlos integriert werden können.
Mit der Anwendung „Vereinfachter Datenimport“ können Sie einzelne Datenimporte starten.
Mit der Anwendung „Vereinfachter Datenimport“ können Sie einzelne Datenimporte starten. Im Gegensatz zur Anwendung „Daten importieren“ können fehlerhafte Daten nicht durch eine Korrektur-Anwendung bearbeitet werden. Der Datenimport bezieht sich immer auf ein Entwicklungsobjekt des Typs „Anwendung“. Für diese Anwendung muss in der Anwendung „Entwicklungsobjekte“ der Typ „Vereinfachter Datenaustausch“ und die besondere Verwendung „Import“ festgelegt sein.
Beachten Sie bitte, dass sich die Dateien für den vereinfachten Import und die Dateien für den vollumfänglichen Import voneinander unterscheiden. Sie können die Dateien jeweils nur für den gewählten Importprozess nutzen.
2 Begriffsbestimmung
Extensible Markup Language (XML)
Mit XML können strukturierte Daten in einer Text-Datei gespeichert werden. Die Beschreibungssprache ermöglicht die Festlegung, Übertragung, Überprüfung und Interpretation von Daten zwischen Anwendungen und eignet sich besonders für den strukturierten Datenaustausch. Bei XML-Dokumenten erfolgt eine Trennung von Inhalt, Struktur und Information zur Darstellung. XML wird vom W3C als Standard koordiniert und festgelegt.
Extensible Stylesheet Language Transformations (XSLT)
XSLT ist eine Programmiersprache zur Transformation von XML-Dokumenten. XSLT baut auf der logischen Baumstruktur eines XML-Dokumentes auf und dient zur Festlegung von Umwandlungsregeln. Sie beschreibt die Umwandlung eines XML-Dokuments in ein anderes Dokument.
Text durch Trennzeichen getrennt (CSV)
CSV (comma separated values) ist ein Dateityp, in dem die Werte der einzelnen Spalten durch ein Trennzeichen getrennt werden. Zeilen werden durch Zeilenumbrüche getrennt. Dieses Trennzeichen muss bekannt sein, um die Datei importieren zu können. Übliche Trennzeichen sind beispielsweise das einfache Komma und das Semikolon. In diesem Format gespeicherte Daten können in zahlreichen Anwendungsprogrammen verwendet und bearbeitet werden. Durch die einfache, nicht hierarchische Struktur von CSV ist dieser Dateityp zur Abbildung komplexer Datenstrukturen nicht geeignet.
Unicode
Comarch ERP Enterprise verwendet durchgängig Unicode. Deshalb können faktisch sämtliche weltweit gebräuchlichen Zeichen benutzt und auf Formularen gedruckt werden. Vor der Verfügbarkeit von Unicode waren sehr viele unterschiedliche Kodierungssysteme für die Zeichendarstellung erforderlich. Keines dieser Kodierungssysteme umfasste je genug Zeichen. Allein in der Europäischen Union waren mehrere Kodierungssysteme notwendig, um die verschiedenen Sprachen der Mitgliedsländer darstellen zu können. Durch die Unicode-Verwendung kann Comarch ERP Enterprise für viele Systeme direkt eingesetzt werden. Unterschiedliche Länder und Sprachen stellen kein Problem dar. Spezielle und aufwendige Anpassungen sind nicht erforderlich, denn Text kann mit Unicode weltweit ohne Informationsverluste ausgetauscht werden, denn Unicode gibt jedem Zeichen seine eigene Nummer – plattformunabhängig, programmunabhängig, sprachunabhängig.
Unicode-Text durch Tabulator getrennt
Dieser Dateityp ist ähnlich wie CSV, jedoch ist als Trennzeichen der Tabulator und Unicode als Zeichencodierung festgelegt. Dateien in diesem Format können unter anderem von Microsoft Excel verwendet werden. Um diesen Dateityp in Excel zu speichern, müssen Sie in Excel den gleichnamigen Dateityp angeben.
World Wide Web Consortium (W3C)
Das World Wide Web Consortium wurde gegründet, um alle Möglichkeiten des Webs zu erschließen. Dazu werden einheitliche Technologien (Spezifikationen, Richtlinien, Software und Tools) entwickelt, die den Fortschritt des Webs fördern und seine Interoperabilität sicherstellen.
XML-Schema (XSD)
Ein XML-Schema (XML-Schema-Definition, XSD) ist eine formale Spezifikation der Regeln eines XML-Dokuments, das anzeigt, welche Elemente in einem Dokument in welchen Kombinationen zulässig sind.
3 Anwendungsbeschreibung
Die Anwendung „Vereinfachter Datenimport“ wird verwendet, um Daten auf einfache Weise zu importieren. Dazu muss eine Anwendung des Typs „Vereinfachter Datenaustausch“ mit der besonderen Verwendung „Import“ angegeben werden. Diese Anwendung referenziert eine Controller-Java-Klasse, in welcher die externe Objektstruktur festgelegt ist. Darüber werden das zu importierende Business Entity und die Auswahl der zu importierenden Attribute bestimmt.
Die Anwendung ist nicht in einen Identifikations- und Arbeitsbereich aufgeteilt. Sie hat nur einen Arbeitsbereich mit Eingabefeldern.
3.1 Eingabefelder
Die Felder im Einzelnen:
| Feld | Erläuterung |
| Vereinfachter Datenimport | Erfassen Sie in diesem Feld den Entwicklungsobjektnamen der Anwendung, die Sie für den Import von externen Objekten verwenden möchten. Für diese Anwendung muss der Typ „Vereinfachter Datenaustausch“ und die Verwendung „Import“ festgelegt sein. |
| Bezeichnung | In diesem Feld wird die Bezeichnung des externen Objektes angezeigt, welches in der gewählten Anwendung für den vereinfachten Datenaustausch (Import/Export) festgelegt wurde. |
| Business Entity | In diesem Feld wird der vollqualifizierte Name des Business Entitys angezeigt, welches vom externen Objekt referenziert wird. |
| Datenbank | Datenbank, in die das Business Entity importiert wird. |
3.2 Anwendungsbezogene Aktionen
Lesen Sie nachfolgend, welche anwendungsbezogenen Aktionen Ihnen in der Anwendung „Daten importieren“ zur Verfügung stehen:
- XML-Schema erzeugen
- Daten importieren
3.2.1 XML-Schema erzeugen
Mit dieser Aktion wird das Erzeugen einer XML-Schema-Datei für den aktuell geöffneten Filter gestartet. Hierbei werden die noch nicht gespeicherten Änderungen am Filter und der Attributauswahl berücksichtigt. Durch das Drücken des Buttons „XML-Schema erzeugen“ wird das Dialogfenster „XML-Schema erzeugen“ geöffnet, auf dem Sie eine Datei angeben und weitere Einstellungen vornehmen können.
Die Beschreibung des Dialogfensters finden Sie in der Dokumentation „Daten exportieren“.
3.2.2 Daten importieren
Mit dieser Aktion wird ein Importvorgang gestartet. Durch Drücken des Buttons „Daten importieren“ wird das Dialogfenster „Daten importieren“ angezeigt, in dem Sie Einstellungen für die Quell-Datei vornehmen können. Der Import kann sofort oder im Hintergrund durchgeführt werden.
Hinweis:
Achten Sie beim Dateityp „Text durch Trennzeichen getrennt“ darauf, dass die Einstellungen für die Kodierung, Trennzeichen und Texterkennungszeichen den Inhalten der Quell-Datei entsprechen.
Die Felder des Dialogfensters „Daten importieren“ im Einzelnen:
| Feld | Erläuterung |
| Quell-Datei | Die Quell-Datei ist jene Datei, aus der die Daten importiert werden sollen. Wählen Sie die Datei aus, die Sie importieren möchten. Erfassen Sie den vollständigen Pfad der Datei mit dem Schema „file:///“ oder „kstore://“. Wenn die Datei die Endung „.gz“ besitzt, dann wird sie als „GZIP“-komprimierte Datei erkannt und automatisch beim Öffnen dekomprimiert.
Vorschlagswert ist eine „GZIP“-komprimierte Datei im Standard-Arbeitsbereich der OLTP-Datenbank, an der Sie angemeldet sind. Im Pfad sind der Name des aktuellen Benutzers und der Name des Business Entitys enthalten. |
| Dateityp | · Legen Sie in diesem Feld den Dateityp der Quell-Datei fest. Wählen Sie einen der folgenden Einträge:
· XML (*.xml) · Text durch Trennzeichen getrennt (*.csv) · Unicode-Text durch Tabulator getrennt (*.xls) · JSON (*.json) |
| Kodierung | Legen Sie in diesem Feld für den Dateityp „Text durch Trennzeichen getrennt“ die Zeichenkodierung der Quell-Datei fest. Die zur Verfügung stehenden Kodierungen hängen von der Java-Version des aktuellen ERP-Application-Servers ab.
Für die anderen Dateitypen ist die Kodierung fest vorgegeben und wird angezeigt. Wenn der Import im Hintergrund ausgeführt wird, dann beachten Sie, dass der ERP-Application-Server, auf dem die Verarbeitungs-Warteschlange läuft, die angegebene Kodierung beherrscht. |
| Trennzeichen | Legen Sie in diesem Feld für den Dateityp „Text durch Trennzeichen getrennt“ das Trennzeichen in der Quell-Datei fest, welches für die Trennung der Felder verwendet wurde. Rechts neben diesem Feld ist ein weiteres vorhanden, welches das gewählte Trennzeichen anzeigt. Wählen Sie zwischen folgenden Einträgen:
· Komma · Leerzeichen · Semikolon · Tabulator · (Sonstige) Durch den Eintrag „(Sonstige)“ können Sie ein anderes Trennzeichen erfassen. Dazu wird bei Auswahl dieses Eintrages das zugehörige Feld eingabebereit. |
| Texterkennungszeichen | Ein Texterkennungszeichen, mit dem Texte in der Quell-Datei gekennzeichnet werden können, ist gemäß gewähltem Dateityp entweder vorgegeben oder kann erfasst werden. Ist der Dateityp „Text durch Trennzeichen getrennt“ ausgewählt, dann können Sie in diesem Feld das Texterkennungszeichen erfassen. Texte, die durch das Texterkennungszeichen eingerahmt sind, können das Trennzeichen selbst enthalten. |
| Protokollierungsstufe | · In diesem Feld legen Sie fest, ob der Importvorgang protokolliert werden soll. Wählen Sie zwischen folgenden Einträgen:
· Keine Protokollierung · Protokollierung aktiviert |
4 Customizing
Für die Anwendung „Vereinfachter Datenimport“ sind in der Anwendung „Customizing“ keine Einstellungen festzulegen.
5 Business Entity
Für diese Anwendung ist kein Business Entity relevant.
6 Berechtigungen
Berechtigungen können sowohl mithilfe der Berechtigungsrollen als auch durch die Zuordnung einer Organisation vergeben werden. Das Berechtigungskonzept können Sie in der Technischen Dokumentation „Berechtigungen“ nachlesen.
6.1 Spezielle Fähigkeiten
Für die Anwendung „Vereinfachter Datenimport“ bestehen keine speziellen Fähigkeiten.
6.2 Organisations-Zuordnungen
Für die Anwendung „Vereinfachter Datenimport“ ist eine Organisations-Zuordnung nicht erforderlich.
6.3 Besonderheiten
Für die Anwendung „Vereinfachter Datenimport“ sind folgende Besonderheiten zu berücksichtigten:
- Berechtigungseinstellungen ergeben sich durch die referenzierte Anwendung des Typs „Vereinfachter Datenaustausch“ mit der Verwendung „Import“.
- Für die Ausführung des Datenimports sind Lese- und Schreibberechtigungen für den Knowledge Store und das Dateisystem erforderlich.
6.4 Berechtigungen für Geschäftspartner
Die Anwendung „Vereinfachter Datenimport“ ist für Geschäftspartner nicht freigegeben.
7 Vorgehensweise: Daten importieren
Voraussetzungen
Eine Anwendung des Typs „Vereinfachter Datenaustausch“ mit der besonderen Verwendung „Import“ muss bestehen. Beachten Sie zusätzlich die notwendigen Lese- und Schreibberechtigungen für den Knowledge Store.
Anleitung
- Öffnen Sie die Anwendung „Vereinfachter Datenimport“.
- Erfassen Sie im Feld „Vereinfachter Datenimport“ den vollqualifizierten Namen der gewünschten Anwendung für den Import.
- Die weiteren Felder werden mit den Daten aus der gewählten Anwendung gefüllt und anzeigt.
- Drücken Sie in der Standard-Symbolleiste auf den Button „Daten importieren“.
- Ein Dialogfenster öffnet sich, in dem Sie die Einstellungen für die Ausführung des Imports vornehmen können. Beachten Sie dazu das Kapitel „Daten importieren“.
- Drücken Sie im Dialogfenster eine der Aktionen „Im Hintergrund“ oder „Sofort“.
- Die Daten werden vom System importiert.