====== 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 [[module:extras_schnittstellen|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.

<WRAP center round info 100%>
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.
</WRAP>

===== 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 =====

  * [[schnittstellen:schnittstellen|Übersicht der dokumentierten Schnittstellen]]
  * [[module:extras_schnittstellen|Modul Schnittstellen]]

===== Prüfstand =====

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