Required Webservices

In order for ding.TING to be usable it heavily dependent on the following webservices, which are hosted and serviced by a couple of different companies.

You will have to make agreements with these companies in order to access their services, and not all the services are available for pure testing purposes (yet).

Diagram of the required ding.TING services below.

TING services

Demo access to following services - please contact DBC - bow@dbc.dk or bsp@dbc.dk

OpenSearch [required]

OpenSearch is essential for ding.TING - this webservice enables us to search in the Data Well (“data brønd”) provided by DBC. Without this, there will not be much data available for the ding.TING system.

Required information in ding.TING:

• Agency ID
• Webservice URL

Test url:
http://didicas.dbc.dk/opensearch_nextkilde/

Production url (IP restricted):
http://opensearch.addi.dk/1.3/ (mind you that the version number will change over time).

Changelog url:
http://opensearch.addi.dk/

Documentation url:
http://oss.dbc.dk/plone/services/open-search

WSDL:

http://didicas.dbc.dk/opensearch_nextkilde/opensearch.wsdl

Provided by: DBC

OpenScan

We use the OpenScan webservice in conjunction with the OpenSpell webservice in order to show autosuggest-as-you-type in the ding.TING search field.
The OpenScan service itself will search in the indexes of the OpenSearch catalogue.
Mind that the OpenScan service in it’s current form returns global results, and not only results from a specific library. Also it currently searches in the “phrase” index, meaning it will suggest sentences and not only words.

Required information in ding.TING:

• Agency ID
• Webservice URL

Test url:
http://didicas.dbc.dk/openscan_nextkilde/

Production url (IP restricted):
http://openscan.addi.dk/1.7/

Changelog url:
http://openscan.addi.dk/

 
Documentation url:
http://oss.dbc.dk/plone/services/open-scan

WSDL:
http://didicas.dbc.dk/openscan_nextkilde/openscan.wsdl

Provided by: DBC

OpenSpell

We use the OpenSpell webservice in conjunction with the OpenScan webservice in order to show autosuggest-as-you-type in the ding.TING search field.
The OpenSpell service itself will return spelling corrections of the words you type.

Required information in ding.TING:

• Agency ID
• Webservice URL

Test url:
http://didicas.dbc.dk/openspell_nextkilde/

Production url (IP restricted):
http://openspell.addi.dk/1.2/

Documentation url:
http://oss.dbc.dk/plone/services/open-spell
 

WSDL:
http://didicas.dbc.dk/openspell_nextkilde/openspell.wsdl

Provided by: DBC

OpenADHL (“recommendation service”)

The OpenADHL service suggests materials based on a ISBN number. ADHL is short for (danish) “Andre Der Har Lånt” meaning “Others Who Have Loaned”.
When you send an ISBN it will return a list of other ISBNs of potentially related materials based on anonymized loan-statistics.

Ding will by default show this information on the Collection and Object page.

Required information in ding.TING:

• Agency ID
• Webservice URL

Test url:
Unknown.

Production url (IP restricted):
http://openadhl.addi.dk/1.1/

Documentation url:
http://oss.dbc.dk/plone/services/open-adhl
 

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

Provided by: DBC

Cover service (“forside service”)

This service will return cover-images for the materials in the catalogue. Only a subset of the covers are available, partly due to licensing issues but mostly because it’s rather costly to physically scan and import these covers to the service.

Required information in ding.TING:
In order to authenticate with this service, we need the following information:

• Username
• Password
• Group

Test url:
Unknown.

Production url (authentication required)http://forside.addi.dk/addi.wsdl Documentation url:http://oss.dbc.dk/plone/services/cover-image-service WSDL:http://forside.addi.dk/addi.wsdl

Production url (authentication required)

http://forside.addi.dk/addi.wsdl Documentation url:http://oss.dbc.dk/plone/services/cover-image-service WSDL:http://forside.addi.dk/addi.wsdl

Production url (authentication required)
http://moreinfo.addi.dk/

Documentation url:
http://oss.dbc.dk/plone/services/moreinfo/?searchterm=moreinfo

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

Legacy version

Older versions of DING (<1.8.0) may use an older cover service, ADDI. It is no longer updated an considered obsolete.

Production url (authentication required)
http://forside.addi.dk/addi.wsdl

Documentation url:
http://oss.dbc.dk/plone/services/cover-image-service

WSDL:
http://forside.addi.dk/addi.wsdl

Provided by: DBC (via DanBib)

Ding Provider services [one is required]

The “Ding provider” services are used for the “live data”, meaning user authentication, holdings, location (physically position on the library) and for interacting with these data, meaning reservation of a material, registering fines, updating preferences etc.

The Ding Provider is an abstraction layer, as we currently interacts with two different underlying webservices, DDELibra Webservices (aka ALMA) and OpenRuth.

ding.TING will be kinda workable without these services, but you will not be able to log in as an user nor make any reservations or see any holding information, thus it’s required for (near) production environments.

DDELibra Webservice (ALMA)

This is a webservice for the DDELibra system used by many danish public libraries.
This webservice has to be installed an maintained by Axiell on the libraries DDELibra installation server.
This service must only be available though HTTPS, as we transmit sensitive and personal information between the ding.TING server and this webservice.
Remember to open the firewall in both ends between this webservice and the ding.TING prod and development servers.

Required information in ding.TING:

• Webservice URL and PORT number

Test url:
Currently none

Production url:
Differs for each library. Must be set up individually.

Often looks like this: https://123.123.123.123:8020/alma

Documentation:
See below, or ask Axiell for the latest documentation. The webservice is REST based, no WSDL exists.

• AlmaMessage.xsd
• AlmaMessage.doc - documentation

Provided by: Axiell

OpenRuth

This webservice maps the functionality of the system known as Integra, currently maintained by DBC. It offers the same functionality as the Alma webservice, but also exposes some extra functionality.

Required information in ding.TING:

• Agency ID
• Webservice URL

Test url:
Unknown.

Production url (IP restricted):
http://openruth.addi.dk/0.7/

Documentation:
Ask DBC for the latest documentation.

WSDL:
http://openruth.addi.dk/0.7/openruth.wsdl

Provided by: DBC

Ding Debt

In order for the user to pay fines via the site, we must utilize payment providers.
Currently ding.TING only support one provider (DIBS), but it’s logical to add more payment providers at some point.

DIBS

DIBS is the largest danish internet payment provider.
You will need to have an agreement with them in order to use their system.
We use their “FlexWindow” solution, which is a popup-and-redirect solution used on many e-shops. You only need their standard product in order to have this solution available.
The current implementation does not require webservice access to their solution.

In order to configure the DIBS backend in Drupal, you will need:

• A MerchantID (provided by DIBS)
• Two MD5 Control keys (from the DIBS Administration)

Optionally we need:

• Starting order-number (if you use the the DIBS solution already or elsewhere)
• An order prefix (in order to make transactions from ding distinct)