Connecteur GoFast
Prérequis
Avant de configurer le connecteur GoFast dans Wikit Connect :
- Un compte GoFast disposant des droits de lecture sur le nœud racine à synchroniser.
Configuration du connecteur
Le connecteur GoFast permet de synchroniser les documents stockés dans votre instance GoFast vers Wikit Semantics. Il exploite l'API de recherche GoFast pour découvrir et récupérer les contenus du nœud racine configuré.
| Nom du champ | Format / Type | Obligatoire | Commentaire |
|---|---|---|---|
| URL de l'instance | URL | ✅ | URL de votre instance GoFast (ex : https://gofast.monentreprise.fr) |
| Identifiant du nœud racine | Identifiant | ✅ | ID du nœud Alfresco/GoFast à partir duquel la synchronisation s'effectue (ex : 1812748). Disponible dans l'URL de votre dossier cible |
| Login | Texte libre | ✅ | Identifiant du compte utilisé pour l'authentification |
| Mot de passe | Mot de passe / Token | ✅ | Mot de passe du compte utilisé pour l'authentification |
| Désactiver la validation TLS | Oui / Non | ➖ | Désactive la vérification du certificat SSL. À n'utiliser qu'en cas de nécessité absolue (génère un avertissement dans les logs) |
| Nœuds à exclure | Liste de textes | ➖ | Liste des IDs de nœuds GoFast à exclure de la synchronisation |
💡 Les champs marqués ✅ sont obligatoires pour que le connecteur puisse fonctionner.
Fonctionnement du connecteur
Le connecteur GoFast fonctionne en synchronisation intelligente (smart sync) :
- Découverte des documents : le connecteur effectue une recherche fulltext dans le nœud racine configuré via l'API GoFast. Les résultats sont récupérés par pages de 50 documents.
- Filtrage des fichiers : seuls les formats supportés sont traités (
docx,html,json,md,pdf,txt,csv,xlsx). Les formats.pptx,.pptet.xlssont exclus. - Téléchargement du contenu : chaque document est téléchargé depuis l'API Alfresco embarquée dans GoFast. Le contenu est mis en cache pour éviter les téléchargements redondants lors d'un même cycle de synchronisation.
- Détection des changements : un document est mis à jour si sa date de modification ou son contenu (hash MD5) a changé depuis la dernière synchronisation.
- Gestion des suppressions : les documents présents dans Wikit Semantics mais absents de GoFast sont automatiquement supprimés.
- Exclusion par nœud : si le champ
Nœuds à exclureest renseigné, les documents appartenant à ces nœuds seront ignorés lors de la synchronisation.
FAQ
Comment trouver l'identifiant du nœud racine (nodeId) ?
Naviguez vers le dossier que vous souhaitez synchroniser dans l'interface GoFast. L'identifiant du nœud est affiché dans l'URL de votre navigateur, sous la forme https://gofast.monentreprise.fr/node/{nodeId}. Copiez la valeur numérique et renseignez-la dans le champ Identifiant du nœud racine.
Certains documents n'apparaissent pas dans Wikit Semantics après la synchronisation. Pourquoi ?
Plusieurs raisons peuvent expliquer l'absence de documents :
- Le format du fichier n'est pas supporté. Seuls les formats
docx,html,json,md,pdf,txt,csvetxlsxsont traités. Les fichiers.pptx,.pptet.xlssont exclus. - Le document ne dispose pas d'un identifiant Alfresco valide, auquel cas il est ignoré par le connecteur.
- Le nœud contenant le document est dans la liste
Nœuds à exclure.
Que se passe-t-il si un document est supprimé dans GoFast ?
Lors du prochain cycle de synchronisation, le connecteur détecte que ce document n'est plus présent dans GoFast et le supprime automatiquement de Wikit Semantics.
L'option "Désactiver la validation TLS" est-elle sécurisée ?
Cette option désactive la vérification du certificat SSL de votre instance GoFast. Elle génère un avertissement dans les logs et ne doit être utilisée que dans un environnement de test ou lorsque votre instance utilise un certificat auto-signé. En production, il est fortement recommandé d'utiliser un certificat SSL valide.