Prosjektgruppa for Trondheimsbilder har gått
igjennom "Trondheimsbilder - protokollkrav versjon 1.0" av Ole Husby datert
6.1.04 og prosjektgruppas kommentarer av 27.1.2004 er uthevet med rød
skrift i dette dokumentet.
Dette dokumentet beskriver den protokollen som utgjør grensesnittet mellom samsøkingsklienten og de enkelte databaseserverne som inngår i prosjekt Trondheimsbilder. [1]
Det har videre vært en målsetting å bruke eksisterende standarder og formater så langt det er råd.
Dette forslaget er resultat av et arbeidsmøte 2003-12-03 i Oslo, med følgende deltakere:
Steinar Bjørneset, Museeenes DatatjenesteDet foreliggende forslaget har senere vært drøftet i en uformell arbeidsgruppe som består av disse personene. Forslaget er ikke dermed godkjent av de tre partene som er representert.
Ola Thori Kogstad, Biblioteksystemer AS
Roger Niva, Biblioteksystemer AS
Ole Husby, BIBSYS
Dokumentet "Presisering av kravspesifikasjonen når det gjelder grensesnittet mot databasene" inneholder noen krav som går lenger enn den opprinnelige kravspesifikasjonen. Det gjelder følgende krav, som alle er tatt inn i protokollspesifikasjonen:
Det er gjort en vesentlig endring i forhold til "Presisering av kravspesifikasjonen når det gjelder grensesnittet mot databasene", nemlig at UTF-8 skal brukes som tegnsett i stedet for ISO 8859-1. OK!
Protokollkravene er beskrevet i forhold til protokollen SRW versjon 1.0. En ny versjon 1.1 vil bli offentliggjort snart, og det vil være naturlig å legge denne til grunn for implementasjonene. Vi går ut fra at endringene fra 1.0 til 1.1 ikke er større enn at de foreliggende spesifikasjonene er gode nok som grunnlag for å starte design-arbeidet. Vi foreslår at systemleverandørene foretar en vurdering når versjon 1.1 foreligger, for å
Følgende abstrakte metadataskjema brukes som grunnlag for utveksling av metadataposter.
De 7 første elementene henviser til kravspesifikasjonen [2], og beskrivelsen er hentet derfra.
De fleste feltene passer inn i MARC 21, og for disse er angitt feltkode og evt delfeltkode. Merk at bruken av feltkode 245 for Motiv er diskutabel. OK!
| Navn | Beskrivelse | MARC 21 |
| Fotograf | Fotograf | 100 $a |
| År | Fotograferingsår | 260 $c |
| Motiv | Tittel / motiv | 245 $a |
| Beskrivelse | Beskrivelse av bildet (tilsvarer notefeltet i marc-formatet) | 520 $a |
| Person | Person på bildet | 600 $a |
| Emneord | Emneord / stikkord | 650 $a |
| Sted | Sted på bildet | 651 $a |
| FullURI | URI til fullskalabilde | 856 $u |
| MiniatyrURI | URI til miniatyrbilde | - |
| LokalPostURI | URI til postvising i lokalt brukergrensesnitt | - |
| ID | Lokal unik identifikator | 001 |
Spesielle krav:
Så snart versjon 1.1 av SRW publiseres, må det vurderes om denne kan brukes i stedet. OK!
I resten av dette dokumentet henvises det til versjon 1.0.
Det er tilstrekkelig at det informeres om URI for denne WSDL-fila direkte til leverandøren av klienten. Det er opp til databaseleverandørene å bruke UDDI eller andre mekanismer for informasjonsspredning.
I tillegg til de krav som framgår av dette dokumentet stilles det følgende krav:
4.3.1 searchRetrieveRequest |
|
| query | Skal alltid brukes av klienten |
| xQuery | Skal ikke brukes av klienten |
| sortKeys | Kan brukes av klienten. Skal støttes av serveren. Se nærmere beskrivelse av krav til sortering nedenfor. |
| maximumRecords | Skal alltid brukes av klienten |
| recordSchema | Skal alltid brukes av klienten |
4.3.2 searchRetrieveResponse |
|
| numberOfRecords | Skal alltid brukes av serveren |
| resultSetId | Skal alltid brukes av serveren |
| resultSetIdleTime | Skal alltid brukes av serveren. Kan tolkes som minimum levetid for settet. Anbefalt verdi: Minst 1 time. |
| nextRecordPosition | Skal alltid brukes av serveren |
|
|
| explain | Skal alltid brukes av serveren. Skal oppfylle krav i "SRW Conformance Statement". [5] |
FotografI tillegg kommer følgende krav:
År
Motiv
Person
Emneord
Sted
Merk: Dette er minimumskrav for å tilfredsstille standarden, og er vondt å fravike. Men det er sannsynlig at flere av de aktuelle serverne vil ha problem med å støtte generell strengsøking gjennom relasjonen "exact". HVILKE KONSEKVENSER FÅR DETTE?
I tillegg stilles følgende krav:
Som referansedokument er brukt "CQL. Syntax and Rules". [6]
Videre skal det være støtte for indeksen srw.resultSetName fra "SRW Utility Index Set". [7]
Fotograf som 1. kriteriumPoster som mangler Fotograf skal sorteres først.
Motiv som 2. kriterium
Serverne skal kunne levere en alfabetisk liste over stikkord/emneord som er brukt i bildebasen.I kravspesifikasjonsdokumentet står det eksplisitt:
Det skal satses på en protokoll.Videre er det ikke nevnt noe krav om alfabetiske lister. Vi har et krav om alfabetisk liste i punkt 15 i dokumentet "Presisering av kravspesifikasjonen når det gjelder samsøkklienten". Vi ønsker fortsatt at alfabetiske lister skal realiseres.
Klienten skal benytte SRW v. 1.0 og Web Services
Vi har i denne omgang valgt å ikke gå lenger med dette punktet. Det skyldes primært at det ikke er støtte for en slik funksjon ("scan") i SRW versjon 1.0. Derimot er det annonsert at dette vil komme i versjon 1.1.
Hvis en slik funksjon skal støttes, kan det være aktuelt å vurdere den også for andre felter enn emneord. Vi støtter dette. Det er også litt uklart hvordan funksjonaliteten til denne tjenesten skal være, f.eks. med hensyn til antall termer pr forespørsel (vi ønsker presentasjon av 15 termer pr forespørsel), om responsen skal inneholde antall treff pr term o.l. (ja, vi ønsker visning av antall treff pr term, som i Bibliofil - eksempel nedenfor)
Det er ønskelig med tilbakemelding fra prosjektet før dette punktet bearbeides.
Fullskalabildet skal ha en lengste side på 1024 punkter eller mindre.
Miniatyrbildene skal ha en lengste side på 122 punkter eller mindre.
I tillegg til bildene skal serveren på en HTTP-forespørsel sende en logo. Det overlates til klientutvikleren å foreslå størrelse for denne logoen. OK, men vi synes det er tilstrekkelig at eierinsitusjonens logo er lagret lokalt i samsøkklienten.
Merk: Det er en forutsetning at samsøkingsklienten ikke skal ha en eksklusiv adgang til SRW-tjenestene.
Her beskrives et Index set med navn "Trondheimsbilder" og med "tr" som anbefalt prefiks.
| Navn | Abstrakt felt | Syntaks / verdier |
| photographer | Fotograf | Invertert personnavn |
| year | År | Årstall (YYYY) |
| motif | Motiv | Enkeltord |
| person | Person | Invertert personnavn |
| subject | Emneord | Enkeltord |
| location | Sted | Enkeltord |
| limitation | "trondheim" | "image" |
tr.photographer = "røske, anton" and tr.year = 1912Bilder med motiv som inneholder ordene "båt og "ravnkloa":
tr.motif all "båt ravnkloa"Bilder av Johan Bruun i Ravnkloa:
tr.person = "bruun, johan" and tr.location = ravnkloaBilder av robåter fra Trondheim, med tilgjengelig fullskalabilde:
tr.subject = robåter and tr.limitation all "trondheim image"Et tilfeldig utvalg av bilder:
tr.motif = *
Bruken av kvalifisert Dublin Core refererer til "DCMI Metadata Terms" [9]
| Name | Element | refining | type attribute |
| Fotograf | dc:creator | ||
| År | dc:date | ||
| Motiv | dc:title | ||
| Beskrivelse | dc:description | ||
| Person | dc:subject | trterms:personalName | |
| Emneord | dc:subject | ||
| Sted | dcterms:spatial | dc:coverage | |
| FullURI | dc:identifier | dcterms:URI | |
| MiniatyrURI | trterms:hasThumb | dc:relation | dcterms:URI |
| LokalPostURI | trterms:hasLocalPresentation | dc:relation | dcterms:URI |
| ID | dc:identifier |
Kodingen utføres i henhold til "Guidelines for implementing Dublin Core in XML" (DCMI Recommendation) [10]
I vårt tilfelle betyr det i praksis at hasThumb og hasLocalPresentation kodes som selvstendige elementer, selv om de er kvalifikatorer til dc:relation.
| 001 | AR-05778 | |
| 100 | $a | Røske, Anton |
| 245 | $a | Båt i Kanalen ved Ravnkloa |
| 260 | $c | 1912 |
| 520 | $a | Åpen båt med flagg, mann i halvfigur. Utsikt mot Ravnkloa og Fiskehallen, flere båter ved kai |
| 600 | $a | Bruun, Johan |
| 650 | $a | Robåter |
| 651 | $a | Ravnkloa |
| 740 | $a | Motorbåt for I.N. Bruun |
<?xml version="1.0"?> |
<?xml version="1.0"?> |
[1] Prosjekt Trondheimsbilder.
http://trhweb.trondheim.folkebibl.no/bildeprosjekt/
[2] Presisering av kravspesifikasjonen når det gjelder grensesnittet
mot databasene" datert 25. november 2003.
http://trhweb.trondheim.folkebibl.no/bildeprosjekt/kravspek3.html
[3] SRW Specifications
http://lcweb.loc.gov/z3950/agency/zing/srw/specifications.html
[4] SRW Service Description
http://lcweb.loc.gov/z3950/agency/zing/srw/service.html
[5] SRW Conformance Requirements
http://lcweb.loc.gov/z3950/agency/zing/srw/conformance.html
[6] CQL. Syntax and Rules
http://lcweb.loc.gov/z3950/agency/zing/cql/cql-syntax.html
[7] SRW Utility Index Set
http://lcweb.loc.gov/z3950/agency/zing/cql/srw-indexes.html
[8] CQL: Index Sets.
http://lcweb.loc.gov/z3950/agency/zing/cql/index-sets.html
[9] DCMI Metadata Terms
http://www.dublincore.org/documents/dcmi-terms/
[10] Guidelines for implementing Dublin Core in XML (DCMI Recommendation)
http://www.dublincore.org/documents/2003/04/02/dc-xml-guidelines/