Schnittstelle 2020 – Abteilungen aus einer Datei anlegen

Die Schnittstelle Abteilungen liest Abteilungen aus einer Semikolondatei. Sie legt nur IDs an, die in Abteilungen noch fehlen. Vorhandene Abteilungen werden nicht aktualisiert.

Voraussetzungen

Du benötigst eine vorhandene Datei und Zugriff auf das Modul Schnittstellen.
Verwendete Abteilungsgruppen müssen bereits vorhanden sein. Der Wert 0 in der Datei wird als fehlende Gruppe (SQL-NULL) übernommen.
Prüfe die Zeichencodierung der Datei. PEP4 liest sie mit der Windows-Standardcodierung des ausführenden Systems.

Dateiaufbau

Die Felder sind durch Semikolon getrennt; Text in Anführungszeichen darf selbst Semikola enthalten. Die Datei hat keine eigens ausgewertete Kopfzeile. Nur Zeilen mit Satzkennung 2020 und mindestens vier Feldern werden verarbeitet. Weitere Felder bleiben ungenutzt.

Position	Feld	Wirkung
1	Satzkennung	Muss `2020` sein.
2	AbteilungID	Eindeutiger Schlüssel der Abteilung.
3	Bezeichnung	Wird nur bei einer neuen ID geschrieben; im SQL-Parameter auf 50 Zeichen begrenzt.
4	Abteilungsgruppe	Vorhandene Gruppen-ID; `0` wird als SQL-NULL gespeichert.

Vorgehen

Erstelle eine Sicherung und prüfe die Datei anhand der vier Positionen.
Öffne das Modul Schnittstellen und wähle Abteilungen mit Kennung 2020.
Klicke auf Ausführen und wähle die Datei aus.
Prüfe nach dem Lauf das Importprotokoll und vergleiche die neu angelegten Abteilungen mit der Datei. Bereits vorhandene IDs müssen unverändert bleiben.

Ergebnis und Fehlerhinweise

Für eine fehlende ID schreibt PEP4 Abteilungen.AbteilungID, Bezeichnung und Abteilungsgruppe. Es gibt kein UPDATE, DELETE und keine fachliche Stored Procedure. Ein ungültiger Gruppenverweis kann die betreffende Zeile scheitern lassen. Andere Zeilen werden weiter versucht; bereits angelegte Abteilungen bleiben erhalten.

Zusätzlich entsteht im Log-Ordner des Arbeitsverzeichnisses eine Datei mit dem Muster yyyyMMdd_HHmmss_ImportSchnitt_PEP.log. Der Zähler dort umfasst versuchte passende Zeilen, nicht zwingend neu angelegte Abteilungen. Die Quelldatei bleibt erhalten.

Im untersuchten Code liefern Importhelfer und Einstiegsmethode keinen abschließenden Rückgabewert. Deshalb kann PEP4 einen Fehlerabschluss anzeigen, obwohl Abteilungen angelegt wurden. Vergleiche das Protokoll und die Daten; wiederhole den Import nicht allein aufgrund der Meldung.

Technische Referenz

Merkmal	Wert
Programmkennung	`2020` / `ImpAbteilungen`
Einstieg	`cSchnittAbteilungen.Ausführen`
Parameter	`PFAD`; vorhandene Datei, kein Standardwert
Fachliches SQL	Existenzprüfung nach `AbteilungID`, danach nur INSERT
Zieltabelle	`Abteilungen`; FK-Prüfung gegen `Abteilungsgruppen` bei gesetzter Gruppe
Systemeinstellungen	`GLOBAL_LOGLEVEL` und `GLOBAL_LOGLEVELEVLOG` beeinflussen nur die Protokollierung; Standardwerte laut Code 50 und 0

Siehe auch

Prüfstand

Am 25.09.2026 statisch gegen den Quellcommit f1d82a003b62f2658f06eaa943dc685ab219bdf3 geprüft. Keine installierte Version und kein Importlauf bestätigt.