Planungscode Differenz Export: Unterschied zwischen den Versionen

Markierung: 2017-Quelltext-Bearbeitung
Markierung: 2017-Quelltext-Bearbeitung
 
(78 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
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 als Text-Datei exportiert.
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 [[Krankenstands-Dashboard#Datenaustausch_mit_der_Lohnverrechnung|Datenaustausch mit der Lohnverrechnung]] beim [[Krankenstands-Dashboard]] verwendet.
Dieser Export wird zum [[Krankenstands-Dashboard#Datenaustausch_mit_der_Lohnverrechnung|Datenaustausch mit der Lohnverrechnung]] beim [[Krankenstands-Dashboard]] verwendet.


== Aufruf der Funktion ==
Das Ergebnis des '''Planungscode-Differenz Export''' kann in folgender Form ausgegeben werden:
* Als [[#anchorSearchResult|Suchergebnis]] der gefundenen Differenzen je Export
* als formatierte [[#anchorExportFile|Textdatei]]


* Rechtsklick in Reiter Systemeinstellungen: SAP/BI Planungscodes-Export ausführen
==Aufruf der Funktion==
oder
{{AlexBild|Funktionsaufruf über das Kontextmenü in den Systemeinstellungen|[[Datei:Planungscode Differenz Export 1673532293543.png|400px]]|}}
* automatisch einmal am Tag durch Daemon zur einstellbaren Stunde


== Ausgangssituation ==
== Ausgangssituation ==
Zeile 15: Zeile 16:
* welche Zeitbereich er betrachten muss.
* welche Zeitbereich er betrachten muss.
** Heute minus 3 Monate bis Morgen 00:00
** Heute minus 3 Monate bis Morgen 00:00
** Variante: <code>Systemeinstellungen: SAP/BI Export: zukünftige Planungscodes exportieren</code>: Heute minus 3 Monate bis in alle Zukunft
** [[Planungscode_Differenz_Export#Parametrierung|Variante: Zukünftige Planungscodes exportieren]]: Heute minus 3 Monate bis in alle Zukunft
* welche Planungscodes er exportieren muss.  
* [[Planungscode_Differenz_Export#Parametrierung|welche Planungscodes er exportieren muss.]]
** <code>Systemeinstellungen: SAP/BI Export: Planungscodes</code>
* welche Personen er berücksichtigen muss.  
* welche Personen er berücksichtigen muss.  
** gesamtes Personal im System
** gesamtes Personal im System
** einstellbar: <code>Personal: SAP/BI Export: SAP/BI Export Planungscodes aktiv</code>: Ja/Nein vererbt
** [[Planungscode_Differenz_Export#Parametrierung|zusätzlich einstellbar vererbt am Personal]]
* welche Planungscodes für das einzelne Personal beim Export zuvor exportiert wurden.
** welche Planungscodes für das einzelne Personal beim Export zuvor exportiert wurden.


== Funktionsbeschreibung ==
== Funktionsbeschreibung ==
Zeile 33: Zeile 33:
** werden '''ignoriert'''
** 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 [[Planungscode_Differenz_Export#Echtzeitkomponente|Echtzeitkomponente]]
** VARIANTE: werden falls sich das exportierte Bis-Datum geändert hat '''gelöscht''' und mit neuem Bis-Datum '''neu eingefügt''', mehr unter [[Planungscode_Differenz_Export#Echtzeitkomponente|Echtzeitkomponente]]
* Nicht Deckungsgleiche Überschneidungen von PREVIOUS und CURRENT: '''PREVIOUS''' wird '''gelöscht''', '''CURRENT''' wird '''eingefügt'''.
* ansonsten: '''PREVIOUS''' wird '''gelöscht''', '''CURRENT''' wird '''eingefügt'''.
* CURRENT ist in PREVIOUS nicht vorhanden: '''CURRENT''' wird '''eingefügt'''.
* PREVIOUS ist in CURRENT nicht vorhanden: '''PREVIOUS''' wird '''gelöscht'''.


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


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.
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 und eine Änderung in der Schnittstelle kann notwendig werden.
Verlagern sich offene Zeitbereiche durch verstreichen von Zeit in die Vergangenheit, kann sich dieses Bis-Datum ohne getätigte Änderung des Planungscode ändern.


==== Beispiel ====
Diese eventuelle Änderung des Bis-Datum ist in der Schnittstelle dann sichtbar.
 
==== Beispiel 4: Änderung des Bis-Datum ====


  31.12.9999 == inf
  31.12.9999 == inf
Zeile 213: Zeile 214:
           +;E;0-4;K
           +;E;0-4;K
  Previous: E -> K -> {[0-4;4]}
  Previous: E -> K -> {[0-4;4]}
== Zeitraum erweitern<ref name="issue7926">{{githubissue|7926}}</ref>==
Für Spezialfälle gibt es eine Sonderabrechnung "Zeitraum erweitern", mit der man einen exisitierenden Zeitraum um einen angrenzenden Tag verlängern kann, ohne dass an dem betroffenen Tag ein Planungscode eingetragen wird.
Achtung: Diese Sonderabrechnung darf nur an direkt angrenzende Planungscode-Zeiträume eingetragen werden
[[Planungscode_Differenz_Export#Genehmigungsverfahren|Parametrierung]]
==== Beispiel 5: Verlängerung des Zeitraums ====
Der Mitarbeiter meldet sich am Abend des zweiten Tages, nach seinem regulären Dienst, krank.
Hier soll auch der der Tag 2 als "Krank" exportiert werden, damit dies mit der Krankmeldung zusammenpasst, jedoch darf am betroffenen Tag kein Krankenstand eingetragen werden.
Ausgangssituation:   
Tag | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
---------------------------------------------
    |  |  |  | K | K |  |  |  |  |  |
'Export wird durchgeführt'
Ergebnis: +;E;3-4;K
Situation mit erweitertem Zeitraum: 
S = Sonderabrechnung
Tag | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
---------------------------------------------
    |  |  | S | K | K |  |  |  |  |  |
'Export wird durchgeführt'
Ergebnis: -;E;3-4;K
          +;E;2-4;K
== 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.
{{AlexBild|Anzeige der zuletzt exportierten Daten|[[Datei:Planungscode Differenz Export 1674481927307.png|400px]]|}}
====Planungscode-Differenz-Export====
Über diesen Navigatorpunkt können alle bisher erstellten Exporte angezeigt und erneut abgerufen werden.
{{AlexBild|Übersicht aller bisherigen Exporte|[[Datei:Planungscode Differenz Export 1674482187168.png|400px]]|}}
==== <span id="anchorSearchResult"/>Ergebnis eines Planungscode-Differenz-Export als Suche<ref name="issue10254">{{githubissue|10254}}</ref>====
Mittels Rechtsklick und Auswahl des Menüpunkts "Ergebnis für Quellexport" werden die Daten des Exports in einem neuen Reiter aufgelistet
{{AlexBild|Ergebnis eines Exports|[[Datei:Planungscode Differenz Export 1674482550348.png|400px]]|}}
====Personalebene<ref name="issue10254">{{githubissue|10254}}</ref><ref name="issue8079">{{githubissue|8079}}</ref>====
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.
{{AlexBild|Historie eines Personals|[[Datei:Planungscode Differenz Export 1674485152654.png|400px]]|}}
== <span id="anchorExportFile" />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.
{{AlexBild|Erneutes Ausführen eines Exports|[[Datei:Planungscode Differenz Export 1674482424111.png|400px]]|}}
===Über Server-Daemon===
Der Export einmal täglich mittels Server-Daemon ist nach Aktivierung von [[Intern:Bfx.Alex.ExportToSAPBI.Model.dll|Export_SAP-BI]] über [[Export_SAP-BI#Parametrierung|Export_SAP-BI Parametrierung]] <code>Planungscodes: automatisch exportieren</code> möglich.
Mit <code>Beginn zur Stunde</code> kann gewählt werden, wann der Export durchgeführt wird.
===Mögliche Formate===
Nach Aktivierung von nach Aktivierung von [[Intern:Bfx.Alex.ExportToSAPBI.Model.dll|Export_SAP-BI]] sind folgende Formate unter [[Export_SAP-BI#Parametrierung]] einstellbar:
*SAP "PTEX2000-Schnittstellentabelle"
*IPIS-Lohnverrechnung
Standardmäßig wird das SAP-Schnittstellenformat verwendet. Das IPIS-Schnittstellenformat kann über <code>IPIS: Format verwenden</code> aktiviert werden.
====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 [[Planungscode_Differenz_Export#Parametrierung|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 <ref name="issue6648">{{githubissue|6648}}</ref>====
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 [[Planungscode_Differenz_Export#Parametrierung|Parametrierung]]
=====Daten=====
Trennzeichen ";" zwischen den Feldern
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
====LOGA-Format <ref name="issue8147">{{githubissue|8147}}</ref>====
Aktivierung:
Bfx.Alex.ExportPlanSymbolDifferenceToLOGA.Model.dll
Schnittstellenfomat für LOGA 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 [[Planungscode_Differenz_Export#Parametrierung|Parametrierung]]
=====Daten =====
Trennzeichen ";" zwischen den Feldern
Feld 1:        ZEITENKAL          fix "[ZEITENKAL]"
Feld 2:        FUNKTION            "DELETE" für "-", "INSERT" für "+"
Feld 3:        ZK_UNIQID          Eindeutige ID der Export-Zeile
Feld 4:        ZK_HER              fix "IMPVAR1"
Feld 5-6:      leer  
Feld 7:        LV_MANDANT          LOGA-Mandant
Feld 8:        LV_ABRKREIS        LOGA-Abrechnungskreis
Feld 9:        PERSONAL_NR        Personalnummer
Feld 10-11:    leer  
Feld 12:      LV_VERTRAGSNUMMER  LOGA-Vertragsnummer
Feld 13:      ZK_VON              JJJJMMTT Beginn-Datum der Abwesenheit
Feld 14:      ZK_BIS              JJJJMMTT Ende-Datum der Abwesenheit
Feld 15-18:    leer               
Feld 19:      ZK_SYMBOL          JJJJMMTT Ende-Datum der Abwesenheit
Feld 20:      ZK_PLANAN          fix "I"
Feld 21-57:    leer               
Feld 58:      EAU_ZABRUF          fix "1"
Feld 59:      EAU_AABRUF          fix "v"
Feld 60:      leer
===Parametrierung===
====Systemeinstellungen====
{{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
*'''Planungscode:''' Zu übermittelnde Planungscodes
** Hier kann ein externes Kennzeichen vergeben werden, dass sich vom [[Planungscode#Plansymbol f.C3.BCr Export|Plansymbol für Export]] unterscheidet.
***Dies kann beispielsweise notwendig sein, wenn ein Planungscode nicht im Abwesenheitsexport anzuführen ist, jedoch im Planungscode-Differenz Export enthalten sein soll.<ref name="issue10243">{{githubissue|10243}}</ref>
****Plansymbol für Export: leer lassen
****Externe Kennzeichen: gewünschtes Kennzeichen vergeben
*'''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)
====Genehmigungsverfahren====
{{AlexBild|Genehmigungsverfahren|[[Datei:Planungscode Differenz Export 1677664671074.png|500px]]}}
*'''Zeitbereich erweitern mit Sonderabrechnung:''' Hier muss die Sonderabrechnung "Zeitbereich erweitern" hinterlegt werden, damit ein Zeitbereich aus diesem Genehmigungsverfahren erweiterbar ist.
==Fußnoten==
<references />

Aktuelle Version vom 2. August 2024, 08:48 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]}

Zeitraum erweitern[1]

Für Spezialfälle gibt es eine Sonderabrechnung "Zeitraum erweitern", mit der man einen exisitierenden Zeitraum um einen angrenzenden Tag verlängern kann, ohne dass an dem betroffenen Tag ein Planungscode eingetragen wird.

Achtung: Diese Sonderabrechnung darf nur an direkt angrenzende Planungscode-Zeiträume eingetragen werden

Parametrierung

Beispiel 5: Verlängerung des Zeitraums

Der Mitarbeiter meldet sich am Abend des zweiten Tages, nach seinem regulären Dienst, krank. Hier soll auch der der Tag 2 als "Krank" exportiert werden, damit dies mit der Krankmeldung zusammenpasst, jedoch darf am betroffenen Tag kein Krankenstand eingetragen werden.

Ausgangssituation:     
Tag | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
---------------------------------------------
    |   |   |   | K | K |   |   |   |   |   |

'Export wird durchgeführt'

Ergebnis: +;E;3-4;K

Situation mit erweitertem Zeitraum:  
S = Sonderabrechnung
Tag | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
---------------------------------------------
    |   |   | S | K | K |   |   |   |   |   |

'Export wird durchgeführt'

Ergebnis: -;E;3-4;K
          +;E;2-4;K

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

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

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

Über Server-Daemon

Der Export einmal täglich mittels Server-Daemon ist nach Aktivierung von Export_SAP-BI über Export_SAP-BI Parametrierung Planungscodes: automatisch exportieren möglich.

Mit Beginn zur Stunde kann gewählt werden, wann der Export durchgeführt wird.

Mögliche Formate

Nach Aktivierung von nach Aktivierung von Export_SAP-BI sind folgende Formate unter Export_SAP-BI#Parametrierung einstellbar:

  • SAP "PTEX2000-Schnittstellentabelle"
  • IPIS-Lohnverrechnung

Standardmäßig wird das SAP-Schnittstellenformat verwendet. Das IPIS-Schnittstellenformat kann über IPIS: Format verwenden aktiviert werden.

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 [4]

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
Trennzeichen ";" zwischen den Feldern
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

LOGA-Format [5]

Aktivierung:

Bfx.Alex.ExportPlanSymbolDifferenceToLOGA.Model.dll

Schnittstellenfomat für LOGA 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
Trennzeichen ";" zwischen den Feldern
Feld 1:        ZEITENKAL           fix "[ZEITENKAL]"
Feld 2:        FUNKTION            "DELETE" für "-", "INSERT" für "+"
Feld 3:        ZK_UNIQID           Eindeutige ID der Export-Zeile
Feld 4:        ZK_HER              fix "IMPVAR1"
Feld 5-6:      leer 	   
Feld 7:        LV_MANDANT          LOGA-Mandant
Feld 8:        LV_ABRKREIS         LOGA-Abrechnungskreis
Feld 9:        PERSONAL_NR         Personalnummer
Feld 10-11:    leer 	   
Feld 12:       LV_VERTRAGSNUMMER   LOGA-Vertragsnummer
Feld 13:       ZK_VON              JJJJMMTT Beginn-Datum der Abwesenheit
Feld 14:       ZK_BIS              JJJJMMTT Ende-Datum der Abwesenheit
Feld 15-18:    leer                
Feld 19:       ZK_SYMBOL           JJJJMMTT Ende-Datum der Abwesenheit
Feld 20:       ZK_PLANAN           fix "I"
Feld 21-57:    leer                
Feld 58:       EAU_ZABRUF          fix "1"
Feld 59:       EAU_AABRUF          fix "v"
Feld 60:       leer

Parametrierung

Systemeinstellungen

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
    • Hier kann ein externes Kennzeichen vergeben werden, dass sich vom Plansymbol für Export unterscheidet.
      • Dies kann beispielsweise notwendig sein, wenn ein Planungscode nicht im Abwesenheitsexport anzuführen ist, jedoch im Planungscode-Differenz Export enthalten sein soll.[6]
        • Plansymbol für Export: leer lassen
        • Externe Kennzeichen: gewünschtes Kennzeichen vergeben
  • 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)

Genehmigungsverfahren

Genehmigungsverfahren
Planungscode Differenz Export 1677664671074.png
  • Zeitbereich erweitern mit Sonderabrechnung: Hier muss die Sonderabrechnung "Zeitbereich erweitern" hinterlegt werden, damit ein Zeitbereich aus diesem Genehmigungsverfahren erweiterbar ist.

Fußnoten