1                     Themenübersicht

Dieses Dokument beschreibt, wie Sie aus einer Workflow-Aufgabe für einen erfolgreichen oder fehlerhaften Datenimport die Anwendung „Datenimporte“ aufrufen können. In dieser Anwendung können Sie sich Informationen über den Datenimport anzeigen lassen und die Korrektur-Anwendung für einen fehlerhaften Datenimport öffnen.

2                     Zielgruppe

• Berater
• Anwendungsentwickler

3                     Begriffsbestimmung

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 Korrekur-Anwendung ist diejenige Dialog-Anwendung, die verwendet wird, um einfache Fehler-Dateien interaktiv in Semiramis zu bearbeiten. Zu einem Business Entity können eine oder mehrere Korrektur-Anwendungen existieren. Im Allgemeinen ist die Korrektur-Anwendung die zum jeweiligen 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.

4                     Voraussetzungen

Sie können die Anwendung nur verwenden, wenn Sie sich bei Importfehlern über den Workflow benachrichtigen lassen. Die dazu nötige Aktivitätsdefinition ist im Dokument „Datenaustausch: Einführung“ beschrieben.

5                     Anwendungsbeschreibung

Die Anwendung „Datenimporte“ dient der Anzeige der Informationen über einen erfolgreichen oder fehlerhaften Datenimport. Diese Informationen werden am Ende eines Importvorgangenes auf Basis des Ereignisses „com.cisag.pgm.bi.ImportRunCompleted“ durch eine Aktivitätsdefinition in eine Aktivität bzw. eine Worflow-Aufgabe überführt. Die Aktivitätsdefinition „cis.bis.ImportCompleted“ kann hierbei als Vorlage für eigene Aktivitätsdefinitionen dienen. Sie erzeugt Aktivitäten bzw. Worflow-Aufgaben, die mit der Anwendung „Datenimporte“ verknüpft sind.

Wenn Sie eine Workflow-Aufgabe für einen Importvorgang erhalten haben, können Sie mit der Aktion „Öffnen“ auf der Workflow-Aufgabe im Navigationsbereich (Karteireiter „Aufgaben suchen“) die Anwendung „Datenimporte“ öffnen. Die Anwendung zeigt Ihnen an, um welchen Datenimport es sich handelt und mit welchem Ergebnis er durchgeführt wurde. Bei Importfehlern können Sie aus der Anwendung „Datenimporte“ heraus die beim Datenimport angegebene Korrektur-Anwendung öffnen, in der Sie fehlerhafte Daten korrigieren können.

Beachten Sie, dass Sie die Anwendung ausschließlich von einer Workflow-Aufgabe aus öffnen können.

Die Anwendung besitzt einen Arbeitsbereich, aber keinen Identifikationsbereich.

5.1               Arbeitsbereich

Der Arbeitsbereich gibt Ihnen Auskunft über den Ablauf und das Ergebnis des Datenimports. Bis auf das Feld „Korrektur-Anwendung“ sind alle Felder nicht eingabebereit. Die Felder im Einzelnen:

5.2               Customizing

Für die Anwendung „Datenimporte“ sind in der Anwendung „Custo­mizing“ keine Einstellungen fest­zulegen.

5.3               Berechtigungen

Semiramis arbeitet mit einem mehrstufigen Berechtigungskonzept. Fähigkeiten und Berechtigungen können generell auf verschiedenen Ebenen vergeben wer­den:

• Auf den Ebenen für Frameworks und Anwendungen vergeben Sie z. B. eine Berechtigung, mit der eine Anwendung geöffnet werden kann.
• Auf den Ebenen für Business Entitys vergeben Sie z. B. eine Berechtigung, mit der ein Bericht erzeugt werden kann. Die Entity-bezogenen Berechtigungen gelten anwendungs­über­greifend.

Für einige Anwendungen wurden spezielle Fähigkeiten entwickelt, die sich auf bestimmte Aktio­nen und Funk­tionen beziehen. Auch für diese Fähigkeiten können Berechtigungen vergeben werden. So kann z. B. für die spezielle Fähig­keit, eine Bestellung ausgeben zu können, eine Berech­tigung vergeben werden.

Das Berechtigungskonzept sowie die generellen anwendungsbezogenen und Entity-bezogenen Berechtigungen können Sie in der Technischen Dokumentation im Dokument „Berechtigungen“ nachlesen.

Für Berechtigungsfestlegungen für die Anwendung „Datenimporte“ ist kein Business Entity relevant.

Für die Anwendung werden Lese- und Schreibberechtigungen auf die Fehler-Datei benötigt, sofern die Fehler-Datei im Knowledge Store liegt.

5.4               Vorgehensweise: Mit der Anwendung „Datenimporte“ Importfehler korrigieren

Voraussetzung

Sie sehen im Navigationsbereich (Karteireiter „Aufgaben suchen“) eine Workflow-Aufgabe zu einem fehlerhaften Datenimport.

Vorgehen

1. Doppelklicken Sie die Aufgabe im Navigationsbereich

• Die Anwendung „Datenimporte“ wird geöffnet und zeigt Informationen über den Importvorgang an.
  Falls in dem Importvorgang korrigierbare Objekte, aber keine nicht korrigieerbaren Objekte entstanden sind, können Sie die Fehler in der Korrektur-Anwendung korrigieren.

2. Wählen Sie die Aktion „Fehler-Datei in Korrektur-Anwendung öffnen“.

• Das erste fehlerhafte Objekt wird in der Korrektur-Anwendung geöffnet.

3. Korrigieren Sie die fehlerhaften Daten. Die Bedienung von Korrekturanwendungen ist der Dokumentation „Daten importieren“ beschrieben.
4. Wenn Sie alle Fehler in allen Objekten der Fehler-Datei korrigiert haben und die Fehler-Datei nicht mehr benötigen, wechseln Sie wieder zur Anwendung „Datenimporte“ und löschen Sie die Fehler-Datei mit der Aktion „Fehler-Datei löschen“.

Hinweis:
Falls bei einem Import Fehler aufgetreten sind, die so schwerwiegend sind, dass sie nicht in einer Korrektur-Anwendung behoben werden können, kann die Schaltfläche der Aktion „Fehler-Datei in der Korrektur-Anwendung öffnen“ nicht gewählt werden. In diesem Fall müssen Sie die Fehler manuell korrigieren, wie  in der Dokumentation Einführung: Datenaustausch beschrieben ist.

5.5               Anwendungsbezogene Aktionen

Die folgenden anwendungsbezogenen Aktionen stehen in der Anwendung „Datenimporte“ zur Verfügung:

5.5.1          Fehler-Datei in weiterem Fenster öffnen

Mit dieser Aktion öffnen Sie die Fehler-Datei in einem weiteren Fenster oder einer externen Anwendung. Welche Anwendung dies ist, hängt davon ab, welche Anwendung auf dem Client-Rechner mit der Dateierweiterung „.xml“ verknüpft ist. Im Allgemeinen ist dies der Browser. Diese ermöglicht Ihnen, beispielsweise die in der Fehler-Datei gespeicherten Fehlermeldungen anzuzeigen, was insbesondere in dem Fall, dass die Quell-Datei syntaktische Fehler beinhaltet hat, hilfreich ist, da diese Art von Fehlern das Öffnen der Korrektur-Anwendung verhindert.

5.5.2          Fehler-Datei in der Korrektur-Anwendung öffnen

Mit dieser Aktion öffnen Sie die Fehler-Datei in der Korrektur-Anwendung, sofern die Fehler-Datei nur korrigierbare Datensätze enthält. In der Korrektur-Anwendung können Sie die fehlerhaften Datensätze korrigieren.

5.5.3          Fehler-Datei löschen

Mit dieser Aktion löschen Sie nach einer entsprechenden Bestätigung die Fehler-Datei.