Kapittel 1. Innledning

Fjernlånsgruppa, oppnevnt på systemleverandør-møte, den 21/9/2000, fikk i oppgave å lage et utkast til en norsk standard for utveksling av fjernlånsdata mellom systemene. Det gruppa har kommet fram til har vært på høring og er endelig godkjent som anbefalt norsk standard.

Dette dokumentet i PDF-versjon kan lastes ned fra nill.pdf

Gruppa hadde møter, 29/11/2000, 28/5/2001 og 21/1/2004. Følgende har jobbet i gruppa:

• Sigrid Smedsrud, BIBSYS

• Torstein Tjelta, Nasjonalbiblioteket

• Tom André Øverland, Bibliotekenes IT-senter AS

• Tore Morkemo, Bibliotek-Systemer As

• David Massey, Bibliotekenes IT-senter AS

• Erling Fossan, BIBSYS

Kapittel 2. Hensikt

Dette dokumentet beskriver norsk standard for utveksling av fjernlånsdata. Målet med standarden er å forenkle / automatisere fjernlånsbehandlingen mellom norske bibliotek.

De norske leverandørene av biblioteksystemer har i fellesskap utformet standarden.

Kapittel 3. Avgrensninger

Standarden omfatter ikke reserveringer eller videresending av fjernlånsmeldinger. Fjernlån gjøres kun på dokument-nivå og ikke på eksemplarnivå. Fjernlånsbestillinger direkte fra enkeltpersoner omfattes ikke av standarden.

Det er bare de bibliotekene som har fått tildelt lånernummer i Base BIBLIOTEK som kan delta i utvekslingen. Det er opprettet to felter i Base BIBLIOTEK som inneholder epostadressen for mottak av meldinger.

Kapittel 4. Begreper

Kapittel 5. Transportmetode

Utveksling av fjernlånsmeldinger gjøres via e-post. Meldingene legges direkte i e-posten, ikke som vedlegg.

Initielle bestillinger kan også gjøres direkte via internett (http) i eiersystemet der hvor dette er støttet. Kvitteringer skal alltid sendes på e-mail.

Kapittel 6. Protokoll

Følgende DTD (Document Type Definition) er laget for håndtering av både bestilling og kvittering. Denne kan lastes ned fra http://www.biblev.no/dtd/nill.dtd

		<!--
  NILL - DTD for bestilling/kvittering, versjon 1.3
  Lagt til endringer for LII, Versjon 1.3: 2008-01-11 TM
  Versjon 1.2: 2004-02-23 TT
 -->

<!ELEMENT  nill (bestilling | kvittering)>

<!--                                                -->
<!--                                                -->
<!--     Bestilling                                 -->
<!--                                                -->
<!--                                                -->

<!ELEMENT  bestilling  (bestiller, eierbibnr?, ordre)>

<!--  bestiller inneholder data om bestiller -->
<!ELEMENT bestiller (bestbibnr, kontbibnr?, email_nill?, email?)>

<!--            bestbibnr=Bestillers biblioteknummer            -->
<!ELEMENT bestbibnr (#PCDATA)>

<!--            kontbibnr=Betalers biblioteknummer              -->
<!ELEMENT kontbibnr (#PCDATA)>

<!--      email_nill: Bestillers adresse for NILL-kvittering -->
<!ELEMENT email_nill (#PCDATA)>
<!--            email: brukes for kvittering til biblioteker som mangler email_nill -->
<!ELEMENT email (#PCDATA)>


<!--   ordre har data om det som bestilles -->
<!ELEMENT ordre (levering, dokument)>
<!ATTLIST ordre
          type (laan | kopi) #REQUIRED
          lii (0 | 1) #IMPLIED>

<!--   Et dokument er evt. identifikator, bibdata (evt. tom), + evt. artikkeldata -->
<!--   For artikkelbestilling vil 1. element identifisere tidsskrift/vertsdokument -->
<!ELEMENT dokument (identifikator? , bibdata, artikkel?)>

<!ELEMENT identifikator (#PCDATA)>
<!--  LOCAL-ID er default. Referer til en verifisert lokal       -->
<!--                       identifikator i base hos eier         -->
<!ATTLIST identifikator
          scheme ( ISBN | ISSN | SICI | LOCAL-ID) #REQUIRED>

<!--   bibdata : bibliografiske data for bestilt enhet eller vertsdokument -->
<!ELEMENT bibdata (forfatter?, tittel?, volum?, aar?, sider?, heftenr?)>

<!--   artikkel (kopi), identifisert ved lokal identifikator eller bibdata  -->
<!--   hvis bibdata : artikkelens forfatter og tittel samt volum, aar, sider, heftenr -->
<!ELEMENT artikkel (identifikator | bibdata)>


<!-- innhold i bibdata kan vaere disse -->		
<!ELEMENT forfatter (#PCDATA)>
<!ELEMENT tittel (#PCDATA)>
<!ELEMENT heftenr (#PCDATA)>
<!ELEMENT volum (#PCDATA)>
<!ELEMENT aar (#PCDATA)>
<!ELEMENT sider (#PCDATA)>


<!ELEMENT levering (bestrefr, kopiformat?, bestkomm?, bestlokkomm?, bestlokid?)>

<!--      bestrefr=Bestillings-ID, skal returneres i kvitteringen -->
<!ELEMENT bestrefr (#PCDATA)>


<!-- kopiformat forteller om oensket format paa kopi ved kopibestilling -->
<!ELEMENT kopiformat (fax | elektronisk | papir)>

<!-- faxnummer for levering av fax-kopi -->
<!ELEMENT fax (#PCDATA)>

<!-- elektronisk inneholder leveringsinformasjon. som regel epost-adresse -->
<!-- attributt forteller om oensket format paa fil -->
<!ELEMENT elektronisk (#PCDATA)>
<!ATTLIST elektronisk filformat (pdf | ps | link) #IMPLIED>

<!-- ekstra informasjon om levering av kopi paa papir -->
<!ELEMENT papir (#PCDATA)>

<!--      bestlokid: Bestilt til (lokalt laanernummer) -->
<!ELEMENT bestlokid (#PCDATA)>


<!--      bestkomm=Bestillers kommentar til eier          -->
<!ELEMENT bestkomm (#PCDATA)>

<!--      bestlokkomm=Bestillers egen kommentar                  -->
<!ELEMENT bestlokkomm (#PCDATA)>




<!--                                                -->
<!--                                                -->
<!--     Kvittering                                 -->
<!--                                                -->
<!--                                                -->

<!-- bestrefr og bestbibnr i kvittering returnerer verdiene fra bestillingen -->
<!-- kopiformat, bestkomm, bestlokkomm og bestlokid returneres hvis de er med i bestillingen -->

<!ELEMENT kvittering (bestrefr, eierrefr, eierbibnr, bestbibnr, postinfo?,
    eierkomm?, forfdato?, kopiformat?, bestkomm?, bestlokkomm?, bestlokid?)>

<!ATTLIST kvittering
    status (mottatt | sendt | kanselert) #REQUIRED
    type (laan | kopi) #IMPLIED
    lii (0 | 1) #IMPLIED>

<!-- eierrefr  = Eiers referanse id til bestillingen -->
<!ELEMENT eierrefr (#PCDATA)>

<!ELEMENT eierbibnr (#PCDATA)>

<!ELEMENT eierkomm (#PCDATA)>


<!ELEMENT postinfo (marc | bibdata)>


<!-- marc inneholder katalogposten i NORMARC-format -->
<!ELEMENT marc (#PCDATA)>

<!-- Format paa forfallsdato yyyymmdd  -->
<!ELEMENT forfdato (#PCDATA)>
	  

Kapittel 7. Merknader til protokoll

Tegnsettet i protokollen skal være UTF-8 eller ISO-8859-1. Alle meldinger skal starte med:

<?xml version='1.0' encoding='ISO-8859-1'?>

<?xml version='1.0' encoding='UTF-8'?>

Eier skal snarest mulig sende en mottatt-kvittering til bestiller. MARC-post for materialet skal om mulig vedlegges i kvitteringen. Bestiller kan da fritt benytte hele eller deler av MARC-posten til lokal katalogisering av det fjernlånte meterialet.

Kvittering med status kanselert kan komme som første svar på bestilling. Bestillingen regnes da som avsluttet for begge parter.

Følgende felter skal alltid returneres i kvitteringen dersom de er med i bestillingen:

• bestlokid

• bestkomm

• bestlokkomm

• kopiformat

• lii

		  <bestrefr>Minref$8BE2F899EE</bestrefr>
		

Kapittel 8. Krav til web-skjema

For at brukerne av bestillingsskjema for fjernlån skal fylle inn riktige data i de forskjellie bestillingsskjemaene, anbefales følgende ledetekster på skjemaene.

Kapittel 9. Logo

Følgende logo er laget for til bruk i applikasjoner som støtter NILL. Logoen kan f.eks. brukes til å markere på et web-skjema at NILL-støttes.

Kapittel 10. Registrering ved innlevering på andre bibliotek

Dersom en låner ønsker å levere materiale på et annet bibliotek enn der det er lånt er det definert en webservice for håndtering av dette. De aller fleste strekkoder vil kunne fortelle noe om hvor materialet er lånt. Dersom dette ikke er mulig er det som regel mulig på annet vis å finne ute dette ut fra f.eks. stempel i bøker.

Når denne webservicen er brukt så kan eierbiblioteket f.eks. stoppe purringer/regninger på materiale som låner har levert fra seg.

		  <?xml version="1.0" encoding="utf-8"?>
<wsdl:definitions
  xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
  xmlns:tm="http://microsoft.com/wsdl/mime/textMatching/"
  xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
  xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/"
  xmlns:tns="http://bibits.no/RemoteReturnService"
  xmlns:s="http://www.w3.org/2001/XMLSchema"
  xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/"
  xmlns:http="http://schemas.xmlsoap.org/wsdl/http/"
  targetNamespace="http://bibits.no/RemoteReturnService"
  xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
  <wsdl:types />

  <wsdl:message name="materialeInnlevertSoapIn">
    <wsdl:part name="libraryId" type="s:string" />

    <wsdl:part name="barcode" type="s:string" />
  </wsdl:message>

  <wsdl:message name="materialeInnlevertSoapOut">
    <wsdl:part name="return" type="s:string" />
  </wsdl:message>

  <wsdl:message name="materialeInnleverSjekkSoapIn">
    <wsdl:part name="libraryId" type="s:string" />

    <wsdl:part name="barcode" type="s:string" />
  </wsdl:message>

  <wsdl:message name="materialeInnleverSjekkSoapOut">
    <wsdl:part name="return" type="s:string" />
  </wsdl:message>

  <wsdl:portType name="RemoteReturnSoap">
    <wsdl:operation name="materialeInnlevert">
      <wsdl:input message="tns:materialeInnlevertSoapIn" />

      <wsdl:output message="tns:materialeInnlevertSoapOut" />
    </wsdl:operation>

    <wsdl:operation name="materialeInnleverSjekk">
      <wsdl:input message="tns:materialeInnleverSjekkSoapIn" />

      <wsdl:output message="tns:materialeInnleverSjekkSoapOut" />
    </wsdl:operation>
  </wsdl:portType>

  <wsdl:binding name="RemoteReturnSoap"
  type="tns:RemoteReturnSoap">
    <soap:binding transport="http://schemas.xmlsoap.org/soap/http"
    style="rpc" />

    <wsdl:operation name="materialeInnlevert">
      <soap:operation soapAction="" style="rpc" />

      <wsdl:input>
        <soap:body use="encoded" namespace="urn:lii"
        encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" />
      </wsdl:input>

      <wsdl:output>
        <soap:body use="encoded" namespace="urn:lii"
        encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" />
      </wsdl:output>
    </wsdl:operation>

    <wsdl:operation name="materialeInnleverSjekk">
      <soap:operation soapAction="" style="rpc" />

      <wsdl:input>
        <soap:body use="encoded" namespace="urn:lii"
        encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" />
      </wsdl:input>

      <wsdl:output>
        <soap:body use="encoded" namespace="urn:lii"
        encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" />
      </wsdl:output>
    </wsdl:operation>
  </wsdl:binding>

  <wsdl:binding name="RemoteReturnSoap12"
  type="tns:RemoteReturnSoap">
    <soap12:binding
    transport="http://schemas.xmlsoap.org/soap/http" style="rpc" />

    <wsdl:operation name="materialeInnlevert">
      <soap12:operation soapAction="" style="rpc" />

      <wsdl:input>
        <soap12:body use="encoded" namespace="urn:lii"
        encodingStyle="http://www.w3.org/2003/05/soap-encoding" />
      </wsdl:input>

      <wsdl:output>
        <soap12:body use="encoded" namespace="urn:lii"
        encodingStyle="http://www.w3.org/2003/05/soap-encoding" />
      </wsdl:output>
    </wsdl:operation>

    <wsdl:operation name="materialeInnleverSjekk">
      <soap12:operation soapAction="" style="rpc" />

      <wsdl:input>
        <soap12:body use="encoded" namespace="urn:lii"
        encodingStyle="http://www.w3.org/2003/05/soap-encoding" />
      </wsdl:input>

      <wsdl:output>
        <soap12:body use="encoded" namespace="urn:lii"
        encodingStyle="http://www.w3.org/2003/05/soap-encoding" />
      </wsdl:output>
    </wsdl:operation>
  </wsdl:binding>

  <wsdl:service name="RemoteReturn">
    <wsdl:port name="RemoteReturnSoap"
    binding="tns:RemoteReturnSoap">
      <soap:address
      location="http://localhost/wstest/RemoteReturn.asmx" />
    </wsdl:port>

    <wsdl:port name="RemoteReturnSoap12"
    binding="tns:RemoteReturnSoap12">
      <soap12:address
      location="http://localhost/wstest/RemoteReturn.asmx" />
    </wsdl:port>
  </wsdl:service>
</wsdl:definitions>