Inhoud van deze pagina
1 Harvestproces
1.1 Inleiding
Dit hoofdstuk heeft als doel het bereiken van een eenduidige werkwijze voor het harvesten van repositories t.b.v. LOREnet, het kwaliteitsbehoud van de content en de communicatie en is bestemd voor de contactpersonen met voldoende technische kennis van LOREnet en repositorybeheerders van (aspirant) bij LOREnet aangesloten instellingen.
Voor referentie, zie de volgende bronnen:
- Handleiding voor (aspirant) contentdonoren versie 1
- Architectuur LOREnet-2 versie 1.4
- LORElom
- Creative Commons LOREnet versie 0.1.2
- IEEE-LOM met Creative Commons en Nederlandse Basisclassificatie versie 0.1
1.2 Algemeen
Alle communicatie over LOREnet verloopt altijd via SURF. Hoofdcontactpersoon is de projectcoördinator:
Magchiel Bijsterbosch
030 234 66 00
06 46 06 25 97
bijsterbosch@surf.nl
1.3 Aansluiting
De aansluiting van een instelling bij LOREnet voltrekt zich in vier fasen:
- Fase 0: inrichten en testen van de Repository
- Fase 1: uitwisseling benodigde informatie
- Fase 2: overeenkomst aansluiting
- Fase 3: gereedmaken portal en harvester
- Fase 4: initiële harvest
Fase 1
Voordat besloten wordt tot aansluiten bij LOREnet zal veelal eerst de documentatie opgevraagd worden zodat men men inzicht krijgt in de uit te voeren activiteiten die noodzakelijk zijn voor aansluiting. Hierbij zijn de volgende zaken van belang:
- Contactpersoon (repositorybeheerder)
- baseURL
- Prefix t.b.v. [standards:LORElom
- Logo instelling
Zie voor meer informatie Aansluiten (Techniek).
Fase 2
Bij de beslissing tot aansluiting bij LOREnet kunnen deze items worden doorgegeven aan de contactpersoon bij SURF.
Fase 3
Na het verstrekken van deze informatie zal SURF zorgen dat de harvester en de portal in gereedheid worden gebracht zodat de nieuw aangesloten instelling geharvest kan worden.
Fase 4
Na de initiele harvest zal er door SURF naar eventuele fouten worden gekeken en indien noodzakelijk een overleg plaatsvinden tussen de contactpersonen van SURF en de nieuw aangesloten instelling om het e.e.a. glad te strijken. Zodra dit afgerond is gaat men over naar het exploitatie stadium.
1.4 Exploitatie
Algemeen
De instelling is zelf verantwoordelijk voor de "harvestbaarheid" (bereikbaarheid door de harvester) van de repository en aanlevering van content volgens de LOREnet afspraken (IEEE-LOM met CC en NBC). Bij fouten tijdens het harvest- en normalisatie proces worden hiervan logs aangemaakt. Het is de taak aan de instellingen om zelf dagelijks de RSS feed te controleren en hierop actie te ondernemen. Bij fouten die niet à la minute kunnen worden opgelost wordt verwacht dat deze worden doorgegeven aan de contactpersoon bij SURF om de storing te melden en de actie die ondernomen wordt om hem op te lossen.
Bij afwezigheid van de verantwoordelijke wordt van zowel de instellingen als SURF verwacht dat hierover wordt gecommuniceerd en een vervangend contactpersoon wordt aangesteld.
Harvestfouten
Locatie errorlog : http://www.lorenet.nl/harveststatus
OmschrijvingDeze fouten houden in dat er een fout is geconstateerd tijdens het harvestproces en kunnen meerdere oorzaken hebben. De consequentie van fouten binnen dit proces is dat het harvestproces wordt afgebroken. Voorbeeld: record 101 t/m 200 wordt geharvest. Tijdens het harvestproces wordt bij record 147 een fout gevonden. Het harvestproces stop dan bij record 147. Record 147 t/m 200 worden hierbij niet geharvest. Pas bij de volgende loop van de harvester zal deze opnieuw een poging ondernemen om de overige records van de repository (inclusief record 147) te harvesten. Gaat dit wederom fout dan stopt het proces weer en volgt een herhaling van het bovenstaande. Belangerijk om op te merken is dat records 101 t/m 146 wel zullen worden aangemerkt als succesvol geharvest en ook gewoon zullen worden genormaliseerd. Ook alle reeds bestaande records zullen gewoon beschikbaar blijven binnen LOREnet.
Voorbeelden van harvestfouten zijn:
- ongeldige XML
- repository niet bereikbaar (service down)
Communicatieprotocol
| Omschrijving | Actie |
|---|---|
| Fouten gevonden | Inventariseren en indien mogelijk z.s.m. verhelpen |
| Oplossen fouten > 24 uur | SURF op de hoogte stellen, verhelpen |
| Fout ligt buiten repository | SURF op de hoogte stellen. SURF zal verder inventariseren en actie ondernemen. |
Normalisatiefouten
Locatie errorlog: http://www.lorenet.nl/harvestlog
OmschrijvingBinnen het normalisatieproces wordt de metadata in IEEE-LOM formaat gecontroleerd op inhoudsfouten. In tegenstelling tot het harvestingproces waar bij fouten het proces stopt, stop bij normalisatiefouten alleen de bewerking. Het proces zal de record met de fout overslaan en doorgaan met het eerstvolgende record: wanneer record 101 t/m 200 genormaliseerd worden en bij record 148 een fout wordt gevonden zal Meresco record 148 overslaan en vervolgens doorgaan met record 149 t/m 200.
Bij globale/structurele fouten binnen het normalisatieproces voor een bepaald LOM-veld kan er contact worden opgenomen met SURF om te overleggen over de implementatie van een Crosswalkregel. Het toevoegen van een Crosswalkregel is echter alleen mogelijk wanneer dit voor alle objecten binnen de repository geldt (e.g. wanneer dit de standaardmanier is waarop objecten aangeleverd worden). Een voorbeeld is het in het Nederlands specificeren van learningResourceType (veld 5.2), terwijl volgens de LOREnet afspraken alleen specificatie in het Engels wordt ondersteund. De Crosswalk zal dan de Nederlandse vocabulaireitems naar het Engels vertalen. Belangerijk om op te merken is dat wanneer records wel aan het vocabulaire voldoen dit ook wordt geaccepteerd (e.g. wanneer de crosswalk voor veld 5.2 van het Nederlands naar het Engels is aangezet en het record het veld in het Engels - volgens het vocabulaire - aanleverd). Verder geldt een ingevoerde crosswalkregel voor alle aangesloten repositories. Regels hoeven dus niet apart voor iedere aangesloten respository ingevoerd te worden.
Communicatieprotocol
| Omschrijving | Actie |
|---|---|
| Fouten gevonden | Inventariseren en indien mogelijk z.s.m. verhelpen |
| Oplossen fouten > 24 uur | SURF op de hoogte stellen, verhelpen |
| Fout ligt buiten repository | SURF op de hoogte stellen. SURF zal verder inventariseren en actie ondernemen. |
| Globale fout | Overleg SURF i.v.m. crosswalk |
2 Content
2.1 Inleiding
Dit hoofdstuk is opgesteld met als doel het vormen van een basis waarop een waarborging van de kwaliteit van content binnen LOREnet kan plaatsvinden.
2.2 Doelgroep
LOREnet heeft als primaire doelgroep lectoren en docenten en secondair studenten die op zoek zijn naar leermiddelen voor gebruik in colleges, toetsen etc, met als doel het hergebruik van leermaterialen buiten de eigen instelling te stimuleren.
2.3 Metadata
De metadatering van objecten aangeboden door repositories die zijn aangesloten bij LOREnet dient te geschieden conform het document "IEEE-LOM-CC-NBC". Eventuele fouten dienen z.s.m. te worden verholpen conform het document "Richtlijnen Harvest Beheer LOREnet".
2.4 Stabiliteit
Om eventuele ongemakken voor de gebruiker te minimaliseren dient de repository een 100% uptime na te streven. Bij verwijdering van records dient dit goed in de OAI-PMH te worden doorgevoerd zodat het record tijdens de incrementele harvest ook uit de LOREnet metadatastore kan worden verwijderd en zo vervuiling met dode links kan worden voorkomen.
2.5 Gebruik van testrecords
Het onsluiten van testrecords is toegestaan onder de volgende voorwaarden:
- Het record moet duidelijk identificeerbaar zijn als zijnde een test object, zowel voor de gebruiker als voor de beheerder van LOREnet.
- Na het uitvoeren van de test, dient het testobject binnen 24 uur op een juiste manier te worden verwijderd om zo de vervuiling van LOREnet tegen te gaan.
- Wanneer het gewenst is dat het record langer dan 24 uur in het repository blijft dient hierover gecommuniceerd te worden met de beheerder van LOREnet.