Connecteur XWiki
Prérequis
Avant de configurer le connecteur XWiki dans Wikit Connect :
- Une instance XWiki accessible depuis les serveurs Wikit Connect.
- Un compte utilisateur disposant des droits de lecture sur les wikis et espaces à synchroniser (si l'authentification est activée).
- L'API REST XWiki doit être activée sur votre instance (activée par défaut dans XWiki).
Configuration du connecteur
Le connecteur XWiki permet de synchroniser les pages et pièces jointes de votre instance XWiki vers Wikit Semantics. Il prend en charge la synchronisation multi-wiki et permet de cibler des espaces précis.
| Nom du champ | Format / Type | Obligatoire | Commentaire |
|---|---|---|---|
| URL de base | URL | ✅ | URL de votre instance XWiki (ex : https://xwiki.monentreprise.fr) |
| Identifiant du wiki | Identifiant | ➖ | ID du wiki cible. Si non renseigné, tous les wikis de l'instance sont découverts automatiquement |
| Espaces à synchroniser | Liste de textes | ➖ | Liste des identifiants d'espaces à synchroniser. Si non renseigné, tous les espaces sont synchronisés. Exemple : test inclut test, test/toto, test/pagetest1 |
| Espaces à exclure | Liste de textes | ➖ | Liste des identifiants d'espaces à exclure de la synchronisation (filtre sur le nom court de l'espace) |
| Activer l'authentification | Oui / Non | ➖ | Activez cette option si votre instance XWiki requiert une authentification pour accéder à l'API |
| Nom d'utilisateur | Texte libre | ➖ | Nom d'utilisateur pour l'authentification Basic (obligatoire si l'authentification est activée) |
| Mot de passe | Mot de passe / Token | ➖ | Mot de passe pour l'authentification Basic (obligatoire si l'authentification est activée) |
| Inclure les pièces jointes | Oui / Non | ➖ | Activez cette option pour synchroniser également les fichiers joints aux pages XWiki |
💡 Les champs marqués ✅ sont obligatoires pour que le connecteur puisse fonctionner.
Fonctionnement du connecteur
Le connecteur XWiki fonctionne en synchronisation de pages et de pièces jointes :
- Découverte des wikis : si le champ
Identifiant du wikiest renseigné, seul ce wiki est traité. Sinon, tous les wikis disponibles sont découverts automatiquement via l'API XWiki. - Découverte des espaces : pour chaque wiki, l'ensemble des espaces (parents et enfants) est récupéré. Si
Espaces à synchroniserest renseigné, seuls les espaces dont le chemin correspond exactement ou commence par l'un des identifiants fournis sont traités. Les espaces dont le nom figure dansEspaces à excluresont ignorés dans tous les cas. - Synchronisation des pages : pour chaque espace, les pages sont récupérées (jusqu'à 1 000 par espace). Le contenu HTML de chaque page est téléchargé puis converti en Markdown avant d'être stocké dans Wikit Semantics.
- Synchronisation des pièces jointes : si
Inclure les pièces jointesest activé, les fichiers joints à chaque page sont récupérés et synchronisés. Seuls les types de fichiers supportés par Wikit Connect sont traités.
FAQ
Comment cibler un espace spécifique et ses sous-espaces ?
Renseignez l'identifiant court de l'espace dans le champ Espaces à synchroniser. Par exemple, en saisissant test, le connecteur synchronisera l'espace test ainsi que tous ses sous-espaces (test/toto, test/pagetest1, etc.). Vous pouvez saisir plusieurs identifiants pour cibler plusieurs espaces distincts.
Comment exclure un espace de la synchronisation ?
Renseignez le nom court de l'espace dans le champ Espaces à exclure. Ce filtre s'applique sur le nom court de l'espace (dernière partie du chemin) et est actif quelle que soit la configuration du champ Espaces à synchroniser.
Les pièces jointes de toutes les pages sont-elles synchronisées ?
Seules les pièces jointes dont le type de fichier est supporté par Wikit Connect sont synchronisées. Les formats non reconnus sont ignorés. Assurez-vous que l'option Inclure les pièces jointes est activée pour que les pièces jointes soient prises en compte.
L'instance XWiki est accessible sans authentification. Faut-il tout de même renseigner un identifiant ?
Non. Si votre instance XWiki autorise les accès anonymes en lecture, vous pouvez désactiver l'option Activer l'authentification et laisser les champs Nom d'utilisateur et Mot de passe vides. Toutefois, pour les instances en accès restreint, l'authentification est obligatoire.