Allgemeiner Ablauf eines Einzel- und Massenimportvorgangs

Einzelimportvorgang

Der Vorhaben-Einzelimport dient dazu, eine Importdatei (XML-Datei) auszuwählen und den Importprozess hierfür auszulösen. Hierzu wurden in DATES III drei Import-Funktionen umgesetzt:

• Import eines neuen Vorhabens
• Änderungen eines bestehenden (vollständigen) Vorhabens
• Import ausschließlich von Teilnehmerdaten eines bestehenden Vorhabens

Bei einem Vorhabenimport muss immer die vollständige Datenstruktur eines zu importierenden Vorhabens geliefert werden. Ein Deltaimport, d.h. eine Datenaktualisierung um nur geänderte Datenfelder eines Vorhabens oder ein Import von einzelnen Stammblatt-Teilen (außer den Teilnehmerdaten, die in Stammblatt Teil D vorgehalten werden) wird von DATES III nicht unterstützt.

Am Ende eines Imports wird eine Statusmeldung auf dem Dialog ausgegeben, die den Status des Importvorgangs und ggf. eine Fehlermeldung anzeigt (analog zum Eintrag in die sog. Protokolldatei). Zusätzlich erfolgt ein Eintrag in eine sog. Importhistorie und eine Protokolldatei wird erzeugt.

Beim Einzelimport-Vorgang durchläuft die Anwendung nacheinander folgende Schritte:

• Das Einlesen der XML-Datei
• Die Validierung gegen die XML-Schemadefinition
• Die Abbildung der externen auf die interne Datenstruktur von DATES III
• Der Aufruf der Funktionalität „Vorhaben anlegen/bearbeiten“
• Die Rückgabe des Importergebnisses, Erzeugung einer Protokoll- und ggf. Fehlimport-Datei sowie ein Eintrag in Importhistorie. Bei einem Importvorgang werden Systemmeldungen sowohl auf dem Importdialog als auch in der Protokolldatei angezeigt.

Massenimportvorgang

Durch den Massenimport können ein oder mehrere Vorhaben eines ESF-Programms aus einer ZIP-Datei importiert werden, in der die Importdateien aller zu importierenden Vorhaben zusammengefasst werden. Hierbei können sowohl die Importdateien für einen (vollständigen) Vorhaben- als auch für einen Teilnehmerdatenimport zusammen in der ZIP-Datei geliefert werden.

Nach dem Starten des Massenimports findet keine weitere Interaktion mit dem angemeldeten Nutzer statt, sondern der aktuelle Status des Importvorgangs lässt sich in der Importhistorie nachverfolgen. Für jeden Massenimportvorgang wird dabei ein Eintrag in der Importhistorie vorgenommen. Schlägt der Import eines einzelnen Vorhabens fehl, bricht der Importvorgang nicht vollständig ab, sondern es werden alle Dateien der ZIP-Datei nacheinander abgearbeitet.

Beim Massenimport-Vorgang durchläuft die Anwendung nacheinander folgende Schritte:

• Neuer Eintrag in die Importhistorie mit dem Status „Import läuft“. Nach abgeschlossenem Importvorgang wird der Importstatus hierin dokumentiert.
• Für jede in der Massenimportdatei enthaltenen Einzelimportdatei (Vorhabenimport oder Teilnehmerimport) erfolgt:
  • Das Einlesen der XML-Datei
  • Die Validierung gegen die XML-Schemadefinition
  • Die Abbildung der externen auf die interne Datenstruktur von DATES III
  • Ein Aufruf der Funktionalität „Vorhaben anlegen/bearbeiten“
  • Die Rückgabe des Importergebnisses, Erzeugung einer Protokoll- und ggf. Fehlimport-Datei sowie ein Eintrag in Importhistorie. Bei einem Importvorgang werden Systemmeldungen sowohl auf dem Importdialog als auch in der Protokolldatei angezeigt.