Trondheimsbilder - protokollkrav

Versjon 1.0

2004-01-06 Ole Husby

Dette dokumentet beskriver den protokollen som utgjør grensesnittet mellom samsøkingsklienten og de enkelte databaseserverne som inngår i prosjekt Trondheimsbilder. [1]

1. Innledning

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

• Alfabetisk liste over emneord
• Skalering av miniatyrbilder
• Avgrensing til bilder fra Trondheim kommune
• Tilfeldige treff

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.

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 å

• avgjøre om versjon 1.1 skal benyttes, og i såfall
• reviderer foreliggende dokument slik at det harmonerer med versjon 1.1

2. Grunnleggende tjenestemodell

Søking

Alfabetiske termlister

Henting av bilder

Explain

3. Abstrakt metadataskjema

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.

Spesielle krav:

1. LokalPostURI kan være med i posten (optional).
2. FullURI og MiniatyrURI skal være med, men bare hvis hvis de er reelle, dvs representerer et bilde som er tilgjengelig (conditional)
3. Alle de andre elementene i tabellen skal være med hvis de finnes i det lokale systemet (conditional).
4. Andre metadatafelter kan være med (optional)

4. Bruk av SRW

4.1 Versjon

Så snart versjon 1.1 av SRW publiseres, må det vurderes om denne kan brukes i stedet.

I resten av dette dokumentet henvises det til versjon 1.0.

4.2 Bruk av WSDL og UDDI

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.

4.3 Presisering av SRW Service Description

I tillegg til de krav som framgår av dette dokumentet stilles det følgende krav:

4.4 Krav til tegnsett

5. Krav til CQL

5.1 Søkbare felter

Fotograf
År
Motiv
Person
Emneord
Sted

• Det skal være mulig å angi at et søk skal avgrenses til de de postene som har stedsangivelse innenfor Trondheim kommune.
• Det skal i søkingen være mulig å be om et søkesett på minst 30 tilfeldig utvalgte poster.
• Det skal være mulig å angi at et søk skal avgrenses til de postene hvor fullskalabildet faktisk er tilgjengelig.

5.2 Generelle krav til bruk av CQL

<?xml version="1.0"?>

<metadata
  xmlns="http://trondheimsbilder.no/meta/"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://trondheimsbilder.no/meta/ http://trondheimsbilder.no/meta/schema.xsd"
  xmlns:dc="http://purl.org/dc/elements/1.1/"
  xmlns:dcterms="http://purl.org/dc/terms/"
  xmlns:trterms="http://trondheimsbilder.no/meta/terms/">

  <dc:identifier>
    AR-05778
  </dc:identifier>
  <dc:creator>
    Røske, Anton
  </dc:creator>
  <dc:title>
    Båt i Kanalen ved Ravnkloa
  </dc:title>
  <dc:date>
    1912
  </dc:date>
  <dc:description>
    Åpen båt med flagg, mann i halvfigur. Utsikt mot Ravnkloa 
    og Fiskehallen, flere båter ved kai
  </dc:description>
  <dc:subject xsi:type="trterms:personalname">
    Bruun, Johan
  </dc:subject>
  <dc:subject>
    Motorbåt
  </dc:subject>
  <dcterms:spatial>
    Ravnkloa
  </dcterms:spatial>
  <dc:identifier xsi:type="dcterms:URI">
    http://sgate.bibsys.no/bildedb/images/AR%2D05777%3Flib%3Dubit
  </dc:identifier>
  <trterms:hasThumb xsi:type="dcterms:URI">
    http://sgate.bibsys.no/bildedb/thumbnails/AR%2D05777%3Flib%3Dubit
  </trterms:hasThumb>
  <trterms:hasLocalPresentation xsi:type="dcterms:URI">
    http://sgate.bibsys.no/bildedb/record.jsp%3Flib%3Dubit%27id%3DAR%2D05777
  </trterms:hasLocalPresentation>

</metadata>

<?xml version="1.0"?>

<metadata
  <dc:creator>
    Røske, Anton
  </dc:creator>
  <dc:title>
    Båt i Kanalen ved Ravnkloa
  </dc:title>
  <dc:date>
    1912
  </dc:date>
  <dc:description>
    Åpen båt med flagg, mann i halvfigur. Utsikt mot Ravnkloa 
    og Fiskehallen, flere båter ved kai
  </dc:description>
  <dc:subject>
    Bruun, Johan
  </dc:subject>
  <dc:subject>
    Motorbåt
  </dc:subject>
  <dc:coverage>
    Ravnkloa
  </dc:coverage>
  <dc:type>
    Image
  </dc:type>
  <dc:format>
    image/jpeg
  </dc:format>
  <dc:identifier>
    http://sgate.bibsys.no/bildedb/images/AR%2D05777%3Flib%3Dubit
  </dc:identifier>

</metadata>