Table of content:
Introduction
A virtual collection is a coherent set of links to digital objects (e.g. annotated text, video) that can
be easily created, accessed and cited.
The links can originate from different archives, hence the term virtual. A virtual collection is suitable
for manual access (using a web-browser) as well as automated processing (e.g. by a webservice).
More information can be found on the CLARIN website.
User Manual
Browsing Collections
Click on the "Browse" button in the top menu:
The Virtual Collection Registry home page lists all public collections. For each collection the title, type and creation date are shown.
Available actions:
- Click the button to view the collection description.
- Click the collection title to view the complete collection details.
- Click the button to get the citation details for this collection.
The list of collection can be filtered by clicking the button.
This will open the filter options:
After filling in one or more filter options, press the "Filter" button to apply the filter or
use the "Clear" button to clear any applied filter.
Citing Collections
Collections can be cited by clicking the icon. This icon is available for each collection in the public list of collections and for individual collections on the collection details page.
Clicking the citation button will show the following dialog providing basic citation information:
Please make sure that you use the assigned persistent identier, shown in the Link field, when citing a virtual
collection. All public collections have been assigned a persistent identifier.
Creating New Collections
Click on the "Create" button in the top menu:
By default the collection editor is shown in simple mode. As listed below, a number of fields
are not shown in simple mode and will use the assigned default values. If you want to edit
these fields you can switch over to advanced mode using the checkbo in the upper right corner:
There is also the option to show additional help. If you toggle the checkbox, additional descriptions
will be shown inline with the fields.
Each collection has the following fields:
- A name
- A description
- 0 or more keywords
- 1 or more authors
- A type. One of extensional (default) or intensional.
- A purpose. One of Research, reference (default), sample or future use.
- A reproducibility. One of intended (default), fluctuating or untended.
- An optional reproducibility notice, empty by default
For extensional collections 1 or more references must be added. To add a reference a URI (URL or PID) and a title must be supplied. The references will be scanned in the background.
Each reference is marked:
- with a grey dot ( ) while scanning.
- with a yellow check () if the URI is valid but is not recognized as a PID.
- with a green check () if the reference is valid and recognized as a PID.
- with a red cross () if the URI did not return a valid response. This will prevent you from saving the collection. All references must be valid.
For an intensional collection several fields describing the query must be supplied.
After saving the collection, the collection is assigned the private state. In order to cite this collection or allow other people to find this collection, the collection must be published first. See the next section, Your Collections, on how to publish the newly created collectio.
Managing Your Collections
When logged in, click on the "My Collections" button in the top menu:
The My Collections page allows you to manage all your collections. This includes both your public and private collections. Private collections will not be listed in the public Browse Collections page. Depending on the collection state different operations are available.
Available operations for collections in public state:
- Cite collection
- View collection details
- Edit collection
- View collection details
- Publish collection
- Edit collection
- Delete collection
- Retry publication
- Delete collection
Collection lifecycle:
Technical Documentation
REST service
The Virtual Collection Registry REST service is accessible at https://collections.clarin.eu/service/ (base URL).
Documentation pointers:
- API documentation is based on the OpenAPI specification and can be found here.
- OpenAI specification file is availble here.
- An older version of the documentation, which includes the query language specification, is available here.
- You can also consult the WADL file.
OAI provider
The Virtual Collection Registry OAI provider offers all published collections as CMDI or Dublin Core metadata over the OAI/PMH protocol. It is accessible at https://collections.clarin.eu/oai?verb=Identify.
Integration with external repositories
The Virtual Collection Registry can be integrated into exteran repositories, such as the Virtual Language Observatory, to make it easy to create collections from search results. All technical information required to enable such an integration can be found here on GitHub.