DBC Webservices in NFBS

DBC Web Services in NFBS, Anders Vestergaard (ave@dbc.dk), April 12, 2013 (REV: April 19, 2013) 

DBC Web Services in NFBS 

Introduction 

This document serves as an introduction to those of DBC’s web services that are part of the 

requirements for NFBS - “Nyt fælles bibliotekssystem - kravspecifikation bilag 2” (http:// 

www.kombit.dk/bibliotek). 

This document is only to be considered as guiding. It is based on the most current, deployed 

versions of the services (April, 2013). All web services, including functionality, communication 

methods/protocols, URL’s, descriptions, versions, data formats, and terms of use might become 

subject to change. 

1. About DBC’s web services 2 

2. DBC Data Well/Open Search 2 

2.1 search 3 

2.2 getObject 5 

3. Universal Search 11 

4. Open Cataloging 12 

5. Open Format 12 

6. ORS 18 

6.1 Open Order 18 

6.1.1 checkOrderPolicy 19 

6.1.2 placeOrder 19 

6.2 Open Find Order 20 

6.2.1 findAllOpenEndUserOrders 21 

7. Open Agency 22 

8. CULR 25 

9. MoreInfo 25 

10. VoxB 27 

11. Open Question 29 

12. ADHL 29 

1


1. About DBC’s web services 

The interfaces of DBC web services are published in WSDL v1.1. The parameters that a web 

service takes and returns for each of its functions, are desribed in an XSD file, which is referenced 

within the WSDL. 

DBC’s web services uses http and also https where demanded. The services can be accessed 

through the SOAP protocol. Most of DBC’ web services can also be called with a REST-like URLsyntax 

(via HTTP GET) and XML-requests (HTTP POST). 

Most DBC web services provide output as SOAP, XML, JSON and PHP objects. Default output 

format for SOAP and HTTP GET requests is SOAP, and XML for XML-requests. The output 

format can be set with the outputType-parameter in the service request. 

Authentication for service users is either done based on the client’s IP-address and/or 

authentication-parameters included in the request. 

Universal Search is an SRU-service and differs from the description above. See details below 

(section 3). 

2. DBC Data Well/Open Search 

DBC’s data well contains metadata, including bibliographical records of the libraries’ materials as 

well as other digital objects and relations between these and external objects. Available metadata 

formats are DKABM, MARCXchange and DocBook. All objects in the data well are indexed 

(SOLRLucene) and can be searched and retrieved through the web service API Open Search. Open 

Search supports CQL as well as simple word searches. 

Supported communication methods are SOAP and HTTP POST (XML-requests). Most of Open 

Search’ functionality can also be used with HTTP GET (URL-requests), except user defined 

ranking. Supported output formats are SOAP, XML, JSON and PHP. 

Web Service: 

http://opensearch.addi.dk/2.2/ 

WSDL (Open Search 2.2): 

http://opensearch.addi.dk/2.2/opensearch.wsdl 

XSD (Open Search 2.2): 

http://opensearch.addi.dk/2.2/opensearch.xsd 

Additional information (in Danish) about relations http://oss.dbc.dk/wiki/bin/view/Databroend/ 

OpenSearchDocRelations and indexes 

http://oss.dbc.dk/wiki/bin/view/Databroend/OpenSearchDocIndexes 

2


Open Search supports two opeations: search and getObject. These are introduced and exemplified 

below. For full documentation, including full lists of possible sort-parameters, facets, relations and 

indexes, refer to the opensearch.xsd, and the other links above. 

2.1 search 

The agency and profile parameters are used to set which institiution and collection of sources that is 

searched. The search query is stated in the query parameter, either as a simple word search (default 

boolean is AND) or as a CQL-search. The start and stepValue parameters are used to traverse the 

search result. Start is used to set the number of the first hit to return and stepValue is used to set the 

number of hits to be returned. 

Example of a simple search request (SOAP): 

 

 

 

danmark 

100200 

test 

1 

1 

 

 

 

And the same request as a URL: 

http://opensearch.addi.dk/2.2/? 

action=search&query=danmark&agency=100200&profile=test&start=1&stepValue=1 

Response (SOAP): 

 

 

 

 

161200 

1 

true 

 

 

1 

1 

 

 

X1000178|100200 

Bibliotekets materialer 

Danmark 

Danmark : PH-1935 / instruktør: Poul Henningsen. 

voksenmaterialer 

1935 

Video 

 

100200:X1000178 

 

dkabm 

 

3


 

 

 

 

 

0.059343 

 

 

 

 

CQL-search (SOAP): 

 

 

 

dc.title=zorro AND dc.type=bog 

100200 

test 

1 

10 

 

 

 

CQL-search (HTTP GET): 

http://opensearch.addi.dk/2.2/?action=search&query=dc.title=zorro%20AND 

%20dc.type=bog&agency=100200&profile=test&start=1&stepValue=1 

Response (SOAP): 

 

 

 

 

1 

1 

false 

 

 

1 

1 

 

 

25863704|100200 

87-02-04177-4 


El Zorro 

Zorro 

Zorro : en legende fødes 

Isabel Allende 

Allende, Isabel 

Skønlitteratur 

fiktion 

historie 

sk 

spændende bøger 

 

4


Spændende og underholdende røverhistorie om den maskerede helt Zorro, søn af den spanske kaptajn Alejandro de la 

Vega og halvblodsindianeren Toypurnia, som kæmper for retfærdighed i det spansk koloniserede Amerika i årene 

1790-1815 

 


2. oplag 

Gyldendal 

2005 

Bog 

381 sider 

dan 

Dansk 

Spanien 

Californien 

1790-1799 

1800-1809 

1810-1819 

 

100200:25863704 

 

dkabm 

 

 

 

 

 

 

0.079664 

 

 

 

 

2.2 getObject 

The getObject operation is used to retrieve a given object in the format specified with the parameter 

objectFormat. 

Example of a getObject-request that include all relations for the given object (XML): 

 

100200 

test 

100200:27953433 

dkabm 

true 

xml 

full 

 

Response (XML): 

 

 

1 

1 

false 

 

 

1 

1 

5


 

 

27953433|100200 

9788702070767 


Hvad siger sneugleungen Ulla? 

Hvad siger sneugleungen Ulla? 

Mette Moestrup 

Moestrup, Mette 

Skønlitteratur 

fiktion 

for 2-4 år 

lyde 

sk 

sne 

ugler 

 

Billedbog. Den lille sneugleunge ved ikke helt selv, hvad for en lyd en sneugleunge egentlig siger. Men den møder 

sneharen, sneræven og isbjørnen, og de kan måske give gode råd 

 

børnematerialer 


1. udgave, 1. oplag 

Gyldendal 

Charlotte Pardi 

2009 

Billedbog 

alle illustreret i farver 

36 sider 

dan 

Dansk 

 

100200:27953433 

 

 

dbcaddi:hasReview 

870971:34036063 

 

 

 

34036063|870971 

Anmeldelser 

Anmeldelse 

Anmeldelse 

Kari Sønsthagen 

Sønsthagen, Kari 

Vurdering: 3/6 


2010 

Anmeldelse 

Sektion 2, s. 7 

dan 

Dansk 

Berlingske tidende, 2010-03-05 

0106-4223 

 

870971:34036063 

 

dkabm 

 

 

 

 

 


870971:33851790 

6


 

 

 

33851790|870971 

Anmeldelser 

Anmeldelse 

Anmeldelse 

Kathrine Assels 

Assels, Kathrine 

Vurdering: 4/6 


2009 

Anmeldelse 

Sektion 4, s. 7 

dan 

Dansk 

Politiken, 2009-10-31 

0907-1814 

 

870971:33851790 

 

dkabm 

 

 

 

 

 


870971:33953453 

 

 

 

33953453|870971 

Anmeldelser 

Anmeldelse 

Anmeldelse 

Lars Bukdahl 

Bukdahl, Lars 


2010 

Anmeldelse 

Bøger, s. 10 

dan 

Dansk 

Weekendavisen, 2010-01-08 

0106-4142 

 

870971:33953453 

 

dkabm 

 

 

 

 

 

dbcbibaddi:hasReview 

870971:34982031 

 

 

 

34982031|870971 

Anmeldelser 

Anmeldelse 

Anmeldelse 

Lars Bukdahl 

Bukdahl, Lars 

7



2011 

Anmeldelse 

S. 81-84 

dan 

Dansk 

Plys, Nr. 27, (2011) 

0901-7623 

 

870971:34982031 

 

dkabm 

 

 

 

 

 

dbcaddi:hasCreatorDescription 

150005:46074 

 

 

 

46074|150005 

http://www.litteratursiden.dk/?q=node/46074 

Litteratursiden 

modified 



Forfatterportrætter 

nonfiktion 

forfatterportræt 

Litteratursiden 

2004 

Netdokument 

Dansk 

9788702012286 

 

150005:46074 

 

dkabm 

 

 

 

 

 

dbcaddi:hasCreatorDescription 

150016:moestrup-mette 

 

 

 

moestrup-mette|150016 

 

http://forfatterweb.dk/forfatterweb/oversigt/moestrup-mette 

 

Forfatterweb 



 

cand.mag. Katrine Lehmann Sivertsen, iBureauet/Dagbladet Information 

 

2012 

Moestrup, Mette 

lyrik 

dansk litteratur 

Digtere 

forfatterportræt 

8


nonfiktion 

 

Ikke for ingenting er Mette Moestrup blevet kaldte en af de mest eksperimenterende danske digtere i sin generation 

og vores skarpeste postfeministiske poet. Hos Moestrup finder man blandt andet en undersøgelse af, hvordan ordene og 

tingene er forbundet og en tematisk behandling af seksualitet, køn, oprindelse, etnicitet og identitet. Det hele er sat ind i 

en eksperimenterende, legende og fabulerende form, der inddrager alt fra ordspil, montage, anagrammer, grønlandske 

leveregler, litterære referencer, talkshows, omskrivning af talemåder, stram metodik og meget andet. 27971695 Blå bog Født: Den 11. december 

1969 i Århus. Uddannelse: Cand. phil. i litteraturhistorie fra Århus Universitet. Debut: Tatoveringer, 1998. Litteraturpriser:Montanas 

litteraturpris, 2007. Seneste udgivelse: Dø, løgn, dø. Gyldendal, 2012. Digte. 

 

 

DBC 

Artikel 

Dansk 

 

150016:moestrup-mette 

 

dkabm 

docbook 

 

 

 

 

 


870976:30834208 

 

 

 

30834208|870976 

Materialevurderinger 

Lektørudtalelse 

Lektørudtalelse 

Bo Knudsen 

Knudsen, Bo 

 

Grafisk talent møder sproglig snilde, og vupti, har vi en perle for de yngste billedbogslæsere. Bogens enkelhed og 

brugen af kun to farver virker så logisk. Hvis nogen lader bogen stå i billedbogskrybben, fordi de synes, den har for få 

farver, så snyder de sig selv 

 


2009 

Anmeldelse 

dan 

Dansk 

 

870976:30834208 

 

dkabm 

docbook 

 

 

 

 

 

dbcaddi:hasSubjectDescription 

150012:176452 

 

 

 

9


176452|150012 

 

http://www.denstoredanske.dk/Natur_og_milj/Zoologi/Fugle/ugler 

 

Den Store Danske 

ugler 

ugler 

Den Store Danske - Gyldendals åbne encyklopædi 

Fugle 

Natur og milj 

Zoologi 

leksikonartikel 

ugler 

 

Strigiformes, orden af fugle, der normalt inddeles i to nrtstende familier: slrugler (Tytonidae) med 16 arter og egentlige 

ugler (Strigidae) med 189 arter. Uglernes nrmeste slgtninge er ... 

 

Siden opdateret: 2012-02-20 


Gyldendal 

2012 

Netdokument 

dan 

Dansk 

 

150012:176452 

 

dkabm 

 

 

 

 

 

dbcaddi:hasSubjectDescription 

150012:176453 

 

 

 

176453|150012 

 

http://www.denstoredanske.dk/Natur_og_milj/Zoologi/Sommerfugle/ugler 

 

Den Store Danske 

ugler 

ugler 

Den Store Danske - Gyldendals åbne encyklopædi 

Natur og milj 

Sommerfugle 

Zoologi 

leksikonartikel 

ugler 

 

Noctuidae, den mest artsrige familie af natsvrmere og sandsynligvis overhovedet af sommerfugle. Der er beskrevet 

mere end 35.000 uglearter; fra Danmark kendes ca. 475. Familien har (ligesom dens ... 

 

Siden opdateret: 2011-04-24 


Gyldendal 

2011 

Netdokument 

dan 

Dansk 

 

150012:176453 

 

dkabm 

10


 

 

 

 

 

 

dkabm 

 

 

 

 

 

0.308964 

 

 

3. Universal Search 

Universal Search is a platform for integrated searching of various targets, eg. websites, databases, 

data wells, repositories etc. The searches are sent through a service proxy, which handles 

authentication and profiles of targets to search, to the Pazpar2 meta-search engine, which searches 

and retrieves data from the various targets. Possible targets include Z39.50/SRU-services, websites 

(using MasterKey Connect), SOLR-indexes or custom made gateways (for instance an SRU 

gateway built on a proprietary web service API). Pazpar2 returns the various search results to the 

service proxy which handles deduplication, sorting etc. 

Universal Search is built on Index Datas MasterKey Platform and Pazpar2 metasearch service. 

Universal Search can be accessed directly as an SRU-service using HTTP GET (URL-requests). 

Output format is XML. A Drupal module, mkdru, is available, for direct integration of Universal 

Search on Drupal platforms. 

Further documentation: 

http://drupal.org/project/mkdru 

http://www.indexdata.com/masterkey 

http://www.indexdata.com/pazpar2 

Example SRU-requests: 

Authentication request: http://pz2p.dbc.dk/service-proxy/? 

command=auth&action=login&username=123123&password=xyzxyz 

Search request: http://pz2p.dbc.dk/service-proxy/?command=search&query=water 

Stats request (overview of current search: hit count, active connections, failed targets etc.): http:// 

pz2p.dbc.dk/service-proxy/?command=stat 

Status for each searched target: http://pz2p.dbc.dk/service-proxy/?command=bytarget 

Show search result: http://pz2p.dbc.dk/service-proxy/?command=show 

11


4. Open Cataloging 

Open Cataloging is a service used for creating and editing bibliographic records and other data 

objects in the DBC data well. The web service is currently under development. 

5. Open Format 

Open Format is a service used for ad hoc formatting of data objects from the data well. The service 

takes an XML data object and convert it into a given format defined in the Open Format service 

backend. 

Supported communication methods are SOAP and HTTP POST (XML-requests). Supported output 

formats are SOAP, XML, JSON and PHP. 

Web Service: 

http://openformat.addi.dk/0.2 

WSDL: 

http://openformat.addi.dk/0.2/openformat.wsdl 

XSD: 

http://openformat.addi.dk/0.2/openformat.xsd 

The service has one operation, format. The data that is to be formatted is wrapped in the element 

originalData. Additional parameters (language, holdBackEndDate) can also be set in the request. 

The desired outputformat is set with the parameter outputFormat. Available formats are listed in the 

xsd (outputFormatType). 

Example request (SOAP): 

 

 

 

 

2012-04-10 

 

 

1 

1 

 

 

29213836|870970 

NJE 

Laust Sonne 

Laust Sonne 

Laust Sonne 

Sonne, Laust 

78.794:5 

Rock (Beat). Moderne folkemusik (Folk) 

12


dansk pop 

electronica 

electronica 

pop 

pop 

rock 

rock 

vokal 

børnematerialer 


2012 version 

EMI Music Denmark 

Rune Brꜳger 

Nikolaj Juel 

Nicolai Molbech 

Kristoffer Sonne 

Nikolaj Torp Larsen 

Marcus Winther-John 

2012 

Cd (musik) 

1 cd, 1 bilag 

We:Made EMI EMI 9558652 

eng 

Engelsk 

Lost my heart 

Disco heart 

Vertigo 

Taking it back 

Can you keep a secret 

Spell on you 

What about us 

Call me up 

Walk out the door 

How can I 

Chills 

Like a chemical 

Body talk 

Danmark 

2010-2019 

 

 

 

000000000000000000000000 

 

29213836 

870970 

20120210145818 

20120210 

a 

FAUST 

 

 

n 

e 

 

 

20120123 

20120523 

a 

 

 

s 

f 

2012 

dk 

13


eng 

0 

 

 

s 

xc 

a 

xx 

 

 

5099995586526 

 

 

DMO201207 

 

 

bef 

 

 

 

Sonne 

Laust 

 

 

Laust Sonne 

Laust Sonne with Kristoffer Sonne ... [et al.] 

vocals by Laust Sonne 

produced by Kristoffer Sonne, Laust Sonne, Nikolaj Torp, Dyre Gormsen ... [et 

al.] 

 

 

[2012 version] 

 

 

EMI Music Denmark 

p 2012 

 

 

1 cd 

1 bilag 

 

 

MySpace 

http://www.myspace.com/laustsonne 

 

 

Indhold: 

 

 

We:Made 

EMI 

EMI 9558652 

 

 

78.794 

5 

 

 

rock 

pop 

electronica 

vokal 

2010-2019 

Danmark 

 

 

14


 

Brꜳger 

Rune 

 

 

 

Juel 

Nikolaj 

 

 

 

Molbech 

Nicolai 

 

 

 

Sonne 

Kristoffer 

 

 

 

1 

Torp Larsen 

Nikolaj 

 

 

 

6 

Winther-John 

Marcus 

 

 

11 

 

Lost my heart 

written and composed by Kristoffer Sonne & Laust Sonne 

keyboards by Nikolaj Torp & Laust Sonne 

voice by N. Molbech 

add. whoas by K. Sonne 

claps by N. Molbech & Laust 

drum programming by Kristoffer Sonne 

 

 

12 

 

Disco heart 

written and composed by Laust Sonne 

instruments played by Laust 

 

 

13 

 

Vertigo 


keyboards by Nikolaj Torp 

add. whoas by Kristoffer Sonne 

drum programming by Kristoffer Sonne & Laust Sonne 

 

 

14 

 

Taking it back 



 

15


 

15 

 

Can you keep a secret 

written and composed by Laust Sonne, Rune Brꜳger & Marcus Winther- 

John 

 

 

16 

 

Spell on you 



 

 

17 

 

What about us 

written and composed by Kristoffer Sonne, Nikolaj Juel & Laust Sonne 



acoustic guitar by Nikolaj Juel 

 

 

18 

 

Call me up 



breath by N. Molbech 

 

 

19 

 

Walk out the door 



 

 

20 

 

How can I 



 

 

21 

 

Chills 



 

 

22 

 

Like a chemical 




 

 

23 

 

Body talk 

16


written and composed by Laust Sonne & Galgani 

programmed by Galgani 

instruments played by Galgani & Laust 

add. vocals by Galgani 

 

 

 

Larsen 

Nikolaj Torp 

se 

Torp Larsen, Nikolaj 

700/1 

 

 

 

Torp 

Nikolaj 

se 

Torp Larsen, Nikolaj 

700/1 

 

 

 

Jørgensen 

Marcus Winther- 

se 

Winther-John, Marcus 

700/6 

 

 

 

John 

Marcus Winther- 

se 

Winther-John, Marcus 

700/6 

 

 

DBC 

 

 

 

 

1 

 

dkabm 

 

 

 

 

bibliotekdkBriefDisplay 

 

 

 

Response: 

 

 

 

 

 

1 

2012-05-23 

music 

17


music 

 

 

Laust Sonne 

 

 

 

"Laust Sonne" 

Laust Sonne 

 

 

Cd (musik) 

 

 

 

 

6. ORS 

Open Resource Sharing (ORS) is the collective name for DBC’ material sharing and order 

infrastructure which is made up of a database of orders (BOB) and a selection of backend services 

and tools. 

The interface of ORS are two web services: Open Order and Open Find Order. Further more ORS is 

dependent on the following other web services: Open Holding Status, Open Agency, Open Format 

and Open Search. 

Open Order and Open Find Order are described below. 

6.1 Open Order 

The Open Order web service is a service for requesting materials that are either owned by the user's 

library or is not owned by the library (inter library loan). The policies for ordering materials are 

based on those used by bibliotek.dk, and are controlled by the agencies (libraries) in the VIP 

database, and can be accessed using the Open Agency web service (section 7). 

Supported communication methods are SOAP, HTTP POST (XML-requests) and HTTP GET 

(URL-requests). Supported output formats are SOAP, XML, JSON and PHP. 

The main operations when creating orders are checkOrderPolicy and placeOrder, as well as 

checkElectronicDelivery for checking the possibility of online delivery. checkOrderPolicy and 

placeOrder are introduced and exemplified below. 

Furthermore the service also has a range of operations for manipulating existing orders in the ORS 

system: answer, shipped, resend, and updateOrder. See the WSDL for full details. 

Web Service: 

http://openorder.addi.dk/2.2/ 

WSDL: 

http://openorder.addi.dk/2.2/openorder.wsdl 

18


XSD: 

http://openorder.addi.dk/2.2/openorder.xsd 

6.1.1 checkOrderPolicy 

This operation is used to check whether it is possible to place an order for a specific material. The 

request must contain a bibliographic identifier and the ISIL number of the user’s library. 

Request (SOAP): 

 

 

 

29269815 

870970 

716301 

150013 

 

 

 

Response: 

 

 

 

TRUE 

owned_accepted 

 

 

 

Bog 

 

 

6.1.2 placeOrder 

The operation for creating an order to be handled by the ORS system. Before the order is made, a 

checkOrderPolicy request is done automatically. Based on the institution’s order policies and the 

availability of the requested material it is decided whether an order is to be made in the local system 

or as an interlibrary loan. 

placeOrder - example request (SOAP): 

 

 

 

 

123456 

password 

user 

 

false 

true 

2013-07-09T00:00:00 

bibliotekdk 

DK-790900 

820050-katalog:001742765 

190101 

19


12345 

true 

dbcdatawell 

xml 

 

 

 

Response: 

 

 

1011756925 

not_owned_ILL_loc 

 

 

6.2 Open Find Order 

Open Find Order provides access to looking up orders in the ORS database based on a variety of 

criterias such as order id, user, order system, library, order status etc. The service response contains 

all available information about the retrieved orders. A service requester can only look up its own 

orders (both outgoing and incoming) and orders that it has got permission to handle 

In the order database, orders are sorted into 3 groups: End-user orders to the library, inter-library 

orders from the library to other libraries, and inter Inter-library orders to the library from other 

libraries 

The web service provides operations which can search either, in all of these or with different 

restrictions, for example, open or closed orders, orders to the entire library’s library system, or to 

the individual departments, etc. 



Web Service: 

http://openfindorder.addi.dk/2.0/ 

WSDL: 

http://openfindorder.addi.dk/2.0/openfindorder.wsdl 

XSD: 

http://openfindorder.addi.dk/2.0/openfindorder.xsd 

Open Find Order supports the following operations: 

• findAllOrders : all orders regardless of type 

• findAllIllOrders : all inter-library orders 

• findAllNonIllOrders : all end-user orders 

• findAllOpenEndUserOrders : all open end-user orders 

20


• findOpenIllOrders : all open (i.e. have not yet received an answer from the responder) inter- 

library orders 

• findOrdersFromUnknownUser : all orders where checking of the borrower was not 

conducted/implemented 

• findAutomatedOrders : all end-user orders which were carried out as automatic inter-library 

orders 

• findNonAutomatedOrders : all end-user orders which were not carried out as automatic 

inter-library orders 

• findManuallyFinishedIllOrders : all inter-library orders with the status 'finished' 

• findSpecificOrder : a specific order from the order database 

• findOrdersFromUser : an order based on user information 

• findLocalizedEndUserOrders : end-user orders for materials within the library's holdings 

• findNonLocalizedEndUserOrders : end-user orders for materials not in the library's 

holdings 

• findOrdersWithAutoForwardReason : find non-automated orders based on a lack of 

automation 

• findOrderOfType: special article delivery orders 

• bibliographicSearch : orders based on bibliographic data in the order 

• getOrderStatus: gives the status of the order in the order database (answered, closed, 

shipped, modification timestamp, etc.) 

findAllOpenEnUserOrders is introduced and exemplified below. For full documentation refer to the 

links above. 

6.2.1 findAllOpenEndUserOrders 

findAllOpenUserOrders looks up all end user orders that have not yet been closed at a given library 

- including its branches as set with the requesterAgencyId-parameter. 

Request (XML): 

 

 

123456 

password 

user 

 

716700 

1 

1 

creationDateDescending 

716701 

716702 

716703 

716700 

 

21


Response: 

 

 

12 

 

1 

1011212805 

716700 

false 

non_automated 

mono 

870970 

21192708 

77.7; Video 

false 

false 

2013-04-11T20:32:41Z 

true 

false 

false 

chi 

2013-04-11T22:32:46Z 

m nh 

2013-07-10T22:00:00Z 

false 

bibliotekdk 

716700 

[Valby] 

responder_depending 

1996 

Metronome Video 

At leve 

Autovej 2 

12345678901234 

cardno 

 

Hans Hansen 

bibliotekdk 

 

 

 

7. Open Agency 

Open Agency is a web service interface for looking up various parameters for libraries and other 

service vendors in the VIP database (http://vip.dbc.dk). These include technical information such as 

encryption parameters, order policies for use in ORS, Open Search profiles as well as practical 

information about a library (contact information, opening hours). 



Web Service: 

http://openagency.addi.dk/2.2/ 

WSDL: 

http://openagency.addi.dk/2.2/openagency.wsdl 

22


XSD: 

http://openagency.addi.dk/2.2/openagency.xsd 


 

 

 

100200 

test 

2 

 

 

Response: 

 

 

 

 

test 

 

 

Ebsco artikler fra Masterfile Premier (nextkilde) (kun ved abonnement) 

 

150010 

ebscoart 

 

(...) 

 

Filmstriben (fjernlån) (kun ved abonnement) 

150027 

filmstrib 

 

 

Historisk Atlas (Digital kulturarv) 

150043 

atlas 

 

 

 

 

 

7.1 Open Agency operations 

Automation 

This operation provides information about the agencies' preferences regarding automatic forwarding 

of end user requests as ill requests to other agencies. This operation is used by the Open Resource 

Sharing system. 

Encryption 

Operation for looking up encryption information related to a specific email address, used when 

sending encrypted emails to an agency. This operation is used by the Open Resource Sharing 

system. 

End User Order Policy 

23


This operation makes it possible to look up whether a specific agency wants to recieve orders from 

endusers on this type of material. The operation is used by the Open Order sevice. 

Find Library 

Operation for searching general contact information and alike about a given library 

Service 

The service operation looks up information about a specific agency regarding various services 

provided by that agency. It can also look up directory information about an agency. The following 

services are available (most of the are used in ORS): 

• information: directory information about an agency, e.g. address and branch information 

• serverInformation: information about an agency's z39.50 server 

• orsItemRequest: whether an agency wants to receive ILL requests and how they want to receive 

the messages 

• orsAnswer: whether an agency wants to receive ILL answers and how they want to receive the 

messages 

• orsReceipt: whether an agency wants to receive receipts on their ILL requests and how they want 

to receive the messages 

• orsCancel: whether an agency wants to receive cancellations of ILL requests and how they want 

to receive the messages 

• orsCancelReply: whether an agency wants to receive replies to cancellations of ILL requests and 

how they want to receive the messages 

• orsShipping: whether an agency wants to receive shipping information and how they want to 

receive the messages 

• orsRenew: whether an agency wants to receive renewals on ILL loans and how they want to 


• orsRenewAnswer: whether an agency wants to receive answers to renewals on ILL loans and 


• orsEndUserRequest: whether an agency wants to receive requests from end users on their own 

material and how they want to receive the messages 

• orsEndUserIllRequest: whether an agency wants to receive requests from end users on material 

owned by other agencies and how they want to receive the messages 

• orsCancelRequestUser: whether an agency wants to receive cancellations of requests from end 

users and how they want to receive the messages 

• orsRenewItemUser: whether an agency wants to receive renewals of loans from end users and 


• orsLookupUser: whether an agency wants to receive lookup user requests and how they wamt to 


• userOrderParameters: which order parameters must be present for local and ILL orders of various 

material types 

• userParameters: what type of information is needed for authetication of the end user, e.g when the 

user wants to place an item request (cpr, common, barcode, cardno, or optional) 

Name List 

This operation is for receiving a list of agency ids (ISIL numbers) and names of either public 

libraries (Folkebibliotek) or university and research libraries (Forskningsbibliotek). 

24


Open Search Profile 

This operation retrieves information about which data sources are included in a given library's 

profile when the searching with Open Search. 

Pickup Agency List 

This operation can be used for retrieving a list of all public and/or research libraries including 

contact information, pickup agency information and opening hours. 

Remote Access 

Using this operation, you can get information about an agency's subscriptions to licensed resources 

with remote access. 

Request order 

This operation retrieves a prioritised list of which agencies materials must be ordered from for a 

given agency. 

8. CULR 

The Core User Library Registry (CULR) holds the libraries user registrations that they report for 

use for determining access to digital loans across libraries. The service is used by providers and 

services to determine which libraries users are connected to and what municipality they are known 

to reside in. 

The service operates with three entities: AccountId, PatronId and ProviderId. 

The ProviderID is a registration of an institution that has users (a provider). A ProviderId is the 

ISIL number of the institution. 

The AccountId is a registration of a user at a provider. The accountId contains the ProviderId, the 

users ID, the type of the ID, a timestamp telling when the accountId was changed the last time and 

optionally a municipality number. An accountId can have 0 to many patronIds and always exactly 

one providerId. 

The PatronID is a registration that refers uniquely to either a library a person or a company. A 

PatronId has one to many accountIds. PatronIds exist to match accountIds across providers, so they 

never exists without an accountId. The PatronIdValue is globally unique for its type. 

There are two categories of functions for clients. One is mostly manipulating data in the system, 

such as creating accountIds, relating accountIds and patronIds, deleting or updating data, and is to 

be used by providers. The other is retrieving information about a user across providers and is to be 

used by other services. 

The CULR-web service is currently under development. 

9. MoreInfo 

This service returns links to front covers and other additional information (including back covers, 

colophons, title pages and table of contents) for materials in DanBib. 

25


Supported communication methods are HTTP POST (XML-requests). Supported output format is 

XML. 

Web Service: 

http://moreinfo.addi.dk/2.1/ 

WSDL: 

http://moreinfo.addi.dk/2.1/moreinfo.wsdl 

XSD: 

http://moreinfo.addi.dk/2.1/moreinfo.xsd 

The service has one operation, moreInfo, which returns URL’s to images for the material identifiers 

included in the request. 

Example request: 

 

 

User 

123456 

password 

 

 

26775639 

 

 

0764503022 

 

 

Response: 

 

 

ok 

 

 

 

true 

 

26775639 

 

http://moreinfo.addi.dk/2.1/more_info_get.php? 

id=41695029&type=forside_117&key=ba6e2143419dd69d5f3a 


id=41695029&type=forside_207&key=a6199f428b5238384a05 


id=41695029&type=forside_42&key=fbc8a73da6d445cc1bc9 


id=41695029&type=forside_500&key=95345b0280f625feb1e1 


id=41695029&type=forside_lille&key=f70e7499e8ea57a0402f 


id=41695029&type=forside_stor&key=fb1712519aa331ce3627 

 

 

false 

 

0764503022 

 

 

 

26


10. VoxB 

VoxB is a service designed to collect user generated data such as reviews, ratings and tags in a 

central database. For instance a review of a book created with VoxB at a local library website will 

also be shown in connection with the book on other library websites (both local and national) that 

have implemented VoxB. Service users may also declare their own local data types. 

VoxB is integrated with the web service OpenXid for the purpose of normalising and gathering 

various object identifiers that represent the same object (eg. the EAN, ISSN and FAUST of the 

same book). 

Supported communication methods are SOAP and HTTP POST (XML-requests). Supported output 

formats are SOAP, XML, JSON and PHP. 

The web service has operations for creating and handling users; creating, finding, editing, updating 

and deleting data (reviews, tags etc.); as well as a moderator interface (reportOffensiveContent). 

See examples of the createMyData- and fetchData operations below and refer to the WSDL/XSD 

for more details about the various operations. 

Web Service: 

https://voxb.addi.dk/1.1/ 

WSDL: 

https://voxb.addi.dk/1.1/voxb.wsdl 

XSD: 

https://voxb.addi.dk/1.1/voxb.xsd 

Example request (SOAP) - createMyData: 

 

 

 

1234567890 

 

80 

 

linux 

os 

 

 

Example review data 

TXT 

 

 

 

0596004826 

ISBN 

Linux in a Nutshell 

 

 

 

 

Response: 

27


 

 

 

152547 

 

 

 

Example request (SOAP) - fetchData: 

 

 

 

 

 

0900913290 

ISBN 

 

 

all 

 

 

 

 

Response: 

 

 

 

 

 

0900913290 

ISBN 

 

 

100 

1 

 

100 

1 

 

 

 

 

Hans H 

 

123456 

6205588 

100 

 

 

En imponerende, velskrevet og flot illustreret gennemgang af kampvognstræfninger i Normandiet i 1944. I stort omfang 

er det lykkedes forfatterteamet at genfinde de steder, hvor de oprindelige fotos et taget - derfor undertitlen Then and 

Now. Det er en bog, jeg med stor fornøjelse er vendt tilbage til flere gange. 

 

TXT 

 

2012-05-14T09:27:59+01:00 

2012-05-14T09:27:59+01:00 

 

 

 

28


 

 

11. Open Question 

The Open Question web service handles distribution of end user questions to either local or national 

enquiry services, eg. the national ask-a-librarian service, Biblioteksvagten.dk. 



The service has one operation, createQuestion. The parameter agencyId is used to identify the 

sender (website, institution etc.) of the question and qandaServiceName determines which Q&Aservice 

the question is sent to. 

Web Service: 

http://openquestion.addi.dk/1.1/ 

WSDL: 

http://openquestion.addi.dk/1.1/openquestion.wsdl 

XSD: 

http://openquestion.addi.dk/1.1/openquestion.xsd 


 

 

 

 

DK-870970 

bibvagten 

Test 

Test@test.test 

1234567 

sms 

email 

123 

m 

1234 

Titel 

Content 

Note 

24 

other 

 

 

 

12. ADHL 

Open ADHL (What Others Have Borrowed) is a service that returns other titles, which lenders of a 

given title also have borrowed. The other titles are sorted after frequency. The service is based on 

data from a number of libraries. 

29


For more information of how data from the library is loaded into the ADHL-database, see http:// 

danbib.dk/index.php?doc=adhl (in Danish). 



The service has one operation: adhl. See the example below and refer to the WSDL/XSD for further 

documentation. 

Web Service: 

http://openadhl.addi.dk/1.1/ 

WSDL: 

http://openadhl.addi.dk/1.1/adhl.wsdl 

XSD: 

http://openadhl.addi.dk/1.1/adhl.xsd 


 

 

 

 

9788770532563 

 

1 

 

 

 

Response: 

 

 

 

 

28670370|870970 

 

http://www.bibliotek.dk/linkme.php?ccl=lid%3D28670370+og+lok%3D870970 

 

Håkan Nesser 

De ensomme 

[Barbarotti-serien] [4. bind] 

 

Krimi med vicekriminalkommissær Gunnar Barbarotti, der skal opklare en ulykke eller et mord, der har helt klare 

paralleller til en tilsvarende hændelse 35 år tidligere 

 

Bog 

 

 

 

 

30

DBC Webservices in NFBS

Create successful ePaper yourself

Delete template?

Save as template?