Class: DataService
A collection of operations that provides access to one or more distributions or data processing functions.
URI: dldist:DataService
erDiagram
DataService {
string download_url_template
uri endpoint_description
uri endpoint_url
W3CISO8601 date_modified
W3CISO8601 date_published
stringList keyword
uri landing_page
string version
uriorcurie id
uriorcurie schema_type
uriorcurie type
}
Statement {
}
Property {
uriorcurie id
uriorcurie schema_type
uriorcurie type
}
Thing {
uriorcurie id
uriorcurie schema_type
uriorcurie type
}
AttributeSpecification {
uriorcurie schema_type
uriorcurie type
uriorcurie range
string value
}
Activity {
W3CISO8601 ended_at
W3CISO8601 started_at
uriorcurie id
uriorcurie schema_type
uriorcurie type
}
Agent {
uriorcurie id
uriorcurie schema_type
uriorcurie type
}
Relationship {
}
Identifier {
uriorcurie creator
string notation
string schema_agency
}
Location {
uriorcurie id
uriorcurie schema_type
uriorcurie type
}
Entity {
uriorcurie id
uriorcurie schema_type
uriorcurie type
}
Resource {
W3CISO8601 date_modified
W3CISO8601 date_published
stringList keyword
uri landing_page
string version
uriorcurie id
uriorcurie schema_type
uriorcurie type
}
DataService ||--|o Agent : "contact_point"
DataService ||--|o Resource : "is_part_of"
DataService ||--|o Resource : "is_version_of"
DataService ||--}o Identifier : "identifiers"
DataService ||--}o Relationship : "qualified_relations"
DataService ||--}o Agent : "was_attributed_to"
DataService ||--}o Entity : "was_derived_from"
DataService ||--}o Activity : "was_generated_by"
DataService ||--}o Thing : "relations"
DataService ||--}o AttributeSpecification : "has_attributes"
DataService ||--}o Statement : "is_characterized_by"
Statement ||--|| Thing : "object"
Statement ||--|| Property : "predicate"
Property ||--}o Thing : "relations"
Property ||--}o AttributeSpecification : "has_attributes"
Property ||--}o Statement : "is_characterized_by"
Thing ||--}o Thing : "relations"
Thing ||--}o AttributeSpecification : "has_attributes"
Thing ||--}o Statement : "is_characterized_by"
AttributeSpecification ||--|| Property : "predicate"
AttributeSpecification ||--}o AttributeSpecification : "has_attributes"
AttributeSpecification ||--}o Statement : "is_characterized_by"
Activity ||--|o Location : "at_location"
Activity ||--}o Identifier : "identifiers"
Activity ||--}o Relationship : "qualified_relations"
Activity ||--}o Agent : "was_associated_with"
Activity ||--}o Activity : "was_informed_by"
Activity ||--}o Thing : "relations"
Activity ||--}o AttributeSpecification : "has_attributes"
Activity ||--}o Statement : "is_characterized_by"
Agent ||--}o Agent : "acted_on_behalf_of"
Agent ||--|o Location : "at_location"
Agent ||--}o Identifier : "identifiers"
Agent ||--}o Relationship : "qualified_relations"
Agent ||--}o Thing : "relations"
Agent ||--}o AttributeSpecification : "has_attributes"
Agent ||--}o Statement : "is_characterized_by"
Relationship ||--|| Thing : "object"
Relationship ||--}| Role : "had_roles"
Location ||--}o Identifier : "identifiers"
Location ||--}o Relationship : "qualified_relations"
Location ||--}o Thing : "relations"
Location ||--}o AttributeSpecification : "has_attributes"
Location ||--}o Statement : "is_characterized_by"
Entity ||--}o Identifier : "identifiers"
Entity ||--}o Relationship : "qualified_relations"
Entity ||--}o Agent : "was_attributed_to"
Entity ||--}o Entity : "was_derived_from"
Entity ||--}o Activity : "was_generated_by"
Entity ||--}o Thing : "relations"
Entity ||--}o AttributeSpecification : "has_attributes"
Entity ||--}o Statement : "is_characterized_by"
Resource ||--|o Agent : "contact_point"
Resource ||--|o Resource : "is_part_of"
Resource ||--|o Resource : "is_version_of"
Resource ||--}o Identifier : "identifiers"
Resource ||--}o Relationship : "qualified_relations"
Resource ||--}o Agent : "was_attributed_to"
Resource ||--}o Entity : "was_derived_from"
Resource ||--}o Activity : "was_generated_by"
Resource ||--}o Thing : "relations"
Resource ||--}o AttributeSpecification : "has_attributes"
Resource ||--}o Statement : "is_characterized_by"
Inheritance
- Thing [ ThingMixin]
Slots
Name | Cardinality and Range | Description | Inheritance |
---|---|---|---|
download_url_template | 0..1 String |
A URL template with placeholders enclosed in braces ({example} ) |
direct |
endpoint_description | 0..1 Uri |
A description of the services available via the end-points, including their o... | direct |
endpoint_url | 0..1 Uri |
The root location or primary endpoint of a service (a Web-resolvable IRI) | direct |
contact_point | 0..1 Agent |
Relevant contact information for the subject | Resource |
date_modified | 0..1 W3CISO8601 |
Date on which the resource was (last) changed, updated or modified | Resource |
date_published | 0..1 W3CISO8601 |
Date on which the resource was (last) changed, updated or modified | Resource |
is_part_of | 0..1 Resource |
A related resource that is included either physically or logically in the des... | Resource |
is_version_of | 0..1 Resource |
A related resource of which the described resource is a version | Resource |
keyword | * String |
One or more keywords or tags describing the resource | Resource |
landing_page | 0..1 Uri |
A Web page that can be navigated to in a Web browser to gain access to a reso... | Resource |
version | 0..1 String |
Version indicator (name or identifier) of a resource | Resource |
identifiers | * Identifier |
An unambiguous reference to the subject within a given context | Entity |
qualified_relations | * Relationship |
Characterizes the relationship or role of an entity with respect to the subje... | Entity |
was_attributed_to | * Agent |
Attribution is the ascribing of an entity to an agent | Entity |
was_derived_from | * Entity |
Derivation is a transformation of an entity into another, an update of an ent... | Entity |
was_generated_by | * Activity |
Generation is the completion of production of a new entity by an activity | Entity |
id | 1 Uriorcurie |
Globally unique identifier of a metadata object, such as a Thing |
Thing |
relations | * Thing |
Declares an unqualified relation of the subject Thing to another Thing |
Thing |
has_attributes | * AttributeSpecification |
Declares a relation that associates a Thing (or another attribute) with an ... |
ThingMixin |
is_characterized_by | * Statement |
Qualifies relationships between a subject Thing and an object Thing with ... |
ThingMixin |
schema_type | 0..1 Uriorcurie |
Type designator of a schema element for validation and schema structure handl... | ThingMixin |
type | 0..1 Uriorcurie |
State that the subject is an instance of a particular RDF class | ThingMixin |
Usages
used by | used in | type | used |
---|---|---|---|
Distribution | access_service | range | DataService |
QualifiedAccess | access_service | range | DataService |
Comments
- Characteristics of a particular
Dataservice
that do not vary acrossDistributions
that can be requested from theDataService
are considered properties (has_property
) of theDataservice
. In contrast, information needed in addition for requesting a particularDistribution
are considered an access request parameter (has_parameter
). Such parameters can be declared for aDataService
, and provided for a particularDistribution
via a dedicatedQualifiedAccess
relation.
TODOs
- Enable indication what kind of credentials are required for access, and where to obtain them.
Identifier and Mapping Information
Schema Source
- from schema: https://concepts.datalad.org/s/sdd/unreleased
Mappings
Mapping Type | Mapped Value |
---|---|
self | dldist:DataService |
native | dex:DataService |
exact | dcat:DataService |
broad | dcat:Resource, dctypes:Service |
LinkML Source
Direct
name: DataService
description: A collection of operations that provides access to one or more distributions
or data processing functions.
todos:
- Enable indication what kind of credentials are required for access, and where to
obtain them.
comments:
- Characteristics of a particular `Dataservice` that do not vary across `Distributions`
that can be requested from the `DataService` are considered properties (`has_property`)
of the `Dataservice`. In contrast, information needed in addition for requesting
a particular `Distribution` are considered an access request parameter (`has_parameter`).
Such parameters can be declared for a `DataService`, and provided for a particular
`Distribution` via a dedicated `QualifiedAccess` relation.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- dcat:DataService
broad_mappings:
- dcat:Resource
- dctypes:Service
is_a: Resource
slots:
- download_url_template
- endpoint_description
- endpoint_url
class_uri: dldist:DataService
Induced
name: DataService
description: A collection of operations that provides access to one or more distributions
or data processing functions.
todos:
- Enable indication what kind of credentials are required for access, and where to
obtain them.
comments:
- Characteristics of a particular `Dataservice` that do not vary across `Distributions`
that can be requested from the `DataService` are considered properties (`has_property`)
of the `Dataservice`. In contrast, information needed in addition for requesting
a particular `Distribution` are considered an access request parameter (`has_parameter`).
Such parameters can be declared for a `DataService`, and provided for a particular
`Distribution` via a dedicated `QualifiedAccess` relation.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- dcat:DataService
broad_mappings:
- dcat:Resource
- dctypes:Service
is_a: Resource
attributes:
download_url_template:
name: download_url_template
description: A URL template with placeholders enclosed in braces (`{example}`).
When expanded with a given set of named parameters, the instantiated template
forms a valid URL suitable for requesting a download.
notes:
- the `range` is string, because structural elements of the URL (e.g., the protocol)
could also be a placeholder.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
close_mappings:
- linkml:structured_pattern
related_mappings:
- dldist:download_url
rank: 1000
slot_uri: dldist:download_url_template
alias: download_url_template
owner: DataService
domain_of:
- DataService
range: string
endpoint_description:
name: endpoint_description
description: A description of the services available via the end-points, including
their operations, parameters etc.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
rank: 1000
slot_uri: dldist:endpoint_description
alias: endpoint_description
owner: DataService
domain_of:
- DataService
range: uri
endpoint_url:
name: endpoint_url
description: The root location or primary endpoint of a service (a Web-resolvable
IRI).
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- dcat:endpointURL
related_mappings:
- dcat:downloadURL
- dldist:endpoint_description
rank: 1000
slot_uri: dldist:endpoint_url
alias: endpoint_url
owner: DataService
domain_of:
- DataService
range: uri
contact_point:
name: contact_point
description: Relevant contact information for the subject.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- dcat:contactPoint
rank: 1000
slot_uri: dldist:contact_point
alias: contact_point
owner: DataService
domain_of:
- Resource
range: Agent
date_modified:
name: date_modified
description: Date on which the resource was (last) changed, updated or modified.
notes:
- successful validation with `datetime` as a range and linkml-jsonschema-validate`
depends on a patched linkml, see https://github.com/linkml/linkml/issues/1806
- a related problem also exists for `linkml-validate`, we cannot have a more specific
range right now
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- dcterms:modified
rank: 1000
slot_uri: dldist:date_modified
alias: date_modified
owner: DataService
domain_of:
- Publication
- Distribution
- Resource
range: W3CISO8601
date_published:
name: date_published
description: Date on which the resource was (last) changed, updated or modified.
notes:
- successful validation with `datetime` as a range and linkml-jsonschema-validate`
depends on a patched linkml, see https://github.com/linkml/linkml/issues/1806
- a related problem also exists for `linkml-validate`, we cannot have a more specific
range right now
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- schema:datePublished
rank: 1000
slot_uri: dldist:date_published
alias: date_published
owner: DataService
domain_of:
- Publication
- Distribution
- Resource
range: W3CISO8601
is_part_of:
name: is_part_of
description: A related resource that is included either physically or logically
in the described resource.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- dcterms:isPartOf
rank: 1000
slot_uri: dldist:is_part_of
alias: is_part_of
owner: DataService
domain_of:
- Resource
range: Resource
is_version_of:
name: is_version_of
description: A related resource of which the described resource is a version.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- dcat:isVersionOf
rank: 1000
slot_uri: dldist:is_version_of
alias: is_version_of
owner: DataService
domain_of:
- Resource
range: Resource
keyword:
name: keyword
description: One or more keywords or tags describing the resource.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- dcat:keyword
- schema:keywords
rank: 1000
slot_uri: dldist:keyword
alias: keyword
owner: DataService
domain_of:
- Resource
range: string
multivalued: true
landing_page:
name: landing_page
description: A Web page that can be navigated to in a Web browser to gain access
to a resource, its distributions and/or additional information.
comments:
- If the distribution(s) are accessible only through a landing page (i.e., direct
download URLs are not known), then the landing page link SHOULD be duplicated
as `dldist:access_url` on a distribution.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
see_also:
- https://www.w3.org/TR/vocab-dcat-3/#example-landing-page
exact_mappings:
- dcat:landingPage
- foaf:page
rank: 1000
slot_uri: dldist:landing_page
alias: landing_page
owner: DataService
domain_of:
- Resource
range: uri
version:
name: version
description: Version indicator (name or identifier) of a resource.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- dcat:version
- pav:version
rank: 1000
slot_uri: dldist:version
alias: version
owner: DataService
domain_of:
- Resource
range: string
identifiers:
name: identifiers
description: An unambiguous reference to the subject within a given context.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- dcterms:identifier
- schema:identifier
- ADMS:identifier
rank: 1000
slot_uri: dlidentifiers:identifier
alias: identifiers
owner: DataService
domain_of:
- Location
- InstanteneousEvent
- Agent
- Activity
- Entity
range: Identifier
multivalued: true
inlined: true
inlined_as_list: true
qualified_relations:
name: qualified_relations
description: Characterizes the relationship or role of an entity with respect
to the subject entity.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- dcat:qualifiedRelation
rank: 1000
domain: Thing
slot_uri: dlroles:qualified_relation
alias: qualified_relations
owner: DataService
domain_of:
- Location
- InstanteneousEvent
- Agent
- Activity
- Entity
range: Relationship
multivalued: true
inlined: true
inlined_as_list: true
was_attributed_to:
name: was_attributed_to
description: Attribution is the ascribing of an entity to an agent.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- prov:wasAttributedTo
rank: 1000
domain: Entity
slot_uri: dlprov:was_attributed_to
alias: was_attributed_to
owner: DataService
domain_of:
- Entity
range: Agent
multivalued: true
inlined: false
was_derived_from:
name: was_derived_from
description: Derivation is a transformation of an entity into another, an update
of an entity resulting in a new one, or the construction of a new entity based
on a pre-existing entity.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- prov:wasDerivedFrom
rank: 1000
domain: Entity
slot_uri: dlprov:was_derived_from
alias: was_derived_from
owner: DataService
domain_of:
- Entity
range: Entity
multivalued: true
inlined: false
was_generated_by:
name: was_generated_by
description: Generation is the completion of production of a new entity by an
activity. This entity did not exist before generation and becomes available
for usage after this generation.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- prov:wasAttributedTo
rank: 1000
domain: Entity
slot_uri: dlprov:was_generated_by
alias: was_generated_by
owner: DataService
domain_of:
- Entity
range: Activity
multivalued: true
inlined: false
id:
name: id
description: Globally unique identifier of a metadata object, such as a `Thing`.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- dcterms:identifier
- schema:identifier
- ADMS:identifier
rank: 1000
slot_uri: dlthings:id
identifier: true
alias: id
owner: DataService
domain_of:
- Thing
range: uriorcurie
required: true
relations:
name: relations
description: Declares an unqualified relation of the subject `Thing` to another
`Thing`. This schema slot is used to define related things inline. If such a
definition is not needed. A qualified relationship can be declared directly
using the `is_characterized_by` slot.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- dcat:relation
- dcterms:relation
rank: 1000
domain: Thing
slot_uri: dlthings:relation
alias: relations
owner: DataService
domain_of:
- Thing
symmetric: true
relational_role: OBJECT
range: Thing
multivalued: true
inlined: true
inlined_as_list: false
has_attributes:
name: has_attributes
description: Declares a relation that associates a `Thing` (or another attribute)
with an attribute, where an attribute is an intrinsic characteristic, such as
a quality, capability, disposition, function, or is an externally derived attribute
determined from some descriptor (e.g. a quantity, position, label/identifier).
Technically, this declaration is done via an `AttributeSpecification` that combines
a `predicate` with a value declaration and the attribute-related slots of a
`Thing`. Importantly, such attributes are declared inline, because they do not
have a unique identifier. If an identifier is available, a `Thing` declaration
(see `relation`), and a qualification of that relationship via a `Statement`
(see `is_characterized_by`) should be preferred.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- sio:SIO_000008
rank: 1000
slot_uri: dlthings:has_attributes
alias: has_attributes
owner: DataService
domain_of:
- ThingMixin
range: AttributeSpecification
multivalued: true
inlined: true
inlined_as_list: true
is_characterized_by:
name: is_characterized_by
description: Qualifies relationships between a subject `Thing` and an object `Thing`
with a `Statement` declaring a `predicate` on the nature of the relationship.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- obo:RO_0000053
rank: 1000
slot_uri: dlthings:is_characterized_by
alias: is_characterized_by
owner: DataService
domain_of:
- ThingMixin
range: Statement
multivalued: true
inlined: true
inlined_as_list: true
schema_type:
name: schema_type
annotations:
sh:path:
tag: sh:path
value: dlthings:schema_type
description: Type designator of a schema element for validation and schema structure
handling purposes. This is used to indicate specialized schema classes for properties
that accept a hierarchy of classes as their range.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- dcterms:type
rank: 1000
slot_uri: rdf:type
designates_type: true
alias: schema_type
owner: DataService
domain_of:
- ThingMixin
range: uriorcurie
type:
name: type
description: State that the subject is an instance of a particular RDF class.
from_schema: https://concepts.datalad.org/s/sdd/unreleased
exact_mappings:
- dcterms:type
rank: 1000
slot_uri: rdf:type
alias: type
owner: DataService
domain_of:
- ThingMixin
range: uriorcurie
class_uri: dldist:DataService