Diagnostiquer un problème
Lire les logs
Les logs sont écrits dans la console et dans le dossier logs/ de l'application (all.log, warn.log, exceptions.log).
| Installation | Commande |
|---|---|
| Docker | docker compose logs -f |
| Service Linux | journalctl -u save2erp -f |
| Fichiers | logs/all.log |
Le niveau de détail dépend de LOG_LEVEL : info est recommandé en production, debug pour une analyse (les adresses appelées y figurent).
Au démarrage
Les logs de démarrage doivent indiquer :
Licence : …avec le client, le nombre d'utilisateurs et la date de fin ;- pour chaque système déclaré, son environnement, ou la raison pour laquelle il est refusé ;
- en mode
https, le certificat et sa date d'expiration (avertissement 30 jours avant) ; Server HTTPS started on port …(ouServer HTTP started…derrière un proxy).
Une configuration inutilisable (protocole inconnu, port invalide, certificat illisible, clé de signature absente…) empêche le démarrage, avec un message explicite.
La page de test
La page https://<serveur>/test vérifie la connexion au système cible sans Word, dans un navigateur :
- Choisissez un système dans la liste (celle des systèmes déclarés dans le
.env), puis cliquez sur « Se connecter ». - Identifiez-vous dans la fenêtre du système cible et autorisez l'accès.
- Cliquez sur « Lancer le test » : le serveur appelle le service de test du système cible, sans rien modifier. « Tout est OK » confirme que la connexion et les droits de l'utilisateur sont corrects.


La page de test reste accessible sans licence valide. Elle affiche les codes d'erreur du serveur tels quels (voir Codes d'erreur).
Problèmes fréquents
| Symptôme | Cause probable | Que faire |
|---|---|---|
| Le bouton n'apparaît pas dans Word | Complément non déployé pour l'utilisateur, ou Word pas redémarré. | Vérifiez le déploiement (voir Déployer dans Microsoft 365). |
| Le panneau reste vide ou affiche une erreur de certificat | Serveur injoignable, ou certificat non reconnu par le poste. | Ouvrez https://<serveur>/test depuis le poste de l'utilisateur. |
| Système inconnu | Le système de S2E_SystemKey n'a pas de bloc dans le .env. | Ajoutez le système (voir Configurer le serveur). |
| Système mal configuré | Bloc incomplet, environnement inconnu, délai ou chemin invalide. | La raison est dans les logs de démarrage. |
| Connexion impossible | Client OAuth2 refusé, adresse de retour différente, connexion trop longue. | Vérifiez OAUTH_CALLBACK_URI et le client OAuth2 du système cible ; détail dans les logs. |
| Le système cible est momentanément indisponible | Le serveur ne joint pas le système cible, ou il ne répond pas dans le délai. | Vérifiez le réseau entre le serveur et le système cible, et SAP_CALL_TIMEOUT_MS. |
| Erreur du système cible | Erreur technique du système cible (5xx). | Le détail est dans les logs du serveur et du système cible. |
| Cookies bloqués | Word pour le web, navigateur qui bloque les cookies tiers. | Voir Prérequis. |
| Identification impossible | Version de Word sans authentification imbriquée, consentement absent, accès conditionnel. | Mettez Word à jour, vérifiez le consentement administrateur (voir Déployer dans Microsoft 365). |
| Identification refusée | Le jeton Microsoft a été refusé, ou le serveur ne joint pas Microsoft (« Microsoft unreachable from the server » dans les logs). | Vérifiez l'accès du serveur à login.microsoftonline.com. |
La liste complète des codes est dans Codes d'erreur.