The RDA Registry Search Widget provides a quick and easy way of embedding a live Research Data Australia (RDA) search or record display within your new or existing web pages.
The flexibility of the widget allows you to configure a predefined search, or provide your end users with a text field to specify their own search.
Some use cases for the Registry Object Search Widget include:
- Showcase recent collections contributed to Research Data Australia by institution or researcher name
- Implement a lookup function in data capture forms/processes to search for keys or global identifiers
- Supplement your site’s search results with search results from Research Data Australia
- Provide your users with a listing of data collections related to a specific subject
How to use this widget
Before you start!
While optional, ARDC recommends that you register for a free API key to be used with this widget. Registering will allow us to keep you informed of changes and planned outages to our services, as well as monitor the system for quality purposes.
Note that if you have previously registered for an API key you do not need to register again. Your ARDC API key is reusable with any of our widgets and services.
The widget requires jQuery; load this, and the plugin itself (and associated CSS styles) in your document’s
See Configuration section below for details on how to configure the widget on your web page.
Search Result Display Example
Embed the results of a simple search into your website, such as a panel on your institution’s own search page to supplement it with collections which are available in Research Data Australia.
In this example, the top 5 records matching the search term “fish” are listed
Custom Search Result Display Example
Embed the results of a more complex search into your website, such as a panel on your institution's profile page which lists the collections recently contributed to Research Data Australia.
This result example displays the 5 most recent collections contributed by Australian Ocean Data Network
Simple Search Example
Embed the ability to search for research data on your own web page in
less than 5 lines of code!
This search example will search for records in Research Data Australia matching your search term.
Advanced Search Example
Embed the ability to search and display information about research data on your own web page with a customised display.
This search example will search for records and then display them according to a template (see the
The widget can be initialised by two methods:
- Simple Mode: add the
<input>element as illustrated in the examples above. You can also add a
data-modeattribute to customise the behaviour in Simple Mode.
- Custom Mode: initialise the
$('#id_of_your_container_element').registry_widget();. You can pass any of the below properties to the
registry_widget()function to customise its behaviour.
|JSONP proxy for the Registry Widget which resolves search queries against the ARDC Collections Registry APIs|
|Your pre registered api key which will uniquely identify the widget user|
|mode can be |
|Enable Search Functionality|
|Auto Search based on the target’s value|
|Search text displays on the button|
|CSS Classes apply on the search button|
|Overwrite function for search result |
|Enable Resolve/Lookup functionality. This functionality enables the user to identify a registry object based on their |
|Enable Auto lookup based on the target’s value|
|Lookup text displays on the button|
|CSS Classes apply on the lookup button|
|Overwrite function for lookup result |
|Mustache/Handlebar-like template for the search result list|
|Mustache/Handlebar-like template for the single display of a registry object|
|Return a |