Pagina voor allerlei notities, ideeën en random opmerkingen op gebied van de verhuizing van Quaestor.org naar Confluence. Tevens doet dit artikel dienst als proefkonijn voor het testen van mogelijke verbetering van Confluence, macro's en dat soort dingen. 

Problemen

Linking

In Quaestor.org gaat het linken anders dan in Confluence. Bij Confluence wordt de naam van het artikel gebruikt als identifier, bij Quaestor.org is deze identifier in de link anders dan de naam van het artikel. Als de identifiers in de links hetzelfde gehouden moeten worden (zoals ze in .org zijn) ivm Quaestor moeten de namen van de artikels in Confluence hetzelfde zijn als de identifiers in de links van .org, en dat ziet er niet erg netjes uit. 

EDIT: er is besloten om de titels leesbaar te houden en het aan te passen binnen Quaestor.

Ideeën

Confluence CLI 

Confluence bied een aantal macro's om bepaalde acties te automatiseren, denk hierbij aan het toevoegen van code blokken, HTML divs en inhoudsopgaven. Maar wat deze macro's niet blijken te kunnen is het aanpassen en/of toevoegen van grote hoeveelheden pagina's. Batch acties dus. Hiervoor is iets anders beschikbaar: de Confluence CLI. 

De Quaestor wiki heeft een aantal onderdelen waarbij sommige stukken tekst steeds terug komen, zoals de Quick Links onderaan een beschrijving van een attribute. Aangezien er 258 attributen en dus 258 artikelen staan waarin deze links moeten komen is dit een hoop werk om handmatig te doen. Ook komt het de precisie niet ten goede als dit met de hand wordt gedaan en moet de tekst mogelijk later weer aangepast worden. Bij dit soort situaties is de maker van de documentatie (en eigenlijk ook de gebruikers) gebaat bij een tool die dit middels een script in een keer kan doen. Confluence CLI lijkt deze mogelijkheid, en nog veel meer, te bieden. 

Werking

De CLI wordt geleverd met een aardig uitgebreide documentatie. Naast deze documentatie beschrijft deze blog hoe de installatie van CLI moet gebeuren. Hieronder in een notendop wat er moet gebeuren om de CLI werkend te krijgen.

1. De CLI maakt gebruik van de Remote API mogelijkheid van Confluence. Dit moet eerst geactiveerd worden door een gebruiker met Admin rechten (een Space Admin kan dit niet doen) 
2. Download en unzip dit archief op een logische plaats, C:/Confluence CLI bijvoorbeeld

3. In de bijgeleverde batch file confluence.bat moeten de server, username en password worden ingevuld om connectie te kunnen maken met de Remote API van Confluence

4. Nu kan deze batch file worden uitgevoerd met parameters die de acties beschrijven, bijvoorbeeld: --action removePage --space “DOCS” --title “IRC Chat Transcripts” --descendents verwijderd all child pages van het artikel met de naam 'IRC Chat Transcripts' binnen de space genaamd 'DOCS'

confluence -a runFromSql --common "-a run --file appendPage.txt" --database confluence-3.5.13 --driver postgresql --sql "select '--findReplace \"@title@:''' || content.title || ''',@space@:' || spaces.spacekey || '\"' from content, spaces where content.title like '%title 1%' and content.spaceid = spaces.spaceid"