Schnittstelle 7002: Datafox-Stammdaten, Salden und weitere Listen übertragen

Dokumentiert / statisch geprüft: 2026-10-02. Statisch dokumentiert; Nutzerprüfung offen. Keine Schnittstelle ausgeführt.

eProgramm.TerminalStammdatenDatafox = 7002. Aktive feste Registrierung → cSchnittDatafox.StammdatenDelegate (E,P). Registrierung und erreichbare Quellen geprüft; installierte Binärdateien ungeprüft. Active=True, InAutomatik=true, ManuellerAufruf=false, 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.

ID (NumberLong) hat Registrierung.DefaultValue=-1, der Delegate liest aber nur Value und ruft keinen Defaultauflöser auf. Fehlender/nichtnumerischer/nicht gefüllter Value bleibt daher0, nicht automatisch -1. ID=-1→Uhren.Art1/Auto1, konkrete ID→auch nichtAuto; keine weiteren Fachdateiparameter.

Adresse ohne ';'→Bus254,ComTyp3,ComStringAdresse,ComValue8000,Timeout5000. Erweiterte Adresse 'Bus;ComTyp;ComString;ComValue;Timeout'; weniger5 Teile lässt Objekt uninitialisiert, Konvertierungsfehler können abbrechen. Immer DFCom-Verbindung1; Parallelaufrufe teilen die Kanalnummer. Anwendungsordner und relative Datafox-Pfade nicht pauschal identisch setzen. Direktes LEGACY-Logging, keine BASE-Mail/API.

Native Deklarationen benutzen DFComDll/x86-dekorierte Exporte; x64-Varianten im Code auskommentiert. Installierte DLL/Gerätetyp/Firmware/Setup nicht geprüft. Herstellerreferenz: lokale DFCom-Unterlage04.03.23, entsprechende API-HTML. Keine Gerätebefehle ausgeführt.

Je Aktivierung werden Stamm, Salden, Anwesenheit, Nachrichten und Tätigkeiten vorbereitet. Stamm-/Saldo-/Anwesenheitexport schreibt zunächst Dateien für sämtliche passende Art1-Uhren, nicht nur die ausgewählte ID. Erst Upload ist auf die aktuelle Terminalwahl begrenzt. Kein fachlicher DB-Import, keine Neuberechnung.

PersonenTerminal(@Filiale): jetzt gültige ITORGA und Transponder/Transponder2>'0' oder FP1>'0', Namen/Ausweise/Fehlerflag. Keine Personaktiv-/Eintritt-/ITZeitfilter dieser UDF. Beide Ausweisfelder werden exportiert, unabhängig Terminal_UseTransponder2 (hier nicht gelesen).

SaldenTerminalFiliale oder …Pep: ITZeit mit 28 Tagen Vorlauf, SaldoTerminal<>0 und Filialzugehörigkeit bzw. SaldoTerminal2. Quelle<>0 akzeptiert zusätzlich ITPEP/PepGruppen-Filiale, verlangt Transponderlänge>4. Gesamtsaldo = frühere TagesSaldo bei LaufenderSaldo1 + Personen.KorrekturSaldo; Urlaub = Ansprüche Jahre⇐jetzt minus Verbrauch; FS aktuellesJahr; Angerechnet/Anwesend ab DatumSaldo/Terminal_DatumAb bis heute. Keine Berechnung, nur vorhandene Daten verdichten. Saldenquelle0 liefert AnwesendCutKZNetto, andereQuelle Anwesend.

Anwendungsordner/Datafox, Encoding.Default und Tab getrennt, keine Quotes/Escapes:

• PersonalstammPZE_ID.txt: Transponder + Name links20, bei Fehler links18+' *'. Vorher löschen, bei leerem Resultat keine Datei.
• Salden_ID.txt (vorher löschen) oder Append an Personalstammdatei: pro Ausweis/gewähltem Bit eine Textzeile: 'S: Stunden0.00', 'S: Angerechnet0.00', 'U: Urlaub0.0', 'FS: FSganzzahlig', 'A: NzLong(Anwesend)0.00', 'Fehler: kulturabhängigesDatum'. Zwei Ausweisfelder, aber Fehlerliste nur erstes.
• Anwesenheit_ID.txt: Transponder + 1/0 gemäß DF_Anwesenheit (letzte24h/Now+10min, nurK=anwesend).
• Relative Tätigkeit.txt: ID achtstellig + Bezeichnung links20; Ersatz '00000000'+Tab+'DUMMY'. SQL-IN-Liste aus Uhren.Kostenstellen durch Semikolon→Komma, nicht parameterisiert.
• Nachrichten.txt wird durch ExportNachrichten nur gelöscht, nicht neu erzeugt. Kein aktiver Nachrichtenliefervertrag.

TransponderTrim/Length gelten wie oben. Salden mit SaldoInStamm können an alte/stale Stammdatei angefügt werden, wenn Personenexport deaktiviert ist. LeereAuswahl garantiert keine leereGeräteliste, weil fehlende Datei übersprungen wird.

SaldenTerminalFilialePep liefert keinen Transponder2, VB liest ihn dennoch im zweifachen Ausweisloop: konkrete Resultat-/Codeabweichung. Beide Salden-UDFs verwenden ITZeit.aktiv=1; vorhandene Migration0183 belegt IsAktiv, kein hier als garantiert installiert behauptetes aktiv-Feld. IsAnwesend-Status wird geliefert, aber nicht als eigeneSaldoausgabe geschrieben.

Bit16 setzt sc.CommandText auf TERM_Liste_Fehler und stellt ihn vor der nächsten Uhreniteration nicht zurück. Weitere Uhren können dadurch Fehlerresultat statt Saldenresultat erhalten. Fehlerliste braucht biszu3 negativeStatusdaten jePerson und liefert nurTransponder/Datum. Vorangegangene erzeugte Dateien bleiben bei Exportfehler bestehen.

DoUploadStamm kann durch ExportSalden überschrieben werden; ExportFalse deaktiviert eine Liste, wird nicht als globales Fehlersignal gesammelt. ExportTaetigkeit liefert selbst im Catch True. success entspricht letzter Uploadschleife, frühere Gerätfehler können durch spätereErfolge verdeckt werden. SQL_TIMEOUT wird für diese DB-Reads nicht gesetzt.

Upload lädt Geräte-Listenbeschreibung (fest Bus254), leert lokalen Bibliothekspuffer und ordnet Listen nach Index zu:0 Stamm,1 Salden,2 Tätigkeit,3 Nachrichten,4 Anwesenheit. Feldzahl/-längen kommen aus Setup, nicht aus Feldnamen. Tabfile mit Encoding.Default, RemoveEmptyEntries; Zeilenbeginn ';' wird übersprungen. Leere Zeile kann line(0) fehlschlagen. Werte kürzer als Feldlänge werden NUL-gepaddet, längere nicht abgeschnitten; Zeichenzahl wird als native Bytezahl übergeben. Setup-/Codepage-/Marshalingkompatibilität bleibt Geräteabnahme.

DFCMakeListe stellt Bibliothekspuffer her; DFCLoadListen(1,254,…) überträgt diesen. Hersteller groupsetuplists.html: vorhandene Geräteliste erst nach erfolgreicher Übernahme ersetzt. Code verschiebt Inputdatei jedoch schon VOR LoadListen auf Filename+'_' (vorheriges '_' löschen). Gleiches File beim nächsten Lauf wird übersprungen, selbst wenn vorheriger Geräteupload fehlgeschlagen ist. Diese lokale Markierung beweist keinen Geräteempfang.

Upload kann bei c=0 True liefern, auch bei Open-/Checkfehler oder fehlender Datei. Kein Returnwert von GetListDefinition geprüft, gemeinsam globale STL-Strukturen. Keine Gesamttransaktion über Dateien/Geräte/LastGet. com.log im Anwendungsordner wird angefügt; relative Inputpfade können bei anderem CWD auf andere Dateien zeigen.

Gemeinsames Profil: LEGACY (interne Referenz).

Defaults sind keine Livewerte. Melde-/Datei-/DB-Wirkungen sind nicht atomar.

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.

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.

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.

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/<ID> 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.

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.

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.

Siehe auch: Übersicht der Schnittstellen. Keine Ausführung oder Codekorrektur.