Aller au contenu

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

InstallationCommande
Dockerdocker compose logs -f
Service Linuxjournalctl -u save2erp -f
Fichierslogs/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 … (ou Server 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 :

  1. Choisissez un système dans la liste (celle des systèmes déclarés dans le .env), puis cliquez sur « Se connecter ».
  2. Identifiez-vous dans la fenêtre du système cible et autorisez l'accès.
  3. 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ômeCause probableQue faire
Le bouton n'apparaît pas dans WordComplé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 certificatServeur injoignable, ou certificat non reconnu par le poste.Ouvrez https://<serveur>/test depuis le poste de l'utilisateur.
Système inconnuLe 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 impossibleClient 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 indisponibleLe 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 cibleErreur technique du système cible (5xx).Le détail est dans les logs du serveur et du système cible.
Cookies bloquésWord pour le web, navigateur qui bloque les cookies tiers.Voir Prérequis.
Identification impossibleVersion 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éeLe 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.