TheaterEncyclopedie:Koppeling met Nationaal Archief

Uit TheaterEncyclopedie
Ga naar: navigatie, zoeken

Deze pagina is een vervolg op TE:Koppeling met beeldbanken#Koppeling met Nationaal Archief. Zie ook Nationaal Archief - Theaterfoto's

Inleiding

In december 2022 heeft I-trainee Jaime Boer, werkzaam bij het Nationaal Archief een datastory opgeleverd waarin zij een koppeling legt tussen gegevens van de Theaterencyclopedie en foto’s van het Nationaal Archief. Zie deze datastory en een meer (technisch) verslag van het project en zoek naar: Projectverslag Nationaal Archief en Theaterencyclopedie.

Dit project “Theaterencyclopedie: Koppeling met foto’s Nationaal Archief” is een vervolg op de datastory van Jaime Boer. De datastory staat op de NDE site en staat los van de website van de Theaterencyclopedie en/of de website van het Nationaal Archief. Het was een geslaagd experiment om de mogelijkheden van Linked open data in deze context te onderzoeken maar de gewenste situatie is de foto’s van het NA duurzaam te linken naar de Theaterencyclopedie.

Zie ook: Beschrijving van de datasets in Triply.

Doelstellingen

De doelstelling voor het project zoals gedefinieerd in het projectplan
Doel van dit project is de foto’s van het NA (FNA) te publiceren op de website van de Theaterencyclopedie (TE) en dit ook duurzaam en conform de DERA te doen.
Doelstellingen uitgewerkt (voorstel BM)
  1. Tot stand brengen van technische koppeling tussen TE en NA-beeldbank, conform DERA en aansluitend op de TE-ontologie.
  2. Het (kunnen) publiceren van afbeeldingen uit de NA-beeldbank op een pagina in de TE als foto-galerij behorend bij een persoon, productie of theater.
  3. Het (automatisch) ondersteunen van de redactie van de TE bij het ontdekken van relevante foto's in de NA-beeldbank.


Resultaten

  1. Project Start Architectuur om de oplossing voor dit project ook conform de DERA en aansluitend op de ontologie van de TE te realiseren.
  2. NA foto’s gepubliceerd op de website van de theaterencyclopedie:
    1. Op enkele persoonspagina's en productiepagina's
    2. Op Help-pagina ter ondersteuning van TE-redactie (zoek-functionaliteit)
    3. (Zo mogelijk... in concept op Test-TE) op bewerkingsformulieren ter ondersteuning van de TE-redactie)


Resultaten buiten scope:

  1. Lokaal bewerken en toevoegen van annotaties aan beeldmateriaal
  2. Toevoegen van nieuw beeldmateriaal (in NA)
  3. Tools voor synchroniseren van data tussen TE en NA


Aanpak

Uitgangspunten:

  • De ervaring met het ontwikkelen van koppelingen is beperkt en tevens is het belang ervan voor de nabije toekomst groot; er zal dus nadrukkelijk gekeken worden naar alternatieve scenario's.
  • Het project heeft als doel om de technologie te ontwikkelen voor het koppelen van informatiebestanden, binnen het kader van Linked Open Data en DERA. In de aanpak zal dus ook extra aandacht zijn voor het ontwikkelen van deze technologie


Fasering

  1. Onderzoek & inventarisatie van verschillende scenario's
    1. Inventarisatie
    2. Besluitvorming
    3. Planning vervolg (ontwikkeling)
  2. Ontwikkeling van PoC / Test
    1. Ontwikkelingen binnen de omgeving van Test-TE en (beperkt, query?) binnen de NA-beeldbank
    2. Testen binnen projectgroep
    3. Evaluatie
    4. Planning vervolg (ontwikkeling/implementatie)
  3. Implementatie
    1. Migratie/implementatie van ontwikkelde onderdelen naar Productie-TE
    2. Invoering van benodigde informatie (aanmaken pagina's)
    3. Testen met gebruikers
    4. Evaluatie
  4. Planning Vervolg (?)


Ontologie


Aanpassing ontologie - april 2024

Om de TE-ontologie eenduidiger te maken en in lijn met Wikidata worden de volgende wijzigingen geïmplementeerd:

Ontwerp & PSA

Eerste inventarisatie van de ontwerpscenario's / Project Start Architectuur (PSA):

  1. "Wikimedia Commons"-scenario (waarschijnlijk niet haalbaar)
  2. "TheaterKrant"-scenario
  3. "Multimedia/Adlib"-scenario
  4. "Afbeeldingen/Adlib"-scenario
  5. "Theater / Wikidata"-scenario
  6. LinkedWiki-scenario (t.b.v discovery?)
  7. RDF/Triple-Store-scenario
  8. ...

Verdere uitwerking van de ontwerpscenario's op de pagina: TheaterEncyclopedie:Koppeling met Nationaal Archief/Ontwerp.


Planning

N.T.B.

Overgenomen uit PvA (Ed de Heer):

Kick off 23 februari 2023
Projectplan af 1 april
Inventarisatie (stap 1) 1 mei
Project Start Architectuur (stap 2) 15 mei
Realisatie (stap 3) 1 juli


Vervolg planning d.d. 7-9-2023

  1. Demo van PoC - Evaluatie ontwerp en werking
  2. Ontwikkeling van tools voor gebruikers
    • Tab met hints op formulier (Formulier:Persoon, Voorstelling, Werk, Foto
    • Query / To-do lijst voor editor met beschikbare foto's
  3. Ontwikkeling van import/aanmaak-procedure op Test-TE (ca. 100 afbeeldingen)
  4. Migratie beschikbare content naar Productie-TE


Realisatie

Update 26 juni 2023

Uitgevoerd:

Vervolg vanaf september 2023

Vervolg vanaf (oktober) november 2023

  • Importeren CSV / aanmaken totale set van 5061 afbeeldingspagina's
    • Importeren verloopt zonder problemen - duur is ongeveer 30 minuten
    • Vervolgens "resetten" van de Eigenschap:HeeftNAFotoURI, zodat die hierna wel goed wordt geannoteerd (deze handmatige correctie was al bekend uit de vorige "import"-test). Dit duurt nu iets langer agv grote aantal pagina's (ca. 30 minuten om alles te wissen en nogmaals 30 minuten om alles opnieuw te annoteren). NB: tijdens resetten is de weergave van bestaande galerijen verstoord!).
    • Probleem "Dubbele weergave personen in Infobox" doet zich voor op sommige nieuwe pagina's. Voorbeelden:
    • Opmerking/probleem: "Ontbrekende afbeeldingen" - er zijn voorbeelden dat er in het NA een (veel) groter aantal foto's beschikbaar is dan dat wordt weergegeven in de TE. Voorbeeld(en):
  • Overzetten van ontwikkelingen naar de Productie-TE
    • Overzetten van Sjablonen etc. , waaronder vier galerij-opties:
      1. Eenvoudige "automatische" galerij - geeft alle gerelateerde/gekoppelde foto's uit het NA op eenvoudige wijze weer
      2. Eenvoudige "handmatige" galerij - geeft op basis van Foto-ID's foto's uit het NA op dezelfde wijze als boven weer (PS: mogelijk ook functioneel voor nog niet gekoppelde foto's)
      3. Uitgebreide "automatische" galerij - geeft alle gerelateerde/gekoppelde foto's uit het NA met infobox in POP-UP weer
      4. Uitgebreide "handmatige" galerij - geeft op basis van Foto-ID's foto's uit het NA op dezelfde wijze als boven weer
    • Aanpassen van bewerkingsformulieren t.b.v. (Nog uit te voeren !!)
    • Meer mogelijkheden om foto's uit NA te ontdekken (t.b.v. TE-bewerkers) en op te nemen in galerij op de TE; TE:Koppeling met Nationaal Archief/Lijsten

Verstoring van de werking d.d. 4 juli 2023

  • Op dinsdag 4 juli 2023 om 11:00u geconstateerd dat de P0C-pagina's niet meer werken als gevolg van een foutmelding in de API-response
    • live link
    • Er lijkt een probleem te zijn met de sparal-service bij NDE (zie screenshot api-response in fotogalerij)
    • Zie de melding in het screenshot van de datastory op de site van NDE: "Could not show query result, the SPARQL endpoint is not accessible."
  • De link naar het fotorecord op de site nationaalarchief.nl functioneert normaal
  • Na een half uur zijn de eigenschappen nog normaal lokaal opgeslagen in de semantische database van de TE
  • De foto's op de persoonspagina's worden normaal weergegeven
  • De oorzaak van de verstoren bleek het aanpassen ("verplaatsen") van de accounts (van Jamie/Bart) bij NDE naar een algemene "nationaal-archief" account.
    • Technisch gezien verandert hierdoor de API-call (zie bijv. benodigde aanpassing - live link op Test-TE). Oplossing was dus de volgende aanpassing van BartMulckhuijse in nationaal-archief
      • Oorspronkelijke API-call: {{#get_web_data: url=https://api.data.netwerkdigitaalerfgoed.nl/queries/BartMulckhuijse/Alle-fotorecords-met-alle-gematchte-attr/run?zoeken={{urlencode:https://archief.nl/doc/fotorecord/{{{uuid-fr}}}}}
      • Aangepaste API-call: {{#get_web_data: url=https://api.data.netwerkdigitaalerfgoed.nl/queries/nationaal-archief/Alle-fotorecords-met-alle-gematchte-attr/run?zoeken={{urlencode:https://archief.nl/doc/fotorecord/{{{uuid-fr}}}}}


  • Voorbeeldweergave mediapagina met foutmelding

    Voorbeeldweergave mediapagina met foutmelding

  • Foutmelding van de API

    Foutmelding van de API

  • Probleem bij NDE

    Probleem bij NDE

  • Voorbeeld 1 persistentie van eigenschap

    Voorbeeld 1 persistentie van eigenschap

  • Voorbeeld 1 persistentie van eigenschap

    Voorbeeld 1 persistentie van eigenschap

  • Voorbeeld van persoonspagina (normaal)

    Voorbeeld van persoonspagina (normaal)

Wensenlijst / mancolijst voor toekomstige ontwikkelingen

Na de afronding van de implementatie van de eerste versie van de koppeling en het starten van het gebruik in de praktijk van de fotogalerij op diverse pagina's, zijn de volgende wensen voor verbetering of manco's aan de huidige werking naar boven gekomen:

  1. Verbeteren van de weergave-kwaliteit van "kleine" (thumbnail) afbeeldingen op diverse plekken
    • Er wordt in de API-koppeling nu alleen gebruik gemaakt van de "volledige" afbeelding of de "thumbnail"-versie. De eerste zorgt voor performance problemen, de tweede is erg klein.
    • in overleg met N.A. kijken wat er te doen is aan kwaliteit weergave foto's. Zie voorbeeld Test-TE test:Frascati (onder overzicht premières)
  2. Verbeteren ondersteuning gebruiker bij het kopiëren/plaatsen van de CID (het unieke nummer) voor het samenstellen van een maatwerk-galerij.
    • Nadenken over oplossing hoe beter zichtbaar te krijgen op bewerkingsformulieren (Formulier:Persoon, -Productie, -Locatie) welke nummers horen bij welke afbeeldingen.
    • Onderzoeken mogelijkheid tot vereenvoudigen van kopiëren van de nummers van de afbeeldingen (pop-up, click-to-copy ???)
  3. Nog overwegen in hoeverre het wenselijk is om 1) toch de hele afbeelding te zien i.p.v. slechts een strook, en 2) een onderschrift erbij te willen kunnen zetten.
  4. Verbeteren ontologie
  5. Lijst met pagina's om een Fotogalerie te plaatsen

Gebruik

De galerieën met foto's uit het NA worden op de volgende pagina's gebruikt:

NB: Dit overzicht wordt automatisch bijgewerkt.

Links / externe documentatie

Overgenomen van "https://theaterencyclopedie.nl/w/index.php?title=TheaterEncyclopedie:Koppeling_met_Nationaal_Archief&oldid=3061061"