Inhaltsverzeichnis
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.