Import Monatswerte: Unterschied zwischen den Versionen

Aktuelle Version vom 19. August 2024, 12:56 Uhr

Der Import Monatswerte ist eine Programmfunktion, die Monats-Sonderabrechnungen aus einer speziell formatierten Textdatei importiert.

Dieser Import wird zum initialen Festlegen von Startwerten bei Neuinbetriebnahmen verwendet.

Das Ergebnis des Import Monatswerte ist eine Auflistung von Logeinträgen bei Importproblemen.

Aufruf der Funktion

Über Kontextmenü der Systemeinstellungen:

Import Monatswerte

Ausgangssituation

Damit der Import die Monatsextras setzen kann benötigt er:

Eine Datei im entsprechenden Importformat
Eine Sonderabrechnung mit der Verwendung Monat
Einen Stichtag
- Die Pläne müssen zum gewählten Stichtag im Status "nicht erzeugt", "Planung" oder "Ist" sein.

Das System muss gesperrt sein.

Der ausführende Benutzer muss Supervisor-Berechtigungen besitzen und während einer Sperre einsteigen können.

Import Monatswerte Einstellungen

Format der Importdatei

Personalnummer;Wert für Sonderabrechnung(Zeilenumbruch)

2 Felder mit jeweils beliebiger Länge (Trennzeichen ";")
Kommastellen sind nicht zwingend erforderlich
Dezimaltrennzeichen = "." oder ","
Am Zeilenende muss ein Zeilenumbruch erfolgen

Beispiel:

12345555;10.00
12344444;-10.00
12399;5.32

Funktionsbeschreibung

Der Import Monatswerte setzt für jede Zeile in der Importdatei die angegebene Sonderabrechnung zum Monatsersten auf den importierten Wert.

Folgende Fehler können für eine Zeile auftreten:

Für Personalnummer wird kein Personal gefunden
Personal hat zum Stichtag keine Stationszuteilung
Plan bereits im Status Abgeschlossen

Die Fehler werden nach erfolgtem Import mit Zeilennummer ausgewiesen.

Bei Fehlerfreiem Import ist das Ergebnis leer.

Es muss vom Benutzer gespeichert werden!

@@ Zeile 1: / Zeile 1: @@
-==technische Voraussetzungen==
+Der '''Import Monatswerte''' ist eine [[Programmfunktion]], die '''Monats-Sonderabrechnungen''' aus einer speziell formatierten Textdatei importiert.
-* Modul "Import_Extra_Monat.BfxMODULES" muss importiert sein
+Dieser Import wird zum initialen Festlegen von Startwerten bei Neuinbetriebnahmen verwendet.
-* zu importierende Datei (aus Fremdsystem) muss vorhanden sein --> [[Satzaufbau für Import Monatswerte]]
-:* pro Sonderabrechnung muss es eine eigene Importdatei geben
-==Ablaufbeschreibung==
+Das Ergebnis des '''Import Monatswerte''' ist eine Auflistung von Logeinträgen bei Importproblemen.
-* Einstieg in ALEX mit einem Benutzer mit Supervisor-Berechtigung
-: Es ist möglich, eine Anmelde-Sperre für ALEX (="Shutdown") einzugeben, um sicherzustellen, dass kein Personal durch andere ALEX-Benutzer "gesperrt" ist.
-: In diesem Fall muss bei dem ALEX-Benutzer, mit dem der Import ausgeführt werden soll, der Parameter "Einstieg während Sperre" einmalig auf JA gesetzt werden.
-* im Navigator bei "Import Monatswerte" auf "Grünes Plus" klicken
-:* "Bezeichnung"
-::: freier Text
-:* "Importdatei"
-::: hier Dateipfad auswählen (muss zur nachfolgend gewählten Sonderabrechnung passen)
-:* "Monats-Sonderabrechnung"
-::: gewünschte Monats-Sonderabrechnung auswählen
-:* "Datum für Monats-Sonderabrechnung"
-::: hier das Datum des Monatsplans eingeben, auf den die Werte gesetzt werden sollen
-:::* Hinweis: Pläne müssen zum gewählten Zeitpunkt im Status "nicht erzeugt", "Planung" oder "Ist" befinden.
-:::: Sollte versucht werden, einen Datensatz für ein Personal einzuspielen, dessen Plan sich bereits im Status "Abgeschlossen" befindet, so kommt ein Hinweis im Import-Protokoll, dass dieser Datensatz nicht importiert werden konnte.
-:* "Import-Protokoll"
-::: Hier ist nichts zu tun - dieses Feld wird nach Klick auf "Ausführen" automatisch befüllt.
-:* "Ausführen"
-:* Neben "Import-Protokoll" muss der Text "Import OK" angezeigt werden, anderenfalls ist ein Problem aufgetreten.
-:: (Das Import-Protokoll wird auch als Text-Datei in jenem Ordner abgelegt, in dem sich die zuvor gewählte Importdatei befindet.)
-* Änderungen können bei Bedarf sofort in den Monatsplänen kontrolliert werden.
-* "Speichern" bzw. "Alles verwerfen" (alle Änderungen durch den Import werden wieder verworfen)
+==Aufruf der Funktion==
-Beispiel für erfolgreichen Import:
+Über Kontextmenü der Systemeinstellungen:
-[[datei:Import_Monatswerte_Neu.png]]
+{{AlexBild|Import Monatswerte|[[Datei:ImportMonatswerte.png|400px]]|}}
+== Ausgangssituation ==
-Beispiel für Import-Protokoll Datei:
+Damit der Import die Monatsextras setzen kann benötigt er:
-[[datei:Import_Monatswerte_Neu_Protokoll.png]]
+* Eine Datei im entsprechenden Importformat
+* Eine Sonderabrechnung mit der Verwendung '''Monat'''
+* Einen Stichtag
+** Die Pläne müssen zum gewählten Stichtag im Status "nicht erzeugt", "Planung" oder "Ist" sein.
-... diese Protokolldatei wird immer neu erzeugt. Bei einem fehlerfreien Import ist diese leer (0 KB).
+Das System muss gesperrt sein.
+Der ausführende Benutzer muss Supervisor-Berechtigungen besitzen und während einer Sperre einsteigen können.
-[[Kategorie:Funktionsübersicht]]
+{{AlexBild|Import Monatswerte Einstellungen|[[Datei:ImportMonatswerteEinstellungen.png|400px]]|}}
-[[Kategorie:Schnittstellen]]
+=== Format der Importdatei ===
+ Personalnummer;Wert für Sonderabrechnung(Zeilenumbruch)
+* 2 Felder mit jeweils beliebiger Länge (Trennzeichen ";")
+* Kommastellen sind nicht zwingend erforderlich
+* Dezimaltrennzeichen = "." oder ","
+* Am Zeilenende '''muss ein Zeilenumbruch''' erfolgen
+Beispiel:
+ 12345555;10.00
+ 12344444;-10.00
+;5.32
+==Funktionsbeschreibung==
+Der '''Import Monatswerte''' setzt für jede Zeile in der Importdatei die angegebene Sonderabrechnung zum Monatsersten auf den importierten Wert.
+Folgende Fehler können für eine Zeile auftreten:
+* Für Personalnummer wird kein Personal gefunden
+* Personal hat zum Stichtag keine Stationszuteilung
+* Plan bereits im Status '''Abgeschlossen'''
+Die Fehler werden nach erfolgtem Import mit Zeilennummer ausgewiesen.
+Bei Fehlerfreiem Import ist das Ergebnis leer.
+'''Es muss vom Benutzer gespeichert werden!'''