Skip to Content
Last modified by Tobias Wintrich on 2025/05/22 12:20
From version 1.2
edited by Tobias Wintrich
on 2025/05/22 10:03
Change comment: There is no comment for this version
To version 3.1
edited by Tobias Wintrich
on 2025/05/22 12:20
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,4 +1,4 @@
1 -Über "Datei" -> "Report Exportieren" lässt sich bereits heute ein Maschinenlesbarer Report in Form einer CSV Datei exportieren. Will man aber Regelmäßig die Daten aus dem TCMS in einem externen Programm nutzen, lässt sich der Export auch in wenigen Schritten automatisieren. Der Export kann hierdurch voll automatisiert über HTTP(s)/FTP oder SMB bereitgestellt, oder auf einem Netzlaufwerk abgelegt werden.
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.
2 2  
3 3  {{info}}
4 4  __Zuletzt erfolgreich getestet mit:__
... ... @@ -7,36 +7,42 @@
7 7  TCMS 1.9 - 13.00 Build 007
8 8  {{/info}}
9 9  
10 -= Konfiguration eines Export Ordners =
10 += Konfiguration eines Export-Ordners =
11 11  
12 -Entschieden Sie sich zunächst ob Sie Ihren Report auf einem Netzlaufwerk ablegen (PUT), oder zum Download für andere Anwendungen (PULL) bereitstellen möchten.
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.
13 13  
14 14  == Report auf ein Netzlaufwerk ==
15 15  
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". Als Laufwerk können hier Zeile per "SAMAB", "NFS", "SSH" oder "WebDAV" eingebunden werden.
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.
17 17  
18 -Anhand des hier vergebenen "Laufwerksnamen" muss im folgenden Schritt der Export Pfad entsprechend gesetzt angepasst werden.
18 +Anhand des hier vergebenen **Laufwerksnamens** muss im folgenden Schritt der Exportpfad entsprechend angepasst werden:
19 19  
20 -{{{EXPORT_PATH="/mnt/shares/net/#Laufwerksname#" }}}
20 +{{{EXPORT_PATH="/mnt/shares/net/#Laufwerksname#"}}}
21 21  
22 22  [[image:report01.png]]
23 23  
24 24  == Report zum Download freigeben ==
25 25  
26 -Legen Sie das Laufwerk, welches Sie zur Freigabe Ihres Reports nutzen wollen wie unter [[RangeeOS - Austauschlaufwerk auf dem Thin Client>>doc:HowTos.RangeeOS - Austauschlaufwerk auf dem ThinClient.WebHome]] beschrieben an.
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.
27 27  
28 -Anhand des für das Verzeichnis vergebenen "Laufwerksnamen" muss im folgenden Schritt der Export Pfad entsprechend gesetzt angepasst werden.
28 +Anhand des für das Verzeichnis vergebenen **Laufwerksnamens** muss im folgenden Schritt der Exportpfad entsprechend angepasst werden:
29 29  
30 -{{{EXPORT_PATH="/mnt/shares/local/#Laufwerksname#" }}}
30 +{{{EXPORT_PATH="/mnt/shares/local_dir/#Laufwerksname#" }}}
31 31  
32 32  = Konfigurationsexport automatisieren =
33 33  
34 -Zu Automatisierung des Exports können Sie in der Kommbox des TCMS dieses Skript hinterlegen:
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:
35 35  
36 -FOLDER="report"
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#"
37 37  
40 +#Definiert den Dateinamen des Report-Exports - frei wählbar
41 +REPORT_FILENAME="report.csv"
42 +#----------------------------------------------------------------------------------------#
43 +
38 38  # Dieser Befehl exportiert den TCMS Report in das lokale Verzeichnis
39 -COMMAND="/opt/rangee/tcms/symfony tcms:export-report /mnt/shares/local_dir/$FOLDER/report.csv"
45 +COMMAND="/opt/rangee/tcms/symfony tcms:export-report $EXPORT_PATH/$REPORT_FILENAME"
40 40  
41 41  # Temporäre Datei für den aktuellen Crontab
42 42  TEMP_CRON=$(mktemp)
... ... @@ -59,6 +59,23 @@
59 59  rm "$TEMP_CRON"
60 60  
61 61  # Command einmalig ausführen:
62 -$COMMAND
68 +$COMMAND}}}
63 63  
64 -
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"]]
share03.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.twintrich
Size
... ... @@ -1,0 +1,1 @@
1 +59.6 KB
Content