2. Generieke URL's naar records/services in Brocade
Auteur |
|
Aanmaak |
15 jun 2006 17:10 |
Aangepast door |
|
Aangepast op |
05 apr 2016 14:08 |
Oud BVV nr |
2122 |
2.1. Abstract
Dit document beschrijft de wijze waarop in Brocade generieke URL's kunnen worden gelegd naar records en services.
2.2. URL's: Algemeen
Indien je een referentie legt naar een URL binnen een bestaande webpagina en de referentie verwijst naar dezelfde server als deze webpagina, gebruik dan een absolute-path reference
.
Dus, als je in de pagina https://anet.be/desktop/ua/opacua
een link wil leggen naar vb. https://anet.be/record/stcv/c:lvd:2345
, dan beschrijf je deze beter als /record/stcv/c:lvd:2345
.
De voordelen hiervan zijn:
De schrijfwijze is korter.
DNS namen kunnen unicode karakters bevatten. Dit probleem wordt nu omzeild.
Een Brocade installatie op een server met een dubbele interface kan nu op beide interfaces worden gebruikt. vb. Binnen COB Antwerpen kan men werken op: brocade.stad.antwerpen.local. Buiten de COB Antwerpen kan men werken via: 195.13.26.40
Het Cookie probleem wordt opgelost: alle pagina's behoren tot hetzelfde domein bepaald door de URL van de inlog pagina.
De gebruiker kan kiezen of hij secure of niet secure transfer wil: hij vervangt gewoon 'http' door 'https' in zijn inlog URL.
Aanpassing van de DNS naam van de server kan zonder herinstallatie worden uitgevoerd.
2.3. Generieke URL naar ISAD structuren
Een ISAD structuur wordt in 2 panes weergegeven. In het linkerpane staat de boomstructuur. In het rechterlid staat de specifieke beschrijving. Een 'isadloi' kan zowel de klassiek ISAD loi zijn (vb. isad:lh:17
), of een overviewcode (vb. isad:lh:lh:type:lhpersoon
)
https://<server>/isadtree/desktop/opac/isadloi
https://<server>/isadtree/opac/isadloi
https://<server>/isadtree/desktop/opac/isadloi/taalletter
https://<server>/isadtree/opac/isadloi/taalletter
Voorbeelden:
https://anet.be/isadtree/letterenhuis/opaclhisad/isad:lh:lh:type:lhpersoon
https://anet.be/isadtree/opaclhisad/isad:lh:lh:type:lhpersoon
https://anet.be/isadtree/letterenhuis/opaclhisad/isad:lh:lh:type:lhpersoon/N
https://anet.be/isadtree/letterenhuis/opaclhisad/isad:lh:17/N
https://anet.be/isadtree/opaclhisad/isad:lh:lh:type:lhpersoon/N
2.5. Generieke URL naar globals
Generieke URL naar een global in Brocade:
https://<server>/mglobal/<global-reference>
Voorbeelden:
Vanzelfsprekend moet er eerst worden ingelogd in Brocade.
2.6. Generieke URL naar door Brocade beheerd software pakket
Generieke URL naar een softwarepakket met identificatie id is als volgt:
https://<server>/sofedit/<id>
https://<server>/sofedit/<id>/<language>
Voorbeeld:
2.7. Generieke URL naar desktop
Generieke URL naar desktop is als volgt:
https://<server>/desktop/<desktopid>
https://<server>/desktop/<desktopid>/<language>
Voorbeelden:
2.8. Generieke URL naar een service binnen een desktop
Generieke URL naar service binnen een desktop is als volgt:
https://<server>/desktop/<desktopid>/<service>
https://<server>/desktop/<desktopid>/<service>/<language>
Voorbeelden:
2.9. Generieke URL naar OPAC
Generieke URL naar OPAC is als volgt:
https://<server>/opac/<opacid>
https://<server>/opac/<opacid></language>
https://<server>/opac/<desktopid>/<opacid>
https://<server>/opac/<desktopid>/<opacid></language>
https://<server>/opac/<desktopid>/<opacid>/<searchpattern>
https://<server>/opac/<desktopid>/<opacid></language>/<searchpattern>
Voorbeelden:
2.10. Generieke URL naar service
Generieke URL naar service (zonder Desktop chrome) is als volgt:
https://<server>/service/<serviceid>
https://<server>/service/<serviceid></language>
https://<server>/service/<desktopid>/<serviceid>
https://<server>/service/<desktopid>/<serviceid></language>
https://<server>/service/<desktopid>/<serviceid>/<extra>
https://<server>/service/<desktopid>/<serviceid></language>/<extra>
Voorbeelden:
2.11. Generieke URL naar query
Generieke URL naar query is als volgt (default desktop):
https://<server>/query/<opacid>/<queryid>
https://<server>/query/<opacid>/<queryid>/<language>
https://<server>/query/<opacid>/<queryid>/ph<placeholderid>=<value>
https://<server>/query/<opacid>/<queryid>/ph<placeholderid>=<value>/<language>
Generieke URL naar query is als volgt (specifieke desktop):
https://<server>/query/<desktop>/<opacid>/<queryid>
https://<server>/query/<desktop>/<opacid>/<queryid>/<language>
https://<server>/query/<desktop>/<opacid>/<queryid>/ph<placeholderid>=<value>
https://<server>/query/<desktop>/<opacid>/<queryid>/ph<placeholderid>=<value>/<language>
Voorbeelden:
https://anet.be/query/opacuantwerpen/auteur/phau=Claus,%20Hugo
https://anet.be/query/opacuantwerpen/auteur/phau=Claus,%20Hugo/E
In een specifieke desktop:
https://anet.be/query/uantwerpen/opacuantwerpen/auteur/phau=Claus,%20Hugo
https://anet.be/query/uantwerpen/opacuantwerpen/auteur/phau=Claus,%20Hugo/E
Placeholders kunnen in dergelijke constructies gecombineerd worden met een tilde (hoe de operatoren AND, OR, NOT moeten gebruikt worden, dient alleen in de query te worden gedefinieerd):
2.12. Generieke URL naar feedback formulier
Generieke URL naar een feedback formulier is als volgt (default desktop):
https://<server>/feedback/<feedbackid>
https://<server>/feedback/<feedbackid>/<language>
Generieke URL naar feedback formulier is als volgt (specifieke desktop):
https://<server>/feedback/<desktop>/<feedbackid>
https://<server>/feedback/<desktop>/<feedbackid>/<language>
Voorbeelden:
In een specifieke desktop:
2.13. Generieke link naar nieuwsbrief
Generieke URL naar een nieuwsbrief(item) is als volgt:
https://<server>//newsletter/<newsletterserviceid>
https://<server>//newsletter/<newsletterserviceid>/<language>
https://<server>//newsletter/<newsletterserviceid>/<newsitemid>
https://<server>//newsletter/<newsletterserviceid>/<newsitemid>/<language>
Opmerking: newsletterserviceid = service-id zoals ingevuld ter hoogte van de optie Overeenkomende service in de meta-informatie.
Voorbeelden:
2.14. Generieke URL naar een bestelling
Generieke URL naar een bestelling is als volgt (default desktop):
https://<server>/order/<opacid>/<cloi>
https://<server>/order/<opacid>/<cloi>/<language>
Generieke URL naar een bestelling is als volgt (specifieke desktop):
https://<server>/order/<desktop>/<opacid>/<cloi>
https://<server>/order/<desktop>/<opacid>/<cloi>/<language>
Voorbeelden:
In een specifieke desktop:
2.15. Generieke URL naar een o-loi in een digitaal platform
Generieke URL naar een digitalisering in een digitaal platform is als volgt (default desktop):
https://<server>/digital/<opacid>/<digitalid>/<dgloi[-cloi]>
https://<server>/digital/<opacid>/<digitalid>/<oloi[-cloi]>/<language>
Generieke URL naar een digitalisering in een digitaal platform is als volgt (specifieke desktop):
https://<server>/digital/<desktop>/<opacid>/<digitalid>/<dgloi[-cloi]>
https://<server>/digital/<desktop>/<opacid>/<digitalid>/<dgloi[-cloi]>/<language>
Generieke URL naar een specifieke scan in een digitalisering in een digitaal platform is als volgt (specifieke desktop):
https://<server>/digital/<desktop>/<opacid>/<digitalid>/<dgloi[-<value>]>
Deze waarde kan een volgnummer zijn, 5 voor de 5de scan in een digitalisering. Of een tag die ter hoogte van de beschrijving van de digitaliseing wordt ingegeven als een Per-pagina noot.
c-loi moet enkel meegegeven worden in geval van een convoluut omdat de c-loi die bij de o-loi hoort, het overkoepelend convoluut is, en niet de gewenste deelbeschrijving.
Voorbeelden:
https://anet.be/digital/opacmpm/mpm/dg:mpm:543-c:lvd:3253145/N
https://anet.be/digital/opacmpm/mpm/dg:mpm:543-5 (naar 5de scan in digitalisering)
In een specifieke desktop:
2.16. Deep link naar a-loi
Generieke URL naar een a-loi in de context van een OPAC is als volgt:
https://<server>/record/<opacid>/<aloi>/<language>
https://<server>/record/<opacid>/<aloi>
Voorbeelden:
Indien de loi aangevuld wordt met .noopac, wordt de volledige beschrijving getoond zonder knoppen en tabs van de OPAC.
Voorbeeld:
2.17. Deep link naar c-loi in context van een OPAC
Generieke URL naar een c-loi in de context van een OPAC is als volgt:
https://<server>/record/<opacid>/<cloi>
https://<server>/record/<opacid>/<cloi>/<language>
Voorbeeld:
Deze vorm wordt o.a. door Brocade gebruikt bij de publicatie van aanwinsten via SDI.
Indien de loi aangevuld wordt met .noopac, wordt de volledige beschrijving getoond zonder knoppen en tabs van de OPAC.
Voorbeeld:
2.18. Deep link naar c-loi in context van een desktop en OPAC
Indien de deeplink moet leiden naar een c-loi waarbij vervolgens services zoals documentbestelling geleverd moeten worden, dan dient ook een Brocade desktop mee te worden gegeven. Generieke URL naar een c-loi in de context van een desktop en OPAC ziet er dan als volgt uit:
https://<server>/record/<desktopid>/<opacid>/<cloi>
https://<server>/record/<desktopid>/<opacid>/<cloi>/<language>
Voorbeeld:
https://anet.be/record/uantwerpen/opacuantwerpen/c:lvd:51871
https://anet.be/record/uantwerpen/opacuantwerpen/c:lvd:51871/E
Indien de loi aangevuld wordt met .noopac, wordt de volledige beschrijving getoond zonder knoppen en tabs van de OPAC.
Voorbeeld:
2.19. Deep link naar c-loi op basis van bibliografische nummers
Een catalografisch record kan diverse bibliografische nummers hebben (ISBN, ISSN, conversienummers, ...). Voor elk van de nummertypes kan eveneens een URL geconstrueerd worden en wel als volgt:
https://<brocadeserver>/services.phtml?desktop=<desktopid>&service=<opacid>&extra=nr<nummertype>=<catalogusid>:<nummer>
Voorbeeld:
https://anet.be/services.phtml?desktop=uantwerpen&service=opacuantwerpen&extra=nrco=lvd:mid.15346
https://anet.be/services.phtml?desktop=uantwerpen&service=opacuantwerpen&extra=nrissn=lvd:1050-3293
Geef het nummertype zoals dat gedefinieerd is in Brocade. Bijvoorbeeld: nummertype in Brocade is isbn Dit geeft in de URL dan nrisbn als attribuut.
2.20. Deep link naar c-loi op basis van OAI-request
Een individueel catalografisch record kan ook worden opgehaald in een XML-formaat via een OAI-PMH request en wel als volgt:
https://<brocadeserver>/oai/catgeneric/server.phtml?verb=GetRecord&metadataPrefix=<XMLschema>&identifier=<cloi>
Voorbeeld:
Als XML schema's kunnen worden gebruikt:
marc21
mods
udmods (=Unicat Mods)
oai_dc
antilope
catxml (=Brocade xml formaat)
2.21. Opstartomgevingen
De toepassing PURL omgevingen [link] laat toe om via eenvoudige URL's Brocade applicaties op te starten.
Er kunnen PURL omgevingstypes gedefinieerd worden die een basis URL bevatten, aangevuld met <placeholders>
. Momenteel zijn er 2 types gedefinieerd, desktop
en service
. Zo is de basis URL van service: r4_service_start_url?desktop=<desktop>&service=<service>&workstation=<workstation>&language=<language>&extra=<extra>
.
Bij het aanmaken van een nieuwe PURL omgeving moet eerst het type opgegeven worden. Dan krijgt men een invulscherm met parameters die overeenkomen met de placeholders van het gekozen type. Aan deze parameters kunnen nu waarden toegekend worden die dus specifiek zijn voor deze PURL omgeving. Elke parameter kan op zijn beurt een <placeholder>
bevatten die dan in de aansprekende URL moet ingevuld worden. Bovendien kunnen in de aansprekende URL ingevulde parameters overschreven worden (zie voorbeelden).
De URL om een omgeving op te starten is van de vorm /env/omgeving[/par1=value1][/par2=value2]....
Voorbeelden:
omgeving
opacehcwks
van type service met als ingevulde parametersservice:opacehc
,workstation:EHC-LZ
.https://anet.be/env/opacehcwks start OPAC
opacehc
met als werkstationEHC-LZ
https://anet.be/env/opacehcwks/workstation=UA-CDE start OPAC
opacehc
met als werkstationUA-CDE
omdat werkstationEHC-LZ
overschreven wordt
omgeving
stcvquerylib
van type service met als ingevulde parametersservice:stcvopac
,extra:query=stcvlib~phlib=<phlib>
heeft als basis URL
/services.phtml?desktop=stcv&service=stcvopac&workstation=&language=&extra=query%3Dstcvlib%7Ephlib%3D%3Cphlib%3E
(/services.phtml?desktop=&service=stcvopac&workstation=&language=&extra=query=stcvlib~phlib=<phlib>) De placeholder <phlib> moet dus meegegeven worden in de aansprekende URL.
https://anet.be/env/stcvquerylib/phlib=ehc start een query op in OPAC
stcvopac
met als zoekwaardeehc