Planungscode Differenz Export: Unterschied zwischen den Versionen

Keine Bearbeitungszusammenfassung
Markierung: 2017-Quelltext-Bearbeitung
Keine Bearbeitungszusammenfassung
Markierung: 2017-Quelltext-Bearbeitung
Zeile 270: Zeile 270:


=== Parametrierung ===
=== Parametrierung ===
{{AlexBild|Systemeinstellungen Planungscode Differenz Export|[[Datei:Planungscode Differenz Export 1673539788417.png]]}}


*'''zukünftige Planungscodes exportieren''': Aktiviert auch die Übermittlung von zukünftigen, also noch nicht begonnenen, Krankenständen
*'''zukünftige Planungscodes exportieren''': Aktiviert auch die Übermittlung von zukünftigen, also noch nicht begonnenen, Krankenständen

Version vom 12. Januar 2023, 17:10 Uhr

Der Planungscode-Differenz Export ist eine Programmfunktion, die anhand eines fixen Zeitbereichs, der aktuell eingetragenen Planungscodes und der zuvor exportierten Planungscodes des Personals eine Differenz berechnet und diese ausgibt.

Soll die Ausgabe in Form einer Export-Datei erfolgen, z.B. wird dies zum Datenaustausch mit der Lohnverrechnung beim Krankenstands-Dashboard verwendet.

Aufruf der Funktion

Funktionsaufruf über das Kontextmenü in den Systemeinstellungen
Planungscode Differenz Export 1673532293543.png

Ausgangssituation

Damit der Export seine Eingabedaten sammeln kann muss er wissen,

Funktionsbeschreibung

Der Planungscode-Differenz Export kann sich jetzt pro Personal, zu exportierenden Planungscode und Zeitbereich die aktuelle Zeitleiste (in der Folge CURRENT) berechnen. Dann vergleicht er die berechnete Zeitleiste mit der zuvor exportierten (in der Folge PREVIOUS) für dieses Personal und diesen Planungscode.

Es gibt folgende Entscheidungsmöglichkeiten:

  • Deckungsgleiche Überschneidungen von PREVIOUS und CURRENT:
    • werden ignoriert
    • VARIANTE: werden falls sich das exportierte Bis-Datum geändert hat gelöscht und mit neuem Bis-Datum neu eingefügt, mehr unter Echtzeitkomponente
  • ansonsten: PREVIOUS wird gelöscht, CURRENT wird eingefügt.

Deckungsgleiche Überschneidungen werden weitergeschrieben, neu Eingefügte werden weitergeschrieben und bilden die Basis für den nächsten Export. Gelöschte verfallen.

Änderungen bei Planungscodes außerhalb des exportierten Zeitbereiches werden nicht berücksichtigt.

Jeder Planungscode und Zeitbereich der neu eingefügt wird bekommt eine eindeutige Nummer, um ihn beim Löschen referenzieren zu können. Bei den nachfolgenden Beispielen wird diese eindeutige Nummer aus Gründen der Einfachheit nicht berücksichtigt.

Beispiele

Zur Vereinfachung betrachten wir ein System mit einem Personal (E), einem Planungscode (K) und exportiertem Zeitbereich (Tag 0-9)

Beispiel 1: Einfacher Ablauf

Situation zum Zeitpunkt t:
Tag | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
---------------------------------------------
    |   |   |   |   |   |   |   |   |   |   |

'Export wird durchgeführt'

Ergebnis: <leer>
Previous: E -> K -> {}
 
Situation zum Zeitpunkt t + 1:
Tag | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
---------------------------------------------
    | K | K |   |   |   |   |   |   |   |   |

'Export wird durchgeführt'

Ergebnis: +;E;0-1;K
Previous: E -> K -> {[0-1]}

Situation zum Zeitpunkt t + 2:
Tag | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
---------------------------------------------
    | K | K |   |   |   |   |   |   |   |   |

'Export wird durchgeführt'

Ergebnis: <leere Datei>
Previous: E -> K -> {[0-1]}

Situation zum Zeitpunkt t + 3:
Tag | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
---------------------------------------------
    | K | K |   |   | K | K | K |   |   |   |

'Export wird durchgeführt'

Ergebnis: +;E;4-6;K
Previous: E -> K -> {[0-1],[4-6]}

Situation zum Zeitpunkt t + 4:
Tag | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
---------------------------------------------
    | K | K |   |   | K | K | K | K |   |   |

'Export wird durchgeführt'

Ergebnis: -;E;4-6;K
          +;E;4-7;K
Previous: E -> K -> {[0-1],[4-7]}

Situation zum Zeitpunkt t + 5:
Tag | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
---------------------------------------------
    | K | K | K | K | K | K | K | K |   |   |

'Export wird durchgeführt'

Ergebnis: -;E,0-1;K
          -;E,4-7;K
          +;E,0-7;K
Previous: E -> K -> {[0-7]}

Situation zum Zeitpunkt t + 6:
Tag | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
---------------------------------------------
    |   |   |   |   |   |   |   |   |   |   |

'Export wird durchgeführt'

Ergebnis: -;E;0-7;K
Previous: E -> K -> {}

Beispiel 2: Planungscodes vollständig außerhalb exportiertem Zeitraum

Situation zum Zeitpunkt t:
Tag |-3 |-2 |-1 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
---------------------------------------------
    | K | K | K |   |   |   |   |   |   |   |   |   |   |

'Export wird durchgeführt'

Ergebnis: <leer>
Previous: E -> K -> {}
 
Situation zum Zeitpunkt t + 1:
Tag |-3 |-2 |-1 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
---------------------------------------------
    | K |   | K |   |   |   |   |   |   |   |   |   |   |

'Export wird durchgeführt'

Ergebnis: <leer>
Previous: E -> K -> {}

Beispiel 3: Planungscodes teilweise außerhalb exportiertem Zeitraum

Situation zum Zeitpunkt t:
Tag |-3 |-2 |-1 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
---------------------------------------------
    | K | K | K | K | K |   |   |   |   |   |   |   |   |

'Export wird durchgeführt'

Ergebnis: +;E;-3-1;K
Previous: E -> K -> {[-3-1]}
 
Situation zum Zeitpunkt t + 1:
Tag |-3 |-2 |-1 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
---------------------------------------------
    | K |   | K | K | K |   |   |   |   |   |   |   |   |

'Export wird durchgeführt'

Ergebnis: -;E;-3-1;K
          +;E;-1-1;K
Previous: E -> K -> {[-1-1]}

Situation zum Zeitpunkt t + 1:
Tag |-3 |-2 |-1 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
---------------------------------------------
    | K |   | K |   |   |   |   |   |   |   |   |   |   |

'Export wird durchgeführt'

Ergebnis: -;E;-1-1;K
Previous: E -> K -> {}

Echtzeitkomponente

Diese Vorgehensweise ist zurzeit Standard.

Es wird zu jedem exportiertem Zeitbereich das exportierte Bis-Datum gespeichert. Im Normalfall ist dieses ident dem Bis-Datum des exportierten Zeitbereichs.

Manche Lohnverrechnungssyteme verlangen, Zeitbereiche die noch nicht vollständig in der Vergangenheit liegen, als offen zu exportieren. Für diese Systeme wird als exportiertes Bis-Datum der 31.12.9999 gespeichert. Ist beim betreffenden Mitarbeiter bereits eine Inaktivzeit oder ein Austritt erfasst, so wird stattdessen das Datum der letzten Stammzuteilung eingetragen.

Verlagern sich offene Zeitbereiche durch verstreichen von Zeit in die Vergangenheit, kann sich dieses Bis-Datum ohne getätigte Änderung des Planungscode ändern.

Diese eventuelle Änderung des Bis-Datum ist in der Schnittstelle dann sichtbar.

Beispiel 4: Änderung des Bis-Datum

31.12.9999 == inf
 
Situation zum Zeitpunkt t:
Export am:        *        
Tag | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
---------------------------------------------
    | K | K | K | K | K |   |   |   |   |   |

'Export wird durchgeführt'

Ergebnis: +;E;0-inf;K
Previous: E -> K -> {[0-4;inf]}

Situation zum Zeitpunkt t + 1:
Export am:                    *        
Tag | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
---------------------------------------------
    | K | K | K | K | K |   |   |   |   |   |

'Export wird durchgeführt'

Ergebnis: -;E;0-inf;K
          +;E;0-4;K
Previous: E -> K -> {[0-4;4]}

Export als Datei

Für gefundene Differenzen können Dateien in den unten angeführten Formaten expotiert werden. Es werden nur Dateien für Differenzen erzeugt. Falls es von einem Export zum Nächsten keine Differenz gibt wir keine Datei erzeugt.

Interaktiv

Automatisch

SAP

Schnittstellenformat zur Kommunikation mit SAP-"PTEX2000-Schnittstellentabelle". Pro gefundenem Mandant wird eine Datei erzeugt. Der Dateiname hat die Form

<MANDANT>_<INTERNE_ID_DES_EXPORTS>_<ZEITSTEMPEL_DES_EXPORT>.<ENDUNG>

und liegt im eingestellten Verzeichnis.

Siehe Parametrierung

Header

In jeder Datei:

MANDT;LOGSYS;AWTYP;AWKEY;STOKZ;PERNR;INFTY;SUBTY;BEGDA;ENDDA

Daten

Trennzeichen ";" zwischen den Feldern
Feldname:             Kurzzeichen:   Beschreibung:
-----------------------------------------------------------------------------------
Mandant               MANDT          Alphanum. Bezeichnung (für jeden Mandanten wird ein eigenes Export-File erstellt)
Logisches System      LOGSYS         AWTYP + MANDT
Referenzvorgang       AWTYP          ALEX
Referenzschlüssel     AWKEY          Eindeutige ID der Export-Zeile (wird zum stornieren benötigt)
Stornokennzeichen     STOKZ          "X" für "-", leer für "+"
Personalnummer        PERNR          Alphanum. Personalnummer
Infotyp               INFTY          2001
Subtyp                SUBTY          Planungscode: Abw-Kennzeichen für Export
Gültigkeitsbeginn     BEGDA          TT.MM.JJJJ Beginn-Datum der Abwesenheit
Gültigkeitsende       ENDDA          TT.MM.JJJJ Ende-Datum der Abwesenheit (siehe Anmerkung unterhalb)

IPIS [1]

Schnittstellenfomat für IPIS Lohnverrechnung. Pro gefundenem Mandant wird eine Datei erzeugt. Der Dateiname hat die Form

<MANDANT>_<INTERNE_ID_DES_EXPORTS>_<ZEITSTEMPEL_DES_EXPORT>.<ENDUNG>

und liegt im eingestellten Verzeichnis.

Siehe Parametrierung

Daten

Id-Feld                ID_FELD (29)         besteht aus: 
                                            KZ_AEND(1): Stornokennzeichen "L" für "-", "A" für "+"
                                            SB(8): aus "IPIS: Property für 'LV Bedienernummer für Schnittstelle'" 
                                            DAT(10): Datum der Schnittstellenerzeugung
                                            ZEIT(10): Zeit der Schnittstellenerzeugung (leer)
                                            ZEIT(10): Zeit der Schnittstellenerzeugung (leer)
Standort                BZ(14)              "IPIS: Property für 'LV Standort für Schnittstelle'"
Personalnummer          PNR(11)             in der Form "5   XXXXXXX", wobei "XXXXXXX" die 7 Zeichen lange Alphanum. Personalnummer ist
Gültigkeitsbeginn       V_DAT(8)            JJJJMMTT Beginn-Datum der Abwesenheit
Gültigkeitsende         B_DAT(8)            JJJJMMTT Ende-Datum der Abwesenheit
Planungscode            ART(max 4)          Planungscode: Abw-Kennzeichen für Export
 der Rest der Schnittstellenfelder wird leer übermittelt

Parametrierung

Systemeinstellungen Planungscode Differenz Export
Planungscode Differenz Export 1673539788417.png
  • zukünftige Planungscodes exportieren: Aktiviert auch die Übermittlung von zukünftigen, also noch nicht begonnenen, Krankenständen
  • Planungscode: Zu übermittelnde Planungscodes
  • Verhalten Export stundenweiser Planungscode:
    • nie: Stundenweise eingetragene Planungscodes werden im Epxort nicht berücksichtigt
    • immer ganzer Tag: Stundenweise eingetragene Planungscodes werden im Export berücksichtigt
    • erst ab halbe 'Sollzeit vortragen': Stundenweise eingetragene Planungscodes werden im Export berücksichtigt, wenn die Dauer des eingetragenen Planungscodes mindestens die halbe Sollzeit beträgt (Sollzeit = Summe der 'Sollzeit vortragen' Zeibtereiche, hinterlegt beim jeweiligen Dienst)
  • aktiv: Aktiviert die Übermittlung der Planungscodes ab dem gewählten Stichtag (auch auf Planungseinheit und Bereich verfügbar)

Fußnoten

  • Issues:
  1. #8071 SALK: K-Schnittstelle IPIS