Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Page Properties
Target releaseBeta 1.0
Epic 
Document status

Status
titleDraft

Last update08-July-2016
Document owner
Designer 
Developers
QA

...

The details of what each of these metadata object represent are given in the Metadata section below in this document. Also, the details of the FAIR Data Point API are given below in this document at the Application Programming Interface (API) section.

Fig. 4 - FAIR Data Point's Archimate Application layer architecture

 

Metadata

The FAIR Data Point metadata about four entities, namely, the FAIR Data Point itself, the collection of datasets, each one of the offered datasets and the data within each of the dataset

...

Jira Legacy
showSummarytrue
serverJIRA (dtl-fair.atlassian.net)
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdcae6b7e0-a4f7-3b38-b0cc-172741024ef9
keyFDP-36

Fig. 5 - FDP metadata
Term Name: identifier
URI:http://purl.org/dc/terms/identifier
Label:Identifier
Definition:An unambiguous and persistent reference to the FDP.
Comment:Recommended best practice is to identify the resource by means of a string conforming to a formal identification system.
Has Range:http://www.w3.org/2000/01/rdf-schema#Literal
Version:http://dublincore.org/usage/terms/history/#identifierT-001
Term Name: license
URI:http://purl.org/dc/terms/license
Label:License
Definition:A document describing the conditions for access and usage of the FDP.
Has Range:http://purl.org/dc/terms/LicenseDocument
Version:http://dublincore.org/usage/terms/history/#license-002
Term Name: title
URI:http://purl.org/dc/terms/title
Label:Title
Definition:The name of the FDP.
Has Range:http://www.w3.org/2000/01/rdf-schema#Literal
Version:http://dublincore.org/usage/terms/history/#titleT-002
Term Name: description
URI:http://purl.org/dc/terms/description
Label:Description
Definition:A human-readable description of the FDP.
Has Range: 
Version:http://dublincore.org/usage/terms/history/#descriptionT-001
Term Name: hasVersion
URI:http://purl.org/dc/terms/hasVersion
Label: 
Definition:The version of the FDP software.
Has Range: 
Version:http://dublincore.org/usage/terms/history/#hasVersion-003
Term Name: Metadata Version
URI:http://purl.org/dc/terms/hasVersion
Label: 
Definition:The version of the FDP API specification implemented in this FDP deployment.
Has Range: 
Version:http://dublincore.org/usage/terms/history/#hasVersion-003
Term Name: issued
URI:http://purl.org/dc/terms/issued
Label:Date Issued
Definition:Date of formal issuance (e.g., deployment) of the FDP.
Has Range:http://www.w3.org/2000/01/rdf-schema#Literal
Version:http://dublincore.org/usage/terms/history/#issued-003
Term Name: modified
URI:http://purl.org/dc/terms/modified
Term Name: publisher
URI:http://purl.org/dc/terms/publisher
Label:Publisher
Definition:The entity responsible for making the FDP available.
Has Range:http://purl.org/dc/terms/Agent
Version:http://dublincore.org/usage/terms/history/#publisherT-001

 

Catalog, Dataset

...

and

...

Distribution metadata

For the representation of the catalog of datasets and , each of one of the offered datasets and their distributions, we adopt as basis the W3C's Data Catalog Vocabulary (DCAT). DCAT defines three main classes:

  • dcat:Catalog: defines the catalog, i.e., the collection of datasets;
  • dcat:Dataset: represents a individual dataset in the collection;
  • dcat:Distribution: represent an accessible form of a dataset, e.g., a downloadable file or a web service that gives access to the data.

Combining the FDP Metadata API (depicted in figure 5) and DCAT's classes, we have that the FDP's DatasetsMetadata resource is represented by DCAT's Catalog class and FDP's DatasetMetadata resource is represented by combining DCAT's Dataset and Distribution classes.

...

Catalog metadata

List of required and optional predicates for the catalog metadata

...

Figure 6 depicts the HATEOAS RESTful API of FDP. In the figure, the upper-left green box represents the FDP service and responds to requests to the root URL, hereby represented as "/". 

Fig. 6 - FDP HATEOAS API

When the FAIR Data Point Service root URL receives an HTTP GET request (e.g., http://145.100.59.120:8082/fdp/), the Metadata Service returns the FDPMetadata resource. This resource contains information about the FDP itself such as the owner (organisation or individual), FDP version, API version, etc. The content of the FDPMetadata resource is based on the Repository concept defined in the Open Initiative Archive Protocol for Metadata Harvesting (OAI-PMH). Following the HATEOAS guidelines, the FDPMetadata resource also provides a link to the CatalogMetadata resource.

...

Once the user select one of the available datasets, the dataset metadata page is displayed. Figure 9 depicts the mockup of a dataset metadata page.

Fig. 9 - Dataset metadata page

 

 

 

 

 

Additional references

...