1 Themenübersicht
Datenimporte und -exporte mit dem BIS können protokolliert werden. Die Anwendung „Datenaustausch-Protokolleinträge“ zeigt Details eines Imports und Exports an, der mit aktivierter Protokollierung durchgeführt wurde. Es können sowohl bereits beendete, als auch zurzeit laufende Importe und Exporte angezeigt werden.
2 Zielgruppe
- Entwickler
- Technische Berater
3 Begriffsbestimmung
Business Entity
Die Beschreibung einer betriebswirtschaftlichen Größe, wie beispielsweise eines Artikels, erfolgt durch viele Business Objects. Der Umgang mit vielen Business Objects ist sehr mühsam, weshalb diese nach bestimmten Kriterien zusammengefasst wurden. Ein dominierendes, übergeordnetes Business Object aus der Menge der zu einer Gruppe gehörenden Business Objects wird als Business Entity bezeichnet. Ein Business Entity ist also eine betriebswirtschaftliche Größe, die den Umgang mit Business Objects erleichtert und sie benutzergerecht darstellt. So wird zum Beispiel ein Artikel als ein Business Entity bezeichnet; tatsächlich besteht es aus einer Menge von Business Objects, unter anderem eines für die Basisdaten, eines für die Vertriebsdaten und eines für die lieferantenspezifischen Beschaffungsdaten.
Datenaustausch-Protokolleintrag
Ein Datenaustausch-Protokolleintrag entsteht durch einen Import oder Export mit aktivierter Protokollierung. Er enthält einen Import- oder Exportvorgang (Ursprungsvorgang). Bei fehlerhaften Importen kann er zusätzlich Korrekturvorgänge enthalten.
Datenaustausch-Vorgang
Ein Datenaustausch-Vorgang ist das Importieren einer Datei, das Exportieren einer Datei, das Importieren einer Fehler-Datei zwecks Korrektur, oder das Verwenden einer Korrektur-Anwendung.
Filter
Das BIS-Datenmodell zu einem Business Entity kann sehr umfangreich sein. Ein Filter ist ein Ausschnitt des BIS-Datenmodells zu einem Business Entity. Er definiert, welche Objekte, Attribute und Beziehungen eines Business Entitys bei einem Import- bzw. beim Exportvorgang berücksichtigt werden sollen.
Fehler-Datei
Die Datei, in die beim Import von Daten im BIS diejenigen Daten aus der Quell-Datei geschrieben werden, die als fehlerhaft erkannt werden. Abhängig von der Art des Fehlers kann die Fehler-Datei manuell korrigiert und erneut importiert oder in der Korrektur-Anwendung schrittweise eingelesen und abgearbeitet werden.
Korrektur-Anwendung
Die Korrektur-Anwendung ist diejenige Dialog-Anwendung, die verwendet wird, um einfache Fehler-Dateien interaktiv im ERP-System zu bearbeiten. Zu einem Business Entity kann eine oder können mehrere Korrektur-Anwendungen existieren. Im Allgemeinen ist die Korrektur-Anwendung die jeweilig zum Business Entity gehörende Anwendung (z. B. die Anwendung „Partner“ für das Business Entity „com.cisag.app.general.obj.Partner“), die in einem speziellen Modus geöffnet wird. In diesem Modus können die Business-Entity-Instanzen aus der Fehler-Datei einzeln geöffnet, interaktiv bearbeitet und gespeichert werden.
Quell-Datei
Die Quell-Datei ist die Datei, die beim Import von Daten im BIS eingelesen wird. Eine Quell-Datei enthält immer nur die Daten zu einem Business-Entity-Typ. Bei einigen Dateitypen können die zu importierenden Daten über mehrere Quell-Dateien verteilt sein. In diesem Fall spricht man von der Haupt-Quell-Datei und den verknüpften Quell-Dateien. Während des Importvorgangs werden die Haupt-Quell-Datei und die verknüpften Quell-Dateien zu einer neue Datei zusammengefasst, mit welcher der eigentliche Import durchgeführt wird. Die Daten aus der Quell-Datei, die nicht erfolgreich importiert werden können, werden zusammen mit den zugehörigen Fehlermeldungen in die Fehler-Datei geschrieben.
Session
Eine Session ist ein Speicherbereich, der bei der Anmeldung der Benutzer und damit beim Start eines Systemdienstes reserviert wird. Die Instanzen, die innerhalb eine Session entstehen, sind von Objekten in anderen Sessions isoliert. Hierdurch wird ein Mehrbenutzerbetrieb ermöglicht. Soll ein Stück Programmlogik innerhalb einer Session ausgeführt werden, so wird ein Thread reserviert und diesem die Session für die Dauer der Ausführung als Arbeitsbereich zugeordnet.
4 Anwendungsbeschreibung
Die Anwendung „Datenaustausch-Protokolleinträge“ zeigt Details für einen Import oder Export an, der mit aktivierter Protokollierung durchgeführt wurde. Für jeden dieser Importe und Exporte wurde dabei ein Protokolleintrag erzeugt. Gegenüber der Anwendung „Datenaustausch-Protokolleinträge abfragen“ kann mit dieser Anwendung auch eine Liste der importierten bzw. exportierten Objekte angezeigt werden, sowie aufgetretene Meldungen. Die Anwendung stellt auch Möglichkeiten zur Korrektur von Importfehlern zur Verfügung. So können Importvorgänge, die fehlerhaft gelaufen sind, wiederholt werden. Alternativ ist es möglich, die zugehörige Korrekturanwendung zu öffnen.
4.1 Identifikationsbereich
Der Identifikationsbereich enthält allgemeine Informationen über den Datenaustausch-Protokolleintrag.
Die Felder im Einzelnen:
4.2 Arbeitsbereich
Der Arbeitsbereich zeigt Informationen über den letzten für den Datenaustausch-Protokolleintrag durchgeführten Vorgang an. Ist der Vorgang als „Ursprungsvorgang“ gekennzeichnet, so handelt es sich um den Export oder Import selbst, und es wurden im Falle eines Imports keine Korrekturen durchgeführt. Anderenfalls handelt es sich um die zuletzt durchgeführte Korrektur für den angezeigten Datenaustausch-Protokolleintrag.
In der Rubrik „Letzter Vorgang“ stehen folgende Buttons zur Verfügung:
| Button | Erläuterung |
| Meldungen anzeigen | Zeigt Meldungen des Vorgangs an, die keinem Objekt zugeordnet sind. Die Meldungen werden im Karteireiter „Meldungen“ des Navigationsbereichs angezeigt. |
| Datenschutz-Information | Öffnet das Fenster „Datenschutz-Informationen“. Eine Beschreibung der Felder in diesem Fenster finden Sie im Abschnitt „Button „Datenschutz-Informationen““. |
Die Felder in der Rubrik „Letzter Vorgang“:
| Feld | Erläuterung |
| Typ | Typ des Vorgangs. Mögliche Werte sind:
· Ursprungsvorgang, · Korrekturimport, · Korrektur in Korrektur-Anwendung |
| Status | Ergebnis des Vorgangs. Mögliche Werte sind:
· In Bearbeitung, · Erfolgreich beendet, · Fehlerhaft beendet, · Abgebrochen durch Anwendung, · Abgebrochen durch Benutzer, · Abgebrochen durch System |
| Endzeitpunkt | Endzeitpunkt des Vorgangs. |
| Objekte gesamt | Gesamtanzahl Objekte beim letzten Vorgang. |
| Objekte erfolgreich | Anzahl Objekte, die erfolgreich importiert bzw. exportiert wurden und nicht korrigiert werden müssen. |
| Fehlerhafte Objekte | Anzahl Objekte, die nicht erfolgreich importiert bzw. exportiert wurden. |
| Fehlerhafte, nur per Import korrigierbare Objekte | Anzahl der fehlerhaften Objekte aus dem Import- oder Korrekturvorgang, die nur per Korrekturimport, und nicht durch eine Korrektur-Anwendung korrigiert werden können. Für Exporte ist diese Angabe nicht relevant. |
Die Liste „Im letzten Vorgang behandelte Objekte“ zeigt die Objekte an, die exportiert oder importiert wurden.
Die Liste enthält eine Symbolleiste mit folgenden Buttons:
| Button | Erläuterung |
| Sortieren | Legt die Sortierung der importierten bzw. exportierten Instanzen eines Business Entity fest. |
| Nur fehlerhafte | Zeigt in der Liste nur fehlerhafte Objekte an. |
| Meldungen anzeigen | Zeigt Meldungen zum ausgewählten Objekt im Karteireiter „Meldungen“ des Navigationsbereichs an, sofern Meldungen vorhanden sind. Bei fehlerhaften Importen handelt es sich um objektbezogene Fehlermeldungen. |
Die Liste enthält folgende Spalten:
| Spalte | Erläuterung |
| Nummer | Nummer des Objekts in der Quell- bzw. Zieldatei. |
| Identifikation | Identifikation des importierten bzw. exportierten Objekts, soweit eine Identifikation zur Verfügung steht. Die Identifikation kann von der Anzeige in anderen Anwendungen abweichen. |
| Identifikation im Fremdsystem | Zurzeit nicht verwendet. |
| Status | Status des Objekts im letzten Vorgang. Mögliche Werte sind:
· In Bearbeitung · Erfolgreich · Fehler · Fehler (nur per Import korrigierbar) · Von Korrektur ausgenommen |
Button „Datenschutz-Information“
Mithilfe des Buttons „Datenschutz-Information“ können Sie anzeigen, welche geschützten Attribute mit dem Vorgang exportiert wurden. Die Informationen können zum Nachweis des Datenschutzes dienen.
Das Fenster „Datenschutz-Information“ enthält folgende Felder:
| Feld | Erläuterung |
| Empfänger der Daten | Zeigt an, für wen die exportierten Daten bestimmt sind, wenn dies beim Exportieren der Daten angegeben wurde. |
| Verwendungszweck | Zeigt an, zu welchem Zweck die Daten exportiert wurden, wenn dies beim Exportieren der Daten angegeben wurde. |
| OQL-Filter-Statement | Zeigt das OQL-Statement des Export-Filters an. |
| Rubrik „Verwendete geschützte Attribute“ | |
| Attribut-Name | Zeigt die technischen Namen der Attribute an, die exportiert wurden und die durch Zuordnung zu einer Datenschutz-Kategorie sowie durch Festlegun-gen in Berechtigungsrollen als geschützt gekennzeichnet ist. |
Welche Attribute geschützt sind, ist in der Anwendung „Berechtigungsrollen“ unter Verwendung von Datenschutz-Kategorien festgelegt. Weitere Informationen finden Sie in den Dokumentationen „Datenschutz-Kategorien“, „Datenschutz-Kategorien-Zuordnungen“ und „Berechtigungsrollen“.
4.3 Anwendungsbezogene Aktionen
Die folgenden anwendungsbezogenen Aktionen stehen in der Anwendung „Datenaustausch-Protokolleinträge“ zur Verfügung:
- Aktion „Bearbeitete Fehler-Datei importieren
- Aktion „Unbearbeitete Fehler-Datei importieren“
- Aktion „Korrektur-Anwendung öffnen“
- Aktion „Dateien herunterladen“
- Aktion „Status auf Manuell geschlossen setzen“
- Aktion „Verarbeitungsauftrag“
4.3.1 Aktion „Bearbeitete Fehler-Datei importieren“
Durch die Aktion wird ein Import einer anzugebenden Fehler-Datei gestartet. Es ist hiermit möglich, fehlerhafte Objekte zu importieren, nachdem die Fehler in der Fehler-Datei korrigiert wurden.
Durch Auswahl dieser Aktion erscheint ein Dialog, mit dem Sie die Einstellungen für den erneuten Import, der entweder sofort oder als Verarbeitungsauftrag läuft, festlegen können. Der Dialog ist in zwei Karteireiter unterteilt. Die Karteireiter „Anwendung“, „Hintergrundeinstellungen“ und „Direkthilfe“ sind im Dokument „Bedienungsleitfaden“ erklärt und werden hier nicht weiter erläutert.
Der Dialog enthält folgendes Feld:
| Feld | Erläuterung |
| Import-Fehlerdatei | Fehler-Datei, aus der die Daten zur Korrektur importiert werden sollen. Geben Sie den vollständigen Pfad der Datei mit dem Schema „file:///“ oder „kstore://“ an. |
Nach dem Betätigen des Buttons „Sofort“ oder „Im Hintergrund“ wird der Korrekturimport durch die Hintergrund-Anwendung „Erneuter Import der Fehler-Datei (Datenaustausch)“ durchgeführt.
4.3.2 Aktion „Unbearbeitete Fehler-Datei importieren“
Durch die Aktion wird ein Import der im Datenaustausch-Protokoll vorhandenen Fehler-Datei durchgeführt. Es ist hiermit möglich, die bisher nicht erfolgreich importierten Objekte zu importieren, nachdem andere fehlende oder fehlerhafte Daten korrigiert wurden.
Diese Aktion kann auch für mehrere fehlerhafte Datenaustausch-Protokolleinträge gleichzeitig ausgeführt werden. Durch Auswahl dieser Aktion erscheint ein Dialog, über den der Korrekturimport gestartet werden kann.
4.3.3 Aktion „Korrektur-Anwendung öffnen“
Durch die Aktion können Sie fehlerhafte Objekte, die bisher nicht importiert werden konnten, in einer Korrektur-Anwendung korrigieren. Beachten Sie, dass bestimmte Fehler nicht in Korrektur-Anwendungen korrigiert werden können.
Durch Auswahl der Aktion erscheint der Dialog „Korrektur-Anwendung aufrufen“, der folgendes Feld enthält:
| Feld | Erläuterung |
| Korrekturanwendung | Legt fest, mit welcher Anwendung das Korrigieren fehlerhafter Daten erfolgen soll, die in Datenaustausch-Protokoll gespeichert wurden. Ob eine oder mehrere Korrektur-Anwendungen ausgewählt werden kann, ist vom Business Entity abhängig. |
Durch Bestätigen des Dialogs starten Sie die Korrektur-Anwendung. Die Bedienung von Korrektur-Anwendungen ist im Dokument „Daten importieren“ beschrieben.
4.3.4 Aktion „Dateien herunterladen“
Durch die Aktion „Dateien herunterladen“ werden die im Protokoll vorhandenen Dateien des Protokolleintrags in den Knowledge Store oder in das lokale Dateisystem heruntergeladen. Für fehlerhafte Importe stehen die Import- und die Fehler-Datei zur Verfügung, sofern der Import nicht vorzeitig abgebrochen ist.
Nach Auslösen dieser Aktion erscheint ein Dialog, mit dem Sie festlegen können, wohin die Dateien herunterladen werden sollen.
Der Dialog enthält folgendes Feld:
| Feld | Erläuterung |
| Ordner | Ordner, in den die Dateien abgelegt werden. Geben Sie den vollständigen Pfad der Ordners mit dem Schema „file:///“ oder „kstore://“ an. |
Eine heruntergeladene Quell- oder Ziel-Datei hat den ursprünglichen Dateinamen. Eine heruntergeladene Fehler-Datei hat die Endung „.error.xml“ und liegt immer im XML-Format vor. Sind im Ordner bereits Dateien entsprechenden Namens vorhanden, werden die herunterzuladenden Dateien durchnummeriert.
4.3.5 Aktion „Status auf Manuell geschlossen setzen“
Durch die Aktion wird der ausgewählte Datenaustausch-Protokolleintrag mit der Information gekennzeichnet, dass keine weiteren Maßnahmen erforderlich sind.
4.3.6 Aktion „Verarbeitungsauftrag“
Öffnet die Anwendung „Verarbeitungsaufträge“ und zeigt den Verarbeitungsauftrag an, der den letzten Import-, Export- oder Korrekturvorgang des Datenaustausch-Protokolleintrags ausgeführt hat.
Falls der Vorgang nicht im Hintergrund ausgeführt wurde, wird kein Verarbeitungsauftrag geöffnet.
5 Customizing
Für die Anwendung „Datenaustausch-Protokolleinträge“ sind in der Anwendung „Customizing“ keine Einstellungen festzulegen.
6 Business Entitys
Für die Anwendung „Datenaustausch-Protokolleinträge“ ist das nachfolgende Business Entity relevant, das Sie beispielsweise verwenden, um
- Berechtigungen zu vergeben,
- Aktivitätsdefinitionen einzurichten oder
- Daten zu importieren oder zu exportieren.
Datenaustausch-Protokolleintrag
com.cisag.sys.tools.bi.obj.ProcessProtocolEntry
7 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.
7.1 Spezielle Fähigkeiten
Für die Anwendung „Datenaustausch-Protokolleinträge“ bestehen keine speziellen Fähigkeiten.
7.2 Organisations-Zuordnungen
Für die Anwendung „Datenaustausch-Protokolleinträge“ ist eine Organisations-Zuordnung nicht erforderlich.
7.3 Berechtigungen für Geschäftspartner
Die Anwendung „Datenaustausch-Protokolleinträge“ ist für Geschäftspartner nicht freigegeben.
8 Vorgehensweise: Korrekturimport mit bearbeiteter Fehler-Datei
Voraussetzung
Sie haben in der Anwendung „Datenaustausch-Protokolleinträge“ einen Protokolleintrag über einen fehlerhaften Import geöffnet, und der Fehler muss durch eine Änderung der Fehler-Datei korrigiert werden.
Anleitung
- Wählen Sie die anwendungsbezogene Aktion „Dateien herunterladen“.
- Das Dialogfenster „Dateien herunterladen“ wird geöffnet.
- Geben Sie einen Ordner im Knowledge Store an, in den die Dateien abgelegt werden, und bestätigen Sie den Dialog.
- Die Dateien werden im angegebenen Verzeichnis abgelegt. Eine heruntergeladene Fehler-Datei hat die Dateiendung „.error.xml“.
- Korrigieren Sie die Fehler in der Fehler-Datei, und speichern Sie sie an einem Ort (Knowledge Store, ggf. Dateisystem), an dem das ERP-System auf die Datei zugreifen kann.
- Wählen Sie in der Standard-Symbolleiste „Bearbeitete Fehler-Datei importieren“.
- Geben Sie im Feld „Import-Fehlerdatei“ die korrigierte Fehlerdatei an.
- Tragen Sie in die Felder des Karteireiters „Hintergrundeinstellungen“ die gewünschten Werte ein. Erläuterungen zu diesen Feldern entnehmen Sie bitte dem „Bedienungsleitfaden“.
- Wählen Sie „Im Hintergrund“.
- Das System legt einen Verarbeitungsauftrag ein, der gemäß den Hintergrundeinstellungen abgearbeitet wird. Nach Abschluss des Verarbeitungsauftrags können Sie das Ergebnis im Datenaustausch-Protokoll anzeigen lassen. müssen Sie hierfür die Anzeige in der Anwendung aktualisieren, in dem Sie den Button „Aktualisieren“ in der Standard-Symbolleiste drücken.