This section provides information on how to publish datasets on the QDR and sets preferences for uploading and updating your data.
You can log in to the QDR platform using your EU Login account.
If you have not yet registered on the platform and created a profile for your organisation, please check the Register for the QDR pages, follow the described steps, and then return to this step to find out how to publish your data.
The page of the organisation’s profile page is shown in the figure below. You can find several navigation elements:
- [1] ‘Show/Edit data’ – Allowing you to modify information about your organisation.
- [2] ‘Published datasets’ – Here, you can find the datasets you have published and have the possibility to modify them.
- [3] ‘Delegation’ – Allowing you to delegate the publication rights of your organisation to another organisation.
- [4] ‘Publish new dataset’ – Adding a new dataset with qualification, learning opportunity or accreditation data
- [5] ‘Logout’ – To leave the application
On the right side of the landing page, click on the yellow ‘Publish new dataset’ button to upload a new dataset. This will take you to a pop-up page where you can fill out the information of this dataset, as well as decide how you want your data to be updated.
The following information should be indicated during the publication:
- First, fill out the [1] ‘Title’ of your data, then add a brief [2] ‘Dataset description’.
- Then you should indicate what type of data will be published in this dataset in [3] ‘Type of data contained’. The data contained in your dataset should be:
- If publishing Learning Opportunities or Qualifications: ELM Learning opportunities & Qualifications – Among other, containing qualifications, which represent the formal outcome of an assessment and validation process which is obtained when a competent body determines that an individual has achieved learning outcomes to given standards. Contained qualifications may also contain information on accreditation, licencing or authorisation, if relevant.
- If Publishing Accreditations: ELM Accreditations
- In the field ‘Publishing scheme’ [4], select the right option from a top-down menu to indicate which schema is your data published in:
- If you have previously published Qualifications using the QMS2 and plan to continue using this schema, please select “Qualification V2 metadata schema (2020)”;
- If you have previously published Learning Opportunities using the LOMS scheme, and plan to continue, please select "Learning Opportunities metadata schema (2019)"
- If you plan to publish Qualifications or Learning Opportunities in the new ELM schema published in May 2023, please select “European Learning Model v3: Learning Opportunities & Qualifications (2022)”
- For Accreditation data the only available schema is “European Learning Model v3: Accreditations (2022)”
- [5] ‘Namespace’ The namespace is used in order to transform your local identifiers into globally unique ones. Please specify here a globally unique string which will be used to represent a namespace of contained qualifications or learning opportunities. The namespace has to be formed in a URL structure (e.g. "http://example.com/"). This can be represented for example by the URL of your organisation or the base URI of your concepts.
- For the [6] ‘Publishing method’, there are two main distinctions: Hosted or Upload. This defines whether you wish to upload your data as a manual upload in a file to QDR, or automatically to provide a URL from which the platform fetches your data, which is further explained in the following sections.
Hosted: you do not need to manually add a file in the platform. It is a method which requires to host a qualification dataset on a server and provide the URL pointing to the data during dataset creation on the QDR portal. QDR then downloads the qualification data from the provided URL whenever a new version is created. The data must be hosted through http or https and only port 80, 443.
There are three options available for the hosted options listed below:
- Hosted on your server - Automatic Update: the updates will happen automatically. You will then indicate a URL where you are planning to continuously maintain your dataset. Using this method, you should make sure that the HTML header of your indicated URL is updated every time you want to release a new dataset version. You are provided with the following setting with this option:
- In the field ‘Download URL’, a field will appear where you can paste the URL from which QDR will create the new versions as your website is updated.
- In the field ’Update Frequency’, you can control the frequency of the updates, namely: Monthly, Weekly and Daily.
- In the field ‘Type of provided file’, you can see which file types are supported, and you can indicate the option that applies to you.
- Hosted on your server - API update: you will be able to push each update of your dataset to QDR using an API call. If you plan to use this method, please contact the administrators of QDR to provide you with an API key.
- Hosted on your server – Manual Update: you will provide a new URL from which the platform can fetch the updated data every time a new version is released.
Upload: you will need to manually add a file in the platform to publish new datasets. This also means you will upload a new file every time your data is updated.
If you select the publication method ‘hosted - automated fetching’, you will not be able to create new versions manually; they will always be created automatically with a daily refresh.
If you select the publication method ‘hosted – manual update’, you will need to create a dataset version manually and provide a URL each time you want to release a new version.
You can change the publishing method of a specific dataset at any time in case you decide that you want to provide future versions using a different method.
Then, you can save everything by clicking ‘save’ at the bottom of the page.
- After you save, you will be redirected to the previous page.
- If at any point you wish to close the page, you can find the [7] ‘x’ button on the top right.
Once you have created a new dataset, you can now upload your data. For this you will need to create a version. First you have to access the dataset, by clicking on its name on your profile page. Depending on which publishing method you have selected for the dataset, the creation of a version may look slightly different. Below we explain ‘How to create a dataset version?’ for each of the dataset publishing methods.
During the initial publishing phase, if you chose ‘Hosted – Automated Fetching’, the version updates will be done for you and you will not have to update the version using any dialogue, so this option is no longer applicable.
During the initial publishing phase, if you chose ‘Hosted on your server - API update’, the version updates will be done via an API and you will not have to update the version using any dialogue. In this case, the dataset page will show detailed information on how to perform an API call required to push the data to QDR:
If you plan to use this method, please contact the administrators of QDR to provide you with an API key.
To create a new version with this publishing method simply click on the ‘Publish new version’ button. This will show a pop-up page similar to the page for creating new datasets. The page looks like this:
The following information should be indicated during the publication:
- First, fill out the [1] ‘Title’ of the version, then add a brief [2] ‘Dataset Version Description’.
- For [3] ‘Download URL’, you will be asked to indicate the URL from where QDR can retrieve the data.
- Finally, in [4] ‘Type of provided file’ you should indicate what is the type of file that you are providing.
- Then, you can save everything by clicking ‘save’ at the bottom of the page.
- After you save, you will be redirected to the previous page.
- If at any point you wish to close the page, you can find the [5] ‘x’ button on the top right.
To create a new version with this publishing method simply click on the ‘Publish new version’ button. This will show a pop-up page similar to the page for creating new datasets. The page looks like this:
The following information should be indicated during the publication:
- First, fill out the [1] ‘Title’ of the version, then add a brief [2] ‘Dataset Version Description’.
- For [3] ‘Upload’, you will be asked to upload a file containing your data.
- Finally, in [4] ‘Type of provided file’ you should indicate what is the type of file that you are providing.
- Then, you can save everything by clicking ‘save’ at the bottom of the page.
- After you save, you will be redirected to the previous page.
- If at any point you wish to close the page, you can find the [5] ‘x’ button on the top right.
Once you have created a new version you will see it in the listing on the dataset overview. This page looks like this:
Once you have created a new version you will see it in the listing on the dataset overview. This page looks like this:
Here you are able to start the processing of the dataset by clicking [1] ‘Start preparation’. During the processing, the platform takes your data and transforms it into a unified RDF format according to the metadata schema. This process also applies validations of the compliance of the data. The content of your data is not modified by this process.
The processing may take some time and will result in either success or failure.
- Successful upload of a dataset: You will see green checkbox [4] for each successful processing step and will also receive a confirmation e-mail if the processing succeeded until the end.
- Failure to upload a dataset: If there was a problem, you will see this warning right underneath the version as [2] ‘Preparation failed, retry’.
You can then perform the necessary fixes noted in the report ([3] ‘Get report’) and retry processing. If everything went well, you would see this green confirmation instead ([4]).
If there are any problems with the information provided, you will receive an e-mail with a report, which will redirect you to the platform where you can see and resolve the problem.
This is only applicable to: ‘Upload’ and ‘Hosted on your server - Manual Update’. Other methods do not require manual initiation of the processing.
Here you are able to edit the metadata about a dataset by clicking on [1].
You can change all the Dataset Information: Title, Dataset description, Namespace, Type of data contained, Qualification publishing scheme, publishing method and what is included in your dataset.
To edit a dataset version for manual uploads, you can follow the following steps:
- Click on the dataset version you want to edit.
- In the dataset page, click on ‘Show/Edit data’. You will get a form containing the metadata of a dataset version, click on the edit pen to start changing the information [2].
- You can even upload a new dataset to this version by clicking on ‘upload’ [3]
It is recommended to always provide the most up-to-date data. The publishing method you choose will determine how easy it is to ensure the frequency and relevance of the updates:
- Hosted on your server – Automatic Update: The updates happen automatically. It is essential to ensure that the HTML header of your indicated URL is updated every time you want to release a new dataset version.
- Hosted on your server – API update: The latest version could be published using an API call.
- Hosted on your server – Manual Update: For every new version, you will need to add the file in the server.
- Upload: with this publishing option, you will have to manually update the dataset. To update, you will need to create a new dataset version as explained in section ‘Creating dataset versions: Upload’. The system always takes the last uploaded version of the dataset as the latest and correct version.
The automatic/API updates are more efficient and time-saving solutions for updating the datasets. It is highly recommended that these methods are used as publishing options.








