December 2018
Linkme-syntaks for Netpunkt
Du kan linke til søgninger i Netpunkt, eller et specifikt record ID.
Den url, linkme-syntaksen genererer ved hjælp af urlencoding ændrer sig ikke, selv om vi ændrer på Netpunkts struktur.
Du kan også se Netpunkts linkme-syntaks på https://netpunkt.dk/linkme (efter login).
Link til et specifikt record ID
Du opbygger et søgelink til Netpunkt på denne måde:
http://www.netpunkt/linkme?rec.id=<ID>[&database=<base>]
Link til søgning i Netpunkt
En søgning kan være en generel søgning på fx en forfatter, en titel eller kombinationer af disse.
Når du bruger Netpunkt's linkme-syntaks, laves en søgning i Netpunkt, og resultatet vises på Netpunkts brugergrænseflade.
Du opbygger et søgelink til Netpunkt på denne måde:
http://www.netpunkt/linkme?cql=<urlencoded findkommandospecifikation>[&database=<base>]
Forklaring på syntaks
Base er den database, der skal søges i. Hvis der ikke er valgt en, søges der i Danbib.
ID er postens unikke ID. Det er sammensat af <lokalisering id>-<base id>:<post id>. F.eks.: 870970-basis:54422571
Findkommandospecifikation er en "CQL-kommando" (Contextual Query Language) i overensstemmelse med den internationale standard for cql-søgesprog.
Alle søgekoder skal efterfølges af lighedstegn ( urlencoded: %3D ). Langt de fleste søgekoder i Praksisregler for søgeveje kan bruges i Netpunkt.
Kilder som ikke har marcposter vil dog ikke være med i søgeresultatet, hvis man anvender disse søgekoder.
Du kan anvende de booleske operatorer and, or, not, samt parenteser, maskeringstegn (?) og trunkeringstegn (*).
Eksempler
Eksempel 1: link med søgning på titel
Søgning på titel: Vandpest
ti=vandpest
http://netpunkt.dk/linkme?cql=ti%3Dvandpest
Eksempel 2: link til bestemt titel
Søgning på forfatter: ekman og hovedtitel: guds barmhjertighed og materiale: lydbog
fo=ekman and ht="guds barmhjertighed" and ma=lb
http://netpunkt.dk/linkme?cql=fo%3Dekman+and+ht%3D%22guds+barmhjertighed%22+and+term.type%3Dlydbog
Eksempel 3: link til fritekstsøgning
Søgning på fritekst: stumfilm and tyskland
stumfilm and tyskland
http://netpunkt.dk/linkme?cql=stumfilm+and+tyskland
Eksempel 4: link med booleske operatorer og parenteser
Flere operatorer - med parentes: forfatter: sibelius og titel: koncert og materiale: cd (uanset indhold) eller materiale=studiepartiturer
fo=sibelius and ti=koncert and (ma=xc eller ma=ps)
http://netpunkt.dk/linkme?cql=fo%3Dsibelius+and+ti%3Dkoncert+and+%28ma%3Dxc+or+ma%3Dps%29
Eksempel 5: link med trunkeringstegn
Trunkeret søgning: fritekst: sukkersyg* og materiale: film
sukkersyg* and term.workType=movie
http://netpunkt.dk/linkme?cql=sukkersyg%2A+and+term.workType=movie
Eksempel 6: link med faust nr.
Søgning med faustnr.: id=3D54422571
id=54422571
http://netpunkt.dk/linkme?cql=id%3D54422571
Eksempel 7: link til post ID
rec.id=870970-basis:54422571
http://netpunkt.dk/linkme?rec.id=870970-basis%3A54422571
Eksempel 8: link til post ID i materialevurderinger
rec.id=870976-allanmeld%3A31633303
http://netpunkt.dk/linkme?rec.id=870976-allanmeld%3A31633303&database=matvurd
Eksempel 9: link med søgning på titel i materialevurderinger
Søgning på titel: Der der
term.reviewedTitle="der der"
http://netpunkt.dk/linkme?cql=term.reviewedTitle%3D%22der+der%22&database=matvurd
Eksempel 10: link med ccl søgning på id og lokalisering i Danbib.
Gamle linkme URLer med CCL Søgning kan i begrænset omfang automatisk konverteres til CQL.
id=05437970 og lok=870970
http://netpunkt.dk/linkme?ccl=id%3D05437970+og+lok%3D870970&database=danbib
Generelt om urlencoding:
Urlencoding bruges til at opbygge permanente url'er, som kan fortolkes af alle browsere.
Vi anbefaler, at det lokale system urlencoder ved hjælp af en standardrutine (fx Javascript, php).
Se evt. W3schools:
http://www.w3schools.com/tags/ref_urlencode.asp
Her er også en liste over alle tegn og deres urlencoding