PEP4

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Zuletzt angesehen:
schnittstellen:6042

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

Link zu der Vergleichsansicht

schnittstellen:6042 [2026/10/05 09:24] – Schnittstelle 6042 Leistung berechnen dokumentieren codexschnittstellen:6042 [2026/10/05 09:45] (aktuell) – V3-Mitarbeiterleistung und PEP-Dokumentation aktualisieren codex
Zeile 1: Zeile 1:
 ====== Schnittstelle 6042: Leistung berechnen ====== ====== Schnittstelle 6042: Leistung berechnen ======
  
-Dokumentiert / statisch geprüft: **05.10.2026**. Nutzer- und Laufzeitprüfung offen. Die Beschreibung bezieht sich auf den Git-Quellstand ''master/82ed7631f286853b62c92baa22c871abfcca7c04''; eine installierte Version oder Datenbank wurde nicht geprüft.+Dokumentiert: **05.10.2026**. Der Schnittstellen-Einstieg wurde statisch gegen den Git-Quellstand ''master/82ed7631f286853b62c92baa22c871abfcca7c04'' geprüft. Die V3-Prozedur wurde getrennt davon in einer Dev-Datenbank getestet; eine produktive Installation und der Aufruf über die Schnittstelle wurden nicht geprüft.
  
 ===== Zweck und Geltungsbereich ===== ===== Zweck und Geltungsbereich =====
  
 Das Programm ''CalcLeistung = 6042'' erstellt einen gespeicherten Leistungsstand der Version ''V3'' für einen Stichtag. Es berücksichtigt die **91 Kalendertage davor**, nicht den Stichtag selbst. Es handelt sich um eine interne Berechnung mit Datenbankzugriff, nicht um einen Dateiimport oder Export. Das Programm ''CalcLeistung = 6042'' erstellt einen gespeicherten Leistungsstand der Version ''V3'' für einen Stichtag. Es berücksichtigt die **91 Kalendertage davor**, nicht den Stichtag selbst. Es handelt sich um eine interne Berechnung mit Datenbankzugriff, nicht um einen Dateiimport oder Export.
 +
 +Die [[wissen:mitarbeiter_leistung_v3|fachliche Erklärung der Mitarbeiterleistung V3]] zeigt, warum umsatzstarke Gruppen-Tage stärker zählen und wo die Tagesbewertung ihre Grenzen hat.
  
 Die Registrierung nennt das Programm „Leistung Berechnen“ in der Gruppe ''Calc''. Manueller Aufruf und Automatik sind vorgesehen. Das belegt noch keinen eingerichteten Job und keinen erfolgreichen Lauf. Die Registrierung nennt das Programm „Leistung Berechnen“ in der Gruppe ''Calc''. Manueller Aufruf und Automatik sind vorgesehen. Das belegt noch keinen eingerichteten Job und keinen erfolgreichen Lauf.
Zeile 20: Zeile 22:
 Der Aufruf verwendet ''DATUM'' als Stichtag und startet ''MitarbeiterLeistung13WochenSpeichern''. Die Prozedur liest positive Iststunden je Person und Gruppe, Verkäuferumsatz aus ''UmsatzVK'' und Gruppenumsatz aus ''Umsätze''. Zur Gruppenzuordnung nutzt sie zunächst die Umsatzgruppe, danach eine eindeutige Istgruppe und zuletzt eine eindeutige Plangruppe. Fehlende oder mehrdeutige Grundlagen können die Bewertung eines Tages verhindern. Der Aufruf verwendet ''DATUM'' als Stichtag und startet ''MitarbeiterLeistung13WochenSpeichern''. Die Prozedur liest positive Iststunden je Person und Gruppe, Verkäuferumsatz aus ''UmsatzVK'' und Gruppenumsatz aus ''Umsätze''. Zur Gruppenzuordnung nutzt sie zunächst die Umsatzgruppe, danach eine eindeutige Istgruppe und zuletzt eine eindeutige Plangruppe. Fehlende oder mehrdeutige Grundlagen können die Bewertung eines Tages verhindern.
  
-Ein bewertbarer Gruppen-Tag vergleicht den persönlichen Bruttoumsatz mit dem nach Iststunden verteilten Gruppenumsatz. Wenn keine Gruppe bewertbar ist, versucht die Prozedur für Person und Tag eine Bewertung auf Filialebene. Der Index einer Person beträgt ''100 × bewerteter Bruttoumsatz / erwarteter Bruttoumsatz''. Ohne eigene bewertbare Umsätze **und** ohne Iststunden kann der Mittelwert der berechneten Personenindizes zugewiesen werden. Sonst bleibt der Index leer und erhält die Quelle ''nicht bewertbar''.+Ein bewertbarer Gruppen-Tag vergleicht den persönlichen Bruttoumsatz mit dem nach Iststunden verteilten Gruppenumsatz. Wenn keine Gruppe bewertbar ist, versucht die Prozedur für Person und Tag eine Bewertung auf Filialebene. Der Index einer Person beträgt ''100 × Summe bewerteter Bruttoumsätze / Summe erwarteter Bruttoumsätze''. Die erwarteten Umsätze werden **über alle bewertbaren Gruppen-Tage und gegebenenfalls Filial-Tage addiert**. Dadurch zählen Tage mit hohem Vergleichsumsatz stärker als ruhige Tage: Der Index ist kein ungewichteter Durchschnitt von Tages- oder Wochenwerten. Innerhalb eines Gruppen-Tags verteilt die aktuelle V3-Fassung den Tagesumsatz nach Iststunden; sie gewichtet einzelne Uhrzeiten noch nicht nach Tageskurve oder Stundenumsatz. Ohne eigene bewertbare Umsätze **und** ohne Iststunden kann der Mittelwert der berechneten Personenindizes zugewiesen werden. Sonst bleibt der Index leer und erhält die Quelle ''nicht bewertbar''.
  
 Die Prozedur aktualisiert veränderte Personenzeilen, fügt neue hinzu und entfernt zum gleichen Stichtag und zur Version ''V3'' nicht mehr vorhandene Personen. Der Abgleich läuft in einer Datenbanktransaktion. Wenn im Fenster überhaupt keine Person mit Umsatz gefunden wird, meldet SQL einen Fehler und lässt den gespeicherten Stand unverändert. Die Datenbankprozedur liefert Diagnoseergebnisse; die Schnittstelle zeigt diese nicht einzeln an, weil sie ''ExecuteNonQuery'' verwendet. Die Prozedur aktualisiert veränderte Personenzeilen, fügt neue hinzu und entfernt zum gleichen Stichtag und zur Version ''V3'' nicht mehr vorhandene Personen. Der Abgleich läuft in einer Datenbanktransaktion. Wenn im Fenster überhaupt keine Person mit Umsatz gefunden wird, meldet SQL einen Fehler und lässt den gespeicherten Stand unverändert. Die Datenbankprozedur liefert Diagnoseergebnisse; die Schnittstelle zeigt diese nicht einzeln an, weil sie ''ExecuteNonQuery'' verwendet.
  
 Die Zeitraumautomatik kann den gespeicherten V3-Stand bei der Leistungsquelle „Berechnet“ verwenden. Sie wählt den jüngsten Stichtag bis zum Planungsbeginn beziehungsweise bis heute. Fehlt ein passender Stand, kann die Planung mit einer Fehlermeldung abbrechen. Die Schnittstelle 6042 startet die Planung nicht selbst. Die Zeitraumautomatik kann den gespeicherten V3-Stand bei der Leistungsquelle „Berechnet“ verwenden. Sie wählt den jüngsten Stichtag bis zum Planungsbeginn beziehungsweise bis heute. Fehlt ein passender Stand, kann die Planung mit einer Fehlermeldung abbrechen. Die Schnittstelle 6042 startet die Planung nicht selbst.
 +
 +===== Weiterführende Themen =====
 +
 +  * [[wissen:mitarbeiter_leistung_v3|Mitarbeiterleistung V3 fachlich verstehen]]
 +  * [[tutorial:pep_zeitraumautomatik|Den gespeicherten Index in PlanGenie verwenden]]
  
 ===== Fehler und Prüfgrenzen ===== ===== Fehler und Prüfgrenzen =====
Zeile 30: Zeile 37:
 **⚠ Statischer Codebefund:** Bei fehlendem oder ungültigem ''DATUM'' meldet die Datumsroutine einen Fehler. Der neue Einstieg prüft ihren Rückgabewert derzeit nicht und versucht dennoch den SQL-Aufruf. Außerdem trägt der Protokollkontext einen offenbar fremden Modulnamen aus einer ZW-Transfer-Schnittstelle. Diese Befunde sind keine bestätigten Produktionsfehler. **⚠ Statischer Codebefund:** Bei fehlendem oder ungültigem ''DATUM'' meldet die Datumsroutine einen Fehler. Der neue Einstieg prüft ihren Rückgabewert derzeit nicht und versucht dennoch den SQL-Aufruf. Außerdem trägt der Protokollkontext einen offenbar fremden Modulnamen aus einer ZW-Transfer-Schnittstelle. Diese Befunde sind keine bestätigten Produktionsfehler.
  
-Erfolg im Schnittstellenprotokoll zeigt, dass der SQL-Aufruf ohne gemeldete Ausnahme beendet wurde. Die Zahl bewerteter Personen und die fachliche Qualität des Index werden vom VB-Einstieg nicht geprüft. Prüfe dafür die gespeicherten Zeilen, den Stichtag, die Version und die Diagnose der SQL-Prozedur. Für diese Dokumentation wurden keine Echtdaten verarbeitet und kein Lauf ausgeführt.+Erfolg im Schnittstellenprotokoll zeigt, dass der SQL-Aufruf ohne gemeldete Ausnahme beendet wurde. Die Zahl bewerteter Personen und die fachliche Qualität des Index werden vom VB-Einstieg nicht geprüft. Prüfe dafür die gespeicherten Zeilen, den Stichtag, die Version und die Diagnose der SQL-Prozedur. Ein Dev-Test bestätigte die Berechnung und Speicherung von direkten Indizes sowie Mittelwerten bei fehlender Istzeit. Das bestätigt die Prozedur auf einer Testdatenbank, nicht den Aufruf über die Schnittstelle oder die Datenlage anderer Kunden.
  
 ===== Technische Quellen ===== ===== Technische Quellen =====
Zeile 38: Zeile 45:
   * [[https://github.com/seegerstefan/pep4desktop/blob/82ed7631f286853b62c92baa22c871abfcca7c04/Sqlfiles/PEP4Update/update_0896.sql|Tabellenmigration]]   * [[https://github.com/seegerstefan/pep4desktop/blob/82ed7631f286853b62c92baa22c871abfcca7c04/Sqlfiles/PEP4Update/update_0896.sql|Tabellenmigration]]
  
-Stand: 05.10.2026 · Statische Quellenanalyse; kein Laufzeit- oder Produktivschema-Nachweis.+Stand: 05.10.2026 · Schnittstellen-Einstieg statisch geprüft, V3-Prozedur in Dev getestet; kein Produktivschema-Nachweis.
  
schnittstellen/6042.txt · Zuletzt geändert: von codex
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki