Modifié par Taha Gabdouri le 2025/12/05 09:57

Afficher les derniers auteurs
1 Via **« Fichier » → « Exporter le rapport »**, il est possible d’exporter un rapport lisible par machine au format CSV. Si l’on souhaite utiliser régulièrement ces données dans un programme externe, l’export peut être automatisé en quelques étapes. Le rapport peut ainsi être entièrement mis à disposition de manière automatisée via HTTP(S), FTP ou SMB, ou être enregistré sur un lecteur réseau.
2
3 {{info}}
4 Testé avec succès pour la dernière fois avec :
5
6 Firmware: x64 -13.00 Build: 052
7 TCMS 1.9 - 13.00 Build 007
8 {{/info}}
9
10 {{toc/}}
11
12 = Configuration d’un dossier d’exportation =
13
14 Décidez d’abord si vous souhaitez enregistrer votre rapport sur un lecteur réseau (PUT) ou le mettre à disposition pour téléchargement par d’autres applications (PULL).
15
16 == Rapport sur un lecteur réseau ==
17
18 Si vous souhaitez enregistrer votre rapport sur un lecteur réseau, configurez le lecteur dans la Kommbox du TCMS sous **« Périphérie » → « Lecteurs » → « Nouveau lecteur réseau »**. Les lecteurs peuvent être intégrés ici via SMB, NFS, SSH ou WebDAV.
19
20 Le chemin d’exportation doit ensuite être adapté en fonction du nom de lecteur attribué ici :
21
22 {{{EXPORT_PATH="/mnt/shares/net/#NomDuLecteur#"}}}
23
24 [[image:report01.png]]
25
26 == **Mettre le rapport à disposition pour téléchargement** ==
27
28 Créez le lecteur que vous souhaitez utiliser pour partager votre rapport, comme décrit dans le guide [[RangeeOS - Lecteur d’échange sur le Thin Client>>doc:HowTos.RangeeOS - Austauschlaufwerk auf dem ThinClient.WebHome]].
29
30 Le chemin d’exportation doit ensuite être adapté en fonction du nom de lecteur attribué pour le répertoire :
31
32 {{{EXPORT_PATH="/mnt/shares/local_dir/#NomDuLecteur#" }}}
33
34 = **Automatiser l’exportation de la configuration** =
35
36 Pour automatiser l’exportation, vous pouvez placer un script dans la Kommbox du TCMS. Dans l’exemple suivant, un rapport est généré une seule fois au démarrage du TCMS, puis à chaque heure pile. Veuillez adapter **EXPORT_PATH** et **REPORT_FILENAME** en conséquence :
37
38 {{{#-------------------------------------À adapter-------------------------------------#
39 #Répertoire local pour l’export. Veuillez utiliser votre EXPORT_PATH défini précédemmentLokales Verzeichnis für den Export. Übernehmen Sie bitte Ihren zuvor definierten EXPORT_PATH
40 EXPORT_PATH="/mnt/shares/local_dir/#NomDuLecteur#"
41
42 #Définit le nom de fichier de l’export du rapport – choix libre
43 REPORT_FILENAME="report.csv"
44 #----------------------------------------------------------------------------------------#
45
46 # Cette commande exporte le rapport TCMS dans le répertoire local
47 COMMAND="/opt/rangee/tcms/symfony tcms:export-report $EXPORT_PATH/$REPORT_FILENAME"
48
49 # Fichier temporaire pour le crontab actuel
50 TEMP_CRON=$(mktemp)
51
52 # Écrire le crontab actuel dans le fichier temporaire
53 crontab -l > "$TEMP_CRON" 2>/dev/null
54
55 # Vérifier si la commande existe déjà dans le crontab
56 grep -F "$COMMAND" "$TEMP_CRON" > /dev/null
57 if [ $? -eq 0 ]; then
58 echo "Der Cronjob existiert bereits."
59 else
60 # Den neuen Cronjob hinzufügen (jede Stunde)
61 echo "0 * * * * $COMMAND" >> "$TEMP_CRON"
62 # Den aktualisierten Crontab laden
63 crontab "$TEMP_CRON"
64 fi
65
66 # Supprimer le fichier temporaire
67 rm "$TEMP_CRON"
68
69 # Exécuter la commande une seule fois
70 $COMMAND}}}
71
72 Le script peut être placé dans la Kommbox sous **« Outils » → « Scripts » → « Nouvelle connexion »**. Utilisez les paramètres suivants :
73
74
75
76 * **Nom de connexion :** au choix
77 * **Exécuter en tant que root :** oui
78 * **Script :** insérer le script créé
79 * **Démarrage automatique :** oui
80
81 Redémarrez ensuite le TCMS une seule fois.
82
83 = **Récupération des rapports** =
84
85 Un rapport enregistré sur un lecteur réseau est directement accessible après l’exécution du script.
86
87 Les options de récupération pour le lecteur local sont également décrites dans l’article [[RangeeOS – Lecteur d’échange sur le Thin Client>>doc:HowTos.RangeeOS - Austauschlaufwerk auf dem ThinClient.WebHome]]. Via HTTPS, vous pouvez télécharger un rapport créé par le script ci-dessus (avec **NomDuLecteur = "report"**) à l’adresse suivante :
88
89 {{{https://#Client#/shares/report/report.csv}}}
90
91 [[image:share03.png||width="600"]]