2.18. Kikkhullet: Siste x utlånte/registrerte/bestilte

Disse programmene kan ikke startes fra TkStatistikk da de skal inkluderes i allerede eksisterende websider og er ikke beregnet å kjøres på egenhånd.

Vi har gjort noen eksempler tilgjengelig på tjenermaskinen under /usr/www/kikkhullet, som hos de fleste kan hentes opp med http://www.kommunenavn.folkebibl.no/kikkhullet/. De som har en separat webtjener må endre bibserver i filene for at de skal fungere. De som har websidene sine under en annen katalog enn /usr/www må kopiere filene til korrekt katalog selv. NB! Hvis man vil endre filene man kopiere filene og endre kopiene da de vil bli overskrevet av eventuelle nye versjoner som sendes ut fra oss.

Eksempel 2.5. Kopiering av filer til lokalt kikkhullområde

bash# mkdir /usr/www/kikkhull
bash# cp /usr/www/kikkhullet/* /usr/www/kikkhull
bash# chmod 755 /usr/www/kikkhull/*
		

2.18.1. Kikkhullet: Siste x utlånte

Programmet kjøres innenfra en webside. Korrekt konfigurert viser den en helt enkel tabell med de siste utlånte/innleverte eksemplarene.

Argumenter til programmet legges inn som kommentarer i websiden. Hvis man bruker grafiske webeditorer som FrontPage e.l., kan endring av websiden føre til at kommentarene fjernes.

Konfigurasjonsvalg (standardverdi i parentes)

antall (1)

Antall titler som skal vises.

utfavd (*)

Utførende avdeling. Trunkering kan brukes.

eieravd (*)

Eieravdeling. Trunkering kan brukes.

Type (U)

Transaksjonstype. Denne kan settes til U for utlån og I for innleveringer. I tillegg finnes F for fornyelser, P1 til P4 for purringer, PB for purrebrev, PE for purrebrev over epost, R for ekspederte reserveringer, RP for reserveringsbrev, RM for reserveringsbrev over epost, RL for reservering legges, Ib for bestilt fjernlån, Im for mottatt fjernlån samt Iu for utlånt fjernlån.

lnkat (*)

Lånerkategori. Det er mulig å legge inn flere lånekategorier adskilt med mellomrom.

websok (websok)

Instans som skal brukes for webøkset.

hyllestatus (*)

Hyllestatus. Bruk statuskoder fra $DBPATH/koder/ekskoder-filen. Trunkeringstegnet * bruker alle statuskoder.

vis245h (1)

Bestemmer om $245h (dokumenttype) skal vises i tabellen.

ccl ("")

Ccl søk. Denne krever en del ekstra jobbing på serveren og kan føre til at det tar litt tid å generere tabellen.

bibserver (localhost)

Denne spesifiserer navnet på serveren. Denne må brukes hvis programmet ikke kjøres på Bibliofiltjeneren.

forsinkelse (10)

Antall minutter som transaksjonene skal være forsinket. Denne variabelen kan brukes hvis man er bekymret over at lånerne kan sitte på en publikumspc og "se" hva folk låner. Dette er mest aktuelt for mindre bibliotek.

fontsize (+0)

Skriftstørrelse i tabellen.

tableborder (0)

Tykkelse på rammen rundt tabellen.

visbilde (0)

Skal omslagsbilde vises hvis det er tilgjengelig?

tabellheader ("")

Legg inn liste med overskrifter til tabellen. F.eks:

					"Bilde Forfatter Tittel"
					

target

Gjør det mulig å åpne lenker fra et kikkhull som befinner seg i en <IFRAME> i et annet vindu. Hvis kikkhullet er inkorporert i en webside via iframe kan det være nødvendig å vise katalogposten i et nytt vindu.

target kan også brukes i de andre kikkhull-skriptene.

I tillegg til disse må man spesifisere navnet på programmet i exec cgi, dvs /cgi-bin/sisteutlan.tcl.

Eksempel 2.6. Kikkhullet: Siste 20 utlånte


<!--#set var="antall" value="20" -->
<!--#set var="utfavd" value="fabv" -->
<!--#set var="eieravd" value="fabb" -->
<!--#set var="type" value="U" -->
<!--#set var="lnkat" value="b ele" -->
<!--#set var="websok" value="websok-FaretBib" -->
<!--#set var="hyllestatus" value="" -->
<!--#set var="vis245h" value="1" -->
<!--#set var="ccl" value="ff=ed" -->
<!--#set var="bibserver" value="localhost" -->
<!--#set var="forsinkelse" value="10" -->
<!--#set var="fontsize" value="-2" -->
<!--#set var="tableborder" value="1" -->
<!--#set var="visbilde" value="1" -->
<!--#set var="tabellheader" value="Bilde Forfatter Tittel" -->
<!--#set var="tableborder" value="1" -->
<!--#set var="target" value="_parent" -->
<!--#exec cgi="/cgi-bin/sisteutlan.tcl"-->


2.18.2. Kikkhullet: Siste x registrerte

Programmet skal kjøres innenfra en webside. Korrekt konfigurert viser den en helt enkel tabell med de siste registrerte titlene.

Programmet er veldig likt programmet for de siste utlånte.

Konfigurasjonsvalg (standardverdi i parentes)

antall (1)

Antall titler som skal vises.

type (N)

Type transaksjon som vises. N for ny tilvekst, R for retrospektiv tilvekst og A for avgang.

eieravd (*)

Eieravdeling. Trunkering kan brukes.

websok (websok)

Instans som skal brukes for webøkset.

hyllestatus (*)

Hyllestatus. Bruk statuskoder fra $DBPATH/koder/ekskoder-filen. Trunkeringstegnet * bruker alle statuskoder.

vis245h (1)

Bestemmer om $245h (dokumenttype) skal vises i tabellen.

ccl ("")

Ccl søk. Krever en del ekstra jobbing på serveren og kan derfor føre til at det tar litt tid å generere tabellen.

bibserver (localhost)

Spesifiserer navnet på serveren. Denne må brukes hvis programmet ikke kjøres lokalt på Bibliofiltjeneren.

fontsize (+0)

Skriftstørrelse i tabellen.

tableborder (0)

Tykkelse på rammen rundt tabellen.

visbilde (0)

Skal omslagsbilde vises hvis det er tilgjengelig?

tabellheader ("")

Legg inn liste med overskrifter til tabellen. F.eks:

					"Bilde Forfatter Tittel"
					

exec cgi skal ha verdien /cgi-bin/sistetittel.tcl.

Eksempel 2.7. Kikkhullet: 20 nyeste titler


<!--#set var="antall" value="20" -->
<!--#set var="type" value="N" --> (R|N|A)
<!--#set var="websok" value="websok-FaretBib" -->
<!--#set var="eieravd" value="fabb" -->
<!--#set var="hyllestatus" value="" -->
<!--#set var="vis245h" value="1" -->
<!--#set var="bibserver" value="localhost" -->
<!--#set var="ccl" value="ff=ed" -->
<!--#set var="fontsize" value="-2" -->
<!--#set var="tableborder" value="1" -->
<!--#set var="visbilde" value="1" -->
<!--#set var="tabellheader" value="Bilde Forfatter Tittel" -->
<!--#exec cgi="/cgi-bin/sistetittel.tcl"-->


2.18.3. Kikkhullet: Siste x bestilte

Programmet skal kjøres innenfra en webside. Korrekt konfigurert viser den en enkel tabell med de siste bestilte titlene.

Programmet er veldig likt programmet for de siste utlånte.

Konfigurasjonsvalg (standardverdi i parentes)

antall (1)

Antall titler som skal vises.

status (b)

For at titlene skal taes med må de ha denne statuskoden. Statuskoden kan være ' ' (dvs blank) for registrert, b for bestilt, m for mottatt og a for betalt.

eieravd (*)

Eieravdeling. Trunkering kan brukes.

websok (websok)

Instans som skal brukes for webøkset.

eksnr (1)

Eksemplarnummer. Hvis denne er satt til 1 vil den kun vise bestillinger med eksemplarnummer 1 som i de fleste tilfellene betyr en helt ny tittel.

vis245h (1)

Bestemmer om $245h(dokumenttype) skal vises i tabellen.

ccl ("")

Ccl søk. Krever en del ekstra jobbing på serveren og kan derfor føre til at det tar litt tid å generere tabellen.

bibserver (localhost)

Spesifiserer navnet på serveren. Må brukes hvis programmet ikke kjøres på Bibliofiltjeneren.

fontsize (+0)

Skriftstørrelse i tabellen.

tableborder (0)

Tykkelse på rammen rundt tabellen.

visbilde (0)

Skal omslagsbilde vises hvis det er tilgjengelig?

tabellheader ("")

Legg inn liste med overskrifter til tabellen. F.eks:

					"Bilde Forfatter Tittel"
					

exec cgi skal ha verdien /cgi-bin/sistebestilling.tcl

Eksempel 2.8. Kikkhullet: 20 siste bestillinger


<!--#set var="antall" value="20" -->
<!--#set var="websok" value="websok-FaretBib" -->
<!--#set var="eieravd" value="fabb" -->
<!--#set var="status" value="b" --> (''|b|m|a)
<!--#set var="eksnr" value="1" -->
<!--#set var="vis245h" value="1" -->
<!--#set var="ccl" value="ff=ed" -->
<!--#set var="bibserver" value="localhost" -->
<!--#set var="fontsize" value="-2" -->
<!--#set var="tableborder" value="1" -->
<!--#set var="tabellheader" value="Bilde Forfatter Tittel" -->
<!--#set var="visbilde" value="1" -->
<!--#exec cgi="/cgi-bin/sistebestilling.tcl"-->


2.18.4. Kikkhullet: Mest utlånte bøker de siste 6 måneder

Programmet skal kjøres innenfra en webside. Korrekt konfigurert viser den en helt enkel tabell med de mest utlånte bøkene de siste 6 månedene.

Programmet er veldig likt programmet for de siste utlånte.

Konfigurasjonsvalg (standardverdi i parentes)

antall (1)

Antall titler som skal vises.

visutlan ("")

Settes til 1 hvis man vil vise antall utlån som tittelen har hatt.

type (U)

Spesifiserer om man vil vise utlån(U) eller reserveringer(R).

hyllestatus (*)

Hyllestatus. Bruk statuskoder fra $DBPATH/koder/ekskoder-filen. Trunkeringstegnet * bruker alle statuskoder.

websok (websok)

Instans som skal brukes for webøkset.

ccl ("")

Ccl søk. Krever en del ekstra jobbing på serveren og kan derfor føre til at det tar litt tid å generere tabellen.

Viktig

Begrens ikke søket for mye! Den nattlige genereringen inneholder bare de mest utlånte bøkene (titler med færre enn 5 utlån tas ikke med!). Desto mer begrenset søket er, desto lengre tid vil det ta. Det er også mulig at den kommer opp tom hvis den ikke finner noen titler.

Det er ikke mulig å avgrense på noen annen dokumenttype enn bøker!

bibserver (localhost)

Spesifiserer navnet på serveren. Må brukes hvis programmet ikke kjøres på Bibliofiltjeneren.

fontsize (+0)

Skriftstørrelse i tabellen.

tableborder (0)

Tykkelse på rammen rundt tabellen.

visbilde (0)

Skal omslagsbilde vises hvis det er tilgjengelig?

visantex (0)

Skal det være med ei kolonne med antall eksemplarer?

visutlex (0)

Skal det være med ei kolonne med antall utlån/eksemplarer?

tabellheader ("")

Settes for å få kolonneoverskrifter. Hver kolonne skilles med mellomrom, hvis en overskrift inneholder flere ord, som Utlån pr eksemplar må mellomrommene escapes med \ (backslash).

Kolonnene vises i denne rekkefølgen: Bilde, Ordningsord, Tittel, Utlån, Antall eksemplarer, Utlån pr eksemplar.

exec cgi skal ha verdien /cgi-bin/mestutlant.tcl.

Eksempel 2.9. Kikkhullet: 20 mest utlånte bøker beregnet på voksne


<!--#set var="antall" value="20" -->
<!--#set var="websok" value="websok-FaretBib" -->
<!--#set var="visutlan" value="1" -->
<!--#set var="type" value="U" -->
<!--#set var="ccl" value="bn=a" -->
<!--#set var="bibserver" value="localhost" -->
<!--#set var="fontsize" value="-2" -->
<!--#set var="tableborder" value="1" -->
<!--#set var="tabellheader" value="Bilde Ordningsord Tittel Utlån Antex Utån&bsol; pr&bsol; ex" -->
<!--#set var="visantex" value="1" -->
<!--#set var="visutlex" value="1" -->
<!--#exec cgi="/cgi-bin/mestutlant.tcl"-->