Cet article permet d'identifier les pistes de résolution et les informations à recueillir en cas d’erreur API de Batigest Connect.
Avant d’investiguer une erreur d’API :
- Vérifiez que toutes les mises à jour du poste sont installées.
- Redémarrez le poste après l’installation des mises à jour (en attente).
- Confirmez qu’aucune mise à jour n’est en attente.
- S’assurez que le poste n’utilise pas Windows Server 2012.
- Respectez l’ensemble des prérequis de Batigest Connect.
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
- 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).
- 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 »
}}]}
- Consignez le résultat du test :
- Notez le résultat obtenu.
- Si le résultat diffère de celui attendu, réalisez une capture d’écran avant de poursuivre.
- 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.
- 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 :
-
Accédez au dossier C:\Program Files (x86)\Common Files\Sage\PEBatiment\ProvisionApi
-
Localisez les fichiers journaux listés ci-dessus.
-
Ouvrez chaque fichier pour vérifier la présence éventuelle d’erreurs.
-
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.
-
À partir de ces informations :
-
Ouvrez l'Internet Information Service (IIS) via la barre de recherche Windows.
-
Saisissez IIS puis validez.
-
Vérifiez que le numéro de port est identique.

- Si le port est incorrect, modifiez-le via clic droit > Liaisons.
- Redémarrez le site à l’aide des boutons d’action situés à droite.
-
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 -
Accédez à l’emplacement suivant : C:\Program Files (x86)\Sage\BatigestConnectApi
-
Contrôlez les droits sur le répertoire. Ajoutez Contrôle total pour Tout le monde si nécessaire.
-
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.
- Ouvrez le Gestionnaire des services Internet (IIS).
- Dans la barre de recherche Windows, saisissez IIS.
- Appuyez sur Entrée.
- Vérifiez les composants nécessaires :
- Dans la section Pools d’applications, vérifiez la présence de SageBatigestConnectAppPool.
- Dans la section Sites, vérifiez la présence de SageBatigestConnectApi.
- Sélectionnez chaque élément et cliquez sur le bouton Redémarrer situé sur la droite
- Notez l’état du site et du pool d’applications après redémarrage.
- Prenez une capture d’écran.
▼ Étape 2 : Vérifiez si le healthbatigest est "Ok" ou non - Ouvrez un navigateur Internet et saisissez l’URL suivante : https://localhost/healthbatigest.
Ou - Lancez ConnexionManager.exe depuis le répertoire d’installation (par défaut : C:\Sage\BatigestConnect).
- 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 »
}}]}
- 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.
- 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.
- 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)
- 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
- 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 »
}}]}
- 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. - 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.
- 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 :
- Ouvrez le pare-feu Windows.
- Désactivez-le temporairement.
- 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 :
- Ouvrez le fichier projet.ini.txt.
- Copiez le chemin UNC indiqué dans ce fichier.
- Collez ce chemin dans l’explorateur Windows.
- 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 :
- Remplacez le nom de la machine par son adresse IP dans le chemin UNC.
- Testez à nouveau dans l’explorateur Windows.
- 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 :
- Accédez au répertoire suivant : C:\Program Files (x86)\Common Files\Sage\PEBatiment\ComForFront
- Récupérez les fichiers de logs présents dans ce dossier.
- Solution ID
- 250324105730157
- Last Modified Date
- Sun Nov 16 11:42:16 UTC 2025
- Views
- 0