6. Opzetten van een institutional repository-CRIS met Brocade
6.1. Productspecificaties
framework voor gestandardiseerde metadatabeschrijving van onderzoeksinformatie (CERIF entities)
CERIF en FRIS (Flemish research Portaal) compliant
Uitbreidbaar metadatamodel
koppeling output, projecten, organisaties en personen conform FRIS business rules en vademecum
Vlaamse onderzoeks discipline standaard (VODS)
Authority controle
registratieformulieren (webformulieren en client-software)
oai-pmh services met uitgebreide API functionaliteit
repository webportaal (zoek, filter, browse, export, registratieformulieren, css, ....)
lucene indexering
data-export (cerif, mods, bibtex, ris, dublin core, citatiestijlen...)
geoptimaliseerde indexering voor zoekmachines (sitemaps, highwire en schema.org markup)
api -import module (crossref, pubmed, web of science, datacite)
ORCID integratie
helpdesk in functie van support en communicatie
handle server
koppeling met docman repository omgeving voor storage van fulltext
logging en statistieken (aantal downloads, aanmeldingen, gebruik portaal, ...)
authenticatie toepassingen (ldap, single sign on, ...)
6.2. Installatie
Voor het opzetten van een institutional repository moet volgende Brocade infrastrastructuur gedefinieerd worden aan de hand van meta-info.
6.2.1. IR systeem
Aan te maken via https://anet.be/menu/irsys
De meta-info van een IR-systeem bestaat uit verschillende rubrieken. Sommige van de rubrieken of delen ervan zijn obsolete geworden omdat ze zijn vervangen door nieuwe toepassingen.
Bijvoorbeeld de rubriek formulieren bevat meta-informatie om de deposit formulieren oude stijl te bouwen.
De depositformulieren nieuwe stijl worden gestuurd via Institutional repositories - Beheersfuncties - Deposit formulieren [link]
Hieronder een overzicht van de verschillende meta-info rubrieken.
Indien na analyse blijkt dat de rubriek overbodig is wordt dit in dit document genoteerd en aan ontwikkelaar voorgelegd.
Na controle van ontwikkelaar kan rubriek al dan niet geschrapt worden:
6.2.1.1. Algemeen
6.2.1.2. Formulieren
obsolete
nieuw werkwijze zie verder
6.2.1.3. Eindgebruikers aspecten
6.2.1.4. Catalografie
6.2.1.5. Repository
6.2.1.6. Synchronisatie
6.2.1.7. Publicatie
6.2.1.7.1. Voeg een eerste pagina in
Obsolete : vervangen door frontpage toepassing mt:procman:motofrontpage
6.2.1.7.2. Templates voor de voorpagina
Obsolete : vervangen door frontpage toepassing mt:procman:motofrontpage
6.2.1.7.3. Selectie te tonen groepen
6.2.1.7.4. CSS bestand
De vormgeving van een repository wordt in grote mate bepaald door een css bestand. De referentie naar dit bestand is opgenomen bij de meta-informatie van een IR systeem.
Per instelling is een css bestand beschikbaar in het project acadbib/format.
Bij een wijziging van een css bestand moet dit via qtechng worden opgeladen. Resultaat komt terecht in htdocs/acadbib/xxx
6.2.1.7.5. Niet indexeren
vb. lm:abno betekent dat records met dit lidmaatschap niet geïndexeerd worden
6.2.1.7.6. indexinstructies
Bevat instructies/meta-elementen voor de indexering van institutional repositories.
zie : https://brocade.atlassian.net/browse/BR-392
voorbeeld:
inmime, inloc, inaccess zijn regels waar de fulltext aan moet voldoen om geïndexeerd te worden
lm is een regel voor het indexeren van lidmaatschappen. (om bijvoorbeeld te gebruiken in facetten, filters)
6.2.1.7.7. Searcher artikels
Searcher voor artikels toevoegen.
Voorbeelden
mt:expsearcher:irkmska
mt:expsearcher:irua
6.2.1.7.8. Indexer auteurs en indexer artikels
Opm. : indexer auteurs en indexer artikels zijn waarschijnlijk obsolete. (opm. Marc J. Die indexer acadbibkmskaau is niet nodig, alles wordt afgehandeld met irkmska.)
6.2.1.7.9. Template korte beschrijving OPAC
Wijzig templates voor persoonlijke pagina en korte beschrijving in functie van instelling
6.2.1.7.10. Template beschrijving persoonlijke pagina
Wijzig templates voor persoonlijke pagina en korte beschrijving in functie van instelling
6.2.1.7.11. Template voorpagina
Vermoedelijk obsolete, tenzij frontpage toepassing hier nog van gebruik maakt. (check met lucene)
6.2.1.7.12. Geassocieerde desktop
6.2.1.7.13. Geassocieerde OPAC
6.2.1.7.14. Base URL
6.2.1.7.15. Toon attributen in desktop
6.2.2. Regelwerk
voorbeeld irkmska
Bronnen
opacirkmska
oaimarc21
oaicatxml
oaiirkmskacerif
Centaur id's van sources die je in bibrec wil aanbieden
Gelinkte indexen (Dit zijn verwijzingen naar Explorator indexen)
irkmska
irkmskasuggest
6.2.3. Desktop
Via het beheer van de desktops kan men bepalen welke services men wil aanbieden en kan je extra tekst voorzien op het authenticatiescherm ''mijn bibliografie''
voorbeelden:
mt:desktop:irkmska
mt:desktop:irart
6.2.3.1. Desktop services
Service myacadib of variant (vb. myacadbib_ap) toevoegen om volgende services te kunnen aanbieden
mijn account (acadbibiam)
mijn publicaties (acadbibmyart)
publicaties aanmelden (irdepoform)
publicaties in behandeling (irdeposum)
syncroniseer met orcid (orcidsync)
6.2.4. Opac
Maak opac aan via https://anet.be/menu/opameta
Layout hint volledige beschrijving.
mt:opachintf:irkmska
mt:opachintf:irap
mt:opachintf:ir
mt:opachintf:irkdg
Explorator indexer. voorbeeld. mt:expindexer:irkmska
Explorator searcher. voorbeeld mt:expsearcher:irkmska
Filters op zoekacties explorator
Brocade menu item : mt:mitem:opacirkmska (B-file aangepast)
6.2.4.1. Opac Service
voorbeeld: mt:service:opacirkmska
6.2.5. Explorator
6.2.5.1. Explorator indexer
voorbeel: mt:expindexer:irkmska
6.2.6. Eindgebruiker systeem
Toegelaten streepjescodetypes: streepjescode aanmaken voor personeelsnummer : vb. KMSKA-P
IR-gegevens aanvinken
6.2.8. Lidmaatschappen
Specifiek aan te maken per repository
lidmaatschap voor gevalideerd records (vb. irkmska)
lidmaatschap voor record met adres instelling (vb. abkmska)
6.2.9. Docstore
https://anet.be/menu/docstoresys
6.2.9.1. Docman
Wordt aangemaakt bij invullen meta-info docstore (?)
6.2.10. url-types
mt:urltype
6.2.11. toegangscodes
De toegansgscode bepaalt of een inhoudselement moet getoond worden in de opac. De werking wordt gestuurd door de omgeving (https://anet.be/menu/accessenv) die je invult bij de meta-info van een opac. In de meta-info van deze omgeving geef je de toeganscode (s) die gebruikt worden om inhoud te tonen in een opac.
voorbeeld voor omgeving kmska zijn de toeganscodes kmska en anet ingevuld. Betekenis, enkel inhoud met deze toegangscodes wordt getoond, andere niet.
6.2.12. Deposit formulieren
Het aanmaken van records voor een repository gebeurt via deposit formulieren. Er kunnen formulieren gemaakt worden voor brocade gebruikers (catalografen) en formulieren voor externe gebruikers (onderzoekers)
Maak bijhorende catman import profielen.
Generieke verwoordingen voor de formulieren kan je beheren in ir/deposit/irdep.l en gebruiken in de meta-info en templates van een depositformulier
voorbeeld uit het formulier 'iruartikel' :
$.irform.thisisdoi<div class="tooltip"><span class="icon-info"></span><span class="tooltiptext">$.irform.infodoi</span></div>
Verwoordingen voor een lokale context moeten in anet/local/ en gebruiken in de meta-info van een depositformulier
voorbeeld uit het formulier 'iruaartikel' :
$.iruaform.intro1 {$.iruaform.intro3|email} <br> <br>$.irform.introartikel<br><br>
6.2.12.1. Formulier voor Brocade gebruikers
6.2.12.2. Formulier voor externe gebruikers
Indien er een workflow wordt opgezet die gebruikt maakt van de helpdesk moet de opmaak van het helpdeskbericht afgestemd zijn op de instelling die een Brocade repository gebruikt.
het helpdesk onderwerp bevat steeds de cloi. Deze kan je gebruiken om de helpdesk automatisch te laten toewijzen aan een executive.
de template voor de body van de helpdesk wordt gevuld met tekstfragmenten uit een l-file of in html als meertaligheid niet vereist is. Pas aan per instelling
6.2.12.3. Deposit formulier elementen
6.2.12.4. Deposit formulier keuze opties
Een formulier element kan verwijzen naar een keuze-optie. Aan te maken via Institutional repositories - Beheersfuncties [link]
In het element gebruik je een key generator om de keuze-opties in een template te kunnen aanbieden.
voorbeeld voor het element mt:irdelm:vakgroepap is de key generator
s RAkeys("vakgroepua")=$$%RsvT^bidchoic("vakgroepua","vakgroepap","irdepchoice")
waarbij de eerste parameter voor bidchoic de naam van het attribuut moet zijn waar je data wil wegschrijven.
In geval van lokale content moet hier de exacte benaming van het attribuut worden vermeld. Hier vakgroepua
in ander geval de code van het attribuut (su, loc, ...)
voorbeeld:
s RAkeys("locsel")=$$%RsvT^bidchoic("loc","cc","")
De tweede identifier is de identifier van de keuze-optie
6.2.12.5. Catman import profiel
Deze catman profielen moeten worden ingevuld bij de depositformulieren.
voorbeelden:
irdformdesktop
irdform (depositformulier irua voor catalografen. Verschilt van vorige doordat auteurs kunnen worden vervangen door Anet vorm)
irdformkmska
irdformart
6.2.13. OAI server
6.2.14. CERIF export
Records uit een Brocade Institutional Repository kunnen naar buiten gebracht worden in het CERIF formaat
Er zijn verschillende CERIF export profielen. De meta-info over de profielen is terug te vinden via Catalografische Cerif exportprofielen [link]
In een exportprofiel kan je een schema opgeven volgens het welke de brocade elementen moeten vertaald worden.
Naast een exportprofiel kan je bij de export ook een een specifieke exportgenerator meegeven. Catalografische export generatoren [link]
Volgende exportprofielen zijn beschikbaar:
6.2.14.1. cerif
Generieke CERIF export voor een Brocade repository conform de CERIF xsd (versie 1.5.1)
catcnv -export lst:xxxxxx format=cerif profile=cerif|xmllint --format -
6.2.14.2. fris
Specifieke export confom de fris-cerif schema xsd.
Onderstaande vertaaltabellen uit het schema fris zogen voor de vertaling van lokale codes naar de Fris classificaties.
AR: voor omzetting rol (lid - woordvoerder) naar fris classsificatie Assignemnt Role (Member - Responsible)
ROTT: Research Output Taxonomy Type (vb. a::pt.121:1 naar Article)
RTT: Referee type (vb. a::pt.121:1 naar Peer Reviewed)
author_fu: vertaling auteursfuncties
cfClassId: Omzetting volgens classificatieschemas Output Person Participant Role van auteursfuncties naar FRIS waarden. Zie info in scope note van de vertaaltabel
cfClassSchemeId: Omzetting auteursfuncties naar uuid
language_lg: Omzetting taalcodes 3-2 letters
subject_ac: fris publicatietypes
title_lg: Taalcodes van titels
Deze export maakt gebruikt van de fris generator.
catcnv -export lst:xxxxxx format=cerif profile=fris gen=fris|xmllint --format -
6.2.14.3. ua
Specifieke export voor levering aan UA ICT
Maakt gebruik van volgende vertaaltabellen uit het schema uacerif:
language_lg: Omzetting taalcodes 3-2 letters
title_lg: idem
fulltext_license: vertaling naar spdx id’s https://spdx.org/licenses/ en conform business rules FRIS
De export maakt gebruik van de cerifua generator.
catcnv -export lst:xxxxx format=cerif profile=ua gen=cerifua|xmllint --format -