TheaterEncyclopedie:Ontologie van de TheaterEncyclopedie/Realisatie/Bijwerken Productiepagina's

Deze pagina beschrijft het plan van aanpak voor het bijwerken van productiepagina's ten behoeve van de aanpassingen voor het semantisch annoteren van "uitvoerenden" (realisatie productie). Het bijwerken van de pagina's gebeurt na aanpassing van het Tinbot-script en implementatie van het ontwerp in het Sjabloon:Productiepagina_realisatie (test:Sjabloon:Productiepagina_realisatie).

Doelstelling

Primair

1. Het toevoegen van de semantische annotaties m.b.t. realisatie/uitvoerenden aan productiepagina’s door middel van een sjabloon,
   • conform de gegevens zoals nu in Adlib geregistreerd
   • conform de door gebruikers aan de TE toegevoegde informatie (indien aanwezig)
2. Het (redundant) toevoegen van de categorie-informatie
   • conform de gegevens zoals nu in Adlib geregistreerd
   • conform de door gebruikers aan de TE toegevoegde informatie (indien aanwezig)

Secundair

1. Het verwijderen van de redundante categorie-informatie
2. Het toevoegen van lijsten (uitvoerenden/realisatie) en opmaak op basis van de geregistreerde informatie
   • Nader uitwerken welke lijsten en welke opmaak
   • Het verwijderen van redundante bestaande lijsten (vrije tekst)
3. Het met behulp van een formulier bewerken van de semantische gegevens (indien dit mogelijk is in combinatie met het tinbot-script; gegevens worden overschreven?)

Randvoorwaarden

1. “Tijdens de verbouwing blijft de winkel open” - de TE kan ten hoogste voor een korte periode niet beschikbaar zijn voor bewerking (zgn. “freeze”)
2. Geen gegevensverlies binnen de TE (ook niet als de informatie binnen Adlib beschikbaar blijft)
3. Geen gegevensvervuiling en bij voorkeur opschonen van gegevens
4. Beperking en bij voorkeur vermindering van gegevensredundantie (dubbeling van informatie)
5. Reversibel; de totale actie (en/of gedefinieerde stappen) moeten ongedaan gemaakt kunnen worden
6. Beperking handmatige bewerkingen
7. Beperkte doorlooptijd

Methodiek

Er is een aantal verschillende methoden denkbaar om de gegevens bij te werken. De verschillende methoden zullen tot op zekere hoogte worden uitgewerkt om de haalbaarheid en voor- en nadelen te vergelijken en zo een goede keuze te maken.

Het sjabloon:Productiepagina uitvoerenden / realisatie

Bij alle beschreven methoden wordt uitgegaan van het plaatsen (en invullen) van het sjabloon:Productiepagina realisatie (oftewel Sjabloon:Productiepagina uitvoerenden in de oude benaming). Dit sjabloon heeft de volgende functies:

1. Het zorgt voor de semantische annotatie; het toewijzen van de waarden aan de gedefinieerde eigenschappen
2. Het realiseert de toewijzing aan categorieën; het plaatsen van productiepagina in de (conventionele) categorieën
3. Het samenstellen en weergeven van lijsten op de productiepagina; het plaatsen van een (ongenummerde) lijst op de productiepagina.

De werking van het sjabloon is instelbaar; alle drie de bovengenoemde functionaliteiten kunnen los van elkaar eenvoudig aan- of uitgezet worden. Het is dus (ook) mogelijk dat het sjabloon op de pagina geen enkele (on)zichtbaar effect heeft. (Dit heeft dan alleen nut indien er fouten optreden.)

De werking van het sjabloon kan aangepast worden. Zonder dat de productiepagina's aan te passen, kan op een later tijdstip de werking van het sjabloon worden aangepast, uitgebreid of juist deels uitgeschakeld. Dit kan nuttig zijn, wanneer op een later tijdstip wenselijk is om de weergave van lijsten aan te passen of de toewijzing aan de conventionele categorieën te beëindigen (opschonen).

Het is de bedoeling dat het Sjabloon:Productiepagina realisatie een vaste plaats krijgt op de pagina, direct onder het Sjabloon:Productie (of het legacy Sjabloon:Infobox productie).

Methode 1 - Bijwerken uitgaande van informatie op TE door middel van "Zoek en vervang"

In grote lijnen ziet de aanpak volgens deze methode er als volgt uit:

1. Back-up van de nul-situatie bewaren / apart zetten (en liefst ook testen) - er vanuit gaande dat er dagelijkse back-ups gemaakt worden.
2. Toevoegen van het test:sjabloon:productiepagina_realisatie met (alle) lege velden (zonder gegevens)
   • aan alle pagina's met het sjabloon:Productie
   • aan alle pagina's met het sjabloon:Infobox productie
3. Met behulp van "zoek en vervang" specifieke categorie-gegevens kopiëren naar het sjabloon van productie-pagina's
4. Met behulp van "zoek en vervang (verwijder)" specifieke categorie-gegevens verwijderen van productie-pagina's

Methode 2 - Bijwerken uitgaande van informatie in Adlib dmv Tinbot (& zonodig aangevuld met 1)

In grote lijnen ziet de aanpak volgens deze methode er als volgt uit:

1. Back-up van de nul-situatie bewaren / apart zetten
2. Toevoegen van test:sjabloon:productiepagina_realisatie met de gegevens conform Adlib (terwijl de conventionele categorie-toewijzingen blijft bestaan, in de vrij tekst)
   • aan alle door overige gebruikers “onbewerkte pagina’s”
   • aan alle door overige gebruikers “bewerkte pagina’s”
3. Toevoegen van test:sjabloon:productiepagina_realisatie aan pagina’s die door gebruikers zijn aangemaakt (en niet voorkomen in Adlib)
   • Overeenkomstig methode 1 de informatie van categorieën naar sjabloon overbrengen

Opmerking: Uit TE:Documentatie_TINbot is niet 100% duidelijk of Tinbot wel/niet altijd de categorie-gegevens overschrijft (deze staan immers in het veld "vrije tekst").

• Als dit wel zo is, dan kan Adlib de complete sjabloon invullen
• Als dit niet zo is, dan moeten de gegevens nog aangevuld worden met door co-creator/gebruikers toegevoegde categorie-informatie.

Uit het antwoord van Heidi blijkt dat Tinbot geen bewerkte categorie-gegevens overschrijft.

Hulpmiddelen

Om productiepagina's bij te werken zijn de volgende hulpmiddelen beschikbaar:

• De redactiepagina Speciaal:TekstVervangen (en test:Speciaal:TekstVervangen) - alleen bereikbaar met wiki-adminrechten
• Het maintenance script replaceAll.php behorend bij de Extensie:ReplaceText

Gebruik van Regex bij TekstVervangen / replaceAll.php

Zowel de redactiepagina als het maintenance script accepteren Reguliere Expressies (Regex) om flexibel zoek-en-vervang opdrachten te formuleren.

Voorbeelden Zoek-en-vervang opdrachten voor:

• Het toevoegen van wikitekst van het sjabloon:Productiepagina_realisatie onder het sjabloon:Productie
• Het vervangen van een categorie:uitvoerende_naam door een veld in een sjabloon.
• Enkel Producties waar nog geen Productiepagina realisatie op staat. [1]

NB: Voor deze opdrachten gebruikt kunnen worden, moeten ze verder uitgewerkt en getest worden!

Zie verder Ontwikkeling en testen voor TekstVervangen

Benodigde opdrachten

Eerste inventarisatie van benodigde zoek-en-vervangopdrachten

• Plaatsen van sjabloon:Productiepagina_realisatie op:
  • Op pagina's met sjabloon:Productie
  • Op pagina's met sjabloon:Infobox productie
• Overnemen van categorie informatie in sjabloon:
  • Category:Producties <producent> : check redundantie infobox
  • Category:Premieres <theater> : check redundantie infobox
  • Category:Auteur <naam persoon> (zowel 1e als volgende toewijzingen)
  • Category:Regie <naam persoon> (zowel 1e als volgende toewijzingen)
  • Category:Uitvoerende <naam persoon> ...
  • ...
  • zie lijst
• Verwijderen van categorie informatie van pagina's (indien sjabloon aanwezig)
  • Category:regie <naam>
  • Category:...
  • ...
  • zie lijst

Stappenplan zoek-en-vervang opdracht

Voorbereiding voor alle opdrachten:

• Enkele productie-pagina's van de TE selecteren als referentie/test-tekst voor Regexr.com

Ontwikkeling en testen per opdracht:

1. Ontwikkelen en testen binnen regexr.com omgeving
2. Testen op Test-TE via Speciaal:TekstVervangen
3. CLI opdracht samenstellen en documenteren
4. CLI opdracht uitvoeren en testen op Test-TE

Uitvoering op productie-TE:

• Plannen uitvoering op Productie-TE
• Uitvoeren en testen resultaten

Risicobeheer

Omdat het in dit project mogelijk is de TheaterEncyclopedie (onherstelbaar) te beschadigen, is een inventarisatie van risico's gemaakt. Bij ieder risico is vervolgens aangegeven wat de maatregelen zijn om dit risico te neutraliseren.

Afbreukrisico bijwerken productiepagina's

Als gevolg van menselijke of technische oorzaken, kan mogelijk het onderdeel "Bijwerken van de productiepagina's" niet worden voltooid.

Maatregelen:

• Indien alleen nog sjabloon-informatie is toegevoegd:
  • Werking van het sjabloon "uitschakelen", zodat op een later tijdstip eventueel verder kan worden gewerkt
  • Het sjabloon verwijderen van de Productiepagina's (d.m.v. eenvoudige "zoek-en-verwijder"-opdracht)
• Indien voorgaande maatregelen niet effectief zijn: Back-up van de uitgangssituatie terugzetten

Fout bij het toevoegen van sjabloon

Bij het toevoegen van het sjabloon op de productiepagina's (onder het sjabloon:Productie of Sjabloon:Infobox productie) ontstaan fouten

Maatregelen:

• Indien het gaat om maximaal enkele tientallen identificeerbare pagina's:
  • Handmatig corrigeren
• Indien het sjabloon op de verkeerde plaats wordt toegevoegd
  • Het sjabloon verwijderen (d.m.v. zoek-en-verwijder-opdracht)
• Indien voorgaande maatregelen niet effectief zijn: Back-up van de uitgangssituatie terugzetten

Fout bij het verwijderen van redundante categorie-toewijzingen

Bij het verwijderen van de "oude" (redundante) categorie-toewijzingen van de productiepagina's kunnen fouten ontstaan.

Maatregelen:

• Indien niet alle categorieën zijn verwijderd (vervuiling)
  • Handmatig verwijderen (alleen mogelijk indien het probleem van beperkte omvang is)
  • Herziene zoek-en-verwijder opdracht(en) opstellen, testen en uitvoeren.
• Indien voorgaande maatregelen niet effectief zijn: Back-up van de uitgangssituatie terugzetten

Extra Maatregel:

Omdat het in deze fase van het project terugplaatsen van de back-up van de uitgangssituatie een groot verlies aan arbeid zou betekenen, is het raadzaam na het (correct) voltooien van het toevoegen van de sjablonen een nieuwe (tussen-)back-up te maken.

Fout in output van nieuwe Tinbot-script

Nog aan te vullen

Fouten die pas na verloop van tijd ontdekt worden

Nog aan te vullen