Skip to content

Commit

Permalink
editorial RDF additions (cooments) and editorial text (grammar/spelling)
Browse files Browse the repository at this point in the history
  • Loading branch information
Nicholas Car committed Oct 30, 2019
1 parent 0912a4f commit 09e78ba
Showing 1 changed file with 19 additions and 14 deletions.
33 changes: 19 additions & 14 deletions conneg-by-ap/index.html
Expand Up @@ -2387,46 +2387,51 @@ <h4>Examples of model use</h4>
</section>
</section>
<section id="dcat-usage-example">
<h2>Describing Conneg-by-AP support by data distrubutions using DCAT</h2>
<h2>Describing DCAT Distributions support of Content Negotiation by Profile</h2>
<p>
A dataset may be accessible via a data access service, and that service may support one or more functional profiles of this specification. In this case this should be declared via reference to the relevant functional profiles using the dct:conformsTo predicate on a DataService provided by a DataDistribution, as illustrated in the code example below.
A DCAT [[VOCAB-DCAT-2]] <code>dcat:Dataset</code> may be accessible via a <code>dcat:DataService</code>, and that service may support one or more functional profiles of this specification. In this case, support should be declared by the service's reference to relevant functional profiles using the predicate <code>dct:conformsTo</code>, as illustrated in <a href="#dcat-example">Code Listing 5</a>.
</p>
<p>
Note that DCAT currently provides no canonical means to specify if the data access service allows individual data items in the dataset to be accessed by identifier, so this example relates to the dataset distribution as a whole. The use of dct:conformsTo would nevertheless apply to data access services which declare a mechanism to access individual items. This mechanism may be identified via the dcat:endpointDescription.
Note that DCAT 2 provides no canonical means to specify if a data service allows individual data items in the dataset it provides access to, to be accessed by identifier, so this example relates to the dataset distributed as a whole. The use of <code>dct:conformsTo</code> would nevertheless apply to data services which declare a mechanism to access individual items. This mechanism may be identified via the <code>dcat:endpointDescription</code>.
</p>
<div class="issue" data-number="1146"></div>
<pre id="dcat-example"
class="codelisting nohighlight" aria-busy="false" aria-live="polite"
title="Example of describing a dataset supporting Conneg-by-AP in DCAT">
title="Example of describing a dataset supporting Conneg-by-P in DCAT">
<div class="codelisting-title">
<a href="#dcat-example">CODE LISTING 4</a>: Example of describing a dataset supporting Conneg-by-AP in DCAT
<a href="#dcat-example">CODE LISTING 5</a>: Describing a DCAT Data Service supporting Content Negotiation by Profile
</div>
@prefix ex: &lt;http://example.org#> .
@prefix dcat: &lt;http://www.w3.org/ns/dcat#> .
@prefix dct: &lt;http://purl.org/dc/terms/> .
@prefix prof: &lt;http://www.w3.org/ns/dx/prof/> .

:aDataset dcat:hasDistribution :aDatasetDistribution .
# A Dataset has a Distribution
:aDataset dcat:distribution :aDatasetDistribution .

# declare what this version data looks like
# A data profile that the Distribution conforms to
ex:someDataProfile
a prof:DataProfile ;
# profile details
.

# A Distribution that can be accessed by a DataService that support Content
# Negotiation by Profile. The Distribution's content conforms to the Profile above
:aDatasetDistribution
a dcat:Distribution ;
dct:conformsTo ex:someDataProfile ;
dcat:accessService ex:connegDataAccessService .

# describe data
ex:someDataProfile a prof:DataProfile ;
# other details
.

# declare how data can be accessed
# The Service used to access the Dataset's Distribution. The Service itself conforms
# to two functional profiles of Content Negotiation by Profile
ex:connegDataAccessService
a dcat:DataService ;
dct:conformsTo
&lt;http://www.w3.org/ns/dx/conneg/profile/http> ,
&lt;http://www.w3.org/ns/dx/conneg/profile/qsa> ;

# declare that the dataset may be invoked by URI id using conneg-by-ap
# Declare that the Dataset may be invoked by URI, its id, using Content
# Negotiation by Profile
dcat:endPointURL :aDataset .
</pre>
</section>
Expand Down

0 comments on commit 09e78ba

Please sign in to comment.