Aller au contenu

TCMS – Mettre le rapport à disposition pour des applications externes

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

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.

Information

Testé avec succès pour la dernière fois avec :

Firmware: x64 -13.00 Build: 052
TCMS 1.9 - 13.00 Build 007

Configuration d’un dossier d’exportation

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).

Rapport sur un lecteur réseau

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.

Le chemin d’exportation doit ensuite être adapté en fonction du nom de lecteur attribué ici :

EXPORT_PATH="/mnt/shares/net/#NomDuLecteur#"

report01.png

Mettre le rapport à disposition pour téléchargement

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.

Le chemin d’exportation doit ensuite être adapté en fonction du nom de lecteur attribué pour le répertoire :

EXPORT_PATH="/mnt/shares/local_dir/#NomDuLecteur#"

Automatiser l’exportation de la configuration

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 :

#-------------------------------------À adapter-------------------------------------#
#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
EXPORT_PATH="/mnt/shares/local_dir/#NomDuLecteur#"

#Définit le nom de fichier de l’export du rapport – choix libre
REPORT_FILENAME="report.csv"
#----------------------------------------------------------------------------------------#

# Cette commande exporte le rapport TCMS dans le répertoire local
COMMAND="/opt/rangee/tcms/symfony tcms:export-report $EXPORT_PATH/$REPORT_FILENAME"

# Fichier temporaire pour le crontab actuel
TEMP_CRON=$(mktemp)

# Écrire le crontab actuel dans le fichier temporaire
crontab -l > "$TEMP_CRON" 2>/dev/null

# Vérifier si la commande existe déjà dans le crontab
grep -F "$COMMAND" "$TEMP_CRON" > /dev/null
if [ $? -eq 0 ]; then
    echo "Der Cronjob existiert bereits."
else
    # Den neuen Cronjob hinzufügen (jede Stunde)
    echo "0 * * * * $COMMAND" >> "$TEMP_CRON"
    # Den aktualisierten Crontab laden
    crontab "$TEMP_CRON"
fi

# Supprimer le fichier temporaire
rm "$TEMP_CRON"

# Exécuter la commande une seule fois
$COMMAND

Le script peut être placé dans la Kommbox sous « Outils » → « Scripts » → « Nouvelle connexion ». Utilisez les paramètres suivants :

  • Nom de connexion : au choix
  • Exécuter en tant que root : oui
  • Script : insérer le script créé
  • Démarrage automatique : oui

Redémarrez ensuite le TCMS une seule fois.

Récupération des rapports

Un rapport enregistré sur un lecteur réseau est directement accessible après l’exécution du script.

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. Via HTTPS, vous pouvez télécharger un rapport créé par le script ci-dessus (avec NomDuLecteur = "report") à l’adresse suivante :

https://#Client#/shares/report/report.csv

share03.png