====== Schnittstelle 2000 – PEP-Gruppen aus einer Datei übernehmen ====== Die Schnittstelle **Pepgruppen** liest Gruppendaten aus einer Datei. Der untersuchte Programmstand versucht, vorhandene PEP-Gruppen zu löschen und neu anzulegen. Dabei können auch zugehörige Umsatzdaten betroffen sein. Die Schnittstelle ist im Programm registriert, ihr SQL verwendet aber vier Spalten, die in der untersuchten Datenbankmigration entfernt wurden: ''RechenArt'', ''NichtInUebersicht'', ''Nachrichtentext'' und ''DatumUmsChange''. Ob sie in deiner Installation lauffähig ist, ist nicht bestätigt. Starte sie erst, wenn der konkrete Datenbankstand geprüft und der Ablauf in einer isolierten Testumgebung erprobt wurde. Ein erfolgreicher Löschvorgang auf einem passenden Altschema kann abhängige Daten einschließlich ''Umsätze'' entfernen. ===== Eingabedatei ===== PEP4 verlangt eine bereits vorhandene Datei. Der Dateidialog schlägt ''PepGruppen.pep'' vor. Die Datei enthält durch Semikolon getrennte Felder. In Anführungszeichen eingeschlossene Felder dürfen selbst Semikola enthalten. Der Import liest Text mit der Standard-Zeichencodierung des ausführenden Windows-Systems. Es gibt keine feste Kopfzeile; nur Datensätze mit der Satzkennung ''2000'' werden verarbeitet. ^ Position ^ Feld ^ Verwendung ^ | 1 | Satzkennung | Muss ''2000'' sein. | | 2 | PEP-Gruppen-ID | Schlüssel der zu ersetzenden Gruppe. Ungültiger nichtnumerischer Text wird im Code zu 0. | | 3 | Bezeichnung | Neue Gruppenbezeichnung. | | 4 | Kostenstelle | Neue Zuordnung in ''UmsKstGr''. Ungültiger nichtnumerischer Text wird zu 0. | Der Import prüft die Feldzahl nicht vor dem Zugriff. Ein zu kurzer Satz kann den weiteren Import abbrechen. Die Quelldatei bleibt an ihrem Ort. ===== Geplanter Datenweg im untersuchten Code ===== Für jeden passenden Satz enthält der SQL-Batch diese Schritte: - Die PEP-Gruppe mit der angegebenen ID löschen. - Vorhandene Umsatz-Kostenstellenzuordnungen für diese Gruppe löschen. - Die Gruppe mit ihrer Bezeichnung und festen Vorgabewerten neu anlegen. - Eine Zuordnung aus Kostenstelle und Gruppe mit Faktor 1 anlegen. Es gibt kein normales UPDATE und keine gemeinsame Transaktion über die Datei. Fremdschlüssel können eine Gruppenlöschung verhindern oder abhängige Zeilen löschen. Dazu gehören auf passenden Schemaständen auch Umsatzzeilen. Wegen der entfernten Spalten ist nicht zugesichert, dass auf dem neueren Schema irgendeiner dieser Schritte ausgeführt wird; der SQL-Batch kann bereits vor den DELETE-Anweisungen scheitern. ===== Vor einer Prüfung ===== - Vergleiche den eingesetzten Datenbankstand mit den vier oben genannten Spalten. - Sichere die PEP-Gruppen, ihre Umsatz-Kostenstellenzuordnungen und abhängige Daten. - Teste neue und vorhandene IDs ausschließlich in einer isolierten Datenbankkopie. - Verlasse dich nicht allein auf die Rückgabe des Programms: Die Einstiegsmethode liefert im untersuchten Code auch nach einer Erfolgsmeldung ''False''. Ein Export mit [[schnittstellen:2001|Schnittstelle 2001]] ist keine vollständige Sicherung für diesen Import. Er gibt als Kostenstelle die Gruppen-ID aus und enthält nicht alle Gruppeneigenschaften. ===== Technische Referenz ===== ^ Merkmal ^ Wert ^ | Programmkennung | ''2000'' / ''ImpPepGruppen'' | | Einstieg | ''cSchnittPepgruppen.Ausführen'' | | Parameter | ''PFAD''; vorhandene Eingabedatei, kein Standardwert | | Fachliches SQL | Parametrisierter Batch mit DELETE und INSERT; keine fachliche Stored Procedure | | Eingang | Datei: Satzkennung, Gruppen-ID, Bezeichnung, Kostenstelle | | Beabsichtigte Ziele | ''PepGruppen'' und ''UmsKstGr''; abhängige Tabellen bei tatsächlich erfolgreicher Fremdschlüsselkaskade | | Systemeinstellungen | ''GLOBAL_LOGLEVEL'' und ''GLOBAL_LOGLEVELEVLOG'' beeinflussen nur die Protokollierung; Standardwerte laut Code 50 und 0 | ===== Siehe auch ===== * [[schnittstellen:2001|PEP-Gruppen exportieren (2001)]] * [[schnittstellen:schnittstellen|Übersicht der dokumentierten Schnittstellen]] * [[module:extras_schnittstellen|Modul Schnittstellen]] ===== Prüfstand ===== Am 25.09.2026 statisch anhand der Programmregistrierung, der VB-Implementierung und der Datenbankmigrationen am Quellcommit ''f1d82a003b62f2658f06eaa943dc685ab219bdf3'' geprüft. Kein bestimmter Installationsstand und kein Importlauf bestätigt.