diff --git a/specification/tmp/domain_ISA2.md b/specification/tmp/domain_ISA2.md index 2cac59c90dd370b5b7048f6bb65a2f803c8d633a..7861524e181e87625d59585578359d8681bcc378 100644 --- a/specification/tmp/domain_ISA2.md +++ b/specification/tmp/domain_ISA2.md @@ -35,72 +35,182 @@ Well-known data sources of the LOD are [DBpedia](https://de.wikipedia.org/wiki/D Another main focus is on so-called duplicates. These are agents that have been stored in several places due to the distribution of data and may differ from each other. Matching this data technically is a rather complex issue, so we are content to mark these duplicates so that they can be 'followed' and searched for. A 'data owner' then has the option of resolving these duplicates automatically or manually. - -# Agent -Core or Head of our domain is an [Agent](http://xmlns.com/foaf/spec/#term_Agent) (eg. person, group, software or physical artifact). +# TODO kurze einführung in triples. Anmerkung subject == funktionierender link +Kann sameAS auch auf eine html repräsentatuion verwendet werden? wie gehen wir mit https://de.wikipedia.org/wiki/Content_Negotiation um wenn html und turtle an versch. orten liegen? geht das ? + + +# Class Diagram +The colours represent different vocabularies. + + + +## Agent +**Typ:** +[http://xmlns.com/foaf/0.1/Agent](http://xmlns.com/foaf/spec/#term_Agent) + +**Description:** +Core or Head of our domain is an Agent (eg. person, group, software or physical artifact). + +**Properties:** +- [http://purl.org/dc/terms/identifier](https://www.dublincore.org/specifications/dublin-core/dcmi-terms/#http://purl.org/dc/terms/identifier) +Recommended practice is to identify the resource by means of a string conforming to an identification system. Examples include International Standard Book Number (ISBN), Digital Object Identifier (DOI), and Uniform Resource Name (URN). Persistent identifiers should be provided as HTTP URIs. +**TODO** how to Content_Negotiation ?? in case of kvm or adapters +- [http://xmlns.com/foaf/0.1/name](http://xmlns.com/foaf/spec/#term_name) +The name of something is a simple textual string. +- [http://xmlns.com/foaf/0.1/homepage](http://xmlns.com/foaf/spec/#term_homepage) +A homepage for some thing. +- [http://www.w3.org/2002/07/owl#versionInfo](https://www.w3.org/TR/owl-ref/#versionInfo-def) +**NOTE:** _That is not really a good property for that what we need. But i didn't find another yet._ +- [http://purl.org/dc/terms/description](https://www.dublincore.org/specifications/dublin-core/dcmi-terms/#http://purl.org/dc/terms/description) +Description may include but is not limited to: an abstract, a table of contents, a graphical representation, or a free-text account of the resource. ## Group -The [Group](http://xmlns.com/foaf/spec/#term_Group) class represents a collection of individual agents (and may itself play the role of a Agent, ie. something that can perform actions). This concept is intentionally quite broad, covering informal and ad-hoc groups, long-lived communities, organizational groups within a workplace, etc. +**Typ:** +[http://xmlns.com/foaf/0.1/Group](http://xmlns.com/foaf/spec/#term_Group) + +**Description:** +The Group class represents a collection of individual agents (and may itself play the role of a Agent, ie. something that can perform actions). This concept is intentionally quite broad, covering informal and ad-hoc groups, long-lived communities, organizational groups within a workplace, etc. + +**Properties:** +- https://schema.org/foundingDate +The date that this organization was founded. ## Legal Entity -Represents a organisation that is legally registered. See [Legal Entity](https://joinup.ec.europa.eu/site/core_business/rdfs.html#legal:LegalEntity) +**Typ:** +[http://www.w3.org/ns/legal#LegalEntity](https://joinup.ec.europa.eu/site/core_business/rdfs.html#legal:LegalEntity) + +**Description:** +Represents a organisation that is legally registered. + +**Properties:** +- https://schema.org/foundingDate +The date that this organization was founded. ## Person -An individual person who may be dead or alive, but not imaginary. It is that restriction that makes [person:Person](https://joinup.ec.europa.eu/site/core_person/rdfs.html#person:Person) a sub class of both foaf:Person and schema:Person which both cover imaginary characters as well as real people. +**Typ:** +[http://www.w3.org/ns/person#Person](https://joinup.ec.europa.eu/site/core_person/rdfs.html#person:Person) + +**Description:** +An individual person who may be dead or alive, but not imaginary. It is that restriction that makes Person a sub class of both foaf:Person and schema:Person which both cover imaginary characters as well as real people. ## Organizational Unit -An [Organizational Unit](https://www.w3.org/TR/vocab-org/#org:OrganizationalUnit) is a Organization such as a department or support unit which is part of some larger Organization and only has full recognition within the context of that Organization. In particular the unit would not be regarded as a legal entity in its own right. +**Typ:** +[http://www.w3.org/ns/org#OrganizationalUnit](https://www.w3.org/TR/vocab-org/#org:OrganizationalUnit) + +**Description:** +An Organization such as a department or support unit which is part of some larger Organization and only has full recognition within the context of that Organization. In particular the unit would not be regarded as a legal entity in its own right. + +**Properties:** +- https://schema.org/foundingDate +The date that this organization was founded. + +## Organizational Collaboration +**Typ:** +[http://www.w3.org/ns/org#OrganizationalCollaboration](https://www.w3.org/TR/vocab-org/#org:OrganizationalCollaboration) -# Organizational Collaboration -A collaboration between two or more Organizations such as a project. It meets the criteria for being an Organization in that it has an identity and defining purpose independent of its particular members but is neither a formally recognized legal entity nor a sub-unit within some larger organization. Might typically have a shorter lifetime than the Organizations within it, but not necessarily. See [Organizational Collaboration](https://www.w3.org/TR/vocab-org/#org:OrganizationalCollaboration) +**Description:** +A collaboration between two or more Organizations such as a project. It meets the criteria for being an Organization in that it has an identity and defining purpose independent of its particular members but is neither a formally recognized legal entity nor a sub-unit within some larger organization. Might typically have a shorter lifetime than the Organizations within it, but not necessarily. -# Location -Represents any [location](https://joinup.ec.europa.eu/site/core_location/rdfs.html#dcterms:Location), irrespective of size or other restriction. +**Properties:** +- https://schema.org/foundingDate +The date that this organization was founded. + +## Location +**Typ:** +[http://purl.org/dc/terms/Location](https://joinup.ec.europa.eu/site/core_location/rdfs.html#dcterms:Location) + +**Description:** +Represents any location, irrespective of size or other restriction. Unlike the [Business Core Vocabulary](https://joinup.ec.europa.eu/site/core_business/rdfs.html) and [The Organization Ontology](https://www.w3.org/TR/vocab-org) models, we use this location for all agents. See bottom left on the [poster](https://ec.europa.eu/isa2/sites/isa/files/corevocabularies-poster.pdf) -# Opening OpeningHoursSpecification -In the [Core Public Service Vocabulary Application Profile 2.2.1](https://joinup.ec.europa.eu/collection/semantic-interoperability-community-semic/solution/core-public-service-vocabulary-application-profile/release/221) +**Properties** +- Geometry (see following headlines) +- Address (see following headlines) -The opening Hour specification of schema.org is used. the pdf is available [here](https://github.com/catalogue-of-services-isa/CPSV-AP/raw/master/releases/2.2.1/SC2015DI07446_D02.02_CPSV-AP-2.2.1_v1.00.pdf) See `3.12.5. Opening Hours`. +## Geometry +**Typ:** +[http://www.w3.org/ns/locn#Geometry](https://joinup.ec.europa.eu/site/core_location/rdfs.html#locn:Geometry) -The OpeningHoursSpecification of [goodrelations](http://www.heppnetz.de/ontologies/goodrelations/v1.html#OpeningHoursSpecification) is also very simmilar to the [schema.org OpeningHoursSpecification](https://schema.org/OpeningHoursSpecification) +**Description:** +The Geometry Class provides the means to identify a Location as a point. -The [openstreetmap format](https://wiki.openstreetmap.org/wiki/Key:opening_hours) currently used by karte von morgen differs in format. +**Properties** +- https://schema.org/latitude +The latitude of a location. For example 37.42242 [(WGS 84)](https://en.wikipedia.org/wiki/World_Geodetic_System). +- https://schema.org/longitude +The longitude of a location. For example -122.08585 [(WGS 84)](https://en.wikipedia.org/wiki/World_Geodetic_System). -TODO: we have to discuss and decide how we solve that. A feew weeks ago we decided to postpone that decision and did not support openingHous in the first version. +## Address +**Typ:** +[http://www.w3.org/ns/locn#Address](https://joinup.ec.europa.eu/site/core_location/rdfs.html#locn:Address) + +**Description:** +An "address representation" -# Contact Point +**Properties** +- https://www.w3.org/ns/locn#locn:postCode +The post code (a.k.a postal code, **zip code** etc.). Post codes are common elements in many countries' postal address systems. + +- https://www.w3.org/ns/locn#locn:adminUnitL1 +The uppermost administrative unit for the address, almost always a **country**. + +- https://www.w3.org/ns/locn#locn:adminUnitL2 +The region of the address, usually a **county**, state or other such area that typically encompasses several localities. + +- https://www.w3.org/ns/locn#locn:postName +The key postal division of the address, usually the **city** + +- https://www.w3.org/ns/locn#locn:addressArea +The name or names of a geographic area or locality that groups a number of addressable objects for addressing purposes, without being an administrative unit. This would typically be part of a city, a neighbourhood or village. +_Note: As a German, I understand this as a street and would map the street including the house number here for Germany._ + +## Contact Point +**Typ:** +https://schema.org/ContactPoint + +**Description:** +A contact point for a person or organization. Described in the [Core Public Service Vocabulary Application Profile](https://joinup.ec.europa.eu/collection/semantic-interoperability-community-semic/solution/core-public-service-vocabulary-application-profile/releases) see [pdf]( https://github.com/catalogue-of-services-isa/CPSV-AP/raw/master/releases/2.2.1/SC2015DI07446_D02.02_CPSV-AP-2.2.1_v1.00.pdf) chapter `3.18. The Contact Point Class` It references [schema.org ContactPoint](https://schema.org/ContactPoint) - -# Mark as duplicates + +**Properties** +- https://schema.org/name +The name of the item. This could be the name of a contact person. +- https://schema.org/email +Email address. +- https://schema.org/telephone +The telephone number. + +## Mark as duplicates https://www.w3.org/TR/owl-ref/#sameAs-def -# Mark as NOT a duplicate +## Mark as NOT a duplicate https://www.w3.org/TR/owl-ref/#differentFrom-def -# To be discussed +## To be discussed + +### Opening OpeningHoursSpecification +In the [Core Public Service Vocabulary Application Profile 2.2.1](https://joinup.ec.europa.eu/collection/semantic-interoperability-community-semic/solution/core-public-service-vocabulary-application-profile/release/221) + +The opening Hour specification of schema.org is used. the pdf is available [here](https://github.com/catalogue-of-services-isa/CPSV-AP/raw/master/releases/2.2.1/SC2015DI07446_D02.02_CPSV-AP-2.2.1_v1.00.pdf) See `3.12.5. Opening Hours`. + +The OpeningHoursSpecification of [goodrelations](http://www.heppnetz.de/ontologies/goodrelations/v1.html#OpeningHoursSpecification) is also very simmilar to the [schema.org OpeningHoursSpecification](https://schema.org/OpeningHoursSpecification) -## Homepage -The [homepage](http://xmlns.com/foaf/spec/#term_homepage) property relates something to a homepage about it. +The [openstreetmap format](https://wiki.openstreetmap.org/wiki/Key:opening_hours) currently used by karte von morgen differs in format. -## Founding Date -The date that this [organization was founded](https://schema.org/foundingDate). +TODO: we have to discuss and decide how we solve that. A feew weeks ago we decided to postpone that decision and did not support openingHous in the first version. -## Image +### Image http://xmlns.com/foaf/spec/#term_img http://xmlns.com/foaf/spec/#term_thumbnail http://xmlns.com/foaf/spec/#term_logo -## category/tag +### category/tag https://www.w3.org/TR/vcard-rdf/#d4e813 Bei KVM steckt semantik hinter manchen tags, diese sollte man auflösen! -## version -https://www.w3.org/TR/owl-ref/#VersionInformation - -## License -https://schema.org/license \ No newline at end of file +### License +https://schema.org/license