1 Themenübersicht
Datenimporte und –exporte mit dem BIS können protokolliert werden. Die Anwendung „Datenaustausch-Protokolleinträge abfragen“ dient dazu, eine Übersicht über Importe und Exporte, die mit aktivierter Protokollierung durchgeführt wurden, anzuzeigen. 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 Fehlerdatei 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 in Semiramis 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.
Ziel-Datei
Die Datei, die beim Export von Daten im BIS erzeugt wird.
4 Anwendungsbeschreibung
Die Anwendung „Datenaustausch-Protokolleinträge abfragen“ bietet einen Überblick über Importe und Exporte, die mit aktivierter Protokollierung durchgeführt wurden. Für jeden dieser Importe und Exporte wurde dabei ein Protokolleintrag erzeugt. Die anzuzeigenden Protokolleinträge können auf verschiedene Weise eingegrenzt werden, darunter auch nach Meldungstexten bei fehlerhaften Importen. Als anpassbares Cockpit kann die Anwendung zudem auf Bedürfnisse der Benutzer verändert werden.
Für fehlerhafte Importe können Korrekturen gestartet werden. Korrekturvorgänge werden im selben Datenaustausch-Protokolleintrag angezeigt. Bestimmte Listenspalten beziehen sich immer auf den letzten durchgeführten Vorgang. Solange keine Korrekturen durchgeführt wurden, ist dies der Import selbst, und anderenfalls der letzte Korrekturvorgang.
Weitere Details von Datenaustausch-Protokolleinträgen, die nicht in dieser Anwendung angezeigt werden, sind in der Anwendung „Datenaustausch-Protokolleinträge“ verfügbar.
4.1 Abfrage- und Arbeitsbereich
Im Abfragebereich werden Abfragefelder abgelegt. In der Regel sind die wichtigsten Abfragefelder bereits vorhanden. Die Anzahl der Abfragefelder und deren Platzierung können jedoch variieren.
Der Abfragebereich ist für alle Ansichten des Arbeitsbereichs gleich. Welche Abfragefelder angezeigt werden, können Sie selbst bestimmen.
Im Arbeitsbereich der Anwendung „Datenaustausch-Protokolleinträge abfragen“ wird die Ergebnisliste mit den abgefragten Datenaustausch-Protokolleinträgen angezeigt. So können Sie selbst bestimmen, welche Informationen zu einem Protokolleintrag angezeigt werden sollen.
4.1.1 Ansichten des Arbeitsbereichs
Um einen Protokolleintrag auf verschiedene Weise mit unterschiedlichen Informationen betrachten zu können, können mehrere Ansichten erstellt werden. Folgende Ansichten sind bereits vorhanden:
- „Übersicht“: Zeigt die wichtigsten Eigenschaften eines Protokolleintrags in einer Zeile an.
- „Anzahl Instanzen“: Zeigt zusätzlich zur Ansicht „Übersicht“ an, wieviele Objekte für den Datenaustausch-Protokolleintrag bzw. im letzten Vorgang verarbeitet wurden.
- „Gesamtübersicht“: Zeigt Detailinformationen zu einem Protokolleintrag und dessen letzten Vorgang an. Unter anderem werden die verwendeten Filter, der Benutzer, und die URI der ursprünglichen Datei angezeigt.
- „Laufzeiten“: Zeigt zu einem Protokolleintrag auch den Anfangs- und Endzeitpunkt des letzten Vorgangs und dessen Dauer an.
4.1.2 Buttons im Arbeitsbereich
Zusätzlich stehen in der Symbolleiste über der Liste im Arbeitsbereich folgende Buttons zur Verfügung, um die Details über einen Protokolleintrag anzuzeigen oder Verarbeitungsaufträge zu öffnen:
| Button | Erläuterung |
| 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. |
| Datenaustausch-Protokolleintrag | Öffnet die Anwendung „Datenaustausch-Protokolleinträge“ und zeigt Details über einen Protokolleintrag an. Die Details umfassen den zuletzt für den Protokolleintrag durchgeführten Vorgang mit den darin verarbeiteten Objekten und enstandenen Meldungen. |
4.1.3 Abfragefelder und Listenspalten
Nachfolgend sind alle wesentlichen Abfragefelder bzw. Listenspalten aufgeführt. Werden weitere Felder hinzugefügt, dann finden Sie deren Beschreibung in der Direkthilfe.
Sofern Listenspalten bzw. Abfragefelder Informationen aus einem Datenaustausch-Vorgang anzeigen, bezieht sich diese Information immer auf den letzten durchgeführten Vorgang des Datenaustausch-Protokolleintrags.
| Feld oder Spalte | Erläuterung |
| Richtung | Richtung des Datenaustausches. Mögliche Werte sind:
· Import Export |
| Business-Entity-Bezeichnung | Die Bezeichnung eines Business Entity. Dieses Feld kann nicht als Abfragefeld verwendet werden. |
| Business Entity | Der technische Name eines Business Entity, z.B. „com.cisag.app.genral.obj.Item“. |
| Erzeugungszeitpunkt | Erzeugungszeitpunkt des Protokolleintrags. |
| Letzter Änderungszeitpunkt | Letzter Änderungszeitpunkt des Protokolleintrags. |
| Sessiontyp | Typ der Session, in der der Ursprungsvorgang ausgeführt wurde. Der Typ der Session wird bei der Erzeugung der Session festgelegt und ist danach unveränderlich. Anhand des Session-Typs können die Session den verschiedenen Zugriffskanälen in Semiramis zugeordnet werden. Die möglichen Werte sind:
· Initialisierung, · System, · Hintergrundverarbeitung, · Toolshell, · Entfernter Zugriff, · Dialogzugriff, · ODBC-Zugriff, · ODBC-Serverzugriff, · Knowledge-Store-Zugriff, · Ressourcen-Zugriff, · CORBA-Zugriff, · SOAP-Zugriff. |
| Gesamt-Status | Zustand eines Protokolleintrages. Der Gesamt-Status eines Datenaustausch-Protokolleintrags zeigt an, wie weit der Import, Export und ggf. Korrekturen fortgeschritten sind. Die möglichen Werte sind:
· In Bearbeitung, · In Bearbeitung (Korrekturimport), · In Bearbeitung (Korrektur-Anwendung: · Erfolgreich: · Fehlerhaft: · Manuell geschlossen: |
| Objekte gesamt (Ursprungsvorgang) | Gesamtzahl verarbeiteter Instanzen im 1. Vorgang. |
| Objekte erfolgreich | Anzahl der Objekte, die für den Datenaustausch-Protokolleintrag erfolgreich importiert bzw. exportiert wurden.
Wurden für fehlerhafter Importe bereits Korrekturen durchgeführt, sind die in den Korrekturvorgängen erfolgreich importierten Objekte eingeschlossen. |
| Objekte gesamt | Gesamtanzahl der verarbeiteten Objekte während des Datenaustausch-Vorgang. |
| Fehlerhafte Objekte | Anzahl der Objekte, die während des Datenaustausch-Vorgang nicht erfolgreich importiert bzw. exportiert wurden, unabhängig davon, inwieweit Korrekturmöglicheiten bestehen. |
| 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 weden können. Für Exporte ist diese Angabe nicht relevant. |
| Typ (Letzter Vorgang) | Typ des letzten Vorgangs des Datenaustausch-Protokolleintrags. Die möglichen Werte sind:
· Ursprungsvorgang (Import- oder Exportvorgang), · Korrekturimport (Import einer Fehler-Datei), · Korrektur in Korrektur-Anwendung. |
| Status | Status des letzten Vorgangs des Datenaustausch-Protokolleintrags. Die möglichen Werte sind:
· In Bearbeitung, · Erfolgreich beendet, · Fehlerhaft beendet, · Abgebrochen durch Anwendung (Der Vorgang wurde durch einen Fehler in der Anwendung vorzeitig abgebrochen), · Abgebrochen durch Benutzer (Der Vorgang wurde auf Anforderung eines Benutzers vorzeitig abgebrochen), · Abgebrochen durch System (Der Vorgang wurde durch ein Systemausfall vorzeitig abgebrochen.) |
| Filter-Bezeichnung | Die Bezeichnung des für den Import oder Export verwendeten Filters. Dieses Feld darf nur im Anzeigebereich verwendet werden. |
| Filter | Die Identifikation des für den Import oder Export verwendeten Filters. |
| Zuständiger Benutzer | Name des Benutzers, der den Datenaustausch gestartet hat. |
| Meldungstexte | Geben Sie in diesem Feld bei Bedarf Text oder Langtext der Meldung in Anzeigesprache ein, um Datenaustausch-Protokolleinträge auszuwählen, in dessen letztem Vorgang der Text oder Langtext in einer Meldung vorkommt. Meldungsparameter sind bereits ersetzt und können ebenfalls verwendet werden. Gesucht wird in den objektbezogenen Meldungen.
Dieses Feld darf nur im Abfragebereich verwendet werden. |
| Ursprungsdatei | URI der ursprünglichen Datei (Quell-Datei bei Import, Ziel-Datei bei Export). Leer, wenn kein Dateiname bekannt ist (Aufruf über CORBA oder Web-Services)
Hinweis: Es ist möglich, dass die durch die URI bezeichnete Datei nicht mehr existiert oder einen anderen Inhalt hat. |
| Anfangszeitpunkt | Anfangszeitpunkt des Datenaustausch-Vorgangs. |
| Endzeitpunkt | Endzeitpunkt des Datenaustausch-Vorgangs. |
| Dauer | Ausführungsdauer des Datenaustausch-Vorgangs. |
| Korrekturen | Anzahl der bisher für den Datenaustausch-Protokolleintrag gestarteten Korrekturen. |
4.2 Anwendungsbezogene Aktionen
Die folgenden anwendungsbezogenen Aktionen stehen in der Anwendung „Datenaustausch-Protokolleinträge abfragen“ unter dem Aktionen-Button in der Standard-Symbolleiste zur Verfügung:
- Aktion „Bearbeitete Fehler-Datei importieren
- Aktion „Unbearbeitete Fehler-Datei importieren“
- Aktion „Korrektur-Anwendung öffnen“
- Aktion „Status auf Manuell geschlossen setzen“
- Aktion „Protokoll-Abgleich“
4.2.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.
Nach Wählen 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 anwendungsspezifisches 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 Fehlerdatei (Datenaustausch)“ durchgeführt.
4.2.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 importierbaren Objekte zu importieren, nachdem andere fehlende oder fehlerhafte Daten in Semiramis korrigiert wurden.
Diese Aktion kann auch für mehrere fehlerhafte Datenaustausch-Protokolleinträge gleichzeitig ausgeführt werden.Nach Wählen dieser Aktion erscheint ein Dialog, über den der Korrekturimport gestartet werden kann.
4.2.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. Nach Wählen der Aktion erscheint der Dialog „Korrektur-Anwendung aufrufen“, der folgenes 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.2.4 Aktion „Status auf Manuell geschlossen setzen“
Durch die Aktion werden die ausgewählten Datenaustasuch-Protokolleinträge gekennzeichnet, dass keine weiteren Maßnahmen erforderlich sind.
4.2.5 Aktion „Protokoll-Abgleich“
Durch die Aktion wird der Status von Protokolleinträgen aktualisiert, für die abgebrochene Verarbeitungsaufträgen vorhanden sind, oder Korrekturanwendungen abgebrochen wurden. Verwenden Sie diese Aktion, wenn Protokolleinträge den Gesamt-Status „In Bearbeitung“, „In Bearbeitung (Korrektur)“ oder „In Bearbeitung (Korrekturanwendung)“ haben, jedoch die entsprechenden Vorgänge tatsächlich abgebrochen sind.
5 Customizing
Für die Anwendung „Datenaustausch-Protokolleinträge abfragen“ sind in der Anwendung „Customizing“ keine Einstellungen festzulegen.
6 Business Entitys
Für die Anwendung „Datenaustausch-Protokolleinträge abfragen“ sind die nachfolgenden Business Entitys relevant, die 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 abfragen“ bestehen keine speziellen Fähigkeiten.
7.2 Organisations-Zuordnungen
Für die Anwendung „Datenaustausch-Protokolleinträge abfragen“ ist eine Organisations-Zuordnung nicht erforderlich.
7.3 Berechtigungen für Geschäftspartner
Die Anwendung „Datenaustausch-Protokolleinträge abfragen“ ist für Benutzer vom Typ „Geschäftspartner“ nicht freigegeben.
8 Vorgehensweisen
Lesen Sie nachfolgend, wie Sie mit der Anwendung „Datenaustausch-Protokolleinträge abfragen“ arbeiten:
- Korrekturimport mit bearbeiteter Fehlerdatei
- Korrektur in einer Korrektur-Anwendung
- Datenaustausch-Protokolleintrag öffnen
8.1 Korrekturimport mit bearbeiteter Fehlerdatei
Voraussetzung
Sie haben einen Fehler in der Fehler-Datei korrigiert und möchten die bisher fehlerhaft importierten Objekte nun importieren.
Hinweis: Die Fehler-Datei für protokollierte Importe ist über die Anwendung „Datenaustausch-Protokolleinträge“ verfügbar.
Anleitung
- Öffnen Sie die Anwendung „Datenaustausch-Protokolleinträge abfragen“.
- Geben Sie nach Bedarf Suchmerkmale in die Felder des Abfragebereiches ein.
- Drücken Sie in der Standard-Symbolleiste „Aktualisieren“.
Die Anwendung zeigt die den Suchmerkmalen entsprechenden Datenaustausch-Einträge im Arbeitsbereich an.
- Markieren Sie in der Liste einen Datenaustausch-Eintrag, für den Sie den erneuten Import der Fehlerdatei ausführen möchten.
- Wählen Sie in der Standard-Symbolleiste „Manueller erneuter Import der Fehlerdatei“.
- Tragen Sie in dem Feld „Import-Fehler-Datei“ den vollständigen Pfad der Datei mit dem Schema „file:///“ oder „kstore://“ ein.
- Tragen Sie in die Felder der Karteireiter „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 an, der gemäß den Hintergrundeinstellungen abgearbeitet wird.
Hinweis: Sie können auch im Schritt 5 „Sofort“ auswählen, in diesem Fall wird die Aktion sofort ausgeführt.
8.2 Korrektur in einer Korrektur-Anwendung
Anleitung
- Öffnen Sie die Anwendung „Datenaustausch-Protokolleinträge abfragen“.
- Geben Sie nach Bedarf Suchmerkmale in die Felder des Abfragebereiches ein.
- Drücken Sie in der Standard-Symbolleiste „Aktualisieren“.
Die Anwendung zeigt die den Suchmerkmalen entsprechenden Datenaus-tausch-Einträge im Arbeitsbereich an.
- Markieren Sie in der Liste einen Datenaustausch-Eintrag, für den Sie den Aufruf einer Korrekturanwendung ausführen möchten.
- Wählen Sie in der Standard-Symbolleiste „Aufruf Korrekturanwendung“.
- Wählen Sie in dem Feld „Korrekturanwendung“, falls mehrere Korrekturanwendungen zur Verfügung gestellt sind, die gewünschte Korrekturanwendung und betätigen mit dem „OK“-Button.
Die ausgewählte Korrekturanwendung wird geöfnet.
8.3 Datenaustausch-Protokolleintrag öffnen
Die Anwendung „Datenaustausch-Protokolleinträge“ zeigt Details über einen Protokolleintrag an. Die Details umfassen den zuletzt für den Protokolleintrag durchgeführten Vorgang mit den darin verarbeiteten Instanzen. Bei fehlerhaft importierten Instanzen können auch die Fehlermeldungen angezeigt werden.
Anleitung
- Öffnen Sie die Anwendung „Datenaustausch-Protokolleinträge abfragen“.
- Erfassen Sie die Suchmerkmale im Abfragebereich.
- Betätigen Sie das Button „Aktualisieren“.
Das System zeigt im Arbeitsbereich die Datenaustausch-Protokolleinträge an.
- Wählen Sie einer der Zeilen und betätigen Sie den Button „Datenaustausch-Protokolleintrag“ in der Symbolleiste der Liste.
Das System wechselt zu der Anwendung „Datenaustausch-Protokolleinträge“ und zeigt im Identifikations- und Arbeitsbereich die Informationen zum ausgewählten Datenaustausch-Protokolleintrag.