Automatischer Konto-Report-Export: Unterschied zwischen den Versionen

Aktuelle Version vom 5. August 2024, 13:16 Uhr

Der automatische Konto-Report-Export ist eine Programmfunktion, die es ermöglicht einen Konto-Report periodisch am Server auszuführen.

Die durch den Konto-Report erzeugte Exportdatei wird auf einem Verzeichnis abgelegt und kann von dort zur weiteren Verarbeitung abgeholt werden.

Dies kann durch

direkten Zugriff über das Dateisystem oder
ein Webservice

erfolgen.

Anlage Konto-Report

Vorgehensweise zur Anlage eines neuen Konto-Reports:

Konto-Report aus Navigator mit grünem Plus erzeugen
Konto-Report umbenennen. (Wichtig für Name von automatisch exportierten Dateien)
Werteauswahl (Konten, Parameter, ...) durchführen
Den gewünschten Zeitmaßstab eintragen (für Konto-Report-Export meist Monat oder Tag).
Exporteinstellungen auswählen (einen Konto-Report-Export hinterlegen):

Exporteinstellung wählen

Weitere Informationen, wie ein Konto-Report angelegt wird, sind hier zu finden.

Testen Reports
1. Dazu im Reiter "Export" das gewünschte Exportfile angeben und mittels "Export herunterladen" die Datei auf dem Computer speichern. Es wird eine Zip Datei erstellt, in welcher sich die exportierte Datei befindet.
2. Alternativ kann die Datei direkt abgespeichert werden. Weitere Informationen, wie ein Konto-Report direkt abgespeichert wird, sind hier zu finden.

Anlage automatischer Konto-Report Export

Um dem Daemon-Prozess die zu exportierenden Konto-Reports mitzuteilen, müssen diese in den Systemeinstellungen eingetragen werden:

In Systemeinstellungen - Gruppe "Exporteinstellungen" - Eigenschaft "Automatische Kontoreport Exports" einen neuen Eintrag machen:

Automatischen Konto-Report Export anlegen

Im erzeugten "Automatischen Konto-Report-Export" können folgende Einstellungen getroffen werden:

Parameter	Wert
Konto-Report	auszuführender Konto-Report
Ressourcen	Ressource (Bereich, Planungseinheit), für welche der Konto-Report ausgeführt wird. Keine Auswahl bedeutet "Systemweit", Personal bringt kein Ergebnis.
Ordner	Ordner für erstellte Dateien, falls nicht angegeben wird Ordner "AutomaticAccountsReportExport" im Ordner des Config-Files angelegt (Dateiname = Name des ausgewählten Konto-Report)
Monat in Vergangenheit (-1 für keine)	Anzahl der zu exportierenden Monate in die Vergangenheit, vom aktuellen Monat ausgehend. (0 für 1 Monat)
Monate in Zukunft	Anzahl der zu exportierenden Monate in die Zukunft, vom aktuellen Monat ausgehend
Fixes von-Datum	Konto-Report wird mit diesem von-Datum ausgeführt
Fixes bis-Datum	Konto-Report wird mit diesem bis-Datum ausgeführt
Beginn zur Stunde	Stunde, zu welcher der Konto-Report ausgeführt wird. Nur ganze Stunden möglich. Konto-Reports werden sequentiell ausgeführt. Dauer eines Konto-Reports kann den Beginn des Nächsten verschieben. Sind mehrere Konto-Reports zu selben Zeit geplant, werden diese nach Erstellungsreihenfolge abgearbeitet.
Dateiname ohne Zeitstempel	Exportierte Datei erhält keinen Zeitstempel und wird täglich überschrieben.
Nur aktuellen Tag exportieren	Konto-Report wird mit Zeitbereich "aktueller Tag" ausgeführt. Nur mit "Zeitmaßstab Tag" sinnvoll. (Verwendung: Export Kartennummer tagesaktuell)

Parametrierung Automatischer Konto-Report-Export

Hinterlegung des "Automatischen Konto-Report-Export" in Systemeinstellungen.

Parametrierung Automatischer Konto-Report-Export

Manueller Funktionstest

Ein manueller Funktionstest kann über einen Rechtsklick auf den Reiter des Automatischen Konto-Reports durchgeführt werden. Der Konto-Report wird in dem zuvor definierten Ordner abgelegt.

Automatischen Konto-Report Export testen

Mögliche technische Hindernisse können sein:

Der Benutzer, welcher den Alex-Dienst ausführt, hat andere Berechtigungen als der Benutzer, mit dem in Alex gearbeitet wird
Die Netzwerkfreigabe erlaubt keinen Schreibzugriff auf den angegebenen Ordner

Automatik testen

Der Konto-Report wird 1x täglich ausgeführt. Man kann daher den Parameter Beginn zur Stunde nicht auf eine spätere Uhrzeit stellen, sodass der Report nochmals ausgeführt wird.

Es besteht aber die Möglichkeit, einen weiteren Report anzulegen.

Achtung: Beim Starten des Dienstes wird der Report auch ausgeführt!

Bit Factory interne Zusatzinfos

Aktivierung

@@ Zeile 1: / Zeile 1: @@
-[[Konto-Report|Konto-Reports]] können automatisch ausgeführt werden. Das Ergebnis wird in einem definierten Laufwerk abgelegt.
+Der '''automatische Konto-Report-Export''' ist eine [[Programmfunktion]], die es ermöglicht einen [[Konto-Report]] periodisch am Server auszuführen.
-= Anlegen Konto-Report-Export =
+Die durch den Konto-Report erzeugte '''Exportdatei''' wird auf einem Verzeichnis abgelegt und kann von dort zur weiteren Verarbeitung abgeholt werden.
-Der Konto-Report-Export definiert das Format, wie die Daten exportiert werden.
+Dies kann durch
+* direkten Zugriff über das Dateisystem oder
+* ein [[Webservice_-_Automatischer_Konto-Report-Export|Webservice]]
+erfolgen.
-In den meisten Fällen existieren folgende Konto-Report-Export Möglichkeiten:
+===Anlage Konto-Report===
-* Standard-Export: exportiert den Konto-Report in tabellarischer Form in eine Datei
-* [[Konto-Report_Export_wie_%27Kopieren%27|Konto-Report Export wie 'Kopieren']]
-* evt. auch weitere, kundenspezifische Formate
-Falls das gewünschte Format noch nicht auswählbar ist, muss ein neuer Konto-Report-Export angelegt werden:
+Vorgehensweise zur Anlage eines neuen Konto-Reports:
-* [[Supervisoren_Kompaktübersicht_Windows#Navigatoransicht|Navigatoransicht]] auf Anpassungsansicht wechseln.
+#Konto-Report aus Navigator mit grünem Plus erzeugen
+#Konto-Report umbenennen. (Wichtig für Name von automatisch exportierten Dateien)
+#Werteauswahl (Konten, Parameter, ...) durchführen
+#Den gewünschten Zeitmaßstab eintragen (für Konto-Report-Export meist Monat oder Tag).
+#Exporteinstellungen auswählen (einen '''[[Konto-Report-Export]]''' hinterlegen):{{AlexBild|Exporteinstellung wählen|[[Datei:KR_export.png|550px]]|}} Weitere Informationen, wie ein Konto-Report angelegt wird, sind [[Konto-Report/Parametrierung|hier]] zu finden.
+#[[Konto-Report#Parametergruppe Export|Testen Reports]]
+##Dazu im Reiter "'''Export'''" das gewünschte Exportfile angeben und mittels "'''Export herunterladen'''" die Datei auf dem Computer speichern. Es wird eine Zip Datei erstellt, in welcher sich die exportierte Datei befindet.
+##Alternativ kann die Datei direkt abgespeichert werden.  Weitere Informationen, wie ein Konto-Report direkt abgespeichert wird, sind [[Konto-Report#Parametergruppe Export|hier]] zu finden.
-* Konto-Report-Export anlegen.
+===Anlage automatischer Konto-Report Export===
-{{AlexBild|Konto-Report-Export anlegen|[[Datei:KRE_anlegen.png|500px]]|}}
-* Die gewünschten Prozeduren hinterlegen. Die Prozeduren können in der Softwareentwicklung erfragt werden (Programmierung notwendig!)
-= Anlegen Konto-Report =
-Zuerst muss der zu exportierende Konto-Report erstellt und parametriert werden.
-Dazu wie folgt vorgehen:
-# Konto-Report aus Navigator mit grünem Plus erzeugen
-# Den gewünschten Zeitmaßstab eintragen. (Normalerweise Tag oder Monat)
-# Den zuvor angelegten oder bereits verfügbaren Konto-Report-Export auswählen.
-# Die gewünschten Konten auswählen. (zb.: Standardsummen: Soll, Total, Urlaubsrest)
-# Konto-Report umbenennen. (Wichtig für Name von automatisch exportierten Dateien)
-{{AlexBild|Konto-Report anlegen|[[Datei:KR_anlegen.png|550px]]|}}
-{{AlexBild|Zeitmaßstab wählen|[[Datei:KR_zeitmasstab.png|550px]]|}}
-{{AlexBild|Export wählen|[[Datei:KR_export.png|550px]]|}}
-{{AlexBild|Konten wählen|[[Datei:KR_werte.png|550px]]|}}
-{{AlexBild|Umbenennen|[[Datei:KR_rename.png|550px]]|}}
-Anschließend kann der Export getestet werden.
-Dazu einfach im Reiter "Export" das gewünschte Exportfile angeben. Danach noch Pläne (oder Personal bzw. Berufsgruppen) auswählen, Zeitbereich einstellen und auf "Ausführen" klicken.
-Ist alles richtig eingestellt, wird die angegebene Datei je nach eingestelltem Export gefüllt.
-= Anlegen automatischer Konto-Report Export =
 Um dem Daemon-Prozess die zu exportierenden Konto-Reports mitzuteilen, müssen diese in den Systemeinstellungen eingetragen werden:
@@ Zeile 52: / Zeile 29: @@
 {{AlexBild|Automatischen Konto-Report Export anlegen|[[Datei:AKRE_anlegen.png|550px]]|}}
-Danach müssen im erzeugten "Automatischen Konto-Report-Export" die gewünschten Einstellungen getroffen werden.
+Im erzeugten "Automatischen Konto-Report-Export" können folgende Einstellungen getroffen werden:
+{| class="wikitable"
+!Parameter!!Wert
+|-
+|Konto-Report||auszuführender Konto-Report
+|-
+|Ressourcen||Ressource (Bereich, Planungseinheit), für welche der Konto-Report ausgeführt wird. Keine Auswahl bedeutet "Systemweit", Personal bringt kein Ergebnis.
+|-
+|Ordner|| Ordner für erstellte Dateien, falls nicht angegeben wird Ordner "AutomaticAccountsReportExport" im Ordner des Config-Files angelegt (Dateiname = Name des ausgewählten Konto-Report)
+|-
+|Monat in Vergangenheit (-1 für keine)||Anzahl der zu exportierenden Monate in die Vergangenheit, vom aktuellen Monat ausgehend. (0 für 1 Monat)
+|-
+|Monate in Zukunft|| Anzahl der zu exportierenden Monate in die Zukunft, vom aktuellen Monat ausgehend
+|-
+|Fixes von-Datum||Konto-Report wird mit diesem von-Datum ausgeführt
+|-
+|Fixes bis-Datum|| Konto-Report wird mit diesem bis-Datum ausgeführt
+|-
+|Beginn zur Stunde||Stunde, zu welcher der Konto-Report ausgeführt wird. Nur ganze Stunden möglich. Konto-Reports werden sequentiell ausgeführt. Dauer eines Konto-Reports kann den Beginn des Nächsten verschieben.
+Sind mehrere Konto-Reports zu selben Zeit geplant, werden diese nach Erstellungsreihenfolge abgearbeitet.
+|-
+|Dateiname ohne Zeitstempel ||Exportierte Datei erhält keinen Zeitstempel und wird täglich überschrieben.
+|-
+|Nur aktuellen Tag exportieren||Konto-Report wird mit Zeitbereich "aktueller Tag" ausgeführt. Nur mit "Zeitmaßstab Tag" sinnvoll. (Verwendung: Export Kartennummer tagesaktuell)
+|}
-# Konto-Report auswählen
+{{AlexBild|Parametrierung Automatischer Konto-Report-Export|[[Datei:AutoReport FixerZeitbereich.png|300px]]|}}
-# Etwaige Ressourcen auswählen. (Falls nichts ausgewählt, gilt "Systemweit")
-# Ordner für erstellte Dateien. (Dateien heißen so wie der ausgewählte Konto-Report)
-# Beginn zur Stunde auswählen
-# Dateiname ohne Zeitstempel --> Wenn das File täglich ersetzt werden soll, auf JA setzen
-{{AlexBild|Parametrierung Automatischer Konto-Report-Export|[[Datei:Konto_Report_Export.PNG|450px]]|}}
 Hinterlegung des "Automatischen Konto-Report-Export" in Systemeinstellungen.
@@ Zeile 65: / Zeile 62: @@
 {{AlexBild|Parametrierung Automatischer Konto-Report-Export|[[Datei:AKRE_ok.png|450px]]|}}
-Ein manueller Funktionstest kann über einen Rechtsklick auf den Reiter durchgeführt werden. Der Konto-Report wird in dem zuvor definierten Ordner abgelegt.
+====Manueller Funktionstest====
-{{AlexBild|Automatischen Konto-Report Export testen|[[Datei:Automatischer Konto-Report-Export Test.png]]|}}
+Ein '''manueller Funktionstest''' kann über einen Rechtsklick auf den Reiter des Automatischen Konto-Reports durchgeführt werden. Der Konto-Report wird in dem zuvor definierten Ordner abgelegt.
-Mögliche technische Hindernisse können sein:
-* Der Benutzer, welcher den Alex-Dienst ausführt, hat andere Berechtigungen als der Benutzer, mit dem in Alex gearbeitet wird
-* Die Netzwerkfreigabe erlaubt keinen Schreibzugriff auf den angegebenen Ordner
-'''Es wird täglich zur definierten "Beginnstunde" eine Datei mit dem gewünschten Format auf das gewählte Verzeichnis gelegt.'''
+{{AlexBild|Automatischen Konto-Report Export testen|[[Datei:Automatischer Konto-Report-Export Test.png|400px]]|}}
-= Welche Exporteinstellung ist gerade ausgewählt? =
+Mögliche technische Hindernisse können sein:
-* Kontoreport auswählen
+*Der Benutzer, welcher den Alex-Dienst ausführt, hat andere Berechtigungen als der Benutzer, mit dem in Alex gearbeitet wird
-* In der Werkzeugleiste bei "Export - "Exporteinstellungen auswählen" auf den Pfeil klicken
+*Die Netzwerkfreigabe erlaubt keinen Schreibzugriff auf den angegebenen Ordner
-* Exporteinstellung anzeigen
-{{AlexBild|Exporteinstellungen|[[Datei:Exporteinstellungen.PNG]]|}}
+==== Automatik testen ====
+Der Konto-Report wird 1x täglich ausgeführt. Man kann daher den Parameter '''Beginn zur Stunde''' nicht auf eine spätere Uhrzeit stellen, sodass der Report nochmals ausgeführt wird.
-* Nun erscheint die Information
+Es besteht aber die Möglichkeit, einen weiteren Report anzulegen.
-{{AlexBild|Informationsfenster|[[Datei:Infotextt.PNG|150]]|}}
+Achtung: Beim Starten des Dienstes wird der Report auch ausgeführt!
 [[Kategorie:Neu ab Version 7.8]]
-= Anpassen von Configfile =
+===<span class="mw-headline">Bit Factory interne Zusatzinfos</span>===
+*[[Intern:Automatischer Konto-Report-Export Aktivierung|Aktivierung]]
- , "serverDaemonPlugins" :
-  { "1" : "Bfx.Alex.AccountsReport.Model.dll"
-  }
-Ist dieser Eintrag getätigt, wird beim Serverstart ein zusätzlicher Daemon-Prozess gestartet.
-= Tagesschnittstelle in Verbindung mit dem Automatischen Konto-Report-Export =
-Weiters können Tagesinformationen in Kombination mit dem "Automatischen Konto-Report-Export" aus '''Alex®''' exportiert werden. Nähere Informationen zu '''Export Tagesinformationen''' finden Sie [[Export_Tagesinformationen|hier]].
+<br />
 [[Kategorie:Funktionsübersicht]]