Skip to Content
Last modified by Tobias Wintrich on 2025/05/22 12:20
Hide last authors
Tobias Wintrich 3.1 1 Über **"Datei" → "Report exportieren"** lässt sich ein maschinenlesbarer Report im CSV-Format exportieren. Möchte man die Daten regelmäßig in einem externen Programm nutzen, kann der Export mit wenigen Schritten automatisiert werden. Der Report lässt sich dadurch vollständig automatisiert über **HTTP(S)**, **FTP** oder **SMB** bereitstellen oder auf einem Netzlaufwerk ablegen.
Tobias Wintrich 1.2 2
3 {{info}}
4 __Zuletzt erfolgreich getestet mit:__
5
6 Firmware: x64 -13.00 Build: 052
7 TCMS 1.9 - 13.00 Build 007
8 {{/info}}
9
Tobias Wintrich 3.1 10 = Konfiguration eines Export-Ordners =
Tobias Wintrich 1.2 11
Tobias Wintrich 3.1 12 Entscheiden Sie zunächst, ob Sie Ihren Report auf einem Netzlaufwerk ablegen (PUT) oder zum Download für andere Anwendungen (PULL) bereitstellen möchten.
Tobias Wintrich 1.2 13
14 == Report auf ein Netzlaufwerk ==
15
Tobias Wintrich 3.1 16 Wenn Sie Ihren Report auf einem Netzlaufwerk ablegen möchten, konfigurieren Sie das Laufwerk in der Kommbox des TCMS unter **„Peripherie“ → „Laufwerke“ → „Neues Netzlaufwerk“**. Laufwerke können hier über **SMB**, **NFS**, **SSH** oder **WebDAV** eingebunden werden.
Tobias Wintrich 1.2 17
Tobias Wintrich 3.1 18 Anhand des hier vergebenen **Laufwerksnamens** muss im folgenden Schritt der Exportpfad entsprechend angepasst werden:
Tobias Wintrich 1.2 19
Tobias Wintrich 3.1 20 {{{EXPORT_PATH="/mnt/shares/net/#Laufwerksname#"}}}
Tobias Wintrich 1.2 21
22 [[image:report01.png]]
23
24 == Report zum Download freigeben ==
25
Tobias Wintrich 3.1 26 Legen Sie das Laufwerk, das Sie zur Freigabe Ihres Reports verwenden möchten, wie in der Anleitung [[RangeeOS - Austauschlaufwerk auf dem Thin Client>>doc:HowTos.RangeeOS - Austauschlaufwerk auf dem ThinClient.WebHome]] beschrieben an.
Tobias Wintrich 1.2 27
Tobias Wintrich 3.1 28 Anhand des für das Verzeichnis vergebenen **Laufwerksnamens** muss im folgenden Schritt der Exportpfad entsprechend angepasst werden:
Tobias Wintrich 1.2 29
Tobias Wintrich 3.1 30 {{{EXPORT_PATH="/mnt/shares/local_dir/#Laufwerksname#" }}}
Tobias Wintrich 1.2 31
32 = Konfigurationsexport automatisieren =
33
Tobias Wintrich 3.1 34 Zur Automatisierung des Exports können Sie in der Kommbox des TCMS ein Skript hinterlegen. Im folgenden Beispiel wird ein Report einmalig beim Start des TCMS und anschließend zu jeder vollen Stunde erstellt. Bitte passen Sie EXPORT_PATH und REPORT_FILENAME entsprechend an:
Tobias Wintrich 1.2 35
Tobias Wintrich 3.1 36 {{{#-------------------------------------Bitte anpassen-------------------------------------#
37 #Lokales Verzeichnis für den Export. Übernehmen Sie bitte Ihren zuvor definierten EXPORT_PATH
38 EXPORT_PATH="/mnt/shares/local_dir/#Laufwerksname#"
Tobias Wintrich 1.2 39
Tobias Wintrich 3.1 40 #Definiert den Dateinamen des Report-Exports - frei wählbar
41 REPORT_FILENAME="report.csv"
42 #----------------------------------------------------------------------------------------#
43
Tobias Wintrich 1.2 44 # Dieser Befehl exportiert den TCMS Report in das lokale Verzeichnis
Tobias Wintrich 3.1 45 COMMAND="/opt/rangee/tcms/symfony tcms:export-report $EXPORT_PATH/$REPORT_FILENAME"
Tobias Wintrich 1.2 46
47 # Temporäre Datei für den aktuellen Crontab
48 TEMP_CRON=$(mktemp)
49
50 # Aktuellen Crontab in die temporäre Datei schreiben
51 crontab -l > "$TEMP_CRON" 2>/dev/null
52
53 # Prüfen, ob der Befehl bereits im Crontab existiert
54 grep -F "$COMMAND" "$TEMP_CRON" > /dev/null
55 if [ $? -eq 0 ]; then
56 echo "Der Cronjob existiert bereits."
57 else
58 # Den neuen Cronjob hinzufügen (jede Stunde)
59 echo "0 * * * * $COMMAND" >> "$TEMP_CRON"
60 # Den aktualisierten Crontab laden
61 crontab "$TEMP_CRON"
62 fi
63
64 # Temporäre Datei löschen
65 rm "$TEMP_CRON"
66
67 # Command einmalig ausführen:
Tobias Wintrich 3.1 68 $COMMAND}}}
Tobias Wintrich 1.2 69
Tobias Wintrich 3.1 70 Das Skript können Sie in der Kommbox unter **„Werkzeuge“ → „Skripte“ → „Neue Verbindung“** hinterlegen. Verwenden Sie dabei die folgenden Einstellungen:
71
72 * **Verbindungsname:** frei wählbar
73 * **Als root ausführen:** ja
74 * **Skript:** das erstellte Skript einfügen
75 * **Automatischer Start:** ja
76
77 Starten Sie den TCMS anschließend einmal neu.
78
79 = Abruf des Reports =
80
81 Ein auf einem Netzlaufwerk abgelegter Report ist nach Ausführung des Skripts direkt von dort abrufbar.
82
83 Die Abrufoptionen für das lokale Laufwerk sind ebenfalls im Artikel [[RangeeOS - Austauschlaufwerk auf dem Thin Client>>doc:HowTos.RangeeOS - Austauschlaufwerk auf dem ThinClient.WebHome]] beschrieben. Per **HTTPS** können Sie einen über das obige Skript erstellten Report (bei **Laufwerksname="report"**) unter folgender Adresse herunterladen:
84
85 {{{https://#Client#/shares/report/report.csv}}}
86
87 [[image:share03.png||width="600"]]