SEMIC

Core Public Service Vocabulary Application Profile (CPSV-AP)

Status
SEMIC Recommendation
Published at
2022-05-31
This version
https://semiceu.github.io/CPSV-AP/releases/3.0.0

Summary

The original Core Public Service Vocabulary Application Profile (CPSV-AP) was prepared in the context of Action 2016.29 – Accessing Member State information resources at European level – Catalogue of Services of the European Commission’s Interoperability for European Public Administrations (ISA) programme. The CPSV-AP has been seen as a first step for creating a model for describing public services related to business and life events, to facilitate the set-up of catalogues of services oriented to businesses and citizens.

CPSV-AP is designed to meet the following use cases:

  • facilitating the access to public service information;
  • building user-centric catalogues of public services at all levels from regional to a European federated catalogue;
  • managing portfolios of public services; and
  • finding information of generic and specialised public services.

The specification of the Core Public Service Vocabulary Application Profile is represented in a UML class diagram. The figure here beneath shows the full profile which includes:

  • The classes and properties that define the service itself: the necessary inputs, possible outputs, the responsible public authority and the events that trigger service use;
  • The classes and properties that describe the context in which the service is offered. This includes relevant legislation and rules of operation for the service; and
  • The interface between the service and its users: how and when it can be accessed.

Status of this document

This specification has the status of SEMIC Recommendation published on 2022-05-31.

Overview

This document describes the usage of the following entities for a correct usage of the Core Vocabulary:
| Address | Agent | Business Event | Channel | Collection | Concept | Concession Contract | Contact Point | Contract | Cost | Dataset | Event | Evidence | Legal Resource | Life Event | Opening Hours Specification | Organization | Output | Participation | Public Organization | Public Service | Requirement | Rule |

Entities

Address

Definition
A spatial object that in a human-readable way identifies a fixed location.
Usage

An "address representation" as conceptually defined by the INSPIRE Address Representation data type: "Representation of an address spatial object for use in external application schemas that need to include the basic, address information in a readable way."


The representation of Addresses varies widely from one country's postal system to another. Even within countries, there are almost always examples of Addresses that do not conform to the stated national standard. However, ISO 19160-1 provides a method through which different Addresses can be converted from one conceptual model to another.


This specification was heavily based on the INSPIRE Address Representation data type. It is noteworthy that if an Address is provided using the detailed breakdown suggested by the properties for this class, then it will be INSPIRE-conformant. To this very granular set of properties, we add two further properties:

  • - full address (the complete address as a formatted string)
  • - addressID (a unique identifier for the address)
The first of these allows publishers to simply provide the complete Address as one string, with or without formatting. This is analogous to vCard's label property.


The addressID is part of the INSPIRE guidelines and provides a hook that can be used to link the Address to an alternative representation, such as vCard or OASIS xAL.


This class belongs to Core Location Vocabulary
Properties
For this entity the following properties are defined: address area, address ID, administrative unit, administrative unit level 1 (country), administrative unit level 2 (country/region/state), full address, locator designator, locator name, post code, post name (city), post office box, thoroughfare.
Property Expected Range Cardinality Definition Usage Codelist
address area Text 0..* The name of a geographic area that groups Addresses. This would typically be part of a city, a neighbourhood or village, e.g. Montmartre. Address area is not an administrative unit.
address ID String 0..* A globally unique identifier for each instance of an Address. The concept of adding a globally unique identifier for each instance of an address is a crucial part of the INSPIRE data spec. A number of EU countries have already implemented an ID (a UUID) in their Address Register/gazetteer, among them Denmark. OASIS xAL also includes an address identifier. It is the address Identifier that allows an address to be represented in a format other than INSPIRE whilst remaining conformant to the Core Vocabulary.

The INSPIRE method of representing addresses is very detailed, designed primarily for use in databases of addresses. Whilst data that is published in full conformance with the INSPIRE data structure can be made available using the Core Location Vocabulary the reverse is not true since the Core Vocabulary allows much greater flexibility.

Many datasets that include address data as one piece of information about something else are likely to have that data in simpler formats. These might be tailored to the specific need of the dataset, follow a national norm, or make use of a standard like vCard.

To provide maximum flexibility in the Core Vocabulary, whilst remaining interoperable with INSPIRE Address Guidelines (which EU Member States are obliged to use), the Core Location Vocabulary provides the extra property of full address and makes use of INSPIRE's addressID.
administrative unit AdminUnit 0..* The adminUnit relationship links an Address with the Administrative Unit class.
administrative unit level 1 (country) Text 0..* The name of the uppermost level of the address, almost always a country. Best practice is to use the ISO 3166-1 code but if this is inappropriate for the context, country names should be provided in a consistent manner to reduce ambiguity. For example, either write 'France' or 'FRA' consistently throughout the dataset and avoid mixing the two. The Country controlled vocabulary from the Publications Office can be reused for this.
administrative unit level 2 (country/region/state) Text 0..* The name of a secondary level/region of the address, usually a county, state or other such area that typically encompasses several localities. Values could be a region or province, more granular than level 1.
full address Text 0..* The complete address written as a string. Use of this property is not recommended as it will suffer any misunderstandings that might arise through the breaking up of an address into its component parts. This property is analogous to vCard's label property but with two important differences: (1) formatting is not assumed so that, unlike vCard label, it may not be suitable to print this on an address label, (2) vCard's label property has a domain of vCard Address; the fullAddress property has no such restriction. An example of a full address is "Champ de Mars, 5 Avenue Anatole France, 75007 Paris, France".
locator designator String 0..* A number or sequence of characters that uniquely identifies the locator within the relevant scope. In simpler terms, this is the building number, apartment number, etc. For an address such as "Flat 3, 17 Bridge Street", the locator is "flat 3, 17".
locator name Text 0..* Proper noun(s) applied to the real world entity identified by the locator. The locator name could be the name of the property or complex, of the building or part of the building, or it could be the name of a room inside a building.

The key difference between a locator and a locator name is that the latter is a proper name and is unlikely to include digits. For example, "Shumann, Berlaymont" is a meeting room within the European Commission headquarters for which locator name is more appropriate than locator.
post code String 0..* The code created and maintained for postal purposes to identify a subdivision of addresses and postal delivery points. Post codes are common elements in many countries' postal address systems. One of the many post codes of Paris is for example "75000".
post name (city) Text 0..* A name created and maintained for postal purposes to identify a subdivision of addresses and postal delivery points. Usually a city, for example "Paris".
post office box String 0..* A location designator for a postal delivery point at a post office, usually a number. INSPIRE's name for this is "postalDeliveryIdentifier" for which it uses the locator designator property with a type attribute of that name. This vocabulary separates out the Post Office Box for greater independence of technology. An example post office box number is "9383".
thoroughfare Text 0..* The name of a passage or way through from one location to another. A thoroughfare is usually a street, but it might be a waterway or some other feature. For example, "Avenue des Champs-Élysées".

Agent

Definition
The Agent class is any resource that acts or has the power to act. This includes people, organisations and groups. The Public Organization class, defined in the Core Public Organisation Vocabulary, is a notable subclass of Agent.
Properties
For this entity the following properties are defined: address, identifier, name, plays role.
Property Expected Range Cardinality Definition Usage Codelist
address Address 0..1 An Address related to an Agent. Asserting the address relationship implies that the Agent has an Address.
identifier Literal 1 An Identifier for the Agent.
name Text 1..* The Name of the Agent.
plays role Participation 0..* It links an Agent to the Participation class. The Participation class facilitates the detailed description of how an Agent participates in or interacts with a Public Service and may include temporal and spatial information.

Business Event

Definition
A Business Event is a specific situation or event in the lifecycle of a business that fulfils one or more needs or (legal) obligations of that business at this specific point in time.
Usage
A Business Event requires a set of public services to be delivered and consumed in order for the associated business need(s) or obligation(s) to be fulfilled. Business Events are defined within the context of a particular Member State. In other words, a Business Event groups together a number of public services that need to be delivered for completing that particular event.
Subclass of
Event
Properties
No properties have been defined for this entity.

Channel

Definition
A medium through which an Agent provides, uses or interacts in another way with a Public Service. Typical examples include online services, phone, walk-in centres etc.
Properties
For this entity the following properties are defined: availability restriction, description, has input, identifier, opening hours, owned by, processing time, type.
Property Expected Range Cardinality Definition Usage Codelist
availability restriction Opening Hours Specification 0..1 It links a channel to information about when the channel is not available. The information overrides the general opening hours information. The details are provided using the Opening Hours Specification class.
description Text 0..* A free text description of the Channel, for example to describe conditions when to use it.
has input Evidence 0..* The property links a Public Service directly to one or more pieces of Evidence. In the majority of cases, the evidence required to use a Public Service will be independent of the channel through which the service is accessed. The Has Input property should normally be used to link a Public Service directly to one or more pieces of Evidence. However, where the type of Evidence required varies according to the channel used to access the Public Service, then the Has Input property may be used at the Channel level. For example, a digital signature may be required for an online channel, whereas a physical signature may be required for a face to face service provision.
identifier Literal 1 An Identifier for the Channel.
opening hours Text 0..* The normal opening hours of a channel. The value should follow the flexible format defined for schema.org's opening hours property. Following that structure, days of the week are represented by two letter codes (Mo,Tu, We, Th, Fr, Sa, Su). Lists should be comma separated (for example: Mo, We, Fr) and periods separated by a hyphen (for example: Mo-Fr). If it is appropriate to add opening hours then this follows the day so if a phone service is available 08:00-20:00 Monday to Saturday and 08:00-18:00 on Sundays that would be encoded as Mo-Sa 08:00-20:00, Su 08:00-18:00.
owned by Organization 0..* The owner of a specific Channel through which a Public Service is being delivered.
processing time Duration 0..1 The (estimated) time needed for executing a Public Service which may depend on the Channel chosen. The actual information is provided using the ISO8601 syntax for durations.
type Code 0..1 The type of Channel as defined in a controlled vocabulary. The recommended controlled vocabularies for this property is the Europass Channel Type Authority Table of the Publications Office.

Collection

Definition
This class represent the way Concepts belong together. Thus, different concepts are grouped and define a controlled vocabulary.
Usage
In this context, the CPSV-AP reuses the Collection class as defined in the SKOS Simple Knowledge Organization System. For describing the attributes of a Collection (labels, preferred labels, alternative labels, definition, etc.) we refer to SKOS.
Properties
For this entity the following properties are defined: member.
Property Expected Range Cardinality Definition Usage Codelist
member Concept 0..* It indicates the Concepts that are part of the Collection.

Concept

Definition
This class represents any concept that can be used for classifying the Public Service and which relates to the Public Service through the property Is Classified By.
Usage
This class has been added in the CPSV-AP to complement the need for adding other ways of classifying the Public Service, which have not been explicitly defined in the CPSV-AP. In this context, the CPSV-AP reuses the Concept class as defined in the SKOS Simple Knowledge Organization System. For describing the attributes of a Concept (labels, preferred labels, alternative labels, definition, etc.) we refer to SKOS. The Concept may or may not belong to (member) a certain Collection.
Properties
No properties have been defined for this entity.

Concession Contract

Definition
Concessions are contracts for pecuniary interest by means of which one or more contracting authorities or contracting entities entrusts the execution of works, or the provision and the management of services, to one or more economic operators.
Usage
The object of such contracts is the procurement of works or services by means of a concession, the consideration of which consists in the right to exploit the works or services or in that right together with payment. Such contracts may, but do not necessarily, involve a transfer of ownership to contracting authorities or contracting entities, but contracting authorities or contracting entities always obtain the benefits of the works or services in question. The definition comes from the Directive 2014/23/EU.
Subclass of
Contract
Properties
For this entity the following properties are defined: description, established under, has contracting authority, has economic operator, identifier, name.
Property Expected Range Cardinality Definition Usage Codelist
description Text 1..* A free text description of the Concession Contract.
established under Legal Resource 0..* It links a Concession Contract to relevant legislation or policy documents i.e. the Legal Resource under which the Concession Contracts are being defined.
has contracting authority Public Organization 1..* It links a Concession Contract with the Contracting Authority which is ultimately responsible for a public service.
has economic operator Organization 1..* It links a Concession Contract with the Economic Operator in charge for the provision and the management of public services.
identifier Literal 1 An Identifier for the Concession Contract.
name Text 1..* The Name of the Concession Contract.

Contact Point

Definition
This class represents the contact information for a Public Service, Channel, Public Organization, etc.
Usage
Similarly to the Channel class, a Contact Point may have regular opening hours that are then overridden by, for example, public holidays, using the Opening Hours Specification class.
Properties
For this entity the following properties are defined: availability restriction, contact page, has email, has telephone, opening hours.
Property Expected Range Cardinality Definition Usage Codelist
availability restriction Opening Hours Specification 0..* The time interval during which the Contact Point is not available.
contact page Document 0..* A contact page that could be used to reach out the contact point.
has email Literal 0..* An electronic address through which the Contact Point can be contacted.
has telephone Literal 0..* A telephone number through which the Contact Point can be contacted.
opening hours Literal 0..* The (structured) hours at which the contact point is normally available. Days are specified using two-letter combinations: Mo, Tu, We, Th, Fr, Sa, Su. For example, if the contact point is open Monday-Friday, 9 -5, the value of the openingHours property would be Mo-Fr 09:00-17:00. If the Contact Point is only available on Tuesday and Thursday between 6 and 8pm, the value would be Tu,Th 16:00-20:00.

Contract

Definition
A voluntary, deliberate, and legally binding agreement between two or more competent parties.
Properties
No properties have been defined for this entity.

Cost

Definition
The Cost class represents any costs related to the execution of a Public Service that the Agent consuming it needs to pay.
Properties
For this entity the following properties are defined: currency, description, has value, identifier, if accessed through, is defined by.
Property Expected Range Cardinality Definition Usage Codelist
currency Code 0..1 The currency in which the Cost needs to be paid and the value of the Cost is expressed. The possible values for this property are described in the controlled vocabulary Currency Authority Table of Publications Office.
description Text 0..* A free text description of the Cost.
has value Double 0..1 A numeric value indicating the amount of the Cost.
identifier Literal 1 An Identifier for the Cost.
if accessed through Channel 0..1 The costs created by the use of different Channels. For example, if accessed through an online service cf. accessed at a physical location, the cost can be linked to the channel using the If Accessed Through property.
is defined by Organization 0..* It links the Cost class to one or more instances of the Public Organization class. This property indicates which Public Organization is the Competent Authority for defining the costs associated with the delivery of a particular Public Service.

Dataset

Definition
This class represents a collection of metadata and where they can be found, for instance on a regional public service portal and/or a national eGovernment portal.
Properties
For this entity the following properties are defined: description, has part, identifier, landing page, publisher, title.
Property Expected Range Cardinality Definition Usage Codelist
description Text 1..* A free-text account of the Dataset. This property can be repeated for parallel language versions of the description.
has part Public Service 0..* It links a Dataset to the Public Service.
identifier Literal 0..* The main identifier for the Dataset, e.g. the URI or other unique identifier in the context of the Catalogue.
landing page Document 0..n A web page that provides access to the Dataset, its Distributions and/or additional information. It is intended to point to a landing page at the original data provider, not to a page on a site of a third party, such as an aggregator.
publisher Agent 1 The Publisher of the Dataset, i.e. an entity (organisation) responsible for making the Dataset available.
title Text 1..* A name given to the Dataset. This property can be repeated for parallel language versions of the name.

Event

Definition
This class represents an event that can be of any type that triggers, makes use of, or in some way is related to, a Public Service.
Usage
It is not expected to be used directly, rather, one or other of its subclasses should be used. The properties of the class are, of course, inherited by those subclasses. The Event class is used as a hook either to a single related Public Service, such as diagnosis of illness being related to application for sickness benefit; or to a group of Public Services, such as all those related to the establishment of a new business.
Properties
For this entity the following properties are defined: description, identifier, name, related service, type.
Property Expected Range Cardinality Definition Usage Codelist
description Text 0..* A free text description of the Event. The description is likely to be the text that a business or citizen sees for that specific Event when looking for relevant Public Services. Public administrations are therefore encouraged to include a reasonable level of detail in the description.
identifier Literal 1 An Identifier for the Event.
name Text 1..* The Name (or title) of the Event.
related service Public Service 0..* It links an event directly to a public service that is related to it.
type Code 0..* It links an Event to a controlled vocabulary of event types. It is the nature of those controlled vocabularies that is the major difference between a business event, such as creating the business in the first place and a life event, such as the birth of a child.

Evidence

Definition
The Evidence class is defined in the Core Criterion and Core Evidence vocabulary (CCCEV) as any resource that can prove that a specific requirement is met.
Usage
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).
Subclass of
Dataset
Properties
For this entity the following properties are defined: description, identifier, language, name, related documentation, supports requirement, type.
Property Expected Range Cardinality Definition Usage Codelist
description Text 0..* A free text Description of the piece of Evidence.
identifier Literal 1 An Identifier for the piece of Evidence.
language LinguisticSystem 0..* The language(s) in which the Evidence must be provided. The recommended controlled vocabularies for this property is the Language Authority Table of the Publications Office.
name Text 1..* The official Name of the piece of Evidence.
related documentation Document 0..n The documentation that contains information. For instance, a particular template for an administrative document, an application or a guide on formatting the Evidence.
supports requirement Requirement 0..* Requirement for which the Evidence provides proof.
type Code 0..1 The type of Evidence as described in a controlled vocabulary.
Definition
This class represents the legislation, policy or policies that lie behind the Rules that govern the service.
Usage
The definition and properties of the Legal Resource class in the CPSV-AP are aligned with the ontology included in "Council conclusions inviting the introduction of the European Legislation Identifier (ELI)". For describing the attributes of a Legal Resource (labels, preferred labels, alternative labels, definition, etc.) we refer to the ELI ontology.
Properties
For this entity the following properties are defined: related.
Property Expected Range Cardinality Definition Usage Codelist
related Legal Resource 0..* Another instance of the Legal Resource class that is related to the particular Legal Resource being described.

Life Event

Definition
The Life Event class represents an important event or situation in a citizen's life where public services are required.
Usage
Note on the scope: an individual will encounter any number of 'events'; in the general sense of the word. In the context of the CPSV-AP, the Life Event class only represents an event to which a Public Service is related. For example, a couple becoming engaged is not a CPSV-AP Life Event, getting married is, since only the latter has any relevance to public services.
Subclass of
Event
Properties
No properties have been defined for this entity.

Opening Hours Specification

Definition
An exceptional circumstance that overrides the normal Opening Hours, such as being closed on public holidays.
Usage
This class is aligned to Schema.org OpeningHoursSpecification class. The Opening Hours Specification class can be used to provide details of exceptional circumstances, such as being closed on public holidays, which is encoded (in Turtle), thus: ex:PublicHolidayClosed a cv:OpeningHoursSpecification; schema:dayOfWeek . Note that the property schema:opens is not used, therefore the contact point is closed. More specific closures can be indicated by including the schema:validFrom and schema:validThrough properties, for example: ex:ChristmasClosed a cv:OpeningHoursSpecification; schema:validFrom "2016-12-24T012:00Z"; schema:validThrough "2017-01-02T09:00Z".
Properties
No properties have been defined for this entity.

Organization

Definition
A group of people that get together in a community or other social, commercial or political structure. The group has some common purpose or reason for existence which goes beyond the set of people belonging to it and can act as an Agent. Organizations are often decomposable into hierarchical structures.
Subclass of
Agent
Properties
No properties have been defined for this entity.

Output

Definition
An output can be any resource - document, artefact - anything produced by the Public Service. In the context of a Public Service, the output provides an official document or other artefact of the Competent Authority (Public Organization) that permits/authorises/entitles an Agent to (do) something.
Usage
In some cases, the Output of one Public Service will be used as evidence to fulfil a requirement of another Public Service. Such relationships should be described in the associated Rule(s).
Properties
For this entity the following properties are defined: description, identifier, language, name, type.
Property Expected Range Cardinality Definition Usage Codelist
description Text 0..* A free text Description of the Output.
identifier Literal 1 An Identifier for the Output.
language LinguisticSystem 0..* The language(s) in which the Output is available. This could be one or multiple languages, for instance in countries with more than one official language. The recommended controlled vocabularies for this property is the Language Authority Table of the Publications Office.
name Text 1..* The official Name of the Output.
type Code 0..* The type of Output as defined in a controlled vocabulary. Possible values of Output types are: Declaration, Physical object, Code, Financial obligation, Financial benefit, Recognition, Permit.

Participation

Definition
The CPSV-AP recognises a common role connected with public services, i.e. the Competent Authority.
Usage
This simple structure does not allow statements to be made about those participants, such as the start and end date of a contract, nor does it support the inclusion of other roles. The Participation class supports this extra complexity if required, for instance, the description of a service user or a service provider. The model is consistent with the CPOV which in turn is based on the W3C Organization Ontology that supports the common cases simply but allows the complex cases where necessary. The Participation class can be mapped to the Organization Ontology's Membership class that allows more complex relationships and richer metadata to be applied to a role filled by a given Agent.
Properties
For this entity the following properties are defined: description, identifier, role.
Property Expected Range Cardinality Definition Usage Codelist
description Text 1..* A free text description of the Participation.
identifier Literal 1 An Identifier for the Participation.
role Code 1..* It provides the role played. This should be provided using a controlled vocabulary. Since this is an extension mechanism for the CSPV-AP, the controlled vocabulary should be decided to suit local implementations.

Public Organization

Definition
An Organization that is defined as being part of the public sector by a legal framework at any level.
Usage
Organizations which exist to provide services for its citizens and companies are called Public Organizations. The Public Organization class represents the organization. One organization may comprise several sub-organizations and any organization may have one or more organizational units. Each of these is described using the same properties and relationships.

This definition is consistent with the more detailed definition of a "public sector body" as given in the PSI Directive: "the State, regional or local authorities, bodies governed by public law and associations formed by one or several such authorities or one or several such bodies governed by public law". It further defines a body governed by public law as any body "(a) established for the specific purpose of meeting needs in the general interest, not having an industrial or commercial character; and (b) having legal personality; and (c) financed, for the most part by the State, or regional or local authorities, or other bodies governed by public law; or subject to management supervision by those bodies; or having an administrative, managerial or supervisory board, more than half of whose members are appointed by the State, regional or local authorities or by other bodies governed by public law".
Subclass of
Organization
Properties
For this entity the following properties are defined: preferred label, spatial.
Property Expected Range Cardinality Definition Usage Codelist
preferred label Text 1 A preferred label is used to provide the primary, legally recognised name of the Public Organization, as defined in the ORG Ontology. Refers to the official or legal name of a Public Organization. An organization may only have one such name in any given language. Primary names may be provided in multiple languages with multiple instances of the preferred label property.
spatial AdministrativeTerritorialUnit 1..* It links an Organization to the Administrative Region(s) that it covers. The value of the properly should be the URI of the region as defined in an authoritative list of regions. In Europe, this is likely to be the Administrative Territorial Units Named Authority List maintained by the Publications Office's Metadata Registry.

The ATU list does not include a geometry. That is, the territory is only identified by its name not its spatial coordinates. This is likely to be the case for similar lists. If geometries are available for the Public Organization's territory, they can be linked from the territorial unit using the Core Location Vocabulary's locn:geometry property.

Public Service

Definition
A Public Service is a mandatory or discretionary set of activities performed, or able to be performed, by or on behalf of a public organisation, publicly funded and arise from public policy.
Usage
This class represents the Public Service itself, as it is described in a public service catalogue. Services may be for the benefit of an individual, a business, or other public authority, or groups of any of these. A service exists whether it is used or not, and the term 'benefit' may apply in the sense of enabling the fulfilment of an obligation. As defined in the revised version of the European Interoperability Framework, a European public service comprises any service provided by public administrations in Europe, or by other organisations on their behalf, to businesses, citizens or others public administrations.
Properties
For this entity the following properties are defined: description, follows, functions of government, has channel, has competent authority, has contact point, has cost, has input, has legal resource, has participation, holds requirement, identifier, is classified by, is described at, is grouped by, keyword, language, name, processing time, produces, related, requires, sector, spatial, status, thematic area.
Property Expected Range Cardinality Definition Usage Codelist
description Text 1..* A free text Description of the Public Service. The description is likely to be the text that potential users of the Public Service see in any public service catalogue. Public administrations are encouraged to include a reasonable level of detail in the description, for instance including basic eligibility requirements for the particular Public Service and contact information.
follows Rule 0..* It links a Public Service to the Rule(s) under which it operates. The definition of the Rule class is very broad. In a typical case, the competent authority that provides the public service will also define the rules that will implement its own policies. The CPSV-AP is flexible to allow for significant variation in such a scenario.
functions of government Code 0..* The purpose of a government activity, which the public service is intended for. The possible values for this property are described in the controlled vocabulary COFOG main activity Authority Table of the Publications Office.
has channel Channel 0..* It links the Public Service to any Channel through which an Agent provides, uses or otherwise interacts with the Public Service, such as an online service, phone number or office.
has competent authority Public Organization 1..* It links a Public Service to a Public Organization, which is the responsible Agent for the delivery of the Public Service. Whether the particular Public Organization provides the public service directly or outsources it is not relevant. The Public Organization that is the Competent Authority of the service is the one that is ultimately responsible for managing and providing the public service. The term Competent Authority is defined in the Services Directive (2006/123/EC) in the following way: "Any body or authority which has a supervisory or regulatory role in a Member State in relation to service activities, including, in particular, administrative authorities, including courts acting as such, professional bodies, and those professional associations or other professional organisations which, in the exercise of their legal autonomy, regulate in a collective manner access to service activities or the exercise thereof".
has contact point Contact Point 0..* The way a Public Service is linked to the class Contact Point. Note that the contact information should be relevant to the Public Service which may not be the same as contact information for the Competent Authority or any Participant.
has cost Cost 0..* It indicates the costs related to the execution of a Public Service for the citizen or business related to the execution of the particular Public Service. Where the cost varies depending on the channel through which the service is accessed, it can be linked to the channel using the If Accessed Through relationship.
has input Evidence 0..* It links a Public Service to one or more instances of the Evidence class. A specific Public Service may require the presence of certain pieces of Evidence in order to be delivered. If the evidence required to make use of a service varies according to the channel through which it is accessed, then Has Input should be at the level of the Channel.
has legal resource Legal Resource 0..* It indicates the Legal Resource (e.g. legislation) to which the Public Service relates, operates or has its legal basis.
has participation Participation 0..* It links a Public Service to the Participation class. The Participation class facilitates the detailed description of how an Agent participates in or interacts with a Public Service and may include temporal and spatial information.
holds requirement Requirement 0..* It links a Public Service to a class that describes the Requirement. Usage: It describes the needing or using the service, such as residency in a given location, being over a certain age etc. The Requirement class is defined in the Core Criterion and Core Evidence Vocabulary.
identifier Literal 1 A formally-issued Identifier for the Public Service.
is classified by Concept 0..* It allows to classify the Public Service with any Concept other than those already foreseen and defined explicitly in the CPSV-AP (Thematic Area, Sector, etc.). It is a generic property which can be further specialised to make the classification explicit, for instance for classifying public services according level of digitisation, type of audience, etc. The Concept is at its turn related to a Collection, which groups the different concepts into a controlled vocabulary.
is described at Dataset 0..* It links a Public Service to the Dataset(s) in which it is being described.
is grouped by Event 0..* It links the Public Service to the Event class. Several Public Services may be associated with a particular Event and, likewise, the same Public Service may be associated with several different Events.
keyword Text 0..* A keyword, term or phrase to describe the Public Service.
language LinguisticSystem 0..* The language(s) in which the Public Service is available. This could be one language or multiple languages, for instance in countries with more than one official language. The recommended controlled vocabularies for this property is the Language Authority Table of the Publications Office.
name Text 1..* The official Name of the Public Service.
processing time Duration 0..1 The (estimated) time needed for executing a Public Service. The actual information is provided using the ISO8601 syntax for durations. Some examples are provided below: Duration Syntax - Syntax 5 years - P5Y 1 month - P1M 3 days - P3D 2 days 4 hours - P2DT4H Durations begin with an uppercase P followed by the number and the relevant designator, formally: P[n]Y[n]M[n]DT[n]H[n]M[n]S, where Y is for years, M for months etc. Note that days and times are separated by an uppercase T which also disambiguates M as meaning month (P2M means 2 months) or minute (PT2M means 2 minutes). Durations may also be defined as a number of weeks so P4W means 4 weeks. A full explanation is provided in the Wikipedia page that references the official ISO standard. This approach is consistent with both schema.org and the W3C OWL Time Ontology.
produces Output 0..* It links a Public Service to one or more instances of the Output class, describing the actual result of executing a given Public Service. Outputs can be any resource, for instance a document, artefact or anything else being produced as a result of executing the Public Service.
related Public Service 0..* A Public Service related to the particular instance of the Public Service class.
requires Public Service 0..* The way a Public Service makes use of other Public Services. One Public Service may require, or in some way make use of, the output of one or several other Public Services. In this case, for a Public Service to be executed, another Public Service must be executed beforehand. The nature of the requirement will be described in the associated Rule or Evidence.
sector Code 0..* The industry or sector a Public Service relates to, or is intended for. For example: environment, safety, housing. Note that a single Public Service may relate to multiple sectors. The possible values for this property are provided as a controlled vocabulary. The possible values for this property are described in the controlled vocabulary Data theme Authority Table of the Publications Office.
spatial Location 0..* A Public Service is likely to be available only within a given area, typically the area covered by a particular public authority. A common usage of the spatial property will be to define the Administrative Territorial Unit(s) - typically a country or region - in which a Public Service is available. The Publications Office of the European Union offers a URI set that is suitable for this purpose. In case the ATU code list is not suitable, NUTS or LAU, NAL Place or Geonames are recommended to use, in that order. If those are still not sufficient, we recommend to define your own code list. N.B. The spatial restriction is not meant to be used to describe eligibility or the speed of operation of the service. These aspects will be covered by the Criterion class.
status Code 0..1 It indicates whether a Public Service is active, inactive, under development etc. according to a controlled vocabulary.
thematic area Code 0..* The Thematic Area of a Public Service as For example: social protection, health, recreation, culture and religion, family, traveling economic affairs, tax, staff, environment, etc.

Requirement

Definition
Condition or prerequisite that is to be proven by Evidence.
Usage
Not all public services are needed or are used by everyone. For example, the visa service operated by European countries is not needed by European citizens but is needed by some citizens from elsewhere, or public services offering unemployment benefits and grants are targeting specific societal groups. The CPSV-AP reuses the Core Criterion and Core Evidence Vocabulary for this class. Requirement is a generic class representing any type of prerequisite that may be desired, needed or imposed as an obligation. CCCEV recommends to not use the Requirement class directly, but rather a more semantically-enriched subclass such as Criterion, Information Requirement or Constraint. Also note that the Requirement class is specified at a more abstract level and is not to be used as the instantiation of a Requirement for a specific Agent. To illustrate the notion: the European Directive on services in the internal market defines requirement as any obligation, prohibition, condition or limit provided for in the laws, regulations or administrative provisions of the Member States or in consequence of case-law, administrative practice, the rules of professional bodies, or the collective rules of professional associations or other professional organisations, adopted in the exercise of their legal autonomy.
Properties
For this entity the following properties are defined: fulfils, has supporting evidence, identifier, name, type.
Property Expected Range Cardinality Definition Usage Codelist
fulfils Rule 0..* The Rules that the requiremens fulfils.
has supporting evidence Evidence 0..* Evidence that supplies information, proof or support for the Requirement.
identifier Literal 1 Unambiguous reference to a Requirement.
name Text 1..* Name of the Requirement.
type Code 0..* Category to which the Requirement belongs.

Rule

Definition
The Rule class represents a document that sets out the specific rules, guidelines or procedures that the Public Service follows.
Usage
It includes the terms of service, licence, and authentication requirements of the Public Service. Instances of the Rule class are FRBR Expressions, that is, a concrete expression such as a document, of the more abstract concept of the rules themselves. The CPSV-AP does not envisage instances of the Rule class as machine-readable business rules. Detailed modelling of the rules related to Public Services is out of scope of the CPSV-AP.
Properties
For this entity the following properties are defined: description, identifier, implements, language, name, type.
Property Expected Range Cardinality Definition Usage Codelist
description Text 1..* A free text Description of the Rule.
identifier Literal 1 An Identifier for the Rule.
implements Legal Resource 0..* It links a Rule to relevant legislation or policy documents i.e. the Legal Resource under which the Rules are being defined.
language LinguisticSystem 0..* The language(s) in which the Rule is available. This could be one or multiple languages, for instance in countries with more than one official language. The recommended controlled vocabularies for this property is the Language Authority Table of the Publications Office.
name Text 1..* The Name of the Rule.
type Code 0..1 Type of Rule. For example: a rule for non-disclosure of a dataset, a rule for disclosure of a dataset, etc.

Changelog w.r.t. previous version

(non-normative)

A changelog describing the (major) changes to the previous version (2.2.1) of the CPSV-AP and the new version that is being proposed in this specification (3.0.0), can be found here.

UML representation

(non-normative)

The UML representation from which this specification has been build is available here.

RDF representation

(non-normative)

A reusable RDF representation (in turtle) for this specification is retrievable here.

JSON-LD context

(non-normative)

A reusable JSON-LD context definition for this specification is retrievable here.

SHACL template

(non-normative)

A reusable SHACL template for this specification is retrievable here.