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 4: / Zeile 4: @@
 Dies kann durch
-* direkten Zugriff über das Dateisystem
+* direkten Zugriff über das Dateisystem oder
 * ein [[Webservice_-_Automatischer_Konto-Report-Export|Webservice]]
 erfolgen.
@@ Zeile 10: / Zeile 10: @@
 ===Anlage Konto-Report===
-Zuerst muss der zu exportierende Konto-Report erstellt und parametriert werden.
+Vorgehensweise zur Anlage eines neuen Konto-Reports:
-Dazu wie folgt vorgehen:
 #Konto-Report aus Navigator mit grünem Plus erzeugen
-#Den gewünschten Zeitmaßstab eintragen. (Normalerweise Tag oder Monat)
-#Die gewünschten Konten/Eigenschaften auswählen.
-#Den notwendigen '''[[Konto-Report-Export]]''' auswählen.
 #Konto-Report umbenennen. (Wichtig für Name von automatisch exportierten Dateien)
+#Werteauswahl (Konten, Parameter, ...) durchführen
-Wichtig: Für den Export muss eine Exporteinstellung ausgewählt werden:
+#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.
-{{AlexBild|Exporteinstellung wählen|[[Datei:KR_export.png|550px]]|}}
+#[[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.
-Weitere Informationen, wie ein Konto-Report angelegt wird, sind [[Konto-Report/Parametrierung|hier]] zur finden.
+##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.
-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.
-<br />
-====Welche Exporteinstellung ist gerade ausgewählt?====
-*Kontoreport auswählen
-*In der Werkzeugleiste bei "Export - "Exporteinstellungen auswählen" auf den Pfeil klicken
-*Exporteinstellung anzeigen
-{{AlexBild|Exporteinstellungen|[[Datei:Exporteinstellungen.PNG]]|}}
-*Nun erscheint die Information
-{{AlexBild|Informationsfenster|[[Datei:Infotextt.PNG|250px]]|}}
-<br />
 ===Anlage automatischer Konto-Report Export===
@@ Zeile 53: / 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
-*Etwaige Ressourcen auswählen
-**Falls nichts ausgewählt, gilt "Systemweit"
-**Kleinste Ressource zumindest Plaungseinheit, Personal liefert keine Ergebnisse
-*Ordner für erstellte Dateien (Dateiname = Name des ausgewählten Konto-Report)
-*Monat in Vergangenheit (-1 für keine, 0 für 1 Monat): Anzahl der zu exportierenden Monate in Vergangenheit, vom aktuellen Monat ausgehend
-*Monate in Zukunft: Anzahl der zu exportierenden Monate in Zukunft, vom aktuellen Monat ausgehend
-*[[Automatischer Konto-Report-Export: fixe Zeitbereiche einstellbar|Fixes von-/bis Datum]]: Hier kann ein fixes von-/bis Datum für den Export definiert werden
-*Beginn zur Stunde auswählen
-*Dateiname ohne Zeitstempel: Muss auf Ja gesetzt werden, wenn das File täglich ersetzt werden soll
-*Nur aktuellen Tag exportieren --> Wenn nur der Stand des aktuellen Tages exportiert werden soll (z.B. Kartennummer). --> '''Achtung''': Nur in Verbindung mit Zeitmaßstab = Tag verwenden.
 {{AlexBild|Parametrierung Automatischer Konto-Report-Export|[[Datei:AutoReport FixerZeitbereich.png|300px]]|}}
 Hinterlegung des "Automatischen Konto-Report-Export" in Systemeinstellungen.
@@ Zeile 83: / Zeile 72: @@
 *Die Netzwerkfreigabe erlaubt keinen Schreibzugriff auf den angegebenen Ordner
-[[Kategorie:Neu ab Version 7.8]]
+==== 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 wird täglich zur definierten "Beginnstunde" eine Datei mit dem gewünschten Format auf das gewählte Verzeichnis gelegt.'''
+Es besteht aber die Möglichkeit, einen weiteren Report anzulegen.
-===Konto-Report-Export===
+Achtung: Beim Starten des Dienstes wird der Report auch ausgeführt!
-Der Konto-Report-Export definiert das Format, wie die Daten exportiert werden.
+[[Kategorie:Neu ab Version 7.8]]
-In den meisten Fällen existieren folgende Konto-Report-Export-Möglichkeiten:
-*[[Report-Export Standard]]
-*[[Konto-Report Export wie 'Kopieren']]
-*[[Konto-Report Export Standard JSON]]
-*evtl. auch weitere, kundenspezifische Formate
-Falls das gewünschte Format noch nicht auswählbar ist, kann ein neuer Konto-Report-Export angelegt werden:
-*[[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 (Programmierung notwendig!)
-<br />
-===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 zum '''Export Tagesinformationen''' finden Sie [[Export_Tagesinformationen|hier]].
-=== Webservice - Automatischer Konto-Report-Export ===
-Der automatische Konto-Report-Export ist auch über das Webservice auslesbar. Mehr dazu erfahren Sie [[Webservice - Automatischer Konto-Report-Export|hier]].
 ===<span class="mw-headline">Bit Factory interne Zusatzinfos</span>===
+*[[Intern:Automatischer Konto-Report-Export Aktivierung|Aktivierung]]
-*[[Intern:Automatischer Konto-Report-Export/Aktivierung|Aktivierung]]
 <br />