Planungscode Differenz Export: Unterschied zwischen den Versionen

Markierung: 2017-Quelltext-Bearbeitung
Markierung: 2017-Quelltext-Bearbeitung
Zeile 289: Zeile 289:
  Gültigkeitsende      ENDDA          TT.MM.JJJJ Ende-Datum der Abwesenheit (siehe Anmerkung unterhalb)
  Gültigkeitsende      ENDDA          TT.MM.JJJJ Ende-Datum der Abwesenheit (siehe Anmerkung unterhalb)


==== IPIS-Format <ref name="issue8071">{{githubissue|8071}}</ref>====
==== IPIS-Format <ref name="issue6648">{{githubissue|6648}}</ref>====


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

Version vom 25. Januar 2023, 14:58 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.

Dieser Export wird zum Datenaustausch mit der Lohnverrechnung beim Krankenstands-Dashboard verwendet.

Das Ergebnis des Planungscode-Differenz Export kann in folgender Form ausgegeben werden:

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]}

Auswertungsmöglichkeiten

Folgende Möglichkeiten gibt es um die exportierten Daten bzw. den aktuellen Stand aufzurufen.

vorheriger Planungscode-Differenz-Export

Über diesen Navigatorpunkt kann der aktuelle exportierte Stand abgerufen werden.

Dabei handelt es sich um die Referenz auf den sich der folgende Export bezieht. Es werden für alle betrachteten Personen Datensätze angelegt, auch wenn es keine Differenz gibt.

Anzeige der zuletzt exportierten Daten
Planungscode Differenz Export 1674481927307.png

Planungscode-Differenz-Export

Über diesen Navigatorpunkt können alle bisher erstellten Exporte angezeigt und erneut abgerufen werden.

Übersicht aller bisherigen Exporte
Planungscode Differenz Export 1674482187168.png

Ergebnis eines Planungscode-Differenz-Export als Suche

Mittels Rechtsklick und Auswahl des Menüpunkts "Ergebnis für Quellexport" werden die Daten des Exports in einem neuen Reiter aufgelistet

Ergebnis eines Exports
Planungscode Differenz Export 1674482550348.png

Personalebene[1]

Mittels Rechtsklick auf ein Personal und Auswahl des Menüpunkts "vorheriger Planungscode-Differenz-Export Zeitbereich für Personal", wird die komplette Historie für den gewählten Zeitraum angezeigt.

Historie eines Personals
Planungscode Differenz Export 1674485152654.png

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 wird keine Datei erzeugt.

Interaktiv

Mittels Rechtsklick auf einen Planungscode-Deifferenz-Export und Auswahl des Menüpunkts "SAP Planungscode-Differenz-Export ausführen" kann ein Export interaktiv ausgeführt und als Textdatei abgespeichert werden.

Erneutes Ausführen eines Exports
Planungscode Differenz Export 1674482424111.png

Automatisch

siehe Export_SAP-BI Parametrierung Planungscodes: automatisch exportieren

Mögliche Formate

SAP-Format

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-Format [2]

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)
  • ALTEN Planungscode-Differenz-Export Planungscodes verwenden: Parameter nur für Bestandskunden damit der Umstieg zeitlich bestimmt werden kann. (Default = Nein)[3]
  • aktiv: Aktiviert die Übermittlung der Planungscodes ab dem gewählten Stichtag (auch auf Planungseinheit und Bereich verfügbar)

Fußnoten

  • Issues: