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.
+Der '''automatische Konto-Report-Export''' ist eine [[Programmfunktion]], die es ermöglicht einen [[Konto-Report]] periodisch am Server auszuführen.
-= Anlegen Konto-Report =
+Die durch den Konto-Report erzeugte '''Exportdatei''' wird auf einem Verzeichnis abgelegt und kann von dort zur weiteren Verarbeitung abgeholt werden.
-Zuerst muss der zu exportierende Konto-Report erstellt und parametrisiert werden.
+Dies kann durch
+* direkten Zugriff über das Dateisystem oder
+* ein [[Webservice_-_Automatischer_Konto-Report-Export|Webservice]]
+erfolgen.
-Dazu wie folgt vorgehen:
+===Anlage Konto-Report===
-# Konto-Report aus Navigator mit grünem Plus erzeugen
+Vorgehensweise zur Anlage eines neuen Konto-Reports:
-# 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]]|}}
+#Konto-Report aus Navigator mit grünem Plus erzeugen
-{{AlexBild|Zeitmaßstab wählen|[[Datei:KR_zeitmasstab.png|550px]]|}}
+#Konto-Report umbenennen. (Wichtig für Name von automatisch exportierten Dateien)
-{{AlexBild|Export wählen|[[Datei:KR_export.png|550px]]|}}
+#Werteauswahl (Konten, Parameter, ...) durchführen
-{{AlexBild|Konten wählen|[[Datei:KR_werte.png|550px]]|}}
+#Den gewünschten Zeitmaßstab eintragen (für Konto-Report-Export meist Monat oder Tag).
-{{AlexBild|Umbenennen|[[Datei:KR_rename.png|550px]]|}}
+#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.
-Anschließend kann der Export getestet werden.
+===Anlage automatischer Konto-Report Export===
-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.
+Um dem Daemon-Prozess die zu exportierenden Konto-Reports mitzuteilen, müssen diese in den Systemeinstellungen eingetragen werden:
-Ist alles richtig eingestellt, wird die angegebene Datei je nach eingestelltem Export gefüllt.
+In Systemeinstellungen - Gruppe "Exporteinstellungen" - Eigenschaft "Automatische Kontoreport Exports" einen neuen Eintrag machen:
-OK. Speichern!
+{{AlexBild|Automatischen Konto-Report Export anlegen|[[Datei:AKRE_anlegen.png|550px]]|}}
-= Anlegen automatischer Konto-Report Export =
+Im erzeugten "Automatischen Konto-Report-Export" können folgende Einstellungen getroffen werden:
-Um dem zusätzlichen Daemon-Prozess die zu exportierenden Konto-Reports mitzuteilen, müssen diese in den Systemeinstellungen eingetragen 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)
+|}
-Dazu die Systemeinstellungen öffnen, in die Gruppe "Exporteinstellungen" wechseln und in der Eigenschaft "Automatische Kontoreport Exports" einen neuen Eintrag machen.
+{{AlexBild|Parametrierung Automatischer Konto-Report-Export|[[Datei:AutoReport FixerZeitbereich.png|300px]]|}}
-{{AlexBild|Automatischen Konto-Report Export anlegen|[[Datei:AKRE_anlegen.png|550px]]|}}
+Hinterlegung des "Automatischen Konto-Report-Export" in Systemeinstellungen.
-Danach müssen im erzeugten "Automatischen Konto-Report-Export" die gewünschten Einstellungen getroffen werden.
-# Konto-Report auswählen
+{{AlexBild|Parametrierung Automatischer Konto-Report-Export|[[Datei:AKRE_ok.png|450px]]|}}
-# Etwaige Ressourcen auswählen. (Falls nichts ausgewählt gilt "Systemweit")
-# Ordner für erstellte Dateien. (Dateien heißen so wie der erzeugte Konto-Report)
-# Beginn zur Stunde auswählen
-# Dateiname ohne Zeitstempel --> Wenn das File täglich ersetzt werden soll auf JA setzen
-{{AlexBild|Parametrisieren des Automatischen Konto-Report-Export|[[Datei:Konto_Report_Export.PNG|450px]]|}}
-Hinterlegung des "Automatischen Konto-Report-Export" in Systemeinstellungen.
+====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.
-{{AlexBild|Parametrisieren des Automatischen Konto-Report-Export|[[Datei:AKRE_ok.png|450px]]|}}
+{{AlexBild|Automatischen Konto-Report Export testen|[[Datei:Automatischer Konto-Report-Export Test.png|400px]]|}}
-Ein manueller Funktionstest kann über einen Rechtsklick auf den Reiter durchgeführt werden. Der Konto-Report wird in dem zuvor definierten Ordner abgelegt.
-{{AlexBild|Automatischen Konto-Report Export testen|[[Datei:Automatischer Konto-Report-Export Test.png]]|}}
 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 oder nur Lesezugriff auf den angegebenen Ordner
-'''Falls alles funktioniert, sollte jetzt zur "Beginnstunde x" jeden Tag eine Datei mit dem gewünschten Format auf das gewählte Verzeichnis gelegt werden.'''
-= Welche Exporteinstellung ist gerade ausgewählt? =
-Ab der Version 2017.0.0.95
-Um zu sehen, welche Export man sich gerade eingestellt hat, bitte wie folgt vorgehen:
-* 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]]
-Ab der Version 2020.24 ist in dieser Auswahl eine neue Option verfügbar: [[Konto-Report_Export_wie_%27Kopieren%27|Konto-Report Export wie 'Kopieren']]
+===<span class="mw-headline">Bit Factory interne Zusatzinfos</span>===
+*[[Intern:Automatischer Konto-Report-Export Aktivierung|Aktivierung]]
-= Anpassen von Configfile =
-unter "serverDaemonPlugins" muß die "Bfx.Alex.AccountsReport.Model.dll" eingetragen sein.
- , "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]].
-= Anlegen Konto-Report-Export =
-Falls die entsprechenden Konto-Report-Exports nicht schon angelegt sind, bitte wie folgt vorgehen.
-[[Supervisoren_Kompaktübersicht_Windows#Navigatoransicht|Navigatoransicht]] auf Anpassungsansicht wechseln.
-Konto-Report-Export anlegen.
-{{AlexBild|Konto-Report-Export anlegen|[[Datei:KRE_anlegen.png|500px]]|}}
-Die gewünschten Prozeduren hinterlegen. Die Prozeduren können in der Softwareentwicklung erfragt werden.
-In den meisten Fällen existiert ein Standard-Export, der den Konto-Report in tabellarischer Form in eine Datei exportiert.
-OK. Speichern!
+<br />
 [[Kategorie:Funktionsübersicht]]