Evidence of certificate of admission to secondary education institution

Abstract

Evidence of certificate of admission to secondary education institution is describing an evidence proving the admission of the person (evidence subject) to a secondary education (EQF level 3) institution; note that although related to proof of enrolment it is not intrinsically equivalent to it.

Terminology

An Application Profile (AP) is a specification that reuses terms from one or more base standards, adding more specificity by identifying mandatory, recommended and optional elements to be used for a particular application, as well as recommendations for controlled vocabularies to be used.

A Core Vocabulary (CV) is a basic, reusable and extensible data specification that captures the fundamental characteristics of an entity in a context-neutral fashion. Its main objective is to provide terms to be reused in the broadest possible context. More information can be found on the SEMIC Style Guide.

This specification uses the following prefixes to shorten the URIs for readibility.

Prefix	Namespace IRI
`cv`	`http://data.europa.eu/m8g/`
`dct`	`http://purl.org/dc/terms/`
`elm`	`http://data.europa.eu/snb/model/version/3.2.0/elm/`
`foaf`	`http://xmlns.com/foaf/0.1/`
`locn`	`http://www.w3.org/ns/locn#`
`person`	`http://www.w3.org/ns/person#/`
`rdf`	`http://www.w3.org/1999/02/22-rdf-syntax-ns#`
`rdfs`	`http://www.w3.org/2000/01/rdf-schema#`
`sdg`	`http://data.europa.eu/p4s/`
`skos`	`http://www.w3.org/2004/02/skos/core#`
`TR`	`https://www.w3.org/TR/owl-time/`
`xsd`	`http://www.w3.org/2001/XMLSchema#`

	Property	Range	Card	Definition	Usage
	is about	Person	1	Agent that is the subject in the provided Evidence.
	requires	Admission	1	A related resource that is required by the described resource to support its function, delivery, or coherence.

Supportive Entities

The supportive entities are supporting the main entities in the Application Profile. They are included in the Application Profile because they form the range of properties.

Admission

Definition: Information about the person's secondary education institution admission.
Properties: For this entity the following properties are defined: duration of pursued studies , end date of academic year , has attribute set , name of the study programme to which the admission refers , start date of the academic year .

Property	Range	Card	Definition
duration of pursued studies	Decimal	0..1	length of, or element of the length of, a temporal extent expressed in years.
end date of academic year	Instant	0..1	End of a temporal entity.
has attribute set	Attribute Set	0..1	Relates a concept to the AttributeSet that provides its additional descriptive information.
name of the study programme to which the admission refers	Literal	0..1	A name given to the resource.
start date of the academic year	Instant	0..1	Beginning of a temporal entity.

Attribute

Definition: The optional property that provides additional descriptive information about a concept.
Properties: This specification does not impose any additional requirements to properties for this entity.

Attribute Set

Definition: The collection of attributes grouped to provide additional descriptive information about a concept.
Properties: For this entity the following properties are defined: has attribute .

	Property	Range	Card	Definition	Usage
	has attribute	Attribute	1..*	The optional property that provides additional descriptive information.

Evidence

Definition: Proof that a Requirement is met.
Usage Note: The Evidence class is defined in the Core Criterion and Core Evidence Vocabulary (CCCEV). Although the wording of the definition is different, the semantics are an exact match for CPSV's Input class which it replaces. Evidence can be any resource - document, artefact - anything needed for executing the Public Service. In the context of Public Services, Evidence is usually administrative documents or completed application forms. A specific Public Service may require the presence of certain Evidence or combinations of Evidence in order to be delivered. In some cases, the Output of one service will be Evidence for another service. Such relationships should be described in the associated Rule(s).
Properties: This specification does not impose any additional requirements to properties for this entity.

Legal Entity

Definition: A self-employed person, company, or organization that has legal rights and obligations.
Properties: For this entity the following properties are defined: is part of , name of the secondary education institution .

	Property	Range	Card	Definition	Usage
	is part of	Admission	0..*	A related resource in which the described resource is physically or logically included.
	name of the secondary education institution	Text	0..1	The name under which the Legal Entity is legally registered.

OOTS Evidence

Definition: Proof exchanged through OOTS that a requirement is met.
Subclass of
: Evidence
Properties: For this entity the following properties are defined: has attribute set .

	Property	Range	Card	Definition	Usage
	has attribute set	Attribute Set	0..1	Relates a concept to the AttributeSet that provides its additional descriptive information.

Person

Definition: A individual human being who may be dead or alive, but not imaginary.
Usage Note: The fact that a person in the context of Core Person Vocabulary cannot be imaginary makes person:Person a subclass of foaf:Person which cover imaginary characters as well as real people. The Person Class is a subclass of the more general 'Agent' class.
Subclass of
: Agent
Properties: For this entity the following properties are defined: family name , given name , has attribute set .

Property	Range	Card	Definition	Usage
family name	Text	0..1	The hereditary surname of a family.	Usually referring to a group of people related by blood, marriage or adoption. This attribute also carries prefixes or suffixes which are part of the family name, e.g. "de Boer", "van de Putte", "von und zu Orlow". Multiple family names, such as are commonly found in Hispanic countries, are recorded in the single family name property so that, for example, Miguel de Cervantes Saavedra's family name would be recorded as "de Cervantes Saavedra".
given name	Text	0..1	The name(s) that identify the Person within a family with a common surname.	Usually a first name or forename. Given to a person by his or her parents at birth or legally recognised as 'given names' through a formal process. All given names are ordered in one property so that, for example, the given name for Johann Sebastian Bach is "Johann Sebastian".
has attribute set	Attribute Set	0..1	Relates a concept to the AttributeSet that provides its additional descriptive information.

	Class	Definition
	Code	An idea or notion; a unit of thought.
	Decimal	Decimal represents a subset of the real numbers, which can be represented by decimal numerals.
	Instant	A temporal entity with zero extent or duration.
	Literal	The class of literal values, eg. textual strings and integers.
	Text	The text data type is a combination of a string and a language identifier.

Examples

Example Evidence of certificate of admission to secondary education institution

Usage Guidelines

Support for implementation

The following section provides support for implementing the Evidence of certificate of admission to secondary education institution.

JSON-LD context file

One common technical question is the format in which the data is being exchanged. For conformance with the Evidence of certificate of admission to secondary education institution, it is not mandatory that this happens in a RDF serialisation, but the exhanged format SHOULD be unambiguously be transformable into RDF. For the format JSON, a popular format to exchange data between systems, SEMIC provides a JSON-LD context file. JSON-LD is a W3C Recommendation [[[json-ld11]]] that provided a standard approach to interpret JSON structures as RDF. The provided JSON-LD context file can be used by implementers. This JSON-LD context is not normative, i.e. other JSON-LD contexts are allowed.

The JSON-LD context file is downloadable here.

Validation

SHACL

To verify if the data is (technically) conformant to the Evidence of certificate of admission to secondary education institution, the exchanged data can be validated using the provided SHACL shapes. SHACL is a W3C Recommendation to express constraints on a RDF knowledge graph.

To support the check whether or not a catalogue satisfies the expressed constraints in this Application Profile, the constraints in this specification are expressed using SHACL [[shacl]]. Each constraint in this specification that could be converted into a SHACL expression has been included. As such this collection of SHACL expressions that can be used to build a validation check for data.

It is up to the implementers to define the validation they expect. Each implementation happens within a context, and that context is beyond the SHACL expressions here.

The shapes can be found here.

RDF representation

The RDF representation of the Evidence of certificate of admission to secondary education institution is available here.

UML representation

The UML representation from which the Evidence of certificate of admission to secondary education institution has been build is available here.

XML schema representation

The XML schema representation from which the Evidence of certificate of admission to secondary education institution has been build is available here.

The XML schema is based on the OOTS requirements and it allows some flexibility to include fields that Member States can add in addition to those foreseen in the OOTS requirements.

The XML schema is based on 3 parts:

The subject part, to indicate the Person subject of the evidence
The event/status part, to indicate the data about the event related to the subject
Optional additional part, to add optional fields (attributes) for the evidence type, such as issuing date or issuing authority

All the parts with their respective attributes are optional (min cardinality set to 0).

The XML schema is based on the SEMIC Core Criterion and Core Evidence (CCCEV) specification, and on the Core Person vocabulary. In CCCEV, the Evidence is about an Agent that is the subject in the provided Evidence; in the case of Evidence of Birth, the Agent is the Person. An EvidenceOfCertfiicateAdmissionSecondaryEducationType is then an OOTSEvidenceType (based on CCCEV Evidence) by having the 3 parts:

cv:isAbout. Since the value of cv:isAbout is a generic AgentType, in SDG a PersonType is defined as an AgentType with cv:FamilyName, cv:GivenName, cv:Sex and sdg:AttributeSet, that it means that is possible to add additional fields to the subject.
sdg:Birth, defined by the OOTSBirthType, that includes cv:CountryOfBirth, cv:DateOfBirth, cv:PlaceOfBirth (as foreseen in OOTS requirements) and sdg:AttributeSet
sdg:AttributeSet, that can contains many attributes, where the name, language and type fields could be defined for each attribute

The design of the XML schema is based on the Garden Of Eden Pattern where complex types and elements are defined globals so they can be reused.

Restrictions on the presence of fields and on their values is delegated to schematron file, that can vary on the XML consumer and could be provided by XML providers, such as those on code list. OOTS provides certain code list in Genericode format that can be used via schematron. Additional code list, such as the one of Sex in he current evidence, could be take from the the Publications Office Authority Tables.

Governance

Versioning governance

All specifications produced in SEMIC will follow the versioning rule described by the SEMIC Style Guide rule PC-R3. In case a SEMIC asset is deprecated the asset will remain available through its PURI.

The serialisation will have:

a dct:isReplacedBy referencing the new assets used instead and
an adms:status indicating its deprecated status.

Governance requirements for re-used assets

In order to adhere to the SEMIC Style Guide rule GC-R2 a specification should have quality and governance standards for the assets that are being reused.

In order for an asset to be considered for reuse within a SEMIC specification it can be requested by a community member or it requires to adhere to the following requirements:

The asset is part of a recommendation by a major standards body or an EU institution.
The asset is actively being maintained.

After being taken into consideration the asset will be validated in three steps:

Syntax validation will be performed on the relevant artefacts.
Constraint validation will be performed on the relevant artefacts.
The PURI will be validated.

Once considered and validated an asset can be adopted if it is approved by the community.

Lexicalisation rules

In order to adhere to the SEMIC Style Guide rule SC-R3 a specification requires formal lexicalisation rules. The Style Guide proposes two options either by using RDFS or SKOS lexicalisation.

SEMIC uses and will use the RDFS lexicalisation for all of its specifications. More specifically:

rdfs:label is used to provide a human-readable version of a resource's name.
The usage of certain resource can be clarified in a skos:usageNote.

Mapping

This section offers a condensed tabular overview of the requirements, along with the corresponding classes and properties in ELM and ELMO.

Information requirement	elm Class	elm Property	ELMO Class	ELMO property
(official) duration of the pursued studies to which the admission refer (in years)	LearningOpportunity	duration	/ns:learningOpportunitySpecification[1]	/ns:extension[1]
end date of academic year	LearningOpportunity	end date	/ns:learningOpportunityInstance[1]	/ns:date[1]
name of the study programme to which the admission refers	LearningOpportunity	name of study programme	/ns:issuer[1]	/ns:title[1]
start date of the academic year	LearningOpportunity	start date	/ns:learningOpportunityInstance[1]	/ns:start[1]
family name	Person	family name	/ns:learner[1]	/ns:familyName[1]
given name	Person	given name	/ns:learner[1]	/ns:givenNames[1]
name of the secondary education institution	Organisation	legal name	/ns:issuer[1]/ns:title[1]	/ns:title[1]

Quick Reference of Classes and Properties

This section provides a condensed tabular overview of the mentioned classes and properties in this specification. The properties are indicated as mandatory, recommended, optional and deprecated. These terms have the following meaning.

Mandatory property: a receiver MUST be able to process the information for that property; a sender MUST provide the information for that property.
Recommended property: a receiver MUST be able to process the information for that property; a sender SHOULD provide the information for that property if it is available.
Optional property: a receiver MUST be able to process the information for that property; a sender MAY provide the information for that property but is not obliged to do so.
Deprecated property: a receiver SHOULD be able to process information about instances of that property; a sender SHOULD NOT provide the information about instances of that property.

Class	Class IRI	Property	Property IRI
Admission	http://data.europa.eu/p4s/Admission	duration of pursued studies	https://www.w3.org/TR/owl-time/#time:years
Admission	http://data.europa.eu/p4s/Admission	end date of academic year	https://www.w3.org/TR/owl-time/#time:hasEnd
Admission	http://data.europa.eu/p4s/Admission	has attribute set	http://data.europa.eu/p4s/hasAttributeSet
Admission	http://data.europa.eu/p4s/Admission	name of the study programme to which the admission refers	http://purl.org/dc/terms/title
Admission	http://data.europa.eu/p4s/Admission	start date of the academic year	https://www.w3.org/TR/owl-time/#time:hasBeginning
Attribute	http://data.europa.eu/p4s/Attribute
Attribute Set	http://data.europa.eu/p4s/AttributeSet	has attribute	http://data.europa.eu/p4s/hasAttribute
Evidence	http://data.europa.eu/m8g/Evidence
Evidence of certificate of admission to secondary education institution	http://data.europa.eu/p4s/EvidenceOfCertificateAdmissionSecondaryEducation	is about	http://purl.org/dc/terms/subject
Evidence of certificate of admission to secondary education institution	http://data.europa.eu/p4s/EvidenceOfCertificateAdmissionSecondaryEducation	requires	http://purl.org/dc/terms/requires
Legal Entity	http://www.w3.org/ns/legal#LegalEntity	is part of	http://purl.org/dc/terms/isPartOf
Legal Entity	http://www.w3.org/ns/legal#LegalEntity	name of the secondary education institution	http://www.w3.org/ns/legal#legalName
OOTS Evidence	http://data.europa.eu/p4s/OOTSEvidence	has attribute set	http://data.europa.eu/p4s/hasAttributeSet
Person	http://www.w3.org/ns/person#Person	family name	http://xmlns.com/foaf/0.1/familyName
Person	http://www.w3.org/ns/person#Person	given name	http://xmlns.com/foaf/0.1/givenName
Person	http://www.w3.org/ns/person#Person	has attribute set	http://data.europa.eu/p4s/hasAttributeSet

Abstract

Introduction

Status

License

Terminology

Overview

Main Entities