DE4A Semantic interoperability - Revision history

Anarosa.guzman: Review of IDK

2023-01-20T10:22:34Z

Review of IDK

Anarosa.guzman: review of MOR references

2023-01-20T10:21:06Z

review of MOR references

Anarosa.guzman: Adapted to 2nd iteration

2022-03-23T10:22:30Z

Adapted to 2nd iteration

Thasmee.karunaratne at 15:11, 21 March 2022

2022-03-21T15:11:43Z

Thasmee.karunaratne at 11:29, 21 March 2022

2022-03-21T11:29:24Z

Thasmee.karunaratne at 01:29, 24 February 2022

2022-02-24T01:29:03Z

Thasmee.karunaratne at 14:23, 14 February 2022

2022-02-14T14:23:09Z

Thasmee.karunaratne at 14:17, 14 February 2022

2022-02-14T14:17:59Z

Thasmee.karunaratne at 13:14, 14 February 2022

2022-02-14T13:14:16Z

Thasmee.karunaratne at 11:29, 14 February 2022

2022-02-14T11:29:46Z

@@ Line 38: / Line 38: @@
 * The '''semantic''' aspect refers to the meaning of data elements and the relationship between them. It includes developing vocabularies and schemata to describe data exchanges, and ensures that data elements are understood in the same way by all communicating parties;
 * The '''syntactic''' aspect refers to describing the exact format of the information to be exchanged in terms of grammar and format.
-</blockquote>In this sense, '''semantic interoperability agreements''' need to be set up and manage as part of the interoperability governance and the public service governance. In DE4A, there are concepts and information that need to have a common understanding and the semantic assets of the [[Information Desk]] implement the corresponding semantic interoperability agreements. The main concepts of such agreements and the components that implement them are:
+</blockquote>In this sense, '''semantic interoperability agreements''' need to be set up and manage as part of the interoperability governance and the public service governance. In DE4A, there are concepts and information that need to have a common understanding and the semantic assets of the [[Information Desk]] (IDK) implement the corresponding semantic interoperability agreements. The main concepts of such agreements are:
 * '''[[Canonical Evidence|Canonical evidence type]]''': canonical form for each evidence type that has been identified by the DE4A pilots as relevant for their online procedures. Each canonical evidence type has been designed in a collaborative way between the consuming and issuing authorities and the semantic experts in the DE4A. The full semantic description of the terms that compose each canonical evidence type is available trough the ''[[Multilingual Ontology Repository|DE4A Multilingual Ontology Repository (MOR)]]''. Each canonical evidence type is identified by an URI according to the DE4A policy of identifiers.

@@ Line 44: / Line 44: @@
 * '''Provision''': availability of a data service provided by a ''issuing authority (data owner)'' for issuing a ''canonical evidence type'' (evidence provision) or subscribing to a ''canonical event catalogue'' (subscription provision). For the intermediation pattern, a provision can require some ''additional parameters'' for properly identity the data subject and the registry source of the evidence. Available provisions are located through the ''[[Issuing Authority Locator|DE4A Issuing Authority Locator (IAL)]]'' by specifying at least a canonical evidence type or event catalogue and, optionally, an administrative territorial level or unit where the issuing authority has competences (national, regional, local or educational level or unit). The additional parameters, administrative levels and territorial units are semantically described in the ''[[Multilingual Ontology Repository|DE4A Multilingual Ontology Repository]].''
 * '''Data Service Endpoint''': information for actually use the data service that corresponds to a provision. This information is available through the ''[[DE4A Evidence Service Locator (ESL)]]'', obtaining the data service endpoint information from a issuing authority (data owner) and a document type (either a canonical evidence type or a canonical event catalogue). Besides, the ''DE4A Information Exchange Model (IEM)'' implements the semantic agreement for the exchange of business messages through data services.
-*'''Multilingual/MOR term''': term uniquely identified and defined from the semantic and the syntactic point of view for a common understanding in every EU official language . Labels, descriptions and examples of a term in each language are provided by an automatic translation from English to be verified or corrected by domain experts for each language. The data type of a term can be a simple type (e.g. string) or a complex type; complex types are composed by other simple and/or complex types. Each canonical evidence type, set of additional parameters for a provision and code list are complex types. The full semantic description of all the multilingual terms used in DE4A is available trough the ''[[Multilingual Ontology Repository|DE4A Multilingual Ontology Repository (MOR)]]''.
+*'''MOR term''': term uniquely identified and defined from the semantic and the syntactic point of view in MOR for a common understanding in every EU official language. Labels, descriptions and examples of a MOR term in each language are provided by an automatic translation from English to be verified or corrected by domain experts for each language. The data type of a term can be a simple type (e.g. string) or a complex type; complex types are composed by other simple and/or complex types. Each canonical evidence type, set of additional parameters for a provision and code list are complex types, as well as concepts of core vocabularies and ontologies that are reused for defining other complex types. The full semantic description of all the multilingual terms used in DE4A is available through the ''[[Multilingual Ontology Repository|DE4A Multilingual Ontology Repository (MOR)]]''.
 [[Category:Wip]]

@@ Line 5: / Line 5: @@
 !Description
 !Piloted?
 |-
 |[[DE4A Issuing Authority Locator (IAL)|IAL]]
-|Issuing Authority Locator (IAL) component helps the Data Consumer (DC) to find out the issuing authority that can provide the required evidence within a particular country.
+|Issuing Authority Locator (IAL) component helps the Data Consumer (DC) to find out the issuing authority within a particular country either to obtain a canonical evidence or to subscribe to a canonical event catalogue, and know the characteristics of the provision.
 |Yes
 |-
 |[[DE4A Evidence Service Locator (ESL)|ESL]]
-|Evidence Service Locator (ESL) helps the DC to locate the evidence service able to provide a canonical evidence from a particular competent issuing authority, along with the relevant evidence service characteristics
+|Evidence Service Locator (ESL) helps the DC to obtain the technical details of the evidence service that corresponds to a provision located with the IAL
 |Yes
 |-
 |[[DE4A Cross-border Access Authorisation Registry (CAAR)|CAAR]]
-|Cross-border Access Authorisation Registry (CAAR) is the authorization controller that allows for checking access to specific evidence types initiated by a specific DC to a selected data owner (DO).
+|Cross-border Access Authorisation Registry (CAAR) is the authorization register and controller that allows for checking access to specific provisions initiated by a specific DC for a specific purpose.
 |No
 |-
 |[[DE4A Multilingual Ontology Repository (MOR)|MOR]]
-|Multilingual Ontology Repository (MOR) provides a common understanding of the semantics and syntax of canonical evidence types, additional parameters of provisions, and code lists used for the cross-border evidence exchange, by describing all the terms that compose them.
+|Multilingual Ontology Repository (MOR) provides the semantics and syntax of canonical evidence types, additional parameters of provisions, and code lists used, by defining them and the terms that compose them in a multilingual manner, with the aim to provide a common understanding of each canonical evidence type and multilingual graphical user interfaces for the explicit request, evidence preview and additional parameters functionalities.
 |Yes
 |-
 |[[DE4A Information Exchange Model (IEM)|IEM]]
 |The Information Exchange Model (IEM) provides the payload specification of the messages to be exchanged between competent authorities.
 |Yes
 |}
@@ Line 36: / Line 40: @@
 </blockquote>In this sense, '''semantic interoperability agreements''' need to be set up and manage as part of the interoperability governance and the public service governance. In DE4A, there are concepts and information that need to have a common understanding and the semantic assets of the [[Information Desk]] implement the corresponding semantic interoperability agreements. The main concepts of such agreements and the components that implement them are:
-* '''[[Canonical Evidence|Canonical evidence type]]''': canonical form for each evidence type that has been identified by the DE4A pilots as needed by their online procedures and issued by cross-border authorities. The full semantic description of the terms that compose each canonical evidence type is available trough the ''[[Multilingual Ontology Repository|DE4A Multilingual Ontology Repository (MOR)]]''.
+* '''[[Canonical Evidence|Canonical evidence type]]''': canonical form for each evidence type that has been identified by the DE4A pilots as relevant for their online procedures. Each canonical evidence type has been designed in a collaborative way between the consuming and issuing authorities and the semantic experts in the DE4A. The full semantic description of the terms that compose each canonical evidence type is available trough the ''[[Multilingual Ontology Repository|DE4A Multilingual Ontology Repository (MOR)]]''. Each canonical evidence type is identified by an URI according to the DE4A policy of identifiers.
-* '''Provision''': availability of a data service according to a ''exchange pattern'' for issuing a ''canonical evidence type'' by a ''issuing authority (data owner)'' corresponding to an administrative territorial unit within a country. Each provision can also require some ''additional parameters'' for properly identity the data subject and the evidence. The full semantic description of provisions is available through the ''[[Issuing Authority Locator|DE4A Issuing Authority Locator (IAL)]],'' obtaining the provision information from an administrative territorial level or unit and a canonical evidence type. The additional parameters are semantically described in the ''[[Multilingual Ontology Repository|DE4A Multilingual Ontology Repository]].''
+* '''Canonical event catalogue''': agreement for a group of events regarding an specific topic. Each canonical event catalogue is identified by an URI according to the DE4A policy of identifiers.
-* '''Data Service Endpoint''': information for actually use of the data services that are part of the DE4A evidence exchange system. This information is available through the ''[[DE4A Evidence Service Locator (ESL)]]'', obtaining the data service endpoint information from a issuing authority (data owner) and a canonical evidence type. Besides, the ''DE4A Information Exchange Model (IEM)'' implements the semantic agreement for the exchange of business messages through the data services.
+* '''Provision''': availability of a data service provided by a ''issuing authority (data owner)'' for issuing a ''canonical evidence type'' (evidence provision) or subscribing to a ''canonical event catalogue'' (subscription provision). For the intermediation pattern, a provision can require some ''additional parameters'' for properly identity the data subject and the registry source of the evidence. Available provisions are located through the ''[[Issuing Authority Locator|DE4A Issuing Authority Locator (IAL)]]'' by specifying at least a canonical evidence type or event catalogue and, optionally, an administrative territorial level or unit where the issuing authority has competences (national, regional, local or educational level or unit). The additional parameters, administrative levels and territorial units are semantically described in the ''[[Multilingual Ontology Repository|DE4A Multilingual Ontology Repository]].''
-* '''Multilingual term''': term uniquely identified and semantically described from the semantic and the syntactic point of view for a common understanding. The meaning of a term is described in every EU official language through automatic translations from English or translations verified by national domain experts. The data type of a term can be a simple type (e.g. string) or a complex type; complex types are compose by other simple and/or complex types. A special complex type is either a canonical evidence type, or a set of additional parameters for a provision or a code list. The full semantic description of all the terms used in DE4A is available trough the ''[[Multilingual Ontology Repository|DE4A Multilingual Ontology Repository (MOR)]]''.
+* '''Data Service Endpoint''': information for actually use the data service that corresponds to a provision. This information is available through the ''[[DE4A Evidence Service Locator (ESL)]]'', obtaining the data service endpoint information from a issuing authority (data owner) and a document type (either a canonical evidence type or a canonical event catalogue). Besides, the ''DE4A Information Exchange Model (IEM)'' implements the semantic agreement for the exchange of business messages through data services.
 [[Category:Wip]]

@@ Line 1: / Line 1: @@
-[[File:De4aSem.png|none|thumb|600x600px|DE4A Semantic Interoperability Framework]]
+The framework and the semantic components of the semantic layer of the DE4A technical system is described in this wiki page and the subsequent pages.
 {| class="wikitable"
-|+Title
+|+[[File:De4a Semantic Interoperability Framework.png|none|thumb|600x600px|DE4A Semantic Interoperability Framework]]Title
 !Component
 !Description
@@ Line 7: / Line 7: @@
 |-
 |[[DE4A Issuing Authority Locator (IAL)|IAL]]
 |Issuing Authority Locator (IAL) component helps the Data Consumer (DC) to find out the issuing authority that can provide the required evidence within a particular country.
 |Yes
 |-
@@ Line 15: / Line 15: @@
 |-
 |[[DE4A Cross-border Access Authorisation Registry (CAAR)|CAAR]]
 |Cross-border Access Authorisation Registry (CAAR) is the authorization controller that allows for checking access to specific evidence types initiated by a specific DC to a selected data owner (DO).
 |No
 |-
 |[[DE4A Multilingual Ontology Repository (MOR)|MOR]]
 |Multilingual Ontology Repository (MOR) provides a common understanding of the semantics and syntax of canonical evidence types, additional parameters of provisions, and code lists used for the cross-border evidence exchange, by describing all the terms that compose them.
 |Yes
 |-
 |[[DE4A Information Exchange Model (IEM)|IEM]]
 |The Information Exchange Model (IEM) provides the payload specification of the messages to be exchanged between competent authorities.
 |Yes
 |-
 |[[Canonical Evidence]]
 |Canonical Evidence is the ''canonical form of domestic evidence according to a common data structure and format''. DE4A has defined a canonical form for each of the evidence types required by the procedures involved in the cross-border evidence exchange.
 |Yes
 |}

@@ Line 1: / Line 1: @@
-<<insert high-level diagram>>
+[[File:De4aSem.png|none|thumb|600x600px|DE4A Semantic Interoperability Framework]]
 {| class="wikitable"
 |+Title

← Older revision		Revision as of 14:17, 14 February 2022
Line 33:		Line 33:
	* '''Data Service Endpoint''': information for actually use of the data services that are part of the DE4A evidence exchange system. This information is available through the ''[[DE4A Evidence Service Locator (ESL)]]'', obtaining the data service endpoint information from a issuing authority (data owner) and a canonical evidence type. Besides, the ''DE4A Information Exchange Model (IEM)'' implements the semantic agreement for the exchange of business messages through the data services.		* '''Data Service Endpoint''': information for actually use of the data services that are part of the DE4A evidence exchange system. This information is available through the ''[[DE4A Evidence Service Locator (ESL)]]'', obtaining the data service endpoint information from a issuing authority (data owner) and a canonical evidence type. Besides, the ''DE4A Information Exchange Model (IEM)'' implements the semantic agreement for the exchange of business messages through the data services.
	* '''Multilingual term''': term uniquely identified and semantically described from the semantic and the syntactic point of view for a common understanding. The meaning of a term is described in every EU official language through automatic translations from English or translations verified by national domain experts. The data type of a term can be a simple type (e.g. string) or a complex type; complex types are compose by other simple and/or complex types. A special complex type is either a canonical evidence type, or a set of additional parameters for a provision or a code list. The full semantic description of all the terms used in DE4A is available trough the ''[[Multilingual Ontology Repository\|DE4A Multilingual Ontology Repository (MOR)]]''.		* '''Multilingual term''': term uniquely identified and semantically described from the semantic and the syntactic point of view for a common understanding. The meaning of a term is described in every EU official language through automatic translations from English or translations verified by national domain experts. The data type of a term can be a simple type (e.g. string) or a complex type; complex types are compose by other simple and/or complex types. A special complex type is either a canonical evidence type, or a set of additional parameters for a provision or a code list. The full semantic description of all the terms used in DE4A is available trough the ''[[Multilingual Ontology Repository\|DE4A Multilingual Ontology Repository (MOR)]]''.
		+	[[Category:Wip]]