XWiki - Source de données
La source de données xWiki se connecte à une instance xWiki et indexe ses espaces et ses pages, afin que votre assistant réponde aux questions portant sur le contenu du wiki et renvoie vers la page d'origine.
Ajouter le connecteur xWiki
Ouvrez votre assistant dans l'éditeur, allez dans l'onglet Add data cliquez sur Add connector puis choisissez xWiki.
Étape 1 : se connecter à xWiki
QAnswer s'authentifie auprès du wiki en authentification basique : il lui faut donc un compte xWiki pouvant lire le contenu à indexer :
- xWiki base URL (obligatoire) : l'adresse de votre instance xWiki, par exemple https://wiki.example.com.
- xWiki username (obligatoire) : l'utilisateur avec lequel QAnswer se connecte. Il ne voit que les pages que cet utilisateur peut lire.
- Password (obligatoire) : le mot de passe de cet utilisateur xWiki.
- Wiki name (facultatif) : le wiki à indexer sur une instance multi-wiki. Laissé vide, il vaut « xwiki ».
Le champ Connector's name au-dessus des étapes est prérempli avec « xWiki ». Renommez-le si l'assistant lit plusieurs wikis : c'est ce nom qui apparaît ensuite dans la liste des connecteurs.
Cliquez sur Connect pour vérifier les identifiants. Dès qu'ils sont acceptés, l'étape 1 se replie et l'étape 2 s'ouvre.
Étape 2 : choisir les espaces et les pages à indexer
QAnswer affiche le wiki sous forme d'arborescence, à partir de sa racine. Rien n'est indexé avant votre sélection :
- Cochez un espace pour l'inclure avec toutes les pages et sous-espaces qu'il contient.
- Dépliez un espace avec la flèche pour descendre et ne cocher que les pages ou sous-espaces voulus.
- Un parent partiellement sélectionné affiche un tiret au lieu d'une coche : vous voyez toujours jusqu'où va la sélection.
- Cliquez sur Finish pour enregistrer le connecteur et lancer l'indexation en arrière-plan.
Pages indexées
De retour dans l'onglet Add data, la ligne du connecteur indique le nombre de pages et l'espace qu'elles occupent. Dépliez-la pour voir chaque page indexée :
- La colonne Status et le filtre de statut montrent quelles pages sont indexées et lesquelles sont encore en attente.
- Le champ de recherche retrouve une page par son titre dans le connecteur.
- L'icône d'ouverture mène directement à la page d'origine dans votre instance xWiki.
- L'icône de contenu affiche le texte extrait par QAnswer, et le menu de la ligne regroupe les actions page par page.
Ajouter d'autres espaces plus tard
Pour indexer davantage de contenu, cliquez sur Add files sur la ligne du connecteur. Cette même ligne permet aussi de télécharger le contenu indexé, de renommer le connecteur ou de le supprimer avec tout ce qu'il a indexé.
Maintenir l'index à jour
Les pages xWiki évoluent : le connecteur peut les réindexer pour vous. Ouvrez Update Files sur la ligne du connecteur et choisissez la fréquence :
- Never : aucun rafraîchissement automatique — la valeur par défaut d'un nouveau connecteur.
- Now : lance un rafraîchissement immédiat, en réindexant les pages sélectionnées dont la version xWiki a changé.
- Daily, Weekly, Monthly : rafraîchit selon cette fréquence à partir de maintenant. L'option active reste mise en évidence dans le menu.
Dépannage
Échec de la connexion
- Vérifiez que l'URL de base pointe vers votre instance xWiki et qu'elle est joignable depuis QAnswer.
- Vérifiez que le nom d'utilisateur et le mot de passe sont corrects et que le compte est actif.
- Assurez-vous que le nom du wiki correspond à un wiki existant (« xwiki » par défaut).
Aucun espace ni page affiché
- Assurez-vous que l'utilisateur xWiki a accès en lecture aux espaces attendus.
- Certains espaces ne contiennent que des sous-espaces ; dépliez l'espace pour atteindre ses pages.