2. Generieke URL's naar records/services in Brocade

Auteur	Jan Corthouts
Aanmaak	15 jun 2006 17:10
Aangepast door	Tom De Mey
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/letterenhuis/opaclhisad/isad:lh:17

• https://anet.be/isadtree/opaclhisad/isad:lh:lh:type:lhpersoon

• https://anet.be/isadtree/opaclhisad/isad:lh:17

• 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

• https://anet.be/isadtree/opaclhisad/isad:lh:17/N

2.4. Generieke URL naar Brocade menu-ingangen

Generieke URL naar een menu-ingang (met roepcode id) in Brocade:

• https://<server>/menu/<id>

Voorbeelden:

• https://anet.be/menu/archief

• https://anet.be/menu/bibrec

Vanzelfsprekend moet er eerst worden ingelogd in Brocade.

2.5. Generieke URL naar globals

Generieke URL naar een global in Brocade:

• https://<server>/mglobal/<global-reference>

Voorbeelden:

• https://dev.anet.be/mglobal/ZRP

• https://dev.anet.be/mglobal/c:lvd:248

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:

• https://anet.be/sofedit/beid

2.7. Generieke URL naar desktop

Generieke URL naar desktop is als volgt:

• https://<server>/desktop/<desktopid>

• https://<server>/desktop/<desktopid>/<language>

Voorbeelden:

• https://anet.be/desktop/uantwerpen

• https://anet.be/desktop/uantwerpen/E

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:

• https://anet.be/desktop/uantwerpen/euiam

• https://anet.be/desktop/uantwerpen/euiam/E

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:

• https://anet.be/opac/uantwerpen/opacuantwerpen

• https://anet.be/opac/stcvopac/E

• https://anet.be/opac/uantwerpen/opacuantwerpen/claus%20hugo

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:

• https://anet.be/service/impala-news

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/aw-bio

• https://anet.be/query/opacuantwerpen/aw-bio/E

• 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/aw-bio

• https://anet.be/query/uantwerpen/opacuantwerpen/aw-bio/E

• 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):

• https://anet.be/query/ehc/opacehc/ehc-sigillum/phinst=EHC~phsig=EHC-BAM

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:

• https://anet.be/feedback/ua

• https://anet.be/feedback/ua/E

In een specifieke desktop:

• https://anet.be/feedback/uantwerpen/ua

• https://anet.be/feedback/uantwerpen/ua/E

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:

• https://anet.be/newsletter/anet-logboek/

• https://anet.be/newsletter/impala-news/F

• https://anet.be/newsletter/anet-logboek/13096

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:

• https://anet.be/order/opacuantwerpen/c:lvd:1011611

• https://anet.be/order/opacuantwerpen/c:lvd:1011611/E

In een specifieke desktop:

• https://anet.be/order/uantwerpen/opacuantwerpen/c:lvd:1011611

• https://anet.be/order/uantwerpen/opacuantwerpen/c:lvd:1011611/E

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

• 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:

• https://anet.be/digital/mpm/opacmpm/mpm/dg:mpm:543

• https://anet.be/digital/mpm/opacmpm/mpm/dg:mpm:543-c:lvd:3253145/N

• https://anet.be/digital/uantwerpen/opacuantwerpen/uapreciosa/dg:ua:451-5 (naar 5de scan in digitalisering)

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:

• https://anet.be/record/stcvopac/a::06.3110

• https://anet.be/record/stcvopac/a::06.3110/E

Indien de loi aangevuld wordt met .noopac, wordt de volledige beschrijving getoond zonder knoppen en tabs van de OPAC.

Voorbeeld:

• https://anet.be/record/stcvopac/a::06.3110.noopac

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:

• https://anet.be/record/stcvopac/c:stcv:3120475

• https://anet.be/record/stcvopac/c:stcv:3120475/E

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:

• https://anet.be/record/stcvopac/c:stcv:3120475.noopac

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:

• https://anet.be/record/uantwerpen/opacuantwerpen/c:lvd:51871.noopac

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:

• https://anet.be/oai/catgeneric/server.phtml?verb=GetRecord&metadataPrefix=marc21&identifier=c:lvd:716601

• https://anet.be/oai/catgeneric/server.phtml?verb=GetRecord&metadataPrefix=oai_dc&identifier=c:lvd:716601

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 parameters service:opacehc, workstation:EHC-LZ.

  • https://anet.be/env/opacehcwks start OPAC opacehc met als werkstation EHC-LZ

  • https://anet.be/env/opacehcwks/workstation=UA-CDE start OPAC opacehc met als werkstation UA-CDE omdat werkstation EHC-LZ overschreven wordt

• omgeving stcvquerylib van type service met als ingevulde parameters service: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 zoekwaarde ehc