NORA Online:Werkversies

Doel

Ingrijpende wijzigingen voorbereiden die je eerst helemaal klaar wilt hebben voor je het publiceert. Waarom zou ik een wijziging niet direct zichtbaar willen maken? In principe is elke wijziging terug te draaien en kan het weinig kwaad als er tijdelijk iets 'verkeerds' zichtbaar is voor bezoekers. Toch kunnen we ons voorstellen dat er uitzonderingen zijn:

• Je bewerkt een pagina die voorschrijvend is (die pagina's zijn overigens beveiligd tegen bewerken door niet-beheerders)
• Je wilt meerdere pagina's tegelijk aanpassen, die naar elkaar verwijzen
• Je krijgt de wijzigingen niet direct af waardoor een 'halve' pagina ontstaat die onleesbaar is voor bezoekers
• Je wilt de pagina pas publiceren nadat een collega of expertgroep er naar heeft gekeken

Uitleg

Met Werkversies heeft NORA een methode om aan een nieuwe versie van een pagina te werken terwijl de bestaande pagina nog bestaat en gebruikt kan worden. Er kan gefilterd worden op werkversies of op 'gewone' versies.

Deze methode maakt gebruik van een aparte naamruimte voor werkversies. Een naamruimte is een voorgeconfigureerde plek in de wiki. In dit geval wordt dat elke pagina wiens naam begint met 'Werkversie:'. Op de plek waar je normaal 'Pagina' ziet staan, zie je 'Werkversie' staan.

To do: De daadwerkelijke naamruimte moet nog aangemaakt worden.

Het verschil met concepten

Een pagina heeft in principe altijd een Eigenschap:Status actualiteit. Voor werkversies zet je die per definitie op 'concept'. Heeft de oorspronkelijke pagina die niet, set deze dan met de code: [[Status actualiteit::Concept]] , of vul het invoerformulier in.

Het is niet per se nodig een werkversie te maken om een concept te publiceren, dat is alleen nodig wanneer je een bestaande pagina in stand wilt houden tijdens het maken of aanpassen van een concept. Oftewel wanneer je wijzigingen niet direct zichtbaar wilt maken voor bezoekers.

Waar kun je wel en niet werkversies van maken?

<hier een aantal koppen hieronder samenvatten en/of er naar verwijzen>

1. Controleer of de pagina inderdaad al bestaat en of je de huidige pagina wil bewaren terwijl je aan een werkversie gaat werken. Zo nee kun je je wijzigingen direct in de bestaande pagina maken, dat scheelt een hoop werk.
2. Heeft de bestaande pagina een invoerformulier alleen een tabblad bewerken, of is er ook een tabblad bron bewerken? In het tweede geval is er sprake van een zogenaamde gestructureerde pagina. Neem even contact op met NORA Beheer als je werkversies van gestructureerde pagina's wilt gaan maken.

Aanmaken van een werkversie van een gewone (ongestructureerde) pagina

Pagina aanmaken

1. Ga naar de pagina waar je een werkversie van wilt maken en kopieer de titel van de pagina (selecteren en control-c)
2. Ga in een ander tabblad naar het zoekveld rechtsboven in beeld
   1. type in Werkversie:
   2. plak de titel direct achter de dubbele punt (geen spatie) met control-v
   3. klik op het vergrootglas of gebruik enter om te zoeken
   4. klik in de zoekresultaten op 'Pagina aanmaken'

Pagina vullen met kopie van origineel

1. Ga terug naar het tabblad met de originele pagina en selecteer de hele code
   1. klik op bewerken
   2. klik ergens in het bewerkingsvenster
   3. gebruik control-a om alle tekst & code te selecteren
   4. gebruik control-c om het geselecteerde naar je plakbord te kopiëren
2. ga naar het andere tabblad, waarin de werkversie aangemaakt wordt
   1. kopieer het geselecteerde met control-v
   2. voeg bovenaan de code het sjabloon Werkversie toe (

       {{Werkversie}}

      ), dit zorgt dat het voor bezoekers duidelijk is dat het een werkversie betreft en wat de originele pagina is
   3. geef als samenvatting van je wijzigingen een tekst op als 'werkversie aangemaakt' en klik op 'wijzigingen opslaan'

Wijzigingen aanbrengen ten opzichte van het origineel

Je kunt de werkversie net zo bewerken als het origineel en alle aanpassingen doe die je nodig vindt. Verwijzingen naar gewone pagina's, lijsten, zoekopdrachten et cetera werken net zo als in het origineel. Maak je van meerdere pagina's werkversies, omdat je ze in samenhang met elkaar wilt bewerken? Dan kun je er voor kiezen om onderlinge links naar de werkversie te leggen in plaats van naar het origineel, door Werkversie: te zetten voor de titel van de pagina waar je heen verwijst.

Bij de uiteindelijke migratie van de werkversie naar het gewone deel van de wiki kunnen we die extra 'Werkversie:' er automatisch weer uit halen.

<De komende paar kopjes kunnen wellicht beter samengevat worden onder de kop Waar kun je (geen) werkversie van maken?>

Werkversies van het kennismodel

Elementtypen zetten we niet in de werkversie-naamruimte. Als je wil werken aan een aangepast elementtype, kun je het best een tijdelijk elementtype maken.

Werkversies van sjablonen gebruiken

Je kan ook van een sjabloon een werkversie maken, als je 'Sjabloon:' er tussen zet in de naam. Bij voorbeeld: Werkversie:Sjabloon:voorbeeld. Je verwijst naar die sjabloon met: {{Werkversie:Sjabloon:voorbeeld}}. Tijdens overzetten naar hoofdnaamruimte wordt dat aangepast

Werkversies afbeeldingen

Afbeeldingen kunnen geen werkversie krijgen. Maak eventueel gewoon een nieuwe pagina met een nieuwe afbeelding aan.

Bevragingen (queries)

In principe doe je de semantische bevragingen gewoon met een extra filter: [[Status actualiteit::Actueel]] of [[Status actualiteit::Concept]]. Je kan ook een check doen op de naamruimte: [[:+]] voor hoofdnaamruimte, [[Werkversie:+]] voor alleen werkversie-naamruimte.

Check: pagina's in Werkversie-naamruimte die status 'actueel' hebben

To do: check dat query werkt nadat de naamruimte geconfigureerd is

(Applicatie)code is beschermd tegen ongeautoriseerde wijzigingen, (Software)configuratiebeheer, 14+ netnummer, ADMS (Asset Description Metadata Schema), AES, AES, AI & Algoritmen, API, API (begrip), API Principes, API-contactpersonen, APIs, APIs, ASN.1, ASN.1, AVG (Algemene Verordening Gegevensbescherming), Aan het architectuurdocument gestelde eisen, Aan het management worden evaluatierapportages verstrekt, Aan privacy gerelateerde vraagstukken, Aanbevelingen metadatamanagement... meer resultatenHet deel "]]" van de zoekopdracht is niet begrepen.</br>De resultaten kunnen afwijken van de verwachting.

Schakelen tussen werkversie en echte versie

To do: sjabloon Werkversie-schakelaar maken

Neem deze sjabloon op: Sjabloon:Werkversie-schakelaar.

Deze kijkt of er een werkversie is met dezelfde naam, of als je naar een werkversie kijkt, of er pagina in de hoofdnaamruimte is met dezelfde naam. Als dat zo is, toont hij een link erheen. Aan te raden om deze sjabloon in al je metadata-kaders op te nemen zodat je hem altijd ziet.

Migratie naar echte versie

Maak een script van welke pagina's je wil veranderen.

Losse pagina: kopiëren en plakken

Plaats gewoon de broncode van de werkversie naar de hoofdnaamruimte.

• Vervang links naar werkversies, naar links in hoofdnaamruimte
• Actualiseer 'status actualiteit'

Reeks pagina's: via Joris

Pagina's worden geëxporteerd uit de wiki, eventuele veranderingen worden er op uitgevoerd, en de pagina's worden geïmporteerd in de wiki.

• geef aan of Status actualiteit aangepast moet worden
• geef aan of een tijdelijk elementtype moet worden veranderd (zowel in de elementen aanpassen als in het kennismodel)
• includeer template-sjablonen. Dit kan automatisch gedaan worden door Speciaal:Exporteren
• exporteer naar XML-bestand
• bewerk XML-bestand eventueel en doe vervangacties (Joris gebruikt daar Notepad++ voor omdat daar een zoek-en-vervang met regex in zit)
  • |Status actualiteit=Concept naar |Status actualiteit=Actueel
  • vervangen van namespaces is niet nodig via regex, want je kan bij importeren kiezen voor hoofdnaamruimte (sjablonen worden alsnog in Sjabloon-ruimte gezet als je ze Werkversie:Sjabloon:xxx hebt genoemd). Code zou anders iets zijn met <title>Werkversie:(.*)</title>\n(.*)<ns>3050</ns> naar <title>$1</title>\n$2<ns>0</ns>
  • vervangen van links (en inclusies) naar andere werkversie-pagina's, regex: ([\[\{]{2})[wW]erkversie: naar $1
  • check of nog elders 'werkversie' staat (met en zonder hoofdletter w), met name in queries
• XML uploaden naar Speciaal:Importeren
  • Interwikivoorvoegsel: ""
  • Importeren naar een naamruimte: (hoofdnaamruimte)

Nederlandse Overheid Referentie Architectuur.