1. Introduction
This specification describes a specific implementation of the Direct Consortial Borrowing: Broker Application Manages Transaction Application Profile (DCB-3).
These guidelines are part of a series of specifications for technical interoperability between libraries and between libraries and partners called “danZIG specifications”. The danZIG is a committee representing library system vendors, library technical interoperability consultants and national library services supplemented by libraries representatives put together by Danish Agency for Libraries and Media and chaired by the agency. The purpose of danZIG is to advise the governmental agency Danish Agency for Libraries and Media, which have the responsibility for the published specifications.
The target group for these specifications is vendors to Danish libraries and people interested in technical interoperability in the library sector.
This specification is based on and depends on NCIP Implementation Guidelines: Collaboration between Danish libraries and other agencies (danZIG Specification 03).
This specification is based on and is a further development of NCIP Implementation Guidelines: Collaboration between bibliotek.dk and local library systems (danZIG Specification 03).
2. Scope
This specification describes a specific implementation of the Direct Consortial Borrowing: Broker Application Manages Transaction Application Profile (DCB-3).
In this scenario a user interface (ex. web page with backend) takes the role of a broker between the end user and the local library system. In order to support a number of specific use cases in this scenario, various NCIP services have to be implemented.
Through the general user interface the end user will be able to:
- Get an overview of his or her requested and loaned items and fiscal account information from one or more local libraries
- Cancel his or her requests made through bibliotek.dk and/or one or more local libraries
- Renew items borrowed from one or more libraries (including items borrowed from other libraries, ILL)
- Request items owned by his or her own library
- User Authenticate when requesting e.g. through bibliotek.dk (described in previously published guidelines)
- Register borrower in a local library based on registration in another library
3. Conformance
These guidelines require same level of conformance as NCIP Implementation Guidelines: Collaboration between Danish libraries and other agencies. Additionally, all parameters required in the DCB-3 are also required by these guidelines, unless otherwise stated in the following.
4. Support
Vendors of integrated library systems have stated that named systems support these guidelines from a given version. Present information at:
http://biblstandard.dk/ncip/support_collaboration.htm
5. Services
5.1 List of services
These guidelines require implementation of the following services[1] to support this scenario and the associated use cases.
|
NCIP service |
Local system |
Userinterface |
DCB-3 |
|
Lookup Item Service |
Responder |
Requester |
Required |
|
Lookup User Service |
Responder |
Requester |
Required |
|
Lookup Request Service |
Responder |
Requester |
Optional |
|
Request Item Service |
Responder |
Requester |
Required |
|
Cancel Request Item Service |
Responder |
Requester |
Optional |
|
Update Request Item Service |
Responder |
Requester |
Optional |
|
Renew Item Service |
Responder |
Requester |
Required |
|
Create User Service |
Responder |
Requester |
Optional |
The broker application is required to implement the services as requester, whereas the user agency (the local library system) shall implement the services as responder. A use case which implies the requester communicating directly with other user agencies does not involve a broker role having the consequence the communication should not be guided by this DCB-3 based guideline. Instead the communication should in such a case be guided by the DCB-2 based guideline “NCIP Implementation Guidelines: Collaboration between Integrated (strongly-coupled) and Connected (weakly-coupled) Libraries” (see: 10. References).
For this scenario all transactions takes place between the Broker and the User Agency. The User Agency may in some cases also be the Item Agency, but this is not important for this specific scenario.
5.2 Registered schemes
In addition to the scheme extension and restrictions mentioned in the depended guidelines, the following is required to support this scenario:
|
Name |
Note |
Scheme |
|
Item Element Type |
For Item Element Type following value will always be used:
|
http://www.niso.org/ncip/v1_0/schemes/ |
|
User Element Type |
For User Element Type following value will always be used:
|
http://www.niso.org/ncip/v1_0/schemes/ |
5.3 Request parameters
The password described in the interrelated guidelines (Supplementary information. Agency authentication) is defined by the individual library in the VIP database (Directory of Information Parameters for bibliotek.dk, DanBib and BOB – database of requests) to be used by user interfaces in requests to local libraries.
In addition the following parameters should be sent by the user interface:
- Create User Service
- Name information is required. Structured Personal User Name (if it is not possible to deliver Structured Personal User Name, the Unstructured Personal User Name may be delivered instead). AuthenticationInput must be User id and PIN.
- Address information is required. Structured Address (if it is not possible to deliver Structured Address, the Unstructured Address may be delivered instead).
- DateOfBirth
- Municipality number (use NCIP element district in UserOptionalFields, UserAddressInformation, PhysicalAddress, StructuredAddress for municipality number).
- CPR-number (use Visible User Id with scheme value "CPR" as Visible User Identifier Type)
Some data is only required if requested. The following will not expected to be requested by the user interface.
- Cancel Request Item Service:
- Fiscal Transaction Information
- Item Optional Fields
- User Optional Fields
5.4 Response parameters
Following data are - if available - required in responses:
- Lookup Item Service
- Bibliographic Description is required as part of the Item Optional Fields
- Lookup User Service
- Name information is required. Structured Personal User Name (if it is not possible to deliver Structured Personal User Name, the Unstructured Personal User Name may be delivered instead). AuthenticationInput must be User id and PIN.
- Address information is required. Structured Address (if it is not possible to deliver Structured Address, the Unstructured Address may be delivered instead).
- UserFiscalAccount, RequestedItem and LoanedItem are required when requested
- DateOfBirth
- Municipality number (use NCIP element district in UserOptionalFields, UserAddressInformation, PhysicalAddress, StructuredAddress for municipality number)
- CPR-number (use Visible User Id with scheme value "CPR" as Visible User Identifier Type)
- Lookup Request Service
- Bibliographic Description is required as part of the Item Optional Fields
- Pickup place (use NCIP element locality in ShippingInformation, PhysicalAddress, StructuredAddress for pickup place) must be returned if present in responding system
- Pickup number (use NCIP element LocationWithinBuilding in ShippingInformation, PhysicalAddress, StructuredAddress for pickup number) must be returned if present in responding system
- Renew Item Service
- Date Due is optional in the DCB-3 profile. In order to support this scenario in the best possible way, Date Due is required in the response by these guidelines.
6. References
NCIP Implementation Guidelines: Collaboration between Danish libraries and other agencies (danZIG-specification 3) http://www.bs.dk/publikationer/andre/danzig/03/
NCIP Implementation Guidelines: Collaboration between bibliotek.dk and local library systems (danZIG specification 4)
http://www.bs.dk/publikationer/andre/danzig/04/
NCIP Implementation Guidelines: Collaboration between Integrated (strongly-coupled) and Connected (weakly-coupled) Libraries (danZIG-specification 7)
bibliotek.dk
Service: http://bibliotek.dk/
Documentation: http://www.danbib.dk/index.php?doc=bibdk
Direct Consortial Borrowing: Broker Application Manages Transaction Application Profile (DCB-3): http://ncip.envisionware.com/application_profiles/DCB_Broker_Applicaton_Manages_Transaction.pdf
7. Sample Messages
|
Request Item Service | ||
|
Request |
(to main library on FAUST rec.) |
requestitem-b1.xml |
|
Request |
(to main research library) |
requestitem-b2.xml |
|
Request |
(to branch public library) |
requestitem-b3.xml |
|
Request |
(to mobile library bus stop) |
requestitem-b4.xml |
|
Request |
(with pick-up library) |
requestitem-g5.xml |
|
Response |
(successful) |
requestitemresponse-b.xml |
|
Response |
(problem) |
requestitemproblem-b.xml |
|
Lookup Item Service | ||
|
Request |
|
lookupitem-b.xml |
|
Response |
(successful) |
lookupitemresponse-b.xml |
|
Response |
(problem) |
lookupitemproblem-b.xml |
|
Lookup Request Service | ||
|
Request |
|
lookuprequest-b.xml |
|
Response |
(successful) |
lookuprequestresponse-g.xml |
|
Response |
(problem) |
lookuprequestproblem-b.xml |
|
Lookup User Service | ||
|
Request |
|
lookupuser-b.xml |
|
Response |
(successful) |
lookupuserresponse-g.xml |
|
Response |
(problem) |
lookupuserproblem-b.xml |
|
Renew Item Service | ||
|
Request |
|
renewitem-b.xml |
|
Response |
(successful) |
renewitemresponse-b.xml |
|
Response |
(pending) |
renewitempending-b.xml |
|
Response |
(problem) |
renewitemproblem-b.xml |
|
Cancel Request Item Service | ||
|
Request |
|
cancelrequestitem-b.xml |
|
Response |
(successful) |
cancelrequestitemresponse-b.xml |
|
Response |
(problem) |
cancelrequestitemproblem-b.xml |
|
Create User Service | ||
|
Request |
|
createuser-g.xml |
|
Response |
(successful) |
createuserresponse-g.xml |
|
Response |
(problem) |
createuserproblem-g.xml |
|
Update Request Item Service | ||
|
Request |
|
updaterequestitem-g.xml |
|
Response |
(successful) |
updaterequestitemresponse-g.xml |
|
Response |
(problem) |
updaterequestitemproblem-g.xml |
Examples with “-b” in end of name are also used in NCIP Implementation Guidelines: Collaboration between bibliotek.dk and local library systems.
Examples with “-g” in end of name are done for this specification.
All example-files are stored in this directory:
http://biblstandard.dk/ncip/examples/
[1] The basic circulation/service support required in DCB-3 is: Lookup Item, Lookup User, Renew Item, Request Item, Lookup Agency, Check in Item, Checkout Item, Recall Item, Item Shipped, Accept Item
Publication may be found at the address http://www.bibliotekogmedier.dk/fileadmin/publikationer/publikationer_engelske/danzig/danzig06/index.htm