XWiki - Data Source
The xWiki data source connects to an xWiki instance and indexes its spaces and pages, so your assistant can answer questions over your wiki content and link back to the original page.
Add the xWiki connector
Open your assistant in the editor, switch to the Add data tab, click Add connector and choose xWiki.
Step 1: Connect to xWiki
QAnswer authenticates against the wiki with basic authentication, so it needs an xWiki account that can read the content you want indexed:
- xWiki base URL (required): the address of your xWiki instance, for example https://wiki.example.com.
- xWiki username (required): the user QAnswer signs in as. It only ever sees pages that user can read.
- Password (required): the password of that xWiki user.
- Wiki name (optional): the wiki to index on a multi-wiki instance. Left empty it defaults to "xwiki".
The Connector's name field above the steps is prefilled with "xWiki". Rename it when the assistant reads from more than one wiki — the name is what you see in the connector list afterwards.
Click Connect to verify the credentials. Once they are accepted, step 1 collapses and step 2 opens.
Step 2: Select spaces and pages to index
QAnswer lists the wiki as a tree, starting at its root. Nothing is indexed until you pick something:
- Check a space to include it together with every page and sub-space nested beneath it.
- Expand a space with the arrow to drill down and check only the pages or sub-spaces you need.
- A parent with a partial selection shows a dash instead of a tick, so you can always see where a selection reaches.
- Click Finish to save the connector and start indexing in the background.
Indexed pages
Back on the Add data tab, the connector row shows how many pages it holds and how much space they take. Expand it to see every indexed page:
- The Status column and the status filter show which pages finished indexing and which are still pending.
- The search field finds a page by title inside the connector.
- The open icon jumps straight to the original page in your xWiki instance.
- The content icon shows the text QAnswer extracted from that page, and the row menu holds the per-page actions.
Adding more spaces later
To index more of the wiki, click Add files on the connector row. The same row also lets you download the indexed content, rename the connector, or delete it with everything it indexed.
Keeping the index up to date
xWiki pages change, so the connector can re-ingest them for you. Open Update Files on the connector row and pick how often that should happen:
- Never: no automatic refresh — the default, and what a fresh connector is set to.
- Now: run a refresh immediately, re-ingesting the selected pages whose xWiki version changed.
- Daily, Weekly, Monthly: refresh on that schedule from now on. The option currently in force stays highlighted in the menu.
Troubleshooting
Connection failed
- Check that the base URL points at your xWiki instance and is reachable from QAnswer.
- Check that the username and password are correct and the account is enabled.
- Confirm the wiki name matches an existing wiki (it defaults to "xwiki").
No spaces or pages listed
- Make sure the xWiki user has read access to the spaces you expect to see.
- Some spaces hold only sub-spaces; expand a space to reach its pages.