Consulter l'aide au diagnostic sur l'erreur API

Summary

Cet article permet d'identifier les pistes de résolution et les informations à recueillir en cas d’erreur API de Batigest Connect.

Description

Avant d’investiguer une erreur d’API :

  1. Vérifiez que toutes les mises à jour du poste sont installées.
  2. Redémarrez le poste après l’installation des mises à jour (en attente).
  3. Confirmez qu’aucune mise à jour n’est en attente.
  4. S’assurez que le poste n’utilise pas Windows Server 2012.
  5. Respectez l’ensemble des prérequis de Batigest Connect.

Resolution

 ATTENTION : Ces étapes sont à effectuer par un informaticien ou une personne disposant des compétences techniques nécessaires 

Erreur à l'installation de BatigestConnectAPI

L’installation de Batigest Connect s’interrompt avec le message d’erreur : Étape

"L’installation de Sage BatigestConnectAPI a échoué."
▼ Étape 1 : Vérifiez si le healthbatigest est OK ou non
  1. Ouvrez un navigateur et accéder à l’URL : https://localhost/healthbatigest
    ou
    Ouvrez ConnexionManager.exe dans le répertoire d’installation (par défaut : C:\Sage\BatigestConnect).
  2. Cliquez sur Afficher l’état.

    Résultat attendu :

    {
    « status »: « Healthy »,
    « description »: « Tous les services sont opérationnels. »,
    « services »: [
    {
    « name »: « LoadingCheck »,
    « status »: « Healthy »,
    « data »: {
    « Api »: « Healthy »,
    « Key »: « Healthy »,
    « Sql »: « Healthy »
    }}]}
  3. Consignez le résultat du test :
    1. Notez le résultat obtenu.
    2. Si le résultat diffère de celui attendu, réalisez une capture d’écran avant de poursuivre.
    3. En cas de problème, consultez la rubrique de l'aide en ligne "Que faire si le serveur ne répond pas Healthy ?" qui propose plusieurs solutions.
    4. Si ces solutions ne résolvent pas le problème, consigner les tests effectués ainsi que leurs résultats.
▼ Étape 2 : Vérifiez les logs de provision API 

L’installation des API génère plusieurs fichiers journaux (logs) indiquant le succès ou l’échec des différentes tâches.
Les fichiers concernés sont :

  • configureapi.log
  • configurebatigest.log
  • createsite.log
  • getiisports.log
  • installationapi.log

Étapes à suivre :

  1. Accédez au dossier C:\Program Files (x86)\Common Files\Sage\PEBatiment\ProvisionApi

  2. Localisez les fichiers journaux listés ci-dessus.

  3. Ouvrez chaque fichier pour vérifier la présence éventuelle d’erreurs.

  4. Contrôlez la cohérence des informations, par exemple :

    • Il est impératif que le fichier Configurebatigest.log contienne l’URL du healthbatigest, avec le nom de la machine et le port utilisé.
    • Ce port doit correspondre à celui indiqué dans createsite.log.
  5. À partir de ces informations :

    1.  

      Ouvrez l'Internet Information Service (IIS) via la barre de recherche Windows.

    2.  

      Saisissez IIS puis validez.

    3.  

       

      Vérifiez que le numéro de port est identique.

      Gestionnaire des services Internet (IIS)

    4. Si le port est incorrect, modifiez-le via clic droit > Liaisons.
    5. Redémarrez le site à l’aide des boutons d’action situés à droite.
  6. Si ces actions ne suffisent pas, récupérez :

    • Tous les fichiers *.log présents dans le répertoire
    • Une capture d’écran du contenu du dossier
    • Une capture d’écran de la configuration IIS
▼ Étape 3 : Vérifiez le répertoire d'installation de l'API
  1. Accédez à l’emplacement suivant : C:\Program Files (x86)\Sage\BatigestConnectApi

  2. Contrôlez les droits sur le répertoire. Ajoutez Contrôle total pour Tout le monde si nécessaire.

  3. Récupérez le répertoire logs ainsi qu’une capture d’écran du contenu du répertoire BatigestConnectApi.

Erreur au lancement du dossier 

Il est nécessaire de déterminer si le problème provient :

  • du poste serveur
  • du poste client
  • ou des deux
▼ Étape 1 : Vérifiez IIS 

Cette procédure s’applique uniquement sur le poste serveur lorsque l’erreur est présente sur l’ensemble des postes ou sur un poste en mode monoposte.

  1. Ouvrez le Gestionnaire des services Internet (IIS).
  2. Dans la barre de recherche Windows, saisissez IIS.
  3. Appuyez sur Entrée.
  4. Vérifiez les composants nécessaires :
    1. Dans la section Pools d’applications, vérifiez la présence de SageBatigestConnectAppPool.
    2. Dans la section Sites, vérifiez la présence de SageBatigestConnectApi.
  5. Sélectionnez chaque élément et cliquez sur le bouton Redémarrer situé sur la droite
  6. Notez l’état du site et du pool d’applications après redémarrage.
  7. Prenez une capture d’écran.
▼ Étape 2 : Vérifiez si le healthbatigest est "Ok" ou non
  1. Ouvrez un navigateur Internet et saisissez l’URL suivante : https://localhost/healthbatigest.
    Ou
  2. Lancez ConnexionManager.exe depuis le répertoire d’installation (par défaut : C:\Sage\BatigestConnect).
  3. Cliquez sur Afficher l’état.

    Résultat attendu :
     
    {
    « status »: « Healthy »,
    « description »: « Tous les services sont opérationnels. »,
    « services »: [
    {
    « name »: « LoadingCheck »,
    « status »: « Healthy »,
    « data »: {
    « Api »: « Healthy »,
    « Key »: « Healthy »,
    « Sql »: « Healthy »
    }}]}
  4. Consignez le résultat du test :
    Si celui-ci diffère de celui décrit précédemment, effectuez une capture d’écran avant de poursuivre la procédure.
  5. En cas de problème, consultez la rubrique de l'aide en ligne "Que faire si le serveur ne répond pas Healthy ?" qui propose plusieurs solutions.
  6. Si ces solutions ne permettent pas de résoudre l’incident, notez les tests réalisés ainsi que leurs résultats pour faciliter le diagnostic ultérieur.
▼ Étape 3 : Vérifiez si le healthbatigest est Ok ou non (au travers du réseau)
  1. Ouvrez votre navigateur internet et accédez à l’URL suivante : https://NomDuServeur/healthbatigest
     ATTENTION : Remplacez NomDuServeur par le nom réel de votre machine serveur.  
    Ou
    Lancez l’application ConnexionManager.exe située dans votre répertoire d’installation par défaut : C:\Sage\BatigestConnect
  2. Cliquez sur Afficher l’état.

    Résultat attendu :

    {
    « status »: « Healthy »,
    « description »: « Tous les services sont opérationnels. »,
    « services »: [
    {
    « name »: « LoadingCheck »,
    « status »: « Healthy »,
    « data »: {
    « Api »: « Healthy »,
    « Key »: « Healthy »,
    « Sql »: « Healthy »
    }}]}
  3. Consignez le résultat du test :
    Si celui-ci diffère de celui décrit précédemment, effectuez une capture d’écran avant de poursuivre la procédure.
  4. En cas de problème, consultez la rubrique de l'aide en ligne "Que faire si le serveur ne répond pas Healthy ?" qui propose plusieurs solutions.
  5. Si ces solutions ne permettent pas de résoudre l’incident, notez les tests réalisés ainsi que leurs résultats pour faciliter le diagnostic ultérieur.
▼ Étape 4 : Testez de désactiver le pare-feu Windows

À effectuer uniquement sur le poste serveur, que l’erreur apparaisse sur ce poste, un autre poste ou en configuration monoposte :

  1. Ouvrez le pare-feu Windows.
  2. Désactivez-le temporairement.
  3. Lancez le logiciel concerné et notez le résultat obtenu.
▼ Étape 5 : Vérifiez le fichier projet.ini.txt

À effectuer sur le poste sur lequel l’erreur apparaît :

  1. Ouvrez le fichier projet.ini.txt.
  2. Copiez le chemin UNC indiqué dans ce fichier.
  3. Collez ce chemin dans l’explorateur Windows.
  4. Si le répertoire du serveur s’ouvre correctement, notez le chemin utilisé ainsi que le résultat du test.

Si le répertoire ne s’ouvre pas :

  1. Remplacez le nom de la machine par son adresse IP dans le chemin UNC.
  2. Testez à nouveau dans l’explorateur Windows.
  3. Si cette méthode fonctionne, procédez au remplacement du nom de la machine par son adresse IP. Effectuez cette modification dans tous les fichiers projet.ini présents sur l’ensemble des postes, y compris sur le serveur.
▼ Étape 6 : Récupérer les logs de Com4Front

À effectuer sur le poste sur lequel l’erreur apparaît :

  1. Accédez au répertoire suivant : C:\Program Files (x86)\Common Files\Sage\PEBatiment\ComForFront
  2. Récupérez les fichiers de logs présents dans ce dossier.
▼ Étape 7 : Réparez le module ASP.net
  1. Téléchargez le composant d’installation Windows Hosting Bundle v8.0.x. disponible dans la rubrique de l'aide en ligne. Le lien se trouve au point Erreur 500.x sur l’URL de test "healthbatigest" > Solution 2.
  2. Redémarrez le site sous IIS.

 

 

Solution Properties

Solution ID
250324105730157
Last Modified Date
Sun Nov 16 11:42:16 UTC 2025
Views
0