Benutzer-Werkzeuge

Webseiten-Werkzeuge


schnittstellen:1321

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

Link zu der Vergleichsansicht

schnittstellen:1321 [2026/11/18 11:17] – angelegt - Externe Bearbeitung 127.0.0.1schnittstellen:1321 [2026/11/18 16:58] (aktuell) – Externe Bearbeitung 127.0.0.1
Zeile 29: Zeile 29:
   - Eine Buchung wird über **Person, Datum, Uhrzeit auf die Sekunde und Kommen/Gehen** erkannt. Terminal und Kommentar können abweichen. Gleiche Zeilen innerhalb des gelieferten Tages werden zusammengefasst. Bei einem aktiven Treffer bleiben die PEP-ID, die WebZerf-Zuordnung und das ursprüngliche Terminal erhalten.   - Eine Buchung wird über **Person, Datum, Uhrzeit auf die Sekunde und Kommen/Gehen** erkannt. Terminal und Kommentar können abweichen. Gleiche Zeilen innerhalb des gelieferten Tages werden zusammengefasst. Bei einem aktiven Treffer bleiben die PEP-ID, die WebZerf-Zuordnung und das ursprüngliche Terminal erhalten.
   - Bei exakter Übereinstimmung hat eine aktive Buchung Vorrang. Danach prüft PEP eine wegen Fristablaufs gelöschte Buchung und anschließend ein ausdrücklich storniertes Ereignis. Nur eine durch Fristablauf gelöschte Buchung kann dadurch wieder aktiv werden. Eine bereits als in SAP entfallen abgeschlossene ID (Status 4) ist vom Abgleich ausgeschlossen.   - Bei exakter Übereinstimmung hat eine aktive Buchung Vorrang. Danach prüft PEP eine wegen Fristablaufs gelöschte Buchung und anschließend ein ausdrücklich storniertes Ereignis. Nur eine durch Fristablauf gelöschte Buchung kann dadurch wieder aktiv werden. Eine bereits als in SAP entfallen abgeschlossene ID (Status 4) ist vom Abgleich ausgeschlossen.
-  - Hat sich die Buchungszeit in PEP inzwischen geändert, prüft PEP zusätzlich die ursprüngliche SAP-Fassung, die gespeicherte Vergleichsfassung und die letzte ausgegebene Fassung. Verweisen die passenden Werte eindeutig auf dieselbe PEP-ID, erzeugt die alte SAP-Zeile keine Kopie und überschreibt die aktuelle Korrektur nicht. Eine Bestätigung der aktuellen Fassung setzt voraus, dass deren Uhrzeit und Kennung übereinstimmen.+  - Hat sich die Buchungszeit oder Buchungsart unter derselben PEP-ID geändert, vergleicht der Import jede SAP-Zeile mit den tatsächlich vorhandenen Buchungen. Liefert SAP für dieselbe Sekunde Kommen und Gehen, können beide Ereignisse vorhanden sein.
   - Fehlt eine Zuordnung, legt PEP das gelieferte Ereignis an. Fehlt umgekehrt eine zuvor bestätigte, seither unveränderte Buchung im neueren Stand ihres Tages, erhält sie Status 4 und das Löschkennzeichen. Eine lokale Buchung oder ein unbestätigter Altversand bleibt bei dieser Prüfung erhalten. Für einen aktuellen, noch unbestätigten Versand gilt die Fristregel.   - Fehlt eine Zuordnung, legt PEP das gelieferte Ereignis an. Fehlt umgekehrt eine zuvor bestätigte, seither unveränderte Buchung im neueren Stand ihres Tages, erhält sie Status 4 und das Löschkennzeichen. Eine lokale Buchung oder ein unbestätigter Altversand bleibt bei dieser Prüfung erhalten. Für einen aktuellen, noch unbestätigten Versand gilt die Fristregel.
  
-Das CSV enthält keine eindeutige externe Ereignis-ID. Eine frühere, inzwischen mehrfach überschriebene Zwischenfassung lässt sich daher unter Umständen keiner PEP-ID mehr zuordnen. PEP übernimmt ein solches Ereignis nach den normalen Importregeln. Ein daraus entstehender fachlicher Konflikt wird bei der Zeitberechnung sichtbar.+Das CSV enthält keine eindeutige externe Ereignis-ID. Liefert SAP neben einer lokalen Korrektur auch die frühere Buchungszeit, kann eine zusätzliche Buchung entstehen. Ein fachlicher Konflikt wird bei der Zeitberechnung sichtbar.
  
 ===== SAP-Status und Wirksamkeit ===== ===== SAP-Status und Wirksamkeit =====
  
-''Zeitereignisse.SapSync'' beschreibt den Stand der Buchungsfassung gegenüber SAP. Für die Zeitberechnung zählt zusätzlich ''geloescht'': Eine von SAP bestätigte Zeit kann beispielsweise durch ein ausdrückliches Web-Storno bereits unwirksam sein.+Der SAP-Status bezieht sich auf die Buchungsfassung in der Schnittstellentabelle. Ohne passenden Vergleichsstand gilt die lokale Fassung als Status 0. Für die Zeitberechnung zählt zusätzlich das Löschkennzeichen der Buchung. Auch ein von SAP bestätigtes Ereignis kann durch ein ausdrückliches Web-Storno unwirksam sein.
  
 ^ Wert ^ Bezeichnung für die Anzeige ^ Bedeutung und nächster Übergang ^ ^ Wert ^ Bezeichnung für die Anzeige ^ Bedeutung und nächster Übergang ^
Zeile 61: Zeile 61:
 | 5 | SAP löscht 08:00 und liefert im neueren Tagesstand weiterhin 08:10 und 17:00. | Die bestätigte 4712 fehlt, bekommt Status 4 und ''geloescht=1''. Auch 4711 bleibt storniert. 17:00 ist weiterhin aktiv. Eine nun fehlende Kommen-Buchung betrifft die Berechnung dieses Tages. | | 5 | SAP löscht 08:00 und liefert im neueren Tagesstand weiterhin 08:10 und 17:00. | Die bestätigte 4712 fehlt, bekommt Status 4 und ''geloescht=1''. Auch 4711 bleibt storniert. 17:00 ist weiterhin aktiv. Eine nun fehlende Kommen-Buchung betrifft die Berechnung dieses Tages. |
  
-Wird eine bereits manuell angelegte WebZerf-Buchung nochmals bearbeitet, kann die Korrektur dieselbe ID behalten. Wurde 08:00 schon ausgegeben und ist die aktuelle Fassung inzwischen 07:55, kann PEP die alte 08:00 über die gespeicherte Versandfassung erkennen. Die lokale 07:55 bleibt erhalten und bekommt bei ihrer eigenen Ausgabe eine neue Frist.+Wird eine bereits manuell angelegte WebZerf-Buchung nochmals bearbeitet, kann die Korrektur dieselbe ID behalten. War 08:00 schon ausgegeben und ist die aktuelle Zeit inzwischen 07:55, gibt PEP 07:55 als geänderte Fassung aus. Liefert SAP beide Zeiten, werden beide als eigenständige Buchungen berücksichtigt.
  
 ==== Eine andere Person löst den Fristablauf aus ==== ==== Eine andere Person löst den Fristablauf aus ====
Zeile 78: Zeile 78:
   * Zu einer alten PEP-ID kennt die Migration nur die Auswahl für einen früheren SAP-Export. Die Buchung steht mit 08:30 Kommen in PEP und erhält Status 5. Auch nach drei Tagen ohne Rückmeldung bleibt sie bestehen. Liefert SAP 08:30, geht sie auf 2 und kann bei späterem Fehlen im vollständigen Tag auf 4 wechseln. Wird die lokale Zeit stattdessen zuvor auf 08:25 geändert, startet mit der Ausgabe der geänderten Fassung der reguläre Ablauf bei 1.   * Zu einer alten PEP-ID kennt die Migration nur die Auswahl für einen früheren SAP-Export. Die Buchung steht mit 08:30 Kommen in PEP und erhält Status 5. Auch nach drei Tagen ohne Rückmeldung bleibt sie bestehen. Liefert SAP 08:30, geht sie auf 2 und kann bei späterem Fehlen im vollständigen Tag auf 4 wechseln. Wird die lokale Zeit stattdessen zuvor auf 08:25 geändert, startet mit der Ausgabe der geänderten Fassung der reguläre Ablauf bei 1.
  
-===== Tabellen und Felder ab Update 922 =====+===== Wo speichert PEP den SAP-Stand? =====
  
-Die dauerhaften Angaben zur einzelnen Buchung stehen in ''dbo.Zeitereignisse''. Die SQL-Prozeduren des Imports und Exports pflegen sie innerhalb ihrer Transaktionen. Dafür werden keine Trigger benötigt.+Die eigentliche Buchung steht in ''Zeitereignisse''. Ihre Person, Buchungszeit, Buchungsart und ihr Löschkennzeichen sind für die Zeitberechnung maßgeblich. Die SAP-Schnittstelle führt ihren eigenen Stand in ''SCHNITT_ZalarisTevenTag''.
  
-^ Feld in dbo.Zeitereignisse ^ Verwendung ^ +^ Eintrag ^ Inhalt und Verwendung ^ 
-| ''ID'', ''FremdID'' | ''ID'' identifiziert das Ereignis in PEP. ''FremdID'' kann die zugeordnete Web-ID enthalten. Eine bestätigte Rücklieferung behält die bestehende PEP-ID. | +| Personentag | Person, Tag und Erstellungszeit der jüngsten verarbeiteten SAP-Datei. So kann eine ältere Lieferung den Tagesbestand nicht zurücksetzen. | 
-| ''PersonID'', ''Datum'', ''Kennung'' | Aktuelle Buchung. ''Datum'' enthält Tag und Uhrzeit, ''Kennung'' enthält für diese Schnittstelle K oder G. | +| Einzelne Buchung | PEP-ID, Person, Buchungsdatum mit Uhrzeit, Kommen/Gehen und SAP-Status. Beim Versand merkt sich PEP zusätzlich den UTC-Zeitpunkt für die offene 48-Stunden-Frist. | 
-| ''Terminal'', ''Kommentar'', ''Filiale'' | Eine neue SAP-Buchung erhält die konfigurierte PEP-Uhr, gegebenenfalls die externe Terminal-ID als Kommentar und bei eindeutiger zeitlicher Zuordnung die Filiale aus ''ITORGA''. Ein Treffer auf eine vorhandene Buchung behält deren Terminal. | +| Lokale Buchung ohne SAP-Kontakt | Sie benötigt keinen Eintrag in der Schnittstellentabelle. Ein späterer Export erkennt sie anhand der Auswahlregeln. |
-| ''geloescht'', ''ts'' | Löschkennzeichen und lokaler Änderungszeitpunkt. ''geloescht=1'' nimmt die Buchung aus der wirksamen Zeitberechnung. | +
-| ''SapSync'' | ''tinyint NOT NULL DEFAULT 0''. Zulässige Werte 0 bis 5, siehe Statustabelle. | +
-| ''SapGesendetUtc'' | ''datetime2(3)'', optional. Zeitpunkt der Bereitstellung für die laufende Versandfrist in UTC. | +
-| ''SapSyncDatum'', ''SapSyncKennung'' | ''datetime'' und ''char(1)'', optional. Zeitpunkt des Ereignisses und Kennung der Vergleichsfassung. Bei 5 ist dies der für den Altversand übernommene Vergleichsstand. | +
-| ''SapUrsprungDatum'', ''SapUrsprungKennung'' | ''datetime'' und ''char(1)'', optional. Der zugeordnete SAP-Ursprung hilft, wiederholte Zeilen nach einer lokalen Änderung wiederzuerkennen. Bei geändertem SAP-Tagesstand kann PEP diesen Bezug anpassen. | +
-| ''SapVersandDatum'', ''SapVersandKennung'' | ''datetime'' und ''char(1)'', optional. Letzte bekannte ausgegebene Buchungszeit samt Kennung. Bei einem Export am Montag um 09:00 UTC einer Freitagsbuchung um 08:00 steht hier Freitag 08:00. Montag 09:00 UTC steht in ''SapGesendetUtc''. | +
-| ''SapAltversandAm'' | ''datetime'', optional. Historischer Auswahlzeitpunkt aus ''SCHNITT_Zeitereignis_Out.ts'', unverändert in lokaler SQL-Server-Zeit übernommen. Er startet keine Frist. |+
  
-^ Weitere Tabelle ^ Aufgabe ^ +Beim Kundenupdate von Stand 918 übernimmt PEP vorhandene Buchungen aus der bisherigen Versandauswahl als **5 – Altversand**. Für diese Buchungen läuft keine Versandfrist. Das Update legt alle SAP-Felder direkt in der Schnittstellentabelle an.
-| ''dbo.SCHNITT_ZalarisTevenTag'' | Ein Datensatz je ''PersonID'' (bigint) und ''Tag'' (date), gemeinsam Primärschlüssel. ''Lieferstand'' (datetime2(0)) speichert den jüngsten verarbeiteten Dateistand. Die Tabelle enthält keine einzelnen Zeitereignisse. | +
-| ''dbo.Personen'', ''dbo.ITORGA'' | Prüfung der Personalnummer und Ermittlung der am Buchungstag gültigen Filialzuordnung. | +
-| ''dbo.Uhren'', ''dbo.EinstellungenZw'' | Update 920 richtet die Zalaris-Uhr ein. ''SCHNITT_ZALARIS_TERMINALID'' verweist auf die gültige interne Uhr für neue Importbuchungen. Der XML-Ausgang verwendet den gesonderten Einstellwert ''SCHNITT_ZAL_ZE_TERMINAL''. | +
-| ''dbo.Schnitt_WebZerfPeer'' | Enthält die WebZerf-Zuordnung und die importierte Revision. Damit kann der Export auch eine zurückgemeldete WebZerf-Buchung mit internem Terminal 0 erkennen. | +
-| ''dbo.CStatus'' | Tagesstatus der Zeitberechnung. Importierte Tage und durch Fristablauf geänderte Tage werden zur Nachberechnung vorgemerkt. | +
- +
-==== Übernahme der früheren Tabellen ==== +
- +
-Update 921 übernimmt bei vorhandener Vorabfassung die Liefer- und Zuordnungsdaten aus ''SCHNITT_ZalarisTevenLieferung'' und ''SCHNITT_ZalarisTevenZuordnung'' und entfernt diese Tabellen. Für nachweislich ausgegebene aktuelle Fassungen ohne überlieferten Versandzeitpunkt beginnt die Frist bei dieser Übernahme. +
- +
-Update 922 übernimmt die historische Auswahlzeit aus ''SCHNITT_Zeitereignis_Out'' und die letzte je PEP-ID protokollierte Ausgabe aus ''SCHNITT_ZalarisTevenAusgabe'', soweit sie der Person zugeordnet werden kann. Ein reiner ID-Nachweis ergibt Status 5, sofern kein neuerer Stand vorliegt. Eine nachweislich aktuelle aktive Versandfassung mit bekanntem Versandzeitpunkt kann als Status 1 übernommen werden. Bereits bestätigte, abgelaufene, entfallene oder zwischenzeitlich geänderte Fassungen behalten ihren fachlichen Stand. Erst nach der Übernahme entfernt die Migration beide Ausgangstabellen innerhalb derselben Transaktion. Die aktuelle Schnittstelle führt kein separates dauerhaftes Buchungs- oder Versandverzeichnis.+
  
 ===== Dateiergebnis, Archiv und Nachberechnung ===== ===== Dateiergebnis, Archiv und Nachberechnung =====
Zeile 111: Zeile 93:
 Die SQL-Prozedur ''dbo.SCHNITT_ZALARIS_TEVEN'' speichert Ereignisse, Tagesstände und Vormerkungen zusammen. Nach erfolgreichem Datenbank-Commit verschiebt der Import die Datei in ''IMP'' unter dem Eingangspfad. Fehler bei Format, unbekannter Personalnummer, Datenbankzugriff oder Archivierung erscheinen im Schnittstellenprotokoll. Bei bereits belegtem Archivnamen vergleicht PEP den Inhalt. Abweichender Inhalt unter demselben Namen ist ein Fehler. Ein erneuter Lauf nach einem Archivierungsfehler kann dank des gespeicherten Lieferstands einen bereits übernommenen Tag wiedererkennen. Die SQL-Prozedur ''dbo.SCHNITT_ZALARIS_TEVEN'' speichert Ereignisse, Tagesstände und Vormerkungen zusammen. Nach erfolgreichem Datenbank-Commit verschiebt der Import die Datei in ''IMP'' unter dem Eingangspfad. Fehler bei Format, unbekannter Personalnummer, Datenbankzugriff oder Archivierung erscheinen im Schnittstellenprotokoll. Bei bereits belegtem Archivnamen vergleicht PEP den Inhalt. Abweichender Inhalt unter demselben Namen ist ein Fehler. Ein erneuter Lauf nach einem Archivierungsfehler kann dank des gespeicherten Lieferstands einen bereits übernommenen Tag wiedererkennen.
  
-Nach Abschluss des Imports berechnet PEP die vorgemerkten Bereiche je Person über ''CalcZeitAuswahl''. Ein Fehler bei einer einzelnen Nachberechnung macht den abgeschlossenen Dateiimport nicht fehlerhaft. Weitere Personen werden bearbeitet. Für die Nachverfolgung ist der Tagesstatus maßgeblich. Ein reiner Berechnungsfehler gehört weder in das Schnittstellenprotokoll noch in das PEP3-Log.+Die Schnittstelle merkt die betroffenen Tage direkt beim Speichern vor. Dafür muss kein Datenbanktrigger eingerichtet werden. Nach Abschluss des Imports berechnet PEP die vorgemerkten Bereiche je Person über ''CalcZeitAuswahl''. Ein Fehler bei einer einzelnen Nachberechnung macht den abgeschlossenen Dateiimport nicht fehlerhaft. Weitere Personen werden bearbeitet. Für die Nachverfolgung ist der Tagesstatus maßgeblich. Ein reiner Berechnungsfehler gehört weder in das Schnittstellenprotokoll noch in das PEP3-Log.
  
 **Technische Grundlage.** Desktop-Klassen ''cSchnittZalarisZeitereignisse'' und ''cSchnittZalZeitOut'', SQL-Prozeduren ''SCHNITT_ZALARIS_TEVEN'' und ''Get_SCHNITT_Zeitereignisse'', Datenbankupdates ''0920'' bis ''0922''. Die SQL-Prüffälle für Wiederholung, Webkorrektur, Fristablauf und Migration liegen im Desktop-Projekt unter ''tests/WebZerfSync''. Der beschriebene Stand wurde mit isolierten Prüfdaten abgeglichen. Die produktive SAP-Gegenstelle war nicht Teil der Prüfung. **Technische Grundlage.** Desktop-Klassen ''cSchnittZalarisZeitereignisse'' und ''cSchnittZalZeitOut'', SQL-Prozeduren ''SCHNITT_ZALARIS_TEVEN'' und ''Get_SCHNITT_Zeitereignisse'', Datenbankupdates ''0920'' bis ''0922''. Die SQL-Prüffälle für Wiederholung, Webkorrektur, Fristablauf und Migration liegen im Desktop-Projekt unter ''tests/WebZerfSync''. Der beschriebene Stand wurde mit isolierten Prüfdaten abgeglichen. Die produktive SAP-Gegenstelle war nicht Teil der Prüfung.
  
schnittstellen/1321.1794997021.txt.gz · Zuletzt geändert: von 127.0.0.1

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki