====== Schnittstelle 7020: PCS-Stammdaten exportieren ====== Dokumentiert / statisch geprüft: **2026-10-02**. Statisch dokumentiert; Nutzerprüfung offen. Keine Schnittstelle ausgeführt. ===== Identität und Quellenstand ===== ''eProgramm.PcsStammdaten = 7020''. Aktive feste Registrierung → ''cSchnittPcs.ExportStammdaten'' (E,P). Registrierung und erreichbare Quellen geprüft; installierte Binärdateien ungeprüft. Active=True, InAutomatik=true, ManuellerAufruf=true, NurAufServer=false. Kennzeichen beschreiben Registrierung/Defaults, nicht eingerichtete Jobs; Run selbst prüft keine Serverbindung. ''seegerstefan/pep4desktop'', master, Commit ''f1d82a003b62f2658f06eaa943dc685ab219bdf3''. Lokale .DS_Store-/cPep/PEP-Abweichungen nicht vermischt; Fachquellen cSchnittstellen/ZW/Sqlfiles unverändert. Kein Remote-/Installationsabgleich. ===== Parameter und Gegenstelle ===== PFAD (FileImport) ist eine vorhandene PCS-Datenbankdatei, keine CSV. Verbindung Microsoft.Jet.OLEDB.4.0; installierte Provider/Bitness/Dateischema sind Betriebsvoraussetzungen, nicht hier getesteter Beleg. Keine Fach-SP/Calc/ZW-Fachschlüssel. PEP4 wird nur gelesen, PCS geschrieben. ===== Exportmapping ===== Zuerst kompletter DELETE INTUSCOM_MASTER_RECORDS. Exportiert werden Personen mit nichtleerem Transponder, vorhandenem Saldo und irgendeiner ITORGA-Zugehörigkeit zu einer Uhren.Art7-Filiale. Keine Gültigkeits-/Eintritt-/Austritts-/Aktivselektion; mehrere Saldozeilen können mehrfach liefern. client='01'; timeid_no=zehn Leerzeichen+Right(Transponder,10) (OleDb.Char20); access_profile_no/booking_profile_no/authorisation_group='000'; attendance_status='-'; info_field_1=Saldo.Stunden, info_field_2=Saldo.Urlaub, jeweils kulturabhängige Formatierung0.00/Char14; name_field=Left(Nachname+", "+Vorname,22); status='v'; time_stamp=lokale Now. Parameter im SQL @timid_no, hinzugefügt @timeid_no: Namensabweichung dokumentieren, bei OleDb jedoch Positionsbindung beachten, nicht ungeprüft als sicheren Laufzeitfehler behaupten. Anschließend INTUSCOM_TIMESTAMPS.TIME_STAMP=Now WHERE TABLE_ID='76'. Keine separate Ausgangsdatei. ===== Fehler und Wiederholung ===== Keine Transaktion um Vollersatz. Jede INSERT-Exception wird still geschluckt; Timestamp und True können auch bei leerem/teilfehlgeschlagenem Export folgen. Äußere Exception→LEGACY-Meldung/False; bereits gelöschter Altbestand nicht wiederhergestellt. Fehlender PFAD-Key meldet nur, setzt Ablauf mit leerem Pfad fort. Wiederholung ersetzt erneut vollständigen Zielbestand, nicht inkrementelles Update. ===== Einstellungen und gemeinsame Nebenwirkungen ===== Gemeinsames Profil: LEGACY (interne Referenz). Keine fachliche ZW-Einstellung im erreichbaren Einstieg nachgewiesen; gemeinsame Meldeeinstellungen nur über die ausdrücklich genannten Profile. Defaults sind keine Livewerte. Melde-/Datei-/DB-Wirkungen sind nicht atomar. ===== Feldbeziehungen ===== DB-Rolle PEP4-Anmeldedatenbank, soweit nicht ausdrücklich Aprocon oder Import angegeben. Unqualifizierte Objektschemata nicht als Live-dbo-Vertrag behaupten. INSERT-Defaults/Computed-Spalten sind gesonderte Schemawirkung, kein explizites UPDATE. ^ Beziehung ^ Tabelle.Feld ^ Operation ^ Datenfluss / Verwendung ^ Bedingung ^ Beleg ^ | 7020-D001 | ''Personen.PersonID'' | SELECT | Name/Ausweis und Zugehörigkeit | Nichtleerer Transponder, zwingender Saldo-Join; kein Personenaktivfilter | B | | 7020-D002 | ''Personen.Nachname'' | SELECT | Name/Ausweis und Zugehörigkeit | Nichtleerer Transponder, zwingender Saldo-Join; kein Personenaktivfilter | B | | 7020-D003 | ''Personen.Vorname'' | SELECT | Name/Ausweis und Zugehörigkeit | Nichtleerer Transponder, zwingender Saldo-Join; kein Personenaktivfilter | B | | 7020-D004 | ''Personen.Transponder'' | SELECT | Name/Ausweis und Zugehörigkeit | Nichtleerer Transponder, zwingender Saldo-Join; kein Personenaktivfilter | B | | 7020-D005 | ''Saldo.PersonID'' | SELECT | Zwei Infofelder 0.00 | Alle passenden Saldozeilen | B | | 7020-D006 | ''Saldo.Stunden'' | SELECT | Zwei Infofelder 0.00 | Alle passenden Saldozeilen | B | | 7020-D007 | ''Saldo.Urlaub'' | SELECT | Zwei Infofelder 0.00 | Alle passenden Saldozeilen | B | | 7020-D008 | ''ITORGA.PersonenStammID'' | SELECT | Zugehörigkeit einer PCS-Filiale | Keine von/bis-Abgrenzung | B | | 7020-D009 | ''ITORGA.Filiale'' | SELECT | Zugehörigkeit einer PCS-Filiale | Keine von/bis-Abgrenzung | B | | 7020-D010 | ''Uhren.FilialID'' | SELECT | Art7-Filialen | Keine Uhrwahl pro Person | B | | 7020-D011 | ''Uhren.Art'' | SELECT | Art7-Filialen | Keine Uhrwahl pro Person | B | | 7020-D012 | ''PCS:INTUSCOM_MASTER_RECORDS.— Zeilen'' | DELETE | Komplette PCS-Zieltabelle leeren | Vor neuem Export | B | | 7020-D013 | ''PCS:INTUSCOM_MASTER_RECORDS.client'' | INSERT | 01/Ausweis/000/000/000/-/Stunden/Urlaub/Name/v/Now | Per Person/Saldojoin, Zeilenfehler abgefangen | B | | 7020-D014 | ''PCS:INTUSCOM_MASTER_RECORDS.timeid_no'' | INSERT | 01/Ausweis/000/000/000/-/Stunden/Urlaub/Name/v/Now | Per Person/Saldojoin, Zeilenfehler abgefangen | B | | 7020-D015 | ''PCS:INTUSCOM_MASTER_RECORDS.access_profile_no'' | INSERT | 01/Ausweis/000/000/000/-/Stunden/Urlaub/Name/v/Now | Per Person/Saldojoin, Zeilenfehler abgefangen | B | | 7020-D016 | ''PCS:INTUSCOM_MASTER_RECORDS.booking_profile_no'' | INSERT | 01/Ausweis/000/000/000/-/Stunden/Urlaub/Name/v/Now | Per Person/Saldojoin, Zeilenfehler abgefangen | B | | 7020-D017 | ''PCS:INTUSCOM_MASTER_RECORDS.authorisation_group'' | INSERT | 01/Ausweis/000/000/000/-/Stunden/Urlaub/Name/v/Now | Per Person/Saldojoin, Zeilenfehler abgefangen | B | | 7020-D018 | ''PCS:INTUSCOM_MASTER_RECORDS.attendance_status'' | INSERT | 01/Ausweis/000/000/000/-/Stunden/Urlaub/Name/v/Now | Per Person/Saldojoin, Zeilenfehler abgefangen | B | | 7020-D019 | ''PCS:INTUSCOM_MASTER_RECORDS.info_field_1'' | INSERT | 01/Ausweis/000/000/000/-/Stunden/Urlaub/Name/v/Now | Per Person/Saldojoin, Zeilenfehler abgefangen | B | | 7020-D020 | ''PCS:INTUSCOM_MASTER_RECORDS.info_field_2'' | INSERT | 01/Ausweis/000/000/000/-/Stunden/Urlaub/Name/v/Now | Per Person/Saldojoin, Zeilenfehler abgefangen | B | | 7020-D021 | ''PCS:INTUSCOM_MASTER_RECORDS.name_field'' | INSERT | 01/Ausweis/000/000/000/-/Stunden/Urlaub/Name/v/Now | Per Person/Saldojoin, Zeilenfehler abgefangen | B | | 7020-D022 | ''PCS:INTUSCOM_MASTER_RECORDS.status'' | INSERT | 01/Ausweis/000/000/000/-/Stunden/Urlaub/Name/v/Now | Per Person/Saldojoin, Zeilenfehler abgefangen | B | | 7020-D023 | ''PCS:INTUSCOM_MASTER_RECORDS.time_stamp'' | INSERT | 01/Ausweis/000/000/000/-/Stunden/Urlaub/Name/v/Now | Per Person/Saldojoin, Zeilenfehler abgefangen | B | | 7020-D024 | ''PCS:INTUSCOM_TIMESTAMPS.TABLE_ID'' | SELECT | UPDATE-Auswahl76 | Auch wenn Export leer/teilfehlerhaft | B | | 7020-D025 | ''PCS:INTUSCOM_TIMESTAMPS.TIME_STAMP'' | UPDATE | Now signalisiert neuen Stand | Keine Erfolgsvollständigkeitsprüfung | B | ===== Teststatus und Pflege ===== Keine Laufzeit-/Live-Schema-/Lieferformat-Abnahme, keine Codekorrektur. Q02 gilt für kundenspezifische Trigger/Constraints/DLLs/Jobs; weitere Grenzen siehe oben und Fragen (interne Referenz). Externe Betriebs-/Schemaabweichungen sind nicht durch die statische Analyse ausgeschlossen. ===== Gemeinsame Nebenwirkungen LEGACY ===== Block17 ergänzt6001/6002/6003/6004/6005 ausschließlich für direkte Info-/Dialog-/Logmeldungen; keine BASE-Mail/API. Parameter, Auswahl, Return und Fachwirkung jeID. Block16 ergänzt explizit3031/3032/3041/3042/3060/3500 für die direkten Info-/Logmeldungen. Keine BASE-Vererbung bzw. Mail-/API-Nebenwirkung; Fachdateien/SQL/Returns pro ID prüfen. Keine pauschale Übernahme alter Dateiverträge. Stand 2026-10-02; statisch geprüft am Commit ''f1d82a003b62f2658f06eaa943dc685ab219bdf3''. Mitglieder ausschließlich durch expliziten Profilverweis: Block 07, IDs 2000, 2001, 2010, 2020, 3020, 3021, 3030, 3040, 3050, 3070. Block 13: Profil für 1067,1070,1073 nur bezüglich direkter cInfoTools-Dialog-/Logmeldungen und ihrer zwei Einstellungen wiederverwendet. Deren Datei-/Rückgabe-/Timeout-/Folgeaufrufverträge stehen ausschließlich in den Einzelbeschreibungen; die nachfolgenden Block-07-PFAD-/Return-Aussagen sind keine pauschale Behauptung für diese drei neuen IDs. Block14 nutzt LEGACY ausschließlich für direkte Info-/Logpfade von 1100,1101,1102,1103,1200,1207,1208,1209,1223. Keine pauschale Übernahme der nachfolgenden Block07-Datei-/Rückgabeverträge; konkrete Unterschiede stehen je ID. 1203 verwendet nur direkten MsgBox-Fehlerpfad und ist kein Mitglied. Block15 ergänzt ausdrücklich 1224/1225/1226/1320/1360/1400/1401/2021/2023 sowie die Veraltet-Stubs 2028/2029/2032/2046/2047/2048. Nur direkte Info-/Logpfade; konkrete Datei-/Return-/Timeoutverträge stehen je ID. Die sechs Stubs erben als Klasse zwar BASE, instanziieren aber nichts und rufen deren Start/Ende nicht auf. 2022 hat keinen solchen Pfad. ==== Abgrenzung und Ablauf ==== Die belegten LEGACY-Einstiege rufen cSchnitt_Basis.Start/Ende nicht auf. Die ursprünglichen Block-07-Klassen erben auch nicht von der Basis; für spätere statische Stubs gilt dagegen nur die fehlende Start-/Ende-Ausführung. Deshalb **keine BASE-Mail-/API-/Outboxbeziehungen** übernehmen. MAILTO wird zwar von cProgramm angelegt, aber hier nicht ausgewertet; ebenso keine fachliche Auswertung von MANUELL oder SILENT. RunWithDialog setzt MANUELL. Dialogunterdrückung kommt aus Settings.Info.SupressDialogs (Clientkonstruktor False, Worker True), kein belegter ZW-Schlüssel. Die folgenden Datei-/Return-Aussagen gelten für Block 07, nicht pauschal für spätere Profilmitglieder. PFAD ist FileImport, auch bei den Exporten 2001/3021: vorhandene Datei erforderlich, OpenFileDialog statt SaveFileDialog. Der lokale Registrywert PEP3/PFADESCHNITT/ speichert den zuletzt verwendeten Ordner; dies ist keine serverseitige Systemeinstellung. Fehlender PFAD-Schlüssel ergibt False mit Fehlermeldung. Value.ToString bei Nothing liegt vor dem Fach-Try und kann ungefangen abbrechen. Datei-Existenzprüfung und Startmeldung liegen ebenfalls davor. Meldungen: ShowProgrammStart/ShowProgrammEndeSuccessDialog mit Level 51, ShowProgrammEndeErrorDialog 102, ShowExceptionDialog 105 → ZeigeInfoEvent, ggf. Dialog, Log. Kein Nachweis über externe Event-Abonnentenwirkungen. Dialog kann unterdrückt sein, Logging bleibt separat. Die acht Ausführen-Funktionen außer 2010/3070 haben keinen abschließenden Return und liefern deshalb Boolean False, auch wenn Daten geändert wurden. 2020/3020 und die beiden Exporte haben zusätzlich im Fachhelfer keinen Return; dort wird bereits Success=False und ein Fehlerdialog gewählt. 2000/3030/3040/3050 können Erfolg melden und dennoch False liefern. ==== Einstellungen ==== ^ Beziehung ^ Schlüssel / Variable ^ Default ^ Einfluss ^ Wirkung ^ Beleg ^ | LEGACY-S001 | ''GLOBAL_LOGLEVEL'' / ''GLOBAL_LOGLEVEL'' | 50 | Init → Info.LogLevel | Meldung ab einschließlich Grenzwert in Datei/DB; verändert keine Fachdaten | LEGACY:SET, LEGACY:INIT, LEGACY:INFO | | LEGACY-S002 | ''GLOBAL_LOGLEVELEVLOG'' / ''GLOBAL_LOGLEVELEVENTLOG'' | 0 | Init → Info.LogLevelEvLog | Windows-Ereignisprotokoll nur bei Level > Grenze, Grenze > 0 und Level < 200 | LEGACY:SET, LEGACY:INIT, LEGACY:INFO | Beide gezeigten Settings-Konstruktoren setzen AlwaysToFile=True. Oberhalb LogLevel werden Datei UND DB versucht; bei False nur DB, Datei als Fehlerfallback. Datei unter ApplicationData/PEP/LogFiles/yyyyMMdd_peplog.txt (Append). DB-Fehler werden als False abgefangen, verhindern nicht zwingend den Import. EventLog-Fehler werden geschluckt. Direkte Fachcommands des Block 07 setzen kein Timeout; SQL_TIMEOUT ist in diesen zehn Pfaden nicht gelesen. Keine zusätzliche fachliche ZW-Einstellung nachgewiesen, auch nicht in spCalcUmsatzPlan. ==== Datenbeziehungen ==== DB-Rolle PEP4-Anmeldedatenbank. Log schreibt über eigene Verbindung; nicht atomar mit Fachoperationen. fnUserId liest minimalen UserID zum rechten 25-Zeichen-Teil von SUSER_NAME(), sonst 0. ^ Beziehung ^ Tabelle.Feld ^ Operation ^ Datenfluss / Verwendung ^ Bedingung ^ Beleg ^ | LEGACY-D001 | ''Pep3Log.UserID'' | INSERT | dbo.fnUserId() | Meldungslevel erreicht DB-Log | LEGACY:INFO, LEGACY:FN | | LEGACY-D002 | ''Pep3Log.Datum'' | INSERT | getdate() | Meldungslevel erreicht DB-Log | LEGACY:INFO | | LEGACY-D003 | ''Pep3Log.Kurz'' | INSERT | Kurztext, maximal 255 Zeichen | Meldungslevel erreicht DB-Log | LEGACY:INFO | | LEGACY-D004 | ''Pep3Log.LogText'' | INSERT | Detailtext einschließlich Pfad/ggf. Exception | Meldungslevel erreicht DB-Log | LEGACY:INFO | | LEGACY-D005 | ''Pep3Log.Modul'' | INSERT | Modulbezeichnung, maximal 50 Zeichen | Meldungslevel erreicht DB-Log | LEGACY:INFO | | LEGACY-D006 | ''Pep3Log.InfoLevel'' | INSERT | 51, 102 oder 105 je Meldung | Meldungslevel erreicht DB-Log | LEGACY:INFO | | LEGACY-D007 | ''tblUser.Name'' | SELECT | Abgleich RIGHT(SUSER_NAME(),25) | fnUserId bei Log-INSERT | LEGACY:FN | | LEGACY-D008 | ''tblUser.UserID'' | SELECT | MIN(UserID), fehlend → 0 | fnUserId bei Log-INSERT | LEGACY:FN | ===== Quellenverzeichnis ===== ^ Kürzel ^ Quelldatei am geprüften Commit ^ | E | [[https://github.com/seegerstefan/pep4desktop/blob/f1d82a003b62f2658f06eaa943dc685ab219bdf3/PEP4/ZW/Allgemein.vb|PEP4/ZW/Allgemein.vb]] | | P, LEGACY:P | [[https://github.com/seegerstefan/pep4desktop/blob/f1d82a003b62f2658f06eaa943dc685ab219bdf3/PEP4/cSchnittstellen/Programme/cProgramme.vb|PEP4/cSchnittstellen/Programme/cProgramme.vb]] | | PRJ | [[https://github.com/seegerstefan/pep4desktop/blob/f1d82a003b62f2658f06eaa943dc685ab219bdf3/PEP4/cSchnittstellen/cSchnittstellen.vbproj|PEP4/cSchnittstellen/cSchnittstellen.vbproj]] | | B | [[https://github.com/seegerstefan/pep4desktop/blob/f1d82a003b62f2658f06eaa943dc685ab219bdf3/PEP4/cSchnittstellen/Programme/SchnittstellenToEdit/cSchnittPcs.vb|PEP4/cSchnittstellen/Programme/SchnittstellenToEdit/cSchnittPcs.vb]] | | LEGACY:INFO | [[https://github.com/seegerstefan/pep4desktop/blob/f1d82a003b62f2658f06eaa943dc685ab219bdf3/PEP4/cTools/cInfoTools.vb|PEP4/cTools/cInfoTools.vb]] | | LEGACY:INIT | [[https://github.com/seegerstefan/pep4desktop/blob/f1d82a003b62f2658f06eaa943dc685ab219bdf3/PEP4/ZW/Einstellungen/cSetting.vb|PEP4/ZW/Einstellungen/cSetting.vb]] | | LEGACY:SET | [[https://github.com/seegerstefan/pep4desktop/blob/f1d82a003b62f2658f06eaa943dc685ab219bdf3/PEP4/ZW/Einstellungen/cEinstellungenZw.vb|PEP4/ZW/Einstellungen/cEinstellungenZw.vb]] | | LEGACY:FN | [[https://github.com/seegerstefan/pep4desktop/blob/f1d82a003b62f2658f06eaa943dc685ab219bdf3/Sqlfiles/PEP4Functions/fnUserId.sql|Sqlfiles/PEP4Functions/fnUserId.sql]] | Siehe auch: [[schnittstellen:schnittstellen|Übersicht der Schnittstellen]]. Keine Ausführung oder Codekorrektur.