DE4A - User contributions [en-gb]

Canonical Evidence

2023-01-19T22:28:14Z

Ioannis.konstantinidis: Added link and description to WorkingLifeMeansOfLivingEvidence

'''Canonical Evidence''' is the ''canonical form of a 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. Since canonical evidence is not lawfully issued evidence, issuing authorities should provide both domestic and canonical evidence and they are responsible for the accuracy of the matching between canonical and domestic evidences. In this way, canonical evidence is aimed at the automated processing of cross-border and domestic evidence for legal audits at a regular basis or at the request of interested parties. This approach follows the logic behind the multilingual standard forms set by the [https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX%3A32016R1191 Regulation 2016/1191] on Public documents.

The canonical form for each evidence type that has been identified is called '''canonical evidence type''' and these types are essential for the [[semantic interoperability]] of cross-border evidence, since they provide agreements on concepts, meanings, languages and ways to represent the information.

{| class="wikitable"
|+Canonical evidence types defined in the scope of the DE4A Project
!ID
!Name
!Description
!DE4A Pilot: Use Cases
|-
|[[Company Registration Canonical Evidence|CompanyRegistration]]
| Proof of Company Registration
|The evidence exchanged across-border in the event of starting a business in another EU Member State.
|[[Use Case "Starting a Business in Another Member State" (DBA UC1)|DBA UC1]]
|-
|[[Higher Education Diploma Canonical Evidence|HigherEducationDiploma]]
| Proof of Completion of Higher Education
|Represents all pertinent aspects of CE for applying to public higher education
|[[Use Case "Application to Public Higher Education" (SA UC1)|SA UC1]]
|-
|[[Secondary Education Diploma Canonical Evidence|SecondaryEducationDiploma]]
|Proof of completion of Secondary Education
|Represents all pertinent aspects of CE for applying to public secondary education
|[[Use Case "Application to Public Higher Education" (SA UC1)|SA UC1]]
|-
|[[Disability Canonical Evidence|DisabilityEvidence]]
|Proof of DisabilityEvidenceType
|This evidence serve the purpose of proving a proof that the student suffer from a disability for deciding on if a student is entitled for study grant
|[[Studying Abroad Pilot|SA UC2]]
|-
|[[Disability Canonical Evidence|LargeFamilyEvidence]]
|Proof of a Large Family
|Evidence for proof of that the student is a member of a large family
|[[Studying Abroad Pilot|SA UC2]]
|-
|[[Domicile Registration Canonical Evidence|DomicileRegistrationEvidence]]
|Proof of Domicile Registration
|Evidence for registering a domicile abroad.
|[[Use Case "Request Address Change" (MA UC1)|MA UC1]]
|-
|[[Domicile Deregistration Canonical Evidence|DomicileDeregistrationEvidence]]
|Proof of Domicile Deregistration
|Evidence for removing the registration when the person is registered in another country
|[[Use Case "Request Address Change" (MA UC1)|MA UC1]]
|-
|[[Birth Canonical Evidence|BirthEvidence]]
|Proof of Birth
|Official document or data proving the Birth of a Child.
|[[Use Case "Request an Extract or Copy of a Civil State Certificate" (MA UC2)|MA UC2]]
|-
|[[Marriage Canonical Evidence|MarriageEvidence]]
|Proof of Marriage
|Official document or data proving the Marriage of two Persons.
|[[Use Case "Request an Extract or Copy of a Civil State Certificate" (MA UC2)|MA UC2]]
|-
|[[Pension Means of Living Canonical Evidence|PensionMeansOfLivingEvidence]]
|Proof of Pension means of Living
|The evidence holds information on the pension benefits.
|[[Moving Abroad Pilot|MA UC3]]
|-
|[[Unemployment Means Of Living Canonical Evidence|UnemploymentMeansOfLivingEvidence]]
|Proof of pension by unemployment
|The evidence holds information on unemployment benefits.
|[[Moving Abroad Pilot|MA UC3]]
|-
|[[Working Life Means Of Living Canonical Evidence|WorkingLifeMeansOfLivingEvidence]]
|Proof of working life as a pension
|The evidence holds information on the working life benefits.
|[[Moving Abroad Pilot|MA UC3]]
|}

Canonical evidence types are implemented according to '''common data models''' that are defined from '''domain-specific ontologies''', which reuse existing ''standard agnostic and specific vocabularies, code lists and data models''. Canonical evidence types and common data models are defined according to agreements reached by involved authorities; in the case of the DE4A project, the agreements have been reached by the participants in the DE4A pilot use cases.

[[File:Domain-ontologies-reuse-standards.png|alt=Example of domain-specific ontologies by reusing ISA2 standards|none|thumb|622x622px]]

[[File:Evidence-data-model.png|alt=Example of common data models from domain-specific ontologies|Example of common data models from Personal-Life ontology for two canonical evidence types|none|frame]]

The terms of each canonical evidence type are described in detail in the [[Multilingual Ontology Repository]] in order to allow competent authorities to perform the necessary tasks for mapping their domestic evidence with the corresponding canonical form with an accuracy matching between them.

==Methodology for Modelling Canonical Evidences==
The canonical evidences development process is consisted of the three stages illustrated in Figure below. The process is following an incremental development methodology under agile principles. Hence, in this setting, the WP leader plays the role of the product owner, working in a technical working group with the other two technical works packages, WP4 “[[Pilots|Cross-border Pilots for Citizens and Business and Evaluation]]” and WP5 “[[Library of components and building blocks|Common Component Design & Development]]”, following the same development cycles, as described in the DE4A grant agreement. The canonical evidences are co-created together with the users (the piloting member states), allowing the data models created to best fit the requirements of each member state piloting the evidence exchange. The key stages of the process include elicitation, development and evaluation of the data models.

[[File:D3.5_-_Page_3_(1).png|alt=|frameless|400x400px]]

Accordingly, the preliminary data models are designed based on the existing resources in Stage 1 of the process. The primary models are tested with the piloting member state for model accuracy with respect to the attributes, cardinalities and the affordances of existing vocabularies and code lists. This was an iterative process followed by close dialogue with the respective pilot teams. The XML schemas for the models are developed in Stage 2 in close collaboration with the pilot partners and finally the schemas are validated with the support of WP5 “[[Library of components and building blocks|Common Component Design & Development]]” during the integration into the technical system.
[[Category:Wip]]

Working Life Means Of Living Canonical Evidence

2023-01-19T22:26:35Z

Ioannis.konstantinidis: Added info into WorkingLifeMOL CE page

==Description==
This evidence contains elements related to the Working Life Means of Living Evidence. The Canonical Evidence in [[Use Case "Request Pension Information - Claim Pension" (MA UC3)]].

== XSD ==
XSD files can be found on the [https://github.com/de4a-wp3/moving_abroad GitHub repository].

==Diagram==
[[File:WorkingLifeMeansOfLivingEvidence-0.1.png|alt=|center|1038x1038px]]

==Attribute Specification==
{| class="wikitable"
!DE4A name
!Property type
!Cardinality
!Data type
!Related vocabulary
!Controlled Vocabulary
!Definition
|-
|'''WorkingLifeMeansOfLivingEvidence'''
|'''Class'''
|
|
|
|
|
|-
|Identifier
|Object
|[0..1]
|Identifier
|cva:Cvidentifier
|
|An unambiguous reference to the Working Life Means of Living Evidence
|-
|IssueDate
|Datatype
|[1..1]
|Date
|udt:Date
|
|The most recent date on which the Working Life Means of Living Evidence instance was issued.
|-
|IssuingAuthority
|Object
|[1..1]
|PublicOrganisation
|
|
|A Public Organisation with official authority in charge of issuing the Working Life Means of Living Evidence.
|-
|Certifies
|Object
|[1..1]
|WorkingLifeMeansOfLivingInfo
|
|
|Attesting in a formal way that the Working Life data is true.
|-
|'''PublicOrganisation'''
|'''Class'''
|
|
|
|
|'''Any organisation that is defined as being part of the public sector by a legal framework at any level.'''
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|Many organisations are referred to by an acronym or some other identifier. For example, among the EU institutions, the ECB is the identifier for the European Central Bank, OLAF for the European AntiN/AFraud Office, and so on. These are formally recognised by the European Commission which provides a list of such acronyms. Analogous lists should be used in other contexts.
|-
|PrefLabel
|Datatype
|[1..*]
|Text
|udt:Text
|
|As defined in the ORG Ontology, a preferred label is used to provide the primary, legally recognised name of the organisation. An organisation 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.
|-
|'''WorkingLifeMeansOfLivingInfo'''
|'''Class'''
|
|
|
|
|'''Information on different working life benefits'''
|-
|DataSubject
|Object
|[1..1]
|Person
|
|
|The person who is subject to this information
|-
|WorkingLife
|Object
|[0..1]
|WorkingLife
|
|
|Working life of the citizen
|-
|'''WorkingLife'''
|'''Class'''
|
|
|
|
|'''Working life of the citizen'''
|-
|SituationsList
|Object
|[0..1]
|SituationsList
|
|
|Contains the list of situations of the consulted citizen.
|-
|'''SituationsList'''
|'''Class'''
|
|
|
|
|'''Contains the list of situations of the consulted citizen.'''
|-
|Situation
|Object
|[1..*]
|Situation
|
|
|Contains the data of each situation of the consulted citizen.
|-
|'''Situation'''
|'''Class'''
|
|
|
|
|'''Contains the data of each situation of the consulted citizen.'''
|-
|SocialSecurityNumber
|Object
|[1..1]
|Identifier
|
|
|Social security number of the situation returned.
|-
|Status
|Datatype
|[1..1]
|StatusTypeEnum
|
|
|Status of the benefit.
The possible values are:
• ACTIVE: the citizen is receiving the unemployment benefit
• NON-ACTIVE: the citizen is not receiving the unemployment benefit
• NON-ACTIVE due to APRE (APRE: "Cumulative and early payment of contributory unemployment benefit to foreign workers returning to their country of origin")
• NON-ACTIVE when the benefit has been capitalised
|-
|PeriodOfTime
|Object
|[1..1]
|PeriodOfTime
|
|
|Period of work activity. It includes:
• Date of start of work activity.
• Date from which the registration takes effect for the purposes of entitlement to the benefits of the Social Security system, except for benefits resulting from accidents at work and occupational diseases, unemployment and health care resulting from common illness, maternity and non-occupational accidents, in which case the effective date of registration coincides, in any case, with the date of employment.
• Date of termination of employment.
|-
|ContractType
|Datatype
|[1..1]
|ContractTypeEnum
|
|
|Identifier of the employment contract. The list of contract types is available in tab "Contract types".
|-
|'''PeriodOfTime'''
|'''Class'''
|
|
|
|
|'''Period of time'''
|-
|StartDate
|Datatype
|[0..1]
|Date
|udt:Date
|
|Effective start date of a period time. The format is YYYY-MM-DD
|-
|EndDate
|Datatype
|[0..1]
|Date
|udt:Date
|
|Expected end date or effective end date in case of suspension/cancellation/finish. The format is YYYY-MM-DD
|-
|'''Person'''
|'''Class'''
|
|
|
|
|'''An individual natural person who may be dead or alive, but not imaginary.'''
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|The identifier relation is used to link a Person to any formally issued Identifier for that Person.
|-
|SocialSecurityNumber
|Datatype
|[1..*]
|Identifier
|cva:Cvidentifier
|
|Social Security numbers of the consulted citizen. Up to 10 numbers can be returned, althoug citizens usually have only one Social Security number, but there are also cases with multiple social security numbers.
|-
|PersonName
|Object
|[1..1]
|Name
|
|
|The family name and given name of a Person. At least one of the two must exist.
|-
|DateOfBirth
|Object
|[1..1]
|DateObject
|
|
|The day on which the Person was born.
|-
|'''DateObject'''
|'''Class'''
|
|
|
|
|'''Structured representation of date with year, month and day of the month.'''
|-
|Year
|Datatype
|[0..1]
|Year
|xsd:gYear
|
|A gregorian calendar year. The value space of Year is the set of Gregorian calendar years as defined in § 5.2.1 of ISO 8601. Specifically, it is a set of one-year long, non-periodic instances e.g. lexical 1999 to represent the whole year 1999, independent of how many months and days this year has.
|-
|Month
|Datatype
|[0..1]
|Month
|xsd:gMonth
|
|A gregorian month that recurs every year. The value space of Month is the space of a set of calendar months as defined in § 3 of ISO 8601. Specifically, it is a set of one-month long, yearly periodic instances.
|-
|Day
|Datatype
|[0..1]
|Day
|xsd:gDay
|
|A gregorian day that recurs, specifically a day of the month such as the 5th of the month. The value space of Day is the space of a set of calendar dates as defined in § 3 of ISO 8601. Specifically, it is a set of one-day long, monthly periodic instances.
|-
|'''Name'''
|'''Class'''
|
|
|
|
|'''A name of a person that includes the family and given name.'''
|-
|FamilyName
|Datatype
|[0..*]
|Text
|cbc:FamilyName
|
|A family name is usually shared by members of a family. 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 field so that, for example, Miguel de Cervantes Saavedra's Family Name would be recorded as "de Cervantes Saavedra".
|-
|GivenName
|Datatype
|[0..*]
|Text
|cvb:GivenName
|
|A given name, or multiple given names, are the denominator(s) that identify an individual within a family. These are given to a Person by his or her parents at birth or may be legally recognised as 'given names' through a formal process. All given names are ordered in one field so that, for example, the given name for Johann Sebastian Bach is 'Johann Sebastian'.
|}

File:WorkingLifeMeansOfLivingEvidence-0.1.png

2023-01-19T22:20:33Z

Ioannis.konstantinidis:

uml diagram

Working Life Means Of Living Canonical Evidence

2023-01-19T22:19:12Z

Ioannis.konstantinidis: Created page with "==Description== This evidence contains elements related to the Domicile Deregistration Evidence. The Canonical Evidence in Use Case "Request Address Change" (MA UC1). ==..."

==Description==
This evidence contains elements related to the Domicile Deregistration Evidence. The Canonical Evidence in [[Use Case "Request Address Change" (MA UC1)]].

== XSD ==
XSD files can be found on the [https://github.com/de4a-wp3/moving_abroad GitHub repository].

==Diagram==
[[File:DomicileDeregistrationEvidence-UML-1.7.drawio.png|alt=|center]]

==Attribute Specification==
{| class="wikitable"
|+
!DE4A name
!Property type
!Cardinality
!Data type
!Related Vocabulary
!Controlled vocabulary
!Definition
|-
|'''DomicileRegistrationEvidence'''
|'''Class'''
|
|
|
|
|'''This class contains elements related to the Domicile Registration Evidence.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cva:Cvidentifier
|
|An unambiguous reference to the Domicile Registration Evidence.
|-
|IssueDate
|Datatype
|[1..1]
|Date
|udt:Date
|
|The most recent date on which the Domicile Registration Evidence instance was issued.
|-
|IssuingAuthority
|Object
|[1..1]
|PublicOrganisation
|
|
|A Public Organisation with official authority in charge of issuing the Domicile Registration Evidence.
|-
|IssuingPlace
|Object
|[1..1]
|LocationAddress
|
|
|The location address where the Domicile Registration Evidence was issued.
|-
|CertifiesDomicile
|Object
|[1..1]
|Domicile
|
|
|Attesting in a formal way that the Domicile is true.
|-
|'''PublicOrganisation'''
|'''Class'''
|
|
|
|
|'''Any organisation that is defined as being part of the public sector by a legal framework at any level.'''
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|Many organisations are referred to by an acronym or some other identifier. For example, among the EU institutions, the ECB is the identifier for the European Central Bank, OLAF for the European Anti-Fraud Office, and so on. These are formally recognised by the European Commission which provides a list of such acronyms. Analogous lists should be used in other contexts.
|-
|PrefLabel
|Datatype
|[1..*]
|Text
|udt:Text
|
|As defined in the ORG Ontology, a preferred label is used to provide the primary, legally recognised name of the organisation. An organisation 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.
|-
|'''Domicile'''
|'''Class'''
|
|
|
|
|'''This class contains elements related to the domicile'''
|-
|Inhabitant
|Object
|[1..1]
|Person
|
|
|Person, living in the residence or domicile
|-
|Domicile
|Object
|[1..1]
|ConstrainedLocationAddress
|
|
|Current domicile inhabited by person
|-
|'''Person'''
|'''Class'''
|
|
|
|
|'''An individual natural person who may be dead or alive, but not imaginary.'''
|-
|PersonName
|Object
|[1..1]
|Name
|
|
|The family name and given name of a Person. At least one of the two must exist.
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|The identifier relation is used to link a Person to any formally issued Identifier for that Person.
|-
|DateOfBirth
|Object
|[0..1]
|DateObject
|
|
|The day on which the person was born.
|-
|Gender
|Datatype
|[0..1]
|Code
|udt:Code
|Human Sex
|The chromosomal state, and reproductive organs and structures of a Person that allows them to be distinguished as female or male or not applicable, not known or not stated.
|-
|MaritalStatus
|Datatype
|[0..1]
|Code
|udt:Code
|Marital Status
|An indicator of the marital status
|-
|PlaceOfBirth
|Object
|[0..1]
|LocationAddress
|
|
|The Location where the person was born
|-
|Citizenship
|Object
|[0..*]
|Jurisdiction
|
|
|The citizenship relationship links a Person to a Jurisdiction that has conferred citizenship rights on the individual such as the right to vote, to receive certain protection from the community or the issuance of a passport.
|-
|'''Jurisdiction'''
|'''Class'''
|
|
|
|
|'''The authority that an official organisation has, to make legal decisions about somebody/something.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cvb:JurisdictionID
|
|The value for the id property is a URI for that Jurisdiction.
|-
|Name
|Datatype
|[1..*]
|Text
|cbc:Name
|
|The name is simply a string that identifies the Jurisdiction, typically a country, with or without a language tag.
|-
|'''ConstrainedLocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of a location based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[1..1]
|Text
|cvb:AdminunitSecondline
|NUTS/LAU
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[1..1]
|Text
|cvb:AdminunitFirstline
|Country
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''LocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of the place of birth based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[0..1]
|Text
|cvb:AdminunitSecondline
|
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[0..1]
|Text
|cvb:AdminunitFirstline
|Country
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''Address'''
|'''Class'''
|
|
|
|
|'''Representation of address based on the INSPIRE Address Representation.'''
|-
|PoBox
|Datatype
|[0..1]
|Text
|cvb:PoBox
|
|The Post Office Box 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.
|-
|Thoroughfare
|Datatype
|[0..1]
|Text
|cvb:Thoroughfare
|
|Quoting from the INSPIRE guidelines, a thoroughfare is: "an address component that represents the name of a passage or way through from one location to another. A thoroughfare is not necessarily a road, it might be a waterway or some other feature.
|-
|LocatorDesignator
|Datatype
|[0..1]
|Text
|cvb:LocatorDesignator
|
|The locator designator is defined by the INSPIRE guidelines as "a number or a sequence of characters that uniquely identifies the locator within the relevant scope(s). The full identification of the locator could include one or more locator designators." 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."
|-
|LocatorName
|Datatype
|[0..1]
|Text
|cvb:LocatorName
|
|Based on the INSPIRE guidelines, locator name is defined as: "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.
|-
|AddressArea
|Datatype
|[0..1]
|Text
|cvb:CvaddressArea
|
|Taking the definition from INSPIRE, the address area is: 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.
|-
|PostName
|Datatype
|[0..1]
|Text
|cvb:PostName
|
|The key postal division of the address, usually the city. (INSPIRE's definition is "One or more names created and maintained for postal purposes to identify a subdivision of addresses and postal delivery points.)
|-
|PostCode
|Datatype
|[0..1]
|Text
|cvb:PostCode
|
|The post code (a.k.a postal code, zip code etc.). Post codes are common elements in many countries' postal address systems.
|-
|'''Name'''
|'''Class'''
|
|
|
|
|'''A name of a person that includes the family and given name.'''
|-
|FamilyName
|Datatype
|[0..*]
|Text
|cbc:FamilyName
|
|A family name is usually shared by members of a family. 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 field so that, for example, Miguel de Cervantes Saavedra's Family Name would be recorded as "de Cervantes Saavedra".
|-
|GivenName
|Datatype
|[0..*]
|Text
|cvb:GivenName
|
|A given name, or multiple given names, are the denominator(s) that identify an individual within a family. These are given to a Person by his or her parents at birth or may be legally recognised as 'given names' through a formal process. All given names are ordered in one field so that, for example, the given name for Johann Sebastian Bach is 'Johann Sebastian'.
|-
|'''DateObject'''
|'''Class'''
|
|
|
|
|'''Structured representation of date with year, month and day of the month.'''
|-
|Year
|Datatype
|[0..1]
|Year
|xsd:gYear
|
|A gregorian calendar year. The value space of Year is the set of Gregorian calendar years as defined in § 5.2.1 of ISO 8601. Specifically, it is a set of one-year long, non-periodic instances e.g. lexical 1999 to represent the whole year 1999, independent of how many months and days this year has.
|-
|Month
|Datatype
|[0..1]
|Month
|xsd:gMonth
|
|A gregorian month that recurs every year. The value space of Month is the space of a set of calendar months as defined in § 3 of ISO 8601. Specifically, it is a set of one-month long, yearly periodic instances.
|-
|Day
|Datatype
|[0..1]
|Day
|xsd:gDay
|
|A gregorian day that recurs, specifically a day of the month such as the 5th of the month. The value space of Day is the space of a set of calendar dates as defined in § 3 of ISO 8601. Specifically, it is a set of one-day long, monthly periodic instances.
|}

Canonical Evidence

2023-01-19T22:16:37Z

Ioannis.konstantinidis: Added link and description to UnemploymentMeansOfLivingEvidence

'''Canonical Evidence''' is the ''canonical form of a 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. Since canonical evidence is not lawfully issued evidence, issuing authorities should provide both domestic and canonical evidence and they are responsible for the accuracy of the matching between canonical and domestic evidences. In this way, canonical evidence is aimed at the automated processing of cross-border and domestic evidence for legal audits at a regular basis or at the request of interested parties. This approach follows the logic behind the multilingual standard forms set by the [https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX%3A32016R1191 Regulation 2016/1191] on Public documents.

The canonical form for each evidence type that has been identified is called '''canonical evidence type''' and these types are essential for the [[semantic interoperability]] of cross-border evidence, since they provide agreements on concepts, meanings, languages and ways to represent the information.

{| class="wikitable"
|+Canonical evidence types defined in the scope of the DE4A Project
!ID
!Name
!Description
!DE4A Pilot: Use Cases
|-
|[[Company Registration Canonical Evidence|CompanyRegistration]]
| Proof of Company Registration
|The evidence exchanged across-border in the event of starting a business in another EU Member State.
|[[Use Case "Starting a Business in Another Member State" (DBA UC1)|DBA UC1]]
|-
|[[Higher Education Diploma Canonical Evidence|HigherEducationDiploma]]
| Proof of Completion of Higher Education
|Represents all pertinent aspects of CE for applying to public higher education
|[[Use Case "Application to Public Higher Education" (SA UC1)|SA UC1]]
|-
|[[Secondary Education Diploma Canonical Evidence|SecondaryEducationDiploma]]
|Proof of completion of Secondary Education
|Represents all pertinent aspects of CE for applying to public secondary education
|[[Use Case "Application to Public Higher Education" (SA UC1)|SA UC1]]
|-
|[[Disability Canonical Evidence|DisabilityEvidence]]
|Proof of DisabilityEvidenceType
|This evidence serve the purpose of proving a proof that the student suffer from a disability for deciding on if a student is entitled for study grant
|[[Studying Abroad Pilot|SA UC2]]
|-
|[[Disability Canonical Evidence|LargeFamilyEvidence]]
|Proof of a Large Family
|Evidence for proof of that the student is a member of a large family
|[[Studying Abroad Pilot|SA UC2]]
|-
|[[Domicile Registration Canonical Evidence|DomicileRegistrationEvidence]]
|Proof of Domicile Registration
|Evidence for registering a domicile abroad.
|[[Use Case "Request Address Change" (MA UC1)|MA UC1]]
|-
|[[Domicile Deregistration Canonical Evidence|DomicileDeregistrationEvidence]]
|Proof of Domicile Deregistration
|Evidence for removing the registration when the person is registered in another country
|[[Use Case "Request Address Change" (MA UC1)|MA UC1]]
|-
|[[Birth Canonical Evidence|BirthEvidence]]
|Proof of Birth
|Official document or data proving the Birth of a Child.
|[[Use Case "Request an Extract or Copy of a Civil State Certificate" (MA UC2)|MA UC2]]
|-
|[[Marriage Canonical Evidence|MarriageEvidence]]
|Proof of Marriage
|Official document or data proving the Marriage of two Persons.
|[[Use Case "Request an Extract or Copy of a Civil State Certificate" (MA UC2)|MA UC2]]
|-
|[[Pension Means of Living Canonical Evidence|PensionMeansOfLivingEvidence]]
|Proof of Pension means of Living
|The evidence holds information on the pension benefits.
|[[Moving Abroad Pilot|MA UC3]]
|-
|[[Unemployment Means Of Living Canonical Evidence|UnemploymentMeansOfLivingEvidence]]
|Proof of pension by unemployment
|The evidence holds information on unemployment benefits.
|[[Moving Abroad Pilot|MA UC3]]
|-
|WorkingLifeMeansOfLivingEvidence
|Proof of working life as a pension
|
|[[Moving Abroad Pilot|MA UC3]]
|}

Canonical evidence types are implemented according to '''common data models''' that are defined from '''domain-specific ontologies''', which reuse existing ''standard agnostic and specific vocabularies, code lists and data models''. Canonical evidence types and common data models are defined according to agreements reached by involved authorities; in the case of the DE4A project, the agreements have been reached by the participants in the DE4A pilot use cases.

[[File:Domain-ontologies-reuse-standards.png|alt=Example of domain-specific ontologies by reusing ISA2 standards|none|thumb|622x622px]]

[[File:Evidence-data-model.png|alt=Example of common data models from domain-specific ontologies|Example of common data models from Personal-Life ontology for two canonical evidence types|none|frame]]

The terms of each canonical evidence type are described in detail in the [[Multilingual Ontology Repository]] in order to allow competent authorities to perform the necessary tasks for mapping their domestic evidence with the corresponding canonical form with an accuracy matching between them.

==Methodology for Modelling Canonical Evidences==
The canonical evidences development process is consisted of the three stages illustrated in Figure below. The process is following an incremental development methodology under agile principles. Hence, in this setting, the WP leader plays the role of the product owner, working in a technical working group with the other two technical works packages, WP4 “[[Pilots|Cross-border Pilots for Citizens and Business and Evaluation]]” and WP5 “[[Library of components and building blocks|Common Component Design & Development]]”, following the same development cycles, as described in the DE4A grant agreement. The canonical evidences are co-created together with the users (the piloting member states), allowing the data models created to best fit the requirements of each member state piloting the evidence exchange. The key stages of the process include elicitation, development and evaluation of the data models.

[[File:D3.5_-_Page_3_(1).png|alt=|frameless|400x400px]]

Accordingly, the preliminary data models are designed based on the existing resources in Stage 1 of the process. The primary models are tested with the piloting member state for model accuracy with respect to the attributes, cardinalities and the affordances of existing vocabularies and code lists. This was an iterative process followed by close dialogue with the respective pilot teams. The XML schemas for the models are developed in Stage 2 in close collaboration with the pilot partners and finally the schemas are validated with the support of WP5 “[[Library of components and building blocks|Common Component Design & Development]]” during the integration into the technical system.
[[Category:Wip]]

Unemployment Means Of Living Canonical Evidence

2023-01-19T22:14:37Z

Ioannis.konstantinidis: Added UnemploymentMeansOfLiving Canonical Evidence information.

==Description==
This evidence contains elements related to the Unemployment Means of Living Evidence. The Canonical Evidence in [[Use Case "Request Pension Information - Claim Pension" (MA UC3)|Use Case "Request Pension Information - Claim Pension" (MA UC3]]).

== XSD ==
XSD files can be found on the [https://github.com/de4a-wp3/moving_abroad GitHub repository].

==Diagram==
[[File:UnemploymentMeansOfLivingEvidence-0.1.png|alt=|center|871x871px]]

==Attribute Specification==
{| class="wikitable"
!DE4A name
!Property type
!Cardinality
!Data type
!Related vocabulary
!Controlled Vocabulary
!Definition
|-
|'''UnemploymentMeansOfLivingEvidence'''
|'''Class'''
|
|
|
|
|
|-
|Identifier
|Object
|[0..1]
|Identifier
|cva:Cvidentifier
|
|An unambiguous reference to the Unemployment Means of Living Evidence
|-
|IssueDate
|Datatype
|[1..1]
|Date
|udt:Date
|
|The most recent date on which the Unemployment Means of Living Evidence instance was issued.
|-
|IssuingAuthority
|Object
|[1..1]
|PublicOrganisation
|
|
|A Public Organisation with official authority in charge of issuing the Unemployment Means of Living Evidence.
|-
|Certifies
|Object
|[1..1]
|UnemploymentMeansOfLivingInfo
|
|
|Attesting in a formal way that the Unemployment data is true.
|-
|'''PublicOrganisation'''
|'''Class'''
|
|
|
|
|'''Any organisation that is defined as being part of the public sector by a legal framework at any level.'''
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|Many organisations are referred to by an acronym or some other identifier. For example, among the EU institutions, the ECB is the identifier for the European Central Bank, OLAF for the European AntiN/AFraud Office, and so on. These are formally recognised by the European Commission which provides a list of such acronyms. Analogous lists should be used in other contexts.
|-
|PrefLabel
|Datatype
|[1..*]
|Text
|udt:Text
|
|As defined in the ORG Ontology, a preferred label is used to provide the primary, legally recognised name of the organisation. An organisation 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.
|-
|'''UnemploymentMeansOfLivingInfo'''
|'''Class'''
|
|
|
|
|'''Information on unemployment benefits'''
|-
|DataSubject
|Object
|[1..1]
|Person
|
|
|The person who is subject to this information
|-
|UnemploymentData
|Object
|[0..1]
|UnemploymentData
|
|
|Current unemployment data of the citizen
|-
|'''UnemploymentData'''
|'''Class'''
|
|
|
|
|'''One of the two Persons who are jointly the cause of the Child's Birth, i.e. natural parent.'''
|-
|Status
|Datatype
|[0..1]
|StatusTypeEnum
|
|
|Status of the benefit.
The possible values are:
• ACTIVE: the citizen is receiving the unemployment benefit
• NON-ACTIVE: the citizen is not receiving the unemployment benefit
• NON-ACTIVE due to APRE (APRE: "Cumulative and early payment of contributory unemployment benefit to foreign workers returning to their country of origin")
• NON-ACTIVE when the benefit has been capitalised
|-
|PeriodOfTime
|Object
|[0..1]
|PeriodOfTime
|
|
|Date of start of the current entitlement situation and date of end.
Start date:
• If the Situation is "ACTIVE", this field indicates the initial date on which the citizen began to receive unemployment benefit.
• If the Situation is "NON-ACTIVE", this field indicates the initial date on which the citizen stopped receiving unemployment benefit.
End date:
• If the Situation is "ACTIVE", this field represents the granted period of entitlement; it indicates the end date.
• If the Situation is "NON-ACTIVE", this field is empty.
|-
|'''PeriodOfTime'''
|'''Class'''
|
|
|
|
|'''Period of time'''
|-
|StartDate
|Datatype
|[0..1]
|Date
|udt:Date
|
|Effective start date of a period time. The format is YYYY-MM-DD
|-
|EndDate
|Datatype
|[0..1]
|Date
|udt:Date
|
|Expected end date or effective end date in case of suspension/cancellation/finish. The format is YYYY-MM-DD
|-
|'''Person'''
|'''Class'''
|
|
|
|
|'''An individual natural person who may be dead or alive, but not imaginary.'''
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|The identifier relation is used to link a Person to any formally issued Identifier for that Person.
|-
|SocialSecurityNumber
|Datatype
|[1..*]
|Identifier
|cva:Cvidentifier
|
|Social Security numbers of the consulted citizen. Up to 10 numbers can be returned, althoug citizens usually have only one Social Security number, but there are also cases with multiple social security numbers.
|-
|PersonName
|Object
|[1..1]
|Name
|
|
|The family name and given name of a Person. At least one of the two must exist.
|-
|DateOfBirth
|Object
|[1..1]
|DateObject
|
|
|The day on which the Person was born.
|-
|'''DateObject'''
|'''Class'''
|
|
|
|
|'''Structured representation of date with year, month and day of the month.'''
|-
|Year
|Datatype
|[0..1]
|Year
|xsd:gYear
|
|A gregorian calendar year. The value space of Year is the set of Gregorian calendar years as defined in § 5.2.1 of ISO 8601. Specifically, it is a set of one-year long, non-periodic instances e.g. lexical 1999 to represent the whole year 1999, independent of how many months and days this year has.
|-
|Month
|Datatype
|[0..1]
|Month
|xsd:gMonth
|
|A gregorian month that recurs every year. The value space of Month is the space of a set of calendar months as defined in § 3 of ISO 8601. Specifically, it is a set of one-month long, yearly periodic instances.
|-
|Day
|Datatype
|[0..1]
|Day
|xsd:gDay
|
|A gregorian day that recurs, specifically a day of the month such as the 5th of the month. The value space of Day is the space of a set of calendar dates as defined in § 3 of ISO 8601. Specifically, it is a set of one-day long, monthly periodic instances.
|-
|'''Name'''
|'''Class'''
|
|
|
|
|'''A name of a person that includes the family and given name.'''
|-
|FamilyName
|Datatype
|[0..*]
|Text
|cbc:FamilyName
|
|A family name is usually shared by members of a family. 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 field so that, for example, Miguel de Cervantes Saavedra's Family Name would be recorded as "de Cervantes Saavedra".
|-
|GivenName
|Datatype
|[0..*]
|Text
|cvb:GivenName
|
|A given name, or multiple given names, are the denominator(s) that identify an individual within a family. These are given to a Person by his or her parents at birth or may be legally recognised as 'given names' through a formal process. All given names are ordered in one field so that, for example, the given name for Johann Sebastian Bach is 'Johann Sebastian'.
|}

File:UnemploymentMeansOfLivingEvidence-0.1.png

2023-01-19T22:07:01Z

Ioannis.konstantinidis:

uml diagram

Unemployment Means Of Living Canonical Evidence

2023-01-19T22:04:05Z

Canonical Evidence

2023-01-19T22:01:34Z

Ioannis.konstantinidis: Added link and description to PensioMeansOfLivingEvidence

'''Canonical Evidence''' is the ''canonical form of a 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. Since canonical evidence is not lawfully issued evidence, issuing authorities should provide both domestic and canonical evidence and they are responsible for the accuracy of the matching between canonical and domestic evidences. In this way, canonical evidence is aimed at the automated processing of cross-border and domestic evidence for legal audits at a regular basis or at the request of interested parties. This approach follows the logic behind the multilingual standard forms set by the [https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX%3A32016R1191 Regulation 2016/1191] on Public documents.

The canonical form for each evidence type that has been identified is called '''canonical evidence type''' and these types are essential for the [[semantic interoperability]] of cross-border evidence, since they provide agreements on concepts, meanings, languages and ways to represent the information.

{| class="wikitable"
|+Canonical evidence types defined in the scope of the DE4A Project
!ID
!Name
!Description
!DE4A Pilot: Use Cases
|-
|[[Company Registration Canonical Evidence|CompanyRegistration]]
| Proof of Company Registration
|The evidence exchanged across-border in the event of starting a business in another EU Member State.
|[[Use Case "Starting a Business in Another Member State" (DBA UC1)|DBA UC1]]
|-
|[[Higher Education Diploma Canonical Evidence|HigherEducationDiploma]]
| Proof of Completion of Higher Education
|Represents all pertinent aspects of CE for applying to public higher education
|[[Use Case "Application to Public Higher Education" (SA UC1)|SA UC1]]
|-
|[[Secondary Education Diploma Canonical Evidence|SecondaryEducationDiploma]]
|Proof of completion of Secondary Education
|Represents all pertinent aspects of CE for applying to public secondary education
|[[Use Case "Application to Public Higher Education" (SA UC1)|SA UC1]]
|-
|[[Disability Canonical Evidence|DisabilityEvidence]]
|Proof of DisabilityEvidenceType
|This evidence serve the purpose of proving a proof that the student suffer from a disability for deciding on if a student is entitled for study grant
|[[Studying Abroad Pilot|SA UC2]]
|-
|[[Disability Canonical Evidence|LargeFamilyEvidence]]
|Proof of a Large Family
|Evidence for proof of that the student is a member of a large family
|[[Studying Abroad Pilot|SA UC2]]
|-
|[[Domicile Registration Canonical Evidence|DomicileRegistrationEvidence]]
|Proof of Domicile Registration
|Evidence for registering a domicile abroad.
|[[Use Case "Request Address Change" (MA UC1)|MA UC1]]
|-
|[[Domicile Deregistration Canonical Evidence|DomicileDeregistrationEvidence]]
|Proof of Domicile Deregistration
|Evidence for removing the registration when the person is registered in another country
|[[Use Case "Request Address Change" (MA UC1)|MA UC1]]
|-
|[[Birth Canonical Evidence|BirthEvidence]]
|Proof of Birth
|Official document or data proving the Birth of a Child.
|[[Use Case "Request an Extract or Copy of a Civil State Certificate" (MA UC2)|MA UC2]]
|-
|[[Marriage Canonical Evidence|MarriageEvidence]]
|Proof of Marriage
|Official document or data proving the Marriage of two Persons.
|[[Use Case "Request an Extract or Copy of a Civil State Certificate" (MA UC2)|MA UC2]]
|-
|[[Pension Means of Living Canonical Evidence|PensionMeansOfLivingEvidence]]
|Proof of Pension means of Living
|The evidence holds information on the pension benefits.
|[[Moving Abroad Pilot|MA UC3]]
|-
|UnemploymentMeansOfLivingEvidence
|Proof of pension by unemployment
|
|[[Moving Abroad Pilot|MA UC3]]
|-
|WorkingLifeMeansOfLivingEvidence
|Proof of working life as a pension
|
|[[Moving Abroad Pilot|MA UC3]]
|}

Canonical evidence types are implemented according to '''common data models''' that are defined from '''domain-specific ontologies''', which reuse existing ''standard agnostic and specific vocabularies, code lists and data models''. Canonical evidence types and common data models are defined according to agreements reached by involved authorities; in the case of the DE4A project, the agreements have been reached by the participants in the DE4A pilot use cases.

[[File:Domain-ontologies-reuse-standards.png|alt=Example of domain-specific ontologies by reusing ISA2 standards|none|thumb|622x622px]]

[[File:Evidence-data-model.png|alt=Example of common data models from domain-specific ontologies|Example of common data models from Personal-Life ontology for two canonical evidence types|none|frame]]

The terms of each canonical evidence type are described in detail in the [[Multilingual Ontology Repository]] in order to allow competent authorities to perform the necessary tasks for mapping their domestic evidence with the corresponding canonical form with an accuracy matching between them.

==Methodology for Modelling Canonical Evidences==
The canonical evidences development process is consisted of the three stages illustrated in Figure below. The process is following an incremental development methodology under agile principles. Hence, in this setting, the WP leader plays the role of the product owner, working in a technical working group with the other two technical works packages, WP4 “[[Pilots|Cross-border Pilots for Citizens and Business and Evaluation]]” and WP5 “[[Library of components and building blocks|Common Component Design & Development]]”, following the same development cycles, as described in the DE4A grant agreement. The canonical evidences are co-created together with the users (the piloting member states), allowing the data models created to best fit the requirements of each member state piloting the evidence exchange. The key stages of the process include elicitation, development and evaluation of the data models.

[[File:D3.5_-_Page_3_(1).png|alt=|frameless|400x400px]]

Accordingly, the preliminary data models are designed based on the existing resources in Stage 1 of the process. The primary models are tested with the piloting member state for model accuracy with respect to the attributes, cardinalities and the affordances of existing vocabularies and code lists. This was an iterative process followed by close dialogue with the respective pilot teams. The XML schemas for the models are developed in Stage 2 in close collaboration with the pilot partners and finally the schemas are validated with the support of WP5 “[[Library of components and building blocks|Common Component Design & Development]]” during the integration into the technical system.
[[Category:Wip]]

Pension Means of Living Canonical Evidence

2023-01-19T21:54:54Z

Ioannis.konstantinidis: Added MA canonical evidence types information

==Description==
This evidence contains elements related to the Pension Means of Living Evidence. The Canonical Evidence in [[Use Case "Request Pension Information - Claim Pension" (MA UC3)]].

== XSD==
XSD files can be found on the [https://github.com/de4a-wp3/moving_abroad GitHub repository].

==Diagram==
[[File:PensionMeansOfLivingEvidence-0.1.png|alt=|center|842x842px|Pension Means of Linving Canonical Evidence_ UML diagram]]

==Attribute Specification==
{| class="wikitable"
!DE4A name
!Property type
!Cardinality
!Data type
!Related vocabulary
!Controlled Vocabulary
!Definition
|-
|'''PensionMeansOfLivingEvidence'''
|'''Class'''
|
|
|
|
|
|-
|Identifier
|Object
|[0..1]
|Identifier
|cva:Cvidentifier
|
|An unambiguous reference to the Pension Means of Living Evidence
|-
|IssueDate
|Datatype
|[1..1]
|Date
|udt:Date
|
|The most recent date on which the Pension Means of Living Evidence instance was issued.
|-
|IssuingAuthority
|Object
|[1..1]
|PublicOrganisation
|
|
|A Public Organisation with official authority in charge of issuing the Pension Means of Living Evidence.
|-
|Certifies
|Object
|[1..1]
|PensionMeansOfLivingInfo
|
|
|Attesting in a formal way that the pension data is true.
|-
|'''PublicOrganisation'''
|'''Class'''
|
|
|
|
|'''Any organisation that is defined as being part of the public sector by a legal framework at any level.'''
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|Many organisations are referred to by an acronym or some other identifier. For example, among the EU institutions, the ECB is the identifier for the European Central Bank, OLAF for the European AntiN/AFraud Office, and so on. These are formally recognised by the European Commission which provides a list of such acronyms. Analogous lists should be used in other contexts.
|-
|PrefLabel
|Datatype
|[1..*]
|Text
|udt:Text
|
|As defined in the ORG Ontology, a preferred label is used to provide the primary, legally recognised name of the organisation. An organisation 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.
|-
|'''PensionMeansOfLivingInfo'''
|'''Class'''
|
|
|
|
|'''Information on different pension benefits'''
|-
|DataSubject
|Object
|[1..1]
|Person
|
|
|The person who is subject to this information
|-
|PensionList
|Object
|[0..1]
|PensionList
|
|
|List of pensions and benefits. Contains information on the pensions of the person for whom the query was made.
|-
|PensionList
|Class
|
|
|
|
|
|-
|Pension
|Object
|[1..*]
|Pension
|
|
|Contains detailed data about each specific pension.
|-
|'''Pension'''
|'''Class'''
|
|
|
|
|
|-
|PensionCategory
|Datatype
|[1..1]
|PensionCategoryEnum
|
|
|Literals of the specific codes of the Spanish pension system. The possible values are listed in tab "Pensions".
|-
|Status
|Datatype
|[1..1]
|StatusTypeEnum
|
|
|Status of the benefit.
The possible values are:
• ACTIVE: the citizen is receiving the unemployment benefit
• NON-ACTIVE: the citizen is not receiving the unemployment benefit
• NON-ACTIVE due to APRE (APRE: "Cumulative and early payment of contributory unemployment benefit to foreign workers returning to their country of origin")
• NON-ACTIVE when the benefit has been capitalised
|-
|GrossAmount
|Object
|[0..1]
|MonetaryAmount
|
|
|It corresponds to the amount of the benefit, including the amounts of possible deductions plus the amount of Personal Income Tax (if applicable). There may be benefits with a gross amount equal to zero.
For all social public benefits, the monthly amount of the benefit as at the date of consultation will be returned.
For M6 or P6 direct payment benefits, the gross amount will be the amount that will be paid for the whole benefit even if it has not yet been paid.
For temporary disability (direct payment benefit I6 or I7), the gross amount will be the amount that has been paid up to the time of the consultation.
If there are confirmation statements captured but not paid, the payment will be calculated and included in the gross amount.
Amount in euro cents.
The Format is NNNNNNN
|-
|NetAmount
|Object
|[0..1]
|MonetaryAmount
|
|
|It corresponds to the amount of the benefit after the possible deductions have been applied, plus the amount of Personal Income Tax (if applicable). There may be benefits with a net amount equal to zero, either because it is based on a gross amount of zero, or because it is zero after applying the corresponding deductions.
In all benefits outside the Social Security System, the net amount will coincide with the gross amount, since there is no available data on possible deductions.
Amount in euro cents.
The Format is NNNNNNN
|-
|NumberPaymentsYear
|Datatype
|[0..1]
|Numeric
|
|
|It refers to the number of payments corresponding to that benefit in the period of one year. Unless there is an error, this field will always be returned within the benefits of the Registry of Public Social Benefits.
|-
|PeriodOfTime
|Object
|[0..1]
|PeriodOfTime
|
|
|Effect date: It corresponds to the date of economic effects of the benefit. It will be returned in all cases, except for Temporary Disability benefits (I6 or I7), either the provision in Direct Payment or Delegated Payment. The format is YYYYMMDD
ExpectedEndDate: Corresponds to the date on which the benefit ends. No data will be returned for the benefits of the Registry of Public Social Benefits
In the case of maternity or paternity, it will correspond to the expiration date of the subsidy. In the case of temporary disability, the end date is the date of the last payment made or the last confirmation part noted. In temporary disability, the delegated payment will not be completed.
|-
|'''PeriodOfTime'''
|'''Class'''
|
|
|
|
|'''Period of time'''
|-
|StartDate
|Datatype
|[0..1]
|Date
|udt:Date
|
|Effective start date of a period time. The format is YYYY-MM-DD
|-
|EndDate
|Datatype
|[0..1]
|Date
|udt:Date
|
|Expected end date or effective end date in case of suspension/cancellation/finish. The format is YYYY-MM-DD
|-
|'''MonetaryAmount'''
|'''Class'''
|
|
|
|
|'''A monetary value.'''
|-
|currency
|Datatype
|[0..*]
|Code
|
|Currency
|The currency in which the Monetary Amount is expressed.
|-
|amount
|Datatype
|[1..1]
|Numeric
|
|
|The quantitative value of the Monetary Amount.
|-
|'''Person'''
|'''Class'''
|
|
|
|
|'''An individual natural person who may be dead or alive, but not imaginary.'''
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|The identifier relation is used to link a Person to any formally issued Identifier for that Person.
|-
|SocialSecurityNumber
|Datatype
|[1..*]
|Identifier
|cva:Cvidentifier
|
|Social Security numbers of the consulted citizen. Up to 10 numbers can be returned, althoug citizens usually have only one Social Security number, but there are also cases with multiple social security numbers.
|-
|PersonName
|Object
|[1..1]
|Name
|
|
|The family name and given name of a Person. At least one of the two must exist.
|-
|DateOfBirth
|Object
|[1..1]
|DateObject
|
|
|The day on which the Person was born.
|-
|'''DateObject'''
|'''Class'''
|
|
|
|
|'''Structured representation of date with year, month and day of the month.'''
|-
|Year
|Datatype
|[0..1]
|Year
|xsd:gYear
|
|A gregorian calendar year. The value space of Year is the set of Gregorian calendar years as defined in § 5.2.1 of ISO 8601. Specifically, it is a set of one-year long, non-periodic instances e.g. lexical 1999 to represent the whole year 1999, independent of how many months and days this year has.
|-
|Month
|Datatype
|[0..1]
|Month
|xsd:gMonth
|
|A gregorian month that recurs every year. The value space of Month is the space of a set of calendar months as defined in § 3 of ISO 8601. Specifically, it is a set of one-month long, yearly periodic instances.
|-
|Day
|Datatype
|[0..1]
|Day
|xsd:gDay
|
|A gregorian day that recurs, specifically a day of the month such as the 5th of the month. The value space of Day is the space of a set of calendar dates as defined in § 3 of ISO 8601. Specifically, it is a set of one-day long, monthly periodic instances.
|-
|'''Name'''
|'''Class'''
|
|
|
|
|'''A name of a person that includes the family and given name.'''
|-
|FamilyName
|Datatype
|[0..*]
|Text
|cbc:FamilyName
|
|A family name is usually shared by members of a family. 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 field so that, for example, Miguel de Cervantes Saavedra's Family Name would be recorded as "de Cervantes Saavedra".
|-
|GivenName
|Datatype
|[0..*]
|Text
|cvb:GivenName
|
|A given name, or multiple given names, are the denominator(s) that identify an individual within a family. These are given to a Person by his or her parents at birth or may be legally recognised as 'given names' through a formal process. All given names are ordered in one field so that, for example, the given name for Johann Sebastian Bach is 'Johann Sebastian'.
|}

File:PensionMeansOfLivingEvidence-0.1.png

2023-01-19T21:10:38Z

Ioannis.konstantinidis:

uml diagram

Pension Means of Living Canonical Evidence

2023-01-19T21:01:38Z

Canonical Evidence

2023-01-19T20:59:15Z

Ioannis.konstantinidis: Added link to Deregistration Evidence

'''Canonical Evidence''' is the ''canonical form of a 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. Since canonical evidence is not lawfully issued evidence, issuing authorities should provide both domestic and canonical evidence and they are responsible for the accuracy of the matching between canonical and domestic evidences. In this way, canonical evidence is aimed at the automated processing of cross-border and domestic evidence for legal audits at a regular basis or at the request of interested parties. This approach follows the logic behind the multilingual standard forms set by the [https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX%3A32016R1191 Regulation 2016/1191] on Public documents.

The canonical form for each evidence type that has been identified is called '''canonical evidence type''' and these types are essential for the [[semantic interoperability]] of cross-border evidence, since they provide agreements on concepts, meanings, languages and ways to represent the information.

{| class="wikitable"
|+Canonical evidence types defined in the scope of the DE4A Project
!ID
!Name
!Description
!DE4A Pilot: Use Cases
|-
|[[Company Registration Canonical Evidence|CompanyRegistration]]
| Proof of Company Registration
|The evidence exchanged across-border in the event of starting a business in another EU Member State.
|[[Use Case "Starting a Business in Another Member State" (DBA UC1)|DBA UC1]]
|-
|[[Higher Education Diploma Canonical Evidence|HigherEducationDiploma]]
| Proof of Completion of Higher Education
|Represents all pertinent aspects of CE for applying to public higher education
|[[Use Case "Application to Public Higher Education" (SA UC1)|SA UC1]]
|-
|[[Secondary Education Diploma Canonical Evidence|SecondaryEducationDiploma]]
|Proof of completion of Secondary Education
|Represents all pertinent aspects of CE for applying to public secondary education
|[[Use Case "Application to Public Higher Education" (SA UC1)|SA UC1]]
|-
|[[Disability Canonical Evidence|DisabilityEvidence]]
|Proof of DisabilityEvidenceType
|This evidence serve the purpose of proving a proof that the student suffer from a disability for deciding on if a student is entitled for study grant
|[[Studying Abroad Pilot|SA UC2]]
|-
|[[Disability Canonical Evidence|LargeFamilyEvidence]]
|Proof of a Large Family
|Evidence for proof of that the student is a member of a large family
|[[Studying Abroad Pilot|SA UC2]]
|-
|[[Domicile Registration Canonical Evidence|DomicileRegistrationEvidence]]
|Proof of Domicile Registration
|Evidence for registering a domicile abroad.
|[[Use Case "Request Address Change" (MA UC1)|MA UC1]]
|-
|[[Domicile Deregistration Canonical Evidence|DomicileDeregistrationEvidence]]
|Proof of Domicile Deregistration
|Evidence for removing the registration when the person is registered in another country
|[[Use Case "Request Address Change" (MA UC1)|MA UC1]]
|-
|[[Birth Canonical Evidence|BirthEvidence]]
|Proof of Birth
|Official document or data proving the Birth of a Child.
|[[Use Case "Request an Extract or Copy of a Civil State Certificate" (MA UC2)|MA UC2]]
|-
|[[Marriage Canonical Evidence|MarriageEvidence]]
|Proof of Marriage
|Official document or data proving the Marriage of two Persons.
|[[Use Case "Request an Extract or Copy of a Civil State Certificate" (MA UC2)|MA UC2]]
|-
|PensionMeansOfLivingEvidence
|Proof of Pension means of Living
|
|[[Moving Abroad Pilot|MA UC3]]
|-
|UnemploymentMeansOfLivingEvidence
|Proof of pension by unemployment
|
|[[Moving Abroad Pilot|MA UC3]]
|-
|WorkingLifeMeansOfLivingEvidence
|Proof of working life as a pension
|
|[[Moving Abroad Pilot|MA UC3]]
|}

Canonical evidence types are implemented according to '''common data models''' that are defined from '''domain-specific ontologies''', which reuse existing ''standard agnostic and specific vocabularies, code lists and data models''. Canonical evidence types and common data models are defined according to agreements reached by involved authorities; in the case of the DE4A project, the agreements have been reached by the participants in the DE4A pilot use cases.

[[File:Domain-ontologies-reuse-standards.png|alt=Example of domain-specific ontologies by reusing ISA2 standards|none|thumb|622x622px]]

[[File:Evidence-data-model.png|alt=Example of common data models from domain-specific ontologies|Example of common data models from Personal-Life ontology for two canonical evidence types|none|frame]]

The terms of each canonical evidence type are described in detail in the [[Multilingual Ontology Repository]] in order to allow competent authorities to perform the necessary tasks for mapping their domestic evidence with the corresponding canonical form with an accuracy matching between them.

==Methodology for Modelling Canonical Evidences==
The canonical evidences development process is consisted of the three stages illustrated in Figure below. The process is following an incremental development methodology under agile principles. Hence, in this setting, the WP leader plays the role of the product owner, working in a technical working group with the other two technical works packages, WP4 “[[Pilots|Cross-border Pilots for Citizens and Business and Evaluation]]” and WP5 “[[Library of components and building blocks|Common Component Design & Development]]”, following the same development cycles, as described in the DE4A grant agreement. The canonical evidences are co-created together with the users (the piloting member states), allowing the data models created to best fit the requirements of each member state piloting the evidence exchange. The key stages of the process include elicitation, development and evaluation of the data models.

[[File:D3.5_-_Page_3_(1).png|alt=|frameless|400x400px]]

Accordingly, the preliminary data models are designed based on the existing resources in Stage 1 of the process. The primary models are tested with the piloting member state for model accuracy with respect to the attributes, cardinalities and the affordances of existing vocabularies and code lists. This was an iterative process followed by close dialogue with the respective pilot teams. The XML schemas for the models are developed in Stage 2 in close collaboration with the pilot partners and finally the schemas are validated with the support of WP5 “[[Library of components and building blocks|Common Component Design & Development]]” during the integration into the technical system.
[[Category:Wip]]

Domicile Deregistration Canonical Evidence

2023-01-19T14:40:47Z

Ioannis.konstantinidis: Copied page from domicile registration and change UML

File:DomicileDeregistrationEvidence-UML-1.7.drawio.png

2023-01-19T14:40:00Z

Ioannis.konstantinidis:

Domicile Deregistration Evidence UML

Domicile Deregistration Canonical Evidence

2023-01-19T14:29:03Z

Ioannis.konstantinidis: This evidence contains elements related to the Domicile Registration Evidence. The Canonical Evidence in Use Case "Request Address Change" (MA UC1).

==Description==
This evidence contains elements related to the Domicile Registration Evidence. The Canonical Evidence in [[Use Case "Request Address Change" (MA UC1)]].

== XSD ==
XSD files can be found on the [https://github.com/de4a-wp3/moving_abroad GitHub repository].

==Diagram==
[[File:DomicileRegistrationEvidence-UML-1.7.drawio.png|center]]

==Attribute Specification==
{| class="wikitable"
|+
!DE4A name
!Property type
!Cardinality
!Data type
!Related Vocabulary
!Controlled vocabulary
!Definition
|-
|'''DomicileRegistrationEvidence'''
|'''Class'''
|
|
|
|
|'''This class contains elements related to the Domicile Registration Evidence.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cva:Cvidentifier
|
|An unambiguous reference to the Domicile Registration Evidence.
|-
|IssueDate
|Datatype
|[1..1]
|Date
|udt:Date
|
|The most recent date on which the Domicile Registration Evidence instance was issued.
|-
|IssuingAuthority
|Object
|[1..1]
|PublicOrganisation
|
|
|A Public Organisation with official authority in charge of issuing the Domicile Registration Evidence.
|-
|IssuingPlace
|Object
|[1..1]
|LocationAddress
|
|
|The location address where the Domicile Registration Evidence was issued.
|-
|CertifiesDomicile
|Object
|[1..1]
|Domicile
|
|
|Attesting in a formal way that the Domicile is true.
|-
|'''PublicOrganisation'''
|'''Class'''
|
|
|
|
|'''Any organisation that is defined as being part of the public sector by a legal framework at any level.'''
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|Many organisations are referred to by an acronym or some other identifier. For example, among the EU institutions, the ECB is the identifier for the European Central Bank, OLAF for the European Anti-Fraud Office, and so on. These are formally recognised by the European Commission which provides a list of such acronyms. Analogous lists should be used in other contexts.
|-
|PrefLabel
|Datatype
|[1..*]
|Text
|udt:Text
|
|As defined in the ORG Ontology, a preferred label is used to provide the primary, legally recognised name of the organisation. An organisation 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.
|-
|'''Domicile'''
|'''Class'''
|
|
|
|
|'''This class contains elements related to the domicile'''
|-
|Inhabitant
|Object
|[1..1]
|Person
|
|
|Person, living in the residence or domicile
|-
|Domicile
|Object
|[1..1]
|ConstrainedLocationAddress
|
|
|Current domicile inhabited by person
|-
|'''Person'''
|'''Class'''
|
|
|
|
|'''An individual natural person who may be dead or alive, but not imaginary.'''
|-
|PersonName
|Object
|[1..1]
|Name
|
|
|The family name and given name of a Person. At least one of the two must exist.
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|The identifier relation is used to link a Person to any formally issued Identifier for that Person.
|-
|DateOfBirth
|Object
|[0..1]
|DateObject
|
|
|The day on which the person was born.
|-
|Gender
|Datatype
|[0..1]
|Code
|udt:Code
|Human Sex
|The chromosomal state, and reproductive organs and structures of a Person that allows them to be distinguished as female or male or not applicable, not known or not stated.
|-
|MaritalStatus
|Datatype
|[0..1]
|Code
|udt:Code
|Marital Status
|An indicator of the marital status
|-
|PlaceOfBirth
|Object
|[0..1]
|LocationAddress
|
|
|The Location where the person was born
|-
|Citizenship
|Object
|[0..*]
|Jurisdiction
|
|
|The citizenship relationship links a Person to a Jurisdiction that has conferred citizenship rights on the individual such as the right to vote, to receive certain protection from the community or the issuance of a passport.
|-
|'''Jurisdiction'''
|'''Class'''
|
|
|
|
|'''The authority that an official organisation has, to make legal decisions about somebody/something.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cvb:JurisdictionID
|
|The value for the id property is a URI for that Jurisdiction.
|-
|Name
|Datatype
|[1..*]
|Text
|cbc:Name
|
|The name is simply a string that identifies the Jurisdiction, typically a country, with or without a language tag.
|-
|'''ConstrainedLocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of a location based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[1..1]
|Text
|cvb:AdminunitSecondline
|NUTS/LAU
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[1..1]
|Text
|cvb:AdminunitFirstline
|Country
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''LocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of the place of birth based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[0..1]
|Text
|cvb:AdminunitSecondline
|
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[0..1]
|Text
|cvb:AdminunitFirstline
|Country
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''Address'''
|'''Class'''
|
|
|
|
|'''Representation of address based on the INSPIRE Address Representation.'''
|-
|PoBox
|Datatype
|[0..1]
|Text
|cvb:PoBox
|
|The Post Office Box 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.
|-
|Thoroughfare
|Datatype
|[0..1]
|Text
|cvb:Thoroughfare
|
|Quoting from the INSPIRE guidelines, a thoroughfare is: "an address component that represents the name of a passage or way through from one location to another. A thoroughfare is not necessarily a road, it might be a waterway or some other feature.
|-
|LocatorDesignator
|Datatype
|[0..1]
|Text
|cvb:LocatorDesignator
|
|The locator designator is defined by the INSPIRE guidelines as "a number or a sequence of characters that uniquely identifies the locator within the relevant scope(s). The full identification of the locator could include one or more locator designators." 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."
|-
|LocatorName
|Datatype
|[0..1]
|Text
|cvb:LocatorName
|
|Based on the INSPIRE guidelines, locator name is defined as: "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.
|-
|AddressArea
|Datatype
|[0..1]
|Text
|cvb:CvaddressArea
|
|Taking the definition from INSPIRE, the address area is: 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.
|-
|PostName
|Datatype
|[0..1]
|Text
|cvb:PostName
|
|The key postal division of the address, usually the city. (INSPIRE's definition is "One or more names created and maintained for postal purposes to identify a subdivision of addresses and postal delivery points.)
|-
|PostCode
|Datatype
|[0..1]
|Text
|cvb:PostCode
|
|The post code (a.k.a postal code, zip code etc.). Post codes are common elements in many countries' postal address systems.
|-
|'''Name'''
|'''Class'''
|
|
|
|
|'''A name of a person that includes the family and given name.'''
|-
|FamilyName
|Datatype
|[0..*]
|Text
|cbc:FamilyName
|
|A family name is usually shared by members of a family. 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 field so that, for example, Miguel de Cervantes Saavedra's Family Name would be recorded as "de Cervantes Saavedra".
|-
|GivenName
|Datatype
|[0..*]
|Text
|cvb:GivenName
|
|A given name, or multiple given names, are the denominator(s) that identify an individual within a family. These are given to a Person by his or her parents at birth or may be legally recognised as 'given names' through a formal process. All given names are ordered in one field so that, for example, the given name for Johann Sebastian Bach is 'Johann Sebastian'.
|-
|'''DateObject'''
|'''Class'''
|
|
|
|
|'''Structured representation of date with year, month and day of the month.'''
|-
|Year
|Datatype
|[0..1]
|Year
|xsd:gYear
|
|A gregorian calendar year. The value space of Year is the set of Gregorian calendar years as defined in § 5.2.1 of ISO 8601. Specifically, it is a set of one-year long, non-periodic instances e.g. lexical 1999 to represent the whole year 1999, independent of how many months and days this year has.
|-
|Month
|Datatype
|[0..1]
|Month
|xsd:gMonth
|
|A gregorian month that recurs every year. The value space of Month is the space of a set of calendar months as defined in § 3 of ISO 8601. Specifically, it is a set of one-month long, yearly periodic instances.
|-
|Day
|Datatype
|[0..1]
|Day
|xsd:gDay
|
|A gregorian day that recurs, specifically a day of the month such as the 5th of the month. The value space of Day is the space of a set of calendar dates as defined in § 3 of ISO 8601. Specifically, it is a set of one-day long, monthly periodic instances.
|}

Marriage Canonical Evidence

2022-02-27T12:18:53Z

Ioannis.konstantinidis: Updated diagram. TODO: Update the information on the table

==Description==
Official document or data proving the Marriage of two Persons. The Canonical Evidence in [[Use Case "Request an Extract or Copy of a Civil State Certificate" (MA UC2)]].

==XSD==
XSD files can be found on the [https://github.com/de4a-wp3/moving_abroad GitHub repository].

==Diagram==

[[File:MarriageEvidence-UML-1.7.drawio.png]]

==Attribute Specification==
{| class="wikitable"
|+
!DE4A name
!Property type
!Cardinality
!Data type
!Related vocabulary
!Controlled vocabulary
!Definitions
|-
|'''MarriageEvidence'''
|'''Class'''
|
|
|
|
|'''Official document or data proving the Marriage of two Persons.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cva:Cvidentifier
|
|An unambiguous reference to the Marriage Evidence.
|-
|IssueDate
|Datatype
|[1..1]
|Date
|udt:Date
|
|The most recent date on which the Marriage Evidence instance was issued.
|-
|IssuingAuthority
|Object
|[1..1]
|PublicOrganisation
|
|
|A Public Organisation with official authority in charge of issuing the Marriage Evidence.
|-
|IssuingPlace
|Object
|[1..1]
|ConstrainedLocationAddress
|
|
|The Location where the Marriage Evidence was issued.
|-
|CertifiesMarriage
|Object
|[1..1]
|Marriage
|
|
|Attesting in a formal way that the Marriage is true.
|-
|CertifiesEndOfMarriage
|Object
|[0..1]
|EndOfMarriage
|
|
|In case of divorce, this property includes information on the end of marriage
|-
|'''PublicOrganisation'''
|'''Class'''
|
|
|
|
|'''Any organisation that is defined as being part of the public sector by a legal framework at any level.'''
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|Many organisations are referred to by an acronym or some other identifier. For example, among the EU institutions, the ECB is the identifier for the European Central Bank, OLAF for the European Anti-Fraud Office, and so on. These are formally recognised by the European Commission which provides a list of such acronyms. Analogous lists should be used in other contexts.
|-
|PrefLabel
|Datatype
|[1..*]
|Text
|udt:Text
|
|As defined in the ORG Ontology, a preferred label is used to provide the primary, legally recognised name of the organisation. An organisation 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.
|-
|'''Marriage'''
|'''Class'''
|
|
|
|
|'''A legally accepted relationship between two Persons in which they live together.'''
|-
|DateOfMarriage
|Datatype
|[1..1]
|Date
|udt:Date
|
|The date on which the Marriage took place.
|-
|Spouse
|Object
|[2..2]
|MarriedPerson
|
|
|The Person who was married.
|-
|PlaceOfMarriage
|Object
|[0..1]
|LocationAddress
|
|
|The Location where the Marriage took place.
|-
|'''MarriedPerson'''
|'''Class'''
|
|
|
|
|'''A Person who has entered into a Marriage.'''
|-
|FamilyNameAfterMarriage
|Datatype
|[0..*]
|Text
|udt:Text
|
|This property contains the family name after the Marriage of the Person.
|-
|FamilyNameBeforeMarriage
|Datatype
|[0..*]
|Text
|udt:Text
|
|This property contains the family name before the Marriage of the Person.
|-
|MaritalStatusBeforeMarriage
|Datatype
|[0..1]
|Text
|udt:Code
|Marital Status
|Situation with regard to whether a Person was single, married, separated, divorced or widowed.
|-
|'''Person'''
|'''Class'''
|
|
|
|
|'''An individual natural person who may be dead or alive, but not imaginary.'''
|-
|DateOfBirth
|Datatype
|[0..1]
|DateObject
|
|
|The day on which the Person was born.
|-
|PersonName
|Object
|[1..1]
|Name
|
|
|The family name and given name of a Person. At least one of the two must exist.
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|The identifier relation is used to link a Person to any formally issued Identifier for that Person.
|-
|PlaceOfBirth
|Object
|[0..1]
|LocationAddress
|
|
|The Location where the Person was born.
|-
|Gender
|Datatype
|[1..1]
|Code
|udt:Code
|Human Sex
|The gender of an individual should be recorded using a controlled vocabulary that is appropriate for the specific context. In some cases the chromosomal or physical state of an individual will be more important than the gender that they express, in others the reverse will be true. What is always important is that the controlled vocabulary used to describe an individual's gender is stated explicitly.
|-
|Citizenship
|Object
|[0..*]
|Jurisdiction
|
|
|The citizenship relationship links a Person to a Jurisdiction that has conferred citizenship rights on the individual such as the right to vote, to receive certain protection from the community or the issuance of a passport.
|-
|'''Jurisdiction'''
|'''Class'''
|
|
|
|
|'''The authority that an official organisation has, to make legal decisions about somebody/something.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cvb:JurisdictionID
|
|The value for the id property is a URI for that Jurisdiction.
|-
|Name
|Datatype
|[1..*]
|Text
|cbc:Name
|
|The name is simply a string that identifies the Jurisdiction, typically a country, with or without a language tag.
|-
|'''ConstrainedLocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of a location based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[1..1]
|Text
|cvb:AdminunitSecondline
|
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[1..1]
|Text
|cvb:AdminunitFirstline
|Country
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''LocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of the place of birth based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[0..1]
|Text
|cvb:AdminunitSecondline
|
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[0..1]
|Text
|cvb:AdminunitFirstline
|Country
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''Address'''
|'''Class'''
|
|
|
|
|'''Representation of address based on the INSPIRE Address Representation.'''
|-
|PoBox
|Datatype
|[0..1]
|Text
|cvb:PoBox
|
|The Post Office Box 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.
|-
|Thoroughfare
|Datatype
|[0..1]
|Text
|cvb:Thoroughfare
|
|Quoting from the INSPIRE guidelines, a thoroughfare is: "an address component that represents the name of a passage or way through from one location to another. A thoroughfare is not necessarily a road, it might be a waterway or some other feature.
|-
|LocatorDesignator
|Datatype
|[0..1]
|Text
|cvb:LocatorDesignator
|
|The locator designator is defined by the INSPIRE guidelines as "a number or a sequence of characters that uniquely identifies the locator within the relevant scope(s). The full identification of the locator could include one or more locator designators." 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."
|-
|LocatorName
|Datatype
|[0..1]
|Text
|cvb:LocatorName
|
|Based on the INSPIRE guidelines, locator name is defined as: "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.
|-
|AddressArea
|Datatype
|[0..1]
|Text
|cvb:CvaddressArea
|
|Taking the definition from INSPIRE, the address area is: 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.
|-
|PostName
|Datatype
|[0..1]
|Text
|cvb:PostName
|
|The key postal division of the address, usually the city. (INSPIRE's definition is "One or more names created and maintained for postal purposes to identify a subdivision of addresses and postal delivery points.)
|-
|PostCode
|Datatype
|[0..1]
|Text
|cvb:PostCode
|
|The post code (a.k.a postal code, zip code etc.). Post codes are common elements in many countries' postal address systems.
|-
|'''EndOfMarriage'''
|'''Class'''
|
|
|
|
|'''Date and cause of end of marriage'''
|-
|DateOfEndOfMarriage
|Datatype
|[0..1]
|Date
|udt:Date
|
|
|-
|Cause
|Datatype
|[0..1]
|Text
|udt:Text
|
|
|-
|'''DateObject'''
|'''Class'''
|
|
|
|
|'''Structured representation of date with year, month and day of the month.'''
|-
|Year
|Datatype
|[0..1]
|Year
|xsd:gYear
|
|A gregorian calendar year. The value space of Year is the set of Gregorian calendar years as defined in § 5.2.1 of ISO 8601. Specifically, it is a set of one-year long, non-periodic instances e.g. lexical 1999 to represent the whole year 1999, independent of how many months and days this year has.
|-
|Month
|Datatype
|[0..1]
|Month
|xsd:gMonth
|
|A gregorian month that recurs every year. The value space of Month is the space of a set of calendar months as defined in § 3 of ISO 8601. Specifically, it is a set of one-month long, yearly periodic instances.
|-
|Day
|Datatype
|[0..1]
|Day
|xsd:gDay
|
|A gregorian day that recurs, specifically a day of the month such as the 5th of the month. The value space of Day is the space of a set of calendar dates as defined in § 3 of ISO 8601. Specifically, it is a set of one-day long, monthly periodic instances.
|-
|'''Name'''
|'''Class'''
|
|
|
|
|'''A name of a person that includes the family and given name.'''
|-
|FamilyName
|Datatype
|[0..*]
|Text
|cbc:FamilyName
|
|A family name is usually shared by members of a family. 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 field so that, for example, Miguel de Cervantes Saavedra's Family Name would be recorded as "de Cervantes Saavedra".
|-
|GivenName
|Datatype
|[0..*]
|Text
|cvb:GivenName
|
|A given name, or multiple given names, are the denominator(s) that identify an individual within a family. These are given to a Person by his or her parents at birth or may be legally recognised as 'given names' through a formal process. All given names are ordered in one field so that, for example, the given name for Johann Sebastian Bach is 'Johann Sebastian'.
|}

File:MarriageEvidence-UML-1.7.drawio.png

2022-02-27T12:18:35Z

Ioannis.konstantinidis:

Include codelist types

Birth Canonical Evidence

2022-02-27T12:17:29Z

Ioannis.konstantinidis: Updated diagram. TODO: Update the information on the table

== Description ==
Official document or data proving the Birth of a Child. Canonical evidence in the [[Use Case "Request an Extract or Copy of a Civil State Certificate" (MA UC2)]].

==XSD==
XSD files can be found on the [https://github.com/de4a-wp3/moving_abroad GitHub repository].

== Diagram ==

[[File:BirthEvidence-UML-v1.7.drawio.png]]

== Attribute Specification ==
{| class="wikitable"
|+
!'''DE4A name'''
!'''Property type'''
!'''Cardinality'''
!'''Data type'''
!'''Related vocabulary'''
!'''Controlled Vocabulary'''
!'''Definition'''
|-
|'''BirthEvidence'''
|'''Class'''
|
|
|
|
|'''Official document or data proving the Birth of a Child.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cva:Cvidentifier
|
|An unambiguous reference to the Birth Evidence.
|-
|IssueDate
|Datatype
|[1..1]
|Date
|udt:Date
|
|The most recent date on which the Birth Evidence instance was issued.
|-
|IssuingAuthority
|Object
|[1..1]
|PublicOrganisation
|
|
|A Public Organisation with official authority in charge of issuing the Birth Evidence.
|-
|IssuingPlace
|Object
|[1..1]
|ConstrainedLocationAddress
|
|
|The Location where the Birth Evidence was issued.
|-
|CertifiesBirth
|Object
|[1..1]
|Birth
|
|
|Attesting in a formal way that the Birth is true.
|-
|'''PublicOrganisation'''
|'''Class'''
|
|
|
|
|'''Any organisation that is defined as being part of the public sector by a legal framework at any level.'''
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|Many organisations are referred to by an acronym or some other identifier. For example, among the EU institutions, the ECB is the identifier for the European Central Bank, OLAF for the European AntiN/AFraud Office, and so on. These are formally recognised by the European Commission which provides a list of such acronyms. Analogous lists should be used in other contexts.
|-
|PrefLabel
|Datatype
|[1..*]
|Text
|udt:Text
|
|As defined in the ORG Ontology, a preferred label is used to provide the primary, legally recognised name of the organisation. An organisation 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.
|-
|'''Birth'''
|'''Class'''
|
|
|
|
|'''The event indicating the moment a Child emerges from the body of another Person, i.e. start of life.'''
|-
|Child
|Object
|[1..1]
|Child
|
|
|The Person who is born at the Birth.
|-
|Parent
|Object
|[0..2]
|Parent
|
|
|The Parent of the Child.
|-
|'''Child'''
|'''Class'''
|
|
|
|
|'''A Person of any age, who is a son or daughter.'''
|-
|DateOfBirth
|Object
|[1..1]
|DateObject
|
|
|The day on which the Child was born.
|-
|Gender
|Datatype
|[1..1]
|Code
|udt:Code
|[https://op.europa.eu/en/web/eu-vocabularies/at-concept-scheme/-/resource/authority/human-sex/?target=Browse&uri=http://publications.europa.eu/resource/authority/human-sex Human Sex]
|The chromosomal state, and reproductive organs and structures of a Person that allows them to be distinguished as female or male or undetermined.
|-
|PlaceOfBirth
|Object
|[1..1]
|LocationAddress
|
|
|The Location where the Child was born.
|-
|'''Parent'''
|'''Class'''
|
|
|
|
|'''One of the two Persons who are jointly the cause of the Child's Birth, i.e. natural parent.'''
|-
|DateOfBirth
|Object
|[0..1]
|DateObject
|
|
|The day on which the Parent was born.
|-
|Gender
|Datatype
|[0..1]
|Code
|udt:Code
|[https://op.europa.eu/en/web/eu-vocabularies/at-concept-scheme/-/resource/authority/human-sex/?target=Browse&uri=http://publications.europa.eu/resource/authority/human-sex Human Sex]
|The chromosomal state, and reproductive organs and structures of a Person that allows them to be distinguished as female or male or undetermined.
|-
|PlaceOfBirth
|Object
|[0..1]
|LocationAddress
|
|
|The Location where the Parent was born.
|-
|'''Person'''
|'''Class'''
|
|
|
|
|'''An individual natural person who may be dead or alive, but not imaginary.'''
|-
|PersonName
|Object
|[1..1]
|Name
|
|
|The family name and given name of a Person. At least one of the two must exist.
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|The identifier relation is used to link a Person to any formally issued Identifier for that Person.
|-
|Citizenship
|Object
|[0..*]
|Jurisdiction
|
|
|The citizenship relationship links a Person to a Jurisdiction that has conferred citizenship rights on the individual such as the right to vote, to receive certain protection from the community or the issuance of a passport.
|-
|'''Jurisdiction'''
|'''Class'''
|
|
|
|
|'''The authority that an official organisation has, to make legal decisions about somebody/something.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cvb:JurisdictionID
|[https://op.europa.eu/en/web/eu-vocabularies/at-concept-scheme/-/resource/authority/country/?target=Browse&uri=http://publications.europa.eu/resource/authority/country Country]
|The value for the id property is a URI for that Jurisdiction.
|-
|Name
|Datatype
|[1..*]
|Text
|cbc:Name
|[https://op.europa.eu/en/web/eu-vocabularies/at-concept-scheme/-/resource/authority/country/?target=Browse&uri=http://publications.europa.eu/resource/authority/country Country]
|The name is simply a string that identifies the Jurisdiction, typically a country, with or without a language tag.
|-
|'''ConstrainedLocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of a location based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[1..1]
|Text
|cvb:AdminunitSecondline
|
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[1..1]
|Text
|cvb:AdminunitFirstline
|[https://op.europa.eu/en/web/eu-vocabularies/at-concept-scheme/-/resource/authority/country/?target=Browse&uri=http://publications.europa.eu/resource/authority/country Country]
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''LocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of the place of birth based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[0..1]
|Text
|cvb:AdminunitSecondline
|
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[0..1]
|Text
|cvb:AdminunitFirstline
|[https://op.europa.eu/en/web/eu-vocabularies/at-concept-scheme/-/resource/authority/country/?target=Browse&uri=http://publications.europa.eu/resource/authority/country Country]
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''Address'''
|'''Class'''
|
|
|
|
|'''Representation of address based on the INSPIRE Address Representation.'''
|-
|PoBox
|Datatype
|[0..1]
|Text
|cvb:PoBox
|
|The Post Office Box 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.
|-
|Thoroughfare
|Datatype
|[0..1]
|Text
|cvb:Thoroughfare
|
|Quoting from the INSPIRE guidelines, a thoroughfare is: "an address component that represents the name of a passage or way through from one location to another. A thoroughfare is not necessarily a road, it might be a waterway or some other feature.
|-
|LocatorDesignator
|Datatype
|[0..1]
|Text
|cvb:LocatorDesignator
|
|The locator designator is defined by the INSPIRE guidelines as "a number or a sequence of characters that uniquely identifies the locator within the relevant scope(s). The full identification of the locator could include one or more locator designators." 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."
|-
|LocatorName
|Datatype
|[0..1]
|Text
|cvb:LocatorName
|
|Based on the INSPIRE guidelines, locator name is defined as: "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.
|-
|AddressArea
|Datatype
|[0..1]
|Text
|cvb:CvaddressArea
|
|Taking the definition from INSPIRE, the address area is: 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.
|-
|PostName
|Datatype
|[0..1]
|Text
|cvb:PostName
|
|The key postal division of the address, usually the city. (INSPIRE's definition is "One or more names created and maintained for postal purposes to identify a subdivision of addresses and postal delivery points.)
|-
|PostCode
|Datatype
|[0..1]
|Text
|cvb:PostCode
|
|The post code (a.k.a postal code, zip code etc.). Post codes are common elements in many countries' postal address systems.
|-
|'''DateObject'''
|'''Class'''
|
|
|
|
|'''Structured representation of date with year, month and day of the month.'''
|-
|Year
|Datatype
|[0..1]
|Year
|xsd:gYear
|
|A gregorian calendar year. The value space of Year is the set of Gregorian calendar years as defined in § 5.2.1 of ISO 8601. Specifically, it is a set of one-year long, non-periodic instances e.g. lexical 1999 to represent the whole year 1999, independent of how many months and days this year has.
|-
|Month
|Datatype
|[0..1]
|Month
|xsd:gMonth
|
|A gregorian month that recurs every year. The value space of Month is the space of a set of calendar months as defined in § 3 of ISO 8601. Specifically, it is a set of one-month long, yearly periodic instances.
|-
|Day
|Datatype
|[0..1]
|Day
|xsd:gDay
|
|A gregorian day that recurs, specifically a day of the month such as the 5th of the month. The value space of Day is the space of a set of calendar dates as defined in § 3 of ISO 8601. Specifically, it is a set of one-day long, monthly periodic instances.
|-
|'''Name'''
|'''Class'''
|
|
|
|
|'''A name of a person that includes the family and given name.'''
|-
|FamilyName
|Datatype
|[0..*]
|Text
|cbc:FamilyName
|
|A family name is usually shared by members of a family. 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 field so that, for example, Miguel de Cervantes Saavedra's Family Name would be recorded as "de Cervantes Saavedra".
|-
|GivenName
|Datatype
|[0..*]
|Text
|cvb:GivenName
|
|A given name, or multiple given names, are the denominator(s) that identify an individual within a family. These are given to a Person by his or her parents at birth or may be legally recognised as 'given names' through a formal process. All given names are ordered in one field so that, for example, the given name for Johann Sebastian Bach is 'Johann Sebastian'.
|}

File:BirthEvidence-UML-v1.7.drawio.png

2022-02-27T12:17:07Z

Ioannis.konstantinidis:

Included codelist types

Domicile Registration Canonical Evidence

2022-02-27T12:16:15Z

Ioannis.konstantinidis: Updated diagram. TODO: Update the information on the table

File:DomicileRegistrationEvidence-UML-1.7.drawio.png

2022-02-27T12:11:40Z

Ioannis.konstantinidis:

Updated UML with codelist types

2021-06-08T09:48:23Z

Ioannis.konstantinidis:

File:BirthEvidence-UML-v2.png

2021-06-08T09:47:18Z

Ioannis.konstantinidis:

File:BirthEvidence-UML.png

2021-06-08T09:44:00Z

Ioannis.konstantinidis: Ioannis.konstantinidis reverted File:BirthEvidence-UML.png to an old version

Birth Canonical Evidence UML diagram

File:BirthEvidence-UML.png

2021-06-08T09:43:37Z

Ioannis.konstantinidis: Ioannis.konstantinidis reverted File:BirthEvidence-UML.png to an old version

Birth Canonical Evidence UML diagram

File:BirthEvidence-UML.png

2021-06-08T09:43:20Z

Ioannis.konstantinidis: Ioannis.konstantinidis uploaded a new version of File:BirthEvidence-UML.png

Birth Canonical Evidence UML diagram

Domicile Registration Canonical Evidence

2021-06-08T09:42:36Z

Ioannis.konstantinidis:

==Description==
This evidence contains elements related to the Domicile Registration Evidence. The Canonical Evidence in [[Use Case "Request Address Change" (MA UC1)]].

== XSD ==
XSD files can be found on the [https://github.com/de4a-wp3/moving_abroad GitHub repository].

==Diagram==
[[File:DomicileRegistrationEvidence-UML-v2.png|alt=|center]]

==Attribute Specification==
{| class="wikitable"
|+
!DE4A name
!Property type
!Cardinality
!Data type
!Related Vocabulary
!Controlled vocabulary
!Definition
|-
|'''DomicileRegistrationEvidence'''
|'''Class'''
|
|
|
|
|'''This class contains elements related to the Domicile Registration Evidence.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cva:Cvidentifier
|
|An unambiguous reference to the Domicile Registration Evidence.
|-
|IssueDate
|Datatype
|[1..1]
|Date
|udt:Date
|
|The most recent date on which the Domicile Registration Evidence instance was issued.
|-
|IssuingAuthority
|Object
|[1..1]
|PublicOrganisation
|
|
|A Public Organisation with official authority in charge of issuing the Domicile Registration Evidence.
|-
|IssuingPlace
|Object
|[1..1]
|LocationAddress
|
|
|The location address where the Domicile Registration Evidence was issued.
|-
|CertifiesDomicile
|Object
|[1..1]
|Domicile
|
|
|Attesting in a formal way that the Domicile is true.
|-
|'''PublicOrganisation'''
|'''Class'''
|
|
|
|
|'''Any organisation that is defined as being part of the public sector by a legal framework at any level.'''
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|Many organisations are referred to by an acronym or some other identifier. For example, among the EU institutions, the ECB is the identifier for the European Central Bank, OLAF for the European Anti-Fraud Office, and so on. These are formally recognised by the European Commission which provides a list of such acronyms. Analogous lists should be used in other contexts.
|-
|PrefLabel
|Datatype
|[1..*]
|Text
|udt:Text
|
|As defined in the ORG Ontology, a preferred label is used to provide the primary, legally recognised name of the organisation. An organisation 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.
|-
|'''Domicile'''
|'''Class'''
|
|
|
|
|'''This class contains elements related to the domicile'''
|-
|Inhabitant
|Object
|[1..1]
|Person
|
|
|Person, living in the residence or domicile
|-
|Domicile
|Object
|[1..1]
|ConstrainedLocationAddress
|
|
|Current domicile inhabited by person
|-
|'''Person'''
|'''Class'''
|
|
|
|
|'''An individual natural person who may be dead or alive, but not imaginary.'''
|-
|PersonName
|Object
|[1..1]
|Name
|
|
|The family name and given name of a Person. At least one of the two must exist.
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|The identifier relation is used to link a Person to any formally issued Identifier for that Person.
|-
|DateOfBirth
|Object
|[0..1]
|DateObject
|
|
|The day on which the person was born.
|-
|Gender
|Datatype
|[0..1]
|Code
|udt:Code
|Human Sex
|The chromosomal state, and reproductive organs and structures of a Person that allows them to be distinguished as female or male or not applicable, not known or not stated.
|-
|MaritalStatus
|Datatype
|[0..1]
|Code
|udt:Code
|Marital Status
|An indicator of the marital status
|-
|PlaceOfBirth
|Object
|[0..1]
|LocationAddress
|
|
|The Location where the person was born
|-
|Citizenship
|Object
|[0..*]
|Jurisdiction
|
|
|The citizenship relationship links a Person to a Jurisdiction that has conferred citizenship rights on the individual such as the right to vote, to receive certain protection from the community or the issuance of a passport.
|-
|'''Jurisdiction'''
|'''Class'''
|
|
|
|
|'''The authority that an official organisation has, to make legal decisions about somebody/something.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cvb:JurisdictionID
|
|The value for the id property is a URI for that Jurisdiction.
|-
|Name
|Datatype
|[1..*]
|Text
|cbc:Name
|
|The name is simply a string that identifies the Jurisdiction, typically a country, with or without a language tag.
|-
|'''ConstrainedLocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of a location based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[1..1]
|Text
|cvb:AdminunitSecondline
|NUTS/LAU
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[1..1]
|Text
|cvb:AdminunitFirstline
|Country
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''LocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of the place of birth based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[0..1]
|Text
|cvb:AdminunitSecondline
|
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[0..1]
|Text
|cvb:AdminunitFirstline
|Country
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''Address'''
|'''Class'''
|
|
|
|
|'''Representation of address based on the INSPIRE Address Representation.'''
|-
|PoBox
|Datatype
|[0..1]
|Text
|cvb:PoBox
|
|The Post Office Box 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.
|-
|Thoroughfare
|Datatype
|[0..1]
|Text
|cvb:Thoroughfare
|
|Quoting from the INSPIRE guidelines, a thoroughfare is: "an address component that represents the name of a passage or way through from one location to another. A thoroughfare is not necessarily a road, it might be a waterway or some other feature.
|-
|LocatorDesignator
|Datatype
|[0..1]
|Text
|cvb:LocatorDesignator
|
|The locator designator is defined by the INSPIRE guidelines as "a number or a sequence of characters that uniquely identifies the locator within the relevant scope(s). The full identification of the locator could include one or more locator designators." 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."
|-
|LocatorName
|Datatype
|[0..1]
|Text
|cvb:LocatorName
|
|Based on the INSPIRE guidelines, locator name is defined as: "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.
|-
|AddressArea
|Datatype
|[0..1]
|Text
|cvb:CvaddressArea
|
|Taking the definition from INSPIRE, the address area is: 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.
|-
|PostName
|Datatype
|[0..1]
|Text
|cvb:PostName
|
|The key postal division of the address, usually the city. (INSPIRE's definition is "One or more names created and maintained for postal purposes to identify a subdivision of addresses and postal delivery points.)
|-
|PostCode
|Datatype
|[0..1]
|Text
|cvb:PostCode
|
|The post code (a.k.a postal code, zip code etc.). Post codes are common elements in many countries' postal address systems.
|-
|'''Name'''
|'''Class'''
|
|
|
|
|'''A name of a person that includes the family and given name.'''
|-
|FamilyName
|Datatype
|[0..*]
|Text
|cbc:FamilyName
|
|A family name is usually shared by members of a family. 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 field so that, for example, Miguel de Cervantes Saavedra's Family Name would be recorded as "de Cervantes Saavedra".
|-
|GivenName
|Datatype
|[0..*]
|Text
|cvb:GivenName
|
|A given name, or multiple given names, are the denominator(s) that identify an individual within a family. These are given to a Person by his or her parents at birth or may be legally recognised as 'given names' through a formal process. All given names are ordered in one field so that, for example, the given name for Johann Sebastian Bach is 'Johann Sebastian'.
|-
|'''DateObject'''
|'''Class'''
|
|
|
|
|'''Structured representation of date with year, month and day of the month.'''
|-
|Year
|Datatype
|[0..1]
|Year
|xsd:gYear
|
|A gregorian calendar year. The value space of Year is the set of Gregorian calendar years as defined in § 5.2.1 of ISO 8601. Specifically, it is a set of one-year long, non-periodic instances e.g. lexical 1999 to represent the whole year 1999, independent of how many months and days this year has.
|-
|Month
|Datatype
|[0..1]
|Month
|xsd:gMonth
|
|A gregorian month that recurs every year. The value space of Month is the space of a set of calendar months as defined in § 3 of ISO 8601. Specifically, it is a set of one-month long, yearly periodic instances.
|-
|Day
|Datatype
|[0..1]
|Day
|xsd:gDay
|
|A gregorian day that recurs, specifically a day of the month such as the 5th of the month. The value space of Day is the space of a set of calendar dates as defined in § 3 of ISO 8601. Specifically, it is a set of one-day long, monthly periodic instances.
|}

File:DomicileRegistrationEvidence-UML-v2.png

2021-06-08T09:41:26Z

Ioannis.konstantinidis:

Domicile Registration Canonical Evidence

2021-06-08T09:33:15Z

Ioannis.konstantinidis:

==Description==
This evidence contains elements related to the Domicile Registration Evidence. The Canonical Evidence in [[Use Case "Request Address Change" (MA UC1)]].

== XSD ==
XSD files can be found on the [https://github.com/de4a-wp3/moving_abroad GitHub repository].

==Diagram==
[[File:DomicileRegistrationEvidence-UML.png|alt=|center]]

==Attribute Specification==
{| class="wikitable"
|+
!DE4A name
!Property type
!Cardinality
!Data type
!Related Vocabulary
!Controlled vocabulary
!Definition
|-
|'''DomicileRegistrationEvidence'''
|'''Class'''
|
|
|
|
|'''This class contains elements related to the Domicile Registration Evidence.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cva:Cvidentifier
|
|An unambiguous reference to the Domicile Registration Evidence.
|-
|IssueDate
|Datatype
|[1..1]
|Date
|udt:Date
|
|The most recent date on which the Domicile Registration Evidence instance was issued.
|-
|IssuingAuthority
|Object
|[1..1]
|PublicOrganisation
|
|
|A Public Organisation with official authority in charge of issuing the Domicile Registration Evidence.
|-
|IssuingPlace
|Object
|[1..1]
|LocationAddress
|
|
|The location address where the Domicile Registration Evidence was issued.
|-
|CertifiesDomicile
|Object
|[1..1]
|Domicile
|
|
|Attesting in a formal way that the Domicile is true.
|-
|'''PublicOrganisation'''
|'''Class'''
|
|
|
|
|'''Any organisation that is defined as being part of the public sector by a legal framework at any level.'''
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|Many organisations are referred to by an acronym or some other identifier. For example, among the EU institutions, the ECB is the identifier for the European Central Bank, OLAF for the European Anti-Fraud Office, and so on. These are formally recognised by the European Commission which provides a list of such acronyms. Analogous lists should be used in other contexts.
|-
|PrefLabel
|Datatype
|[1..*]
|Text
|udt:Text
|
|As defined in the ORG Ontology, a preferred label is used to provide the primary, legally recognised name of the organisation. An organisation 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.
|-
|'''Domicile'''
|'''Class'''
|
|
|
|
|'''This class contains elements related to the domicile'''
|-
|Inhabitant
|Object
|[1..1]
|Person
|
|
|Person, living in the residence or domicile
|-
|Domicile
|Object
|[1..1]
|ConstrainedLocationAddress
|
|
|Current domicile inhabited by person
|-
|'''Person'''
|'''Class'''
|
|
|
|
|'''An individual natural person who may be dead or alive, but not imaginary.'''
|-
|PersonName
|Object
|[1..1]
|Name
|
|
|The family name and given name of a Person. At least one of the two must exist.
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|The identifier relation is used to link a Person to any formally issued Identifier for that Person.
|-
|DateOfBirth
|Object
|[0..1]
|DateObject
|
|
|The day on which the person was born.
|-
|Gender
|Datatype
|[0..1]
|Code
|udt:Code
|Human Sex
|The chromosomal state, and reproductive organs and structures of a Person that allows them to be distinguished as female or male or not applicable, not known or not stated.
|-
|MaritalStatus
|Datatype
|[0..1]
|Code
|udt:Code
|Marital Status
|An indicator of the marital status
|-
|PlaceOfBirth
|Object
|[0..1]
|LocationAddress
|
|
|The Location where the person was born
|-
|Citizenship
|Object
|[0..*]
|Jurisdiction
|
|
|The citizenship relationship links a Person to a Jurisdiction that has conferred citizenship rights on the individual such as the right to vote, to receive certain protection from the community or the issuance of a passport.
|-
|'''Jurisdiction'''
|'''Class'''
|
|
|
|
|'''The authority that an official organisation has, to make legal decisions about somebody/something.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cvb:JurisdictionID
|
|The value for the id property is a URI for that Jurisdiction.
|-
|Name
|Datatype
|[1..*]
|Text
|cbc:Name
|
|The name is simply a string that identifies the Jurisdiction, typically a country, with or without a language tag.
|-
|'''ConstrainedLocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of a location based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[1..1]
|Text
|cvb:AdminunitSecondline
|NUTS/LAU
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[1..1]
|Text
|cvb:AdminunitFirstline
|Country
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''LocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of the place of birth based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[0..1]
|Text
|cvb:AdminunitSecondline
|
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[0..1]
|Text
|cvb:AdminunitFirstline
|Country
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''Address'''
|'''Class'''
|
|
|
|
|'''Representation of address based on the INSPIRE Address Representation.'''
|-
|PoBox
|Datatype
|[0..1]
|Text
|cvb:PoBox
|
|The Post Office Box 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.
|-
|Thoroughfare
|Datatype
|[0..1]
|Text
|cvb:Thoroughfare
|
|Quoting from the INSPIRE guidelines, a thoroughfare is: "an address component that represents the name of a passage or way through from one location to another. A thoroughfare is not necessarily a road, it might be a waterway or some other feature.
|-
|LocatorDesignator
|Datatype
|[0..1]
|Text
|cvb:LocatorDesignator
|
|The locator designator is defined by the INSPIRE guidelines as "a number or a sequence of characters that uniquely identifies the locator within the relevant scope(s). The full identification of the locator could include one or more locator designators." 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."
|-
|LocatorName
|Datatype
|[0..1]
|Text
|cvb:LocatorName
|
|Based on the INSPIRE guidelines, locator name is defined as: "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.
|-
|AddressArea
|Datatype
|[0..1]
|Text
|cvb:CvaddressArea
|
|Taking the definition from INSPIRE, the address area is: 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.
|-
|PostName
|Datatype
|[0..1]
|Text
|cvb:PostName
|
|The key postal division of the address, usually the city. (INSPIRE's definition is "One or more names created and maintained for postal purposes to identify a subdivision of addresses and postal delivery points.)
|-
|PostCode
|Datatype
|[0..1]
|Text
|cvb:PostCode
|
|The post code (a.k.a postal code, zip code etc.). Post codes are common elements in many countries' postal address systems.
|-
|'''Name'''
|'''Class'''
|
|
|
|
|'''A name of a person that includes the family and given name.'''
|-
|FamilyName
|Datatype
|[0..*]
|Text
|cbc:FamilyName
|
|A family name is usually shared by members of a family. 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 field so that, for example, Miguel de Cervantes Saavedra's Family Name would be recorded as "de Cervantes Saavedra".
|-
|GivenName
|Datatype
|[0..*]
|Text
|cvb:GivenName
|
|A given name, or multiple given names, are the denominator(s) that identify an individual within a family. These are given to a Person by his or her parents at birth or may be legally recognised as 'given names' through a formal process. All given names are ordered in one field so that, for example, the given name for Johann Sebastian Bach is 'Johann Sebastian'.
|-
|'''DateObject'''
|'''Class'''
|
|
|
|
|'''Structured representation of date with year, month and day of the month.'''
|-
|Year
|Datatype
|[0..1]
|Year
|xsd:gYear
|
|A gregorian calendar year. The value space of Year is the set of Gregorian calendar years as defined in § 5.2.1 of ISO 8601. Specifically, it is a set of one-year long, non-periodic instances e.g. lexical 1999 to represent the whole year 1999, independent of how many months and days this year has.
|-
|Month
|Datatype
|[0..1]
|Month
|xsd:gMonth
|
|A gregorian month that recurs every year. The value space of Month is the space of a set of calendar months as defined in § 3 of ISO 8601. Specifically, it is a set of one-month long, yearly periodic instances.
|-
|Day
|Datatype
|[0..1]
|Day
|xsd:gDay
|
|A gregorian day that recurs, specifically a day of the month such as the 5th of the month. The value space of Day is the space of a set of calendar dates as defined in § 3 of ISO 8601. Specifically, it is a set of one-day long, monthly periodic instances.
|}

File:DomicileRegistrationEvidence-UML.png

2021-06-08T09:31:11Z

Ioannis.konstantinidis: Ioannis.konstantinidis uploaded a new version of File:DomicileRegistrationEvidence-UML.png

Domicile Registration Canonical Evidence UML diagram

Domicile Registration Canonical Evidence

2021-06-08T09:24:47Z

Ioannis.konstantinidis:

==Description==
This evidence contains elements related to the Domicile Registration Evidence. The Canonical Evidence in [[Use Case "Request Address Change" (MA UC1)]].

== XSD ==
XSD files can be found on the [https://github.com/de4a-wp3/moving_abroad GitHub repository].

==Diagram==
[[File:DomicileRegistrationEvidence-UML.png|center]]
==Attribute Specification==
{| class="wikitable"
|+
!DE4A name
!Property type
!Cardinality
!Data type
!Related Vocabulary
!Controlled vocabulary
!Definition
|-
|'''DomicileRegistrationEvidence'''
|'''Class'''
|
|
|
|
|'''This class contains elements related to the Domicile Registration Evidence.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cva:Cvidentifier
|
|An unambiguous reference to the Domicile Registration Evidence.
|-
|IssueDate
|Datatype
|[1..1]
|Date
|udt:Date
|
|The most recent date on which the Domicile Registration Evidence instance was issued.
|-
|IssuingAuthority
|Object
|[1..1]
|PublicOrganisation
|
|
|A Public Organisation with official authority in charge of issuing the Domicile Registration Evidence.
|-
|IssuingPlace
|Object
|[1..1]
|LocationAddress
|
|
|The location address where the Domicile Registration Evidence was issued.
|-
|CertifiesDomicile
|Object
|[1..1]
|Domicile
|
|
|Attesting in a formal way that the Domicile is true.
|-
|'''PublicOrganisation'''
|'''Class'''
|
|
|
|
|'''Any organisation that is defined as being part of the public sector by a legal framework at any level.'''
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|Many organisations are referred to by an acronym or some other identifier. For example, among the EU institutions, the ECB is the identifier for the European Central Bank, OLAF for the European Anti-Fraud Office, and so on. These are formally recognised by the European Commission which provides a list of such acronyms. Analogous lists should be used in other contexts.
|-
|PrefLabel
|Datatype
|[1..*]
|Text
|udt:Text
|
|As defined in the ORG Ontology, a preferred label is used to provide the primary, legally recognised name of the organisation. An organisation 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.
|-
|'''Domicile'''
|'''Class'''
|
|
|
|
|'''This class contains elements related to the domicile'''
|-
|Inhabitant
|Object
|[1..1]
|Person
|
|
|Person, living in the residence or domicile
|-
|Domicile
|Object
|[1..1]
|ConstrainedLocationAddress
|
|
|Current domicile inhabited by person
|-
|'''Person'''
|'''Class'''
|
|
|
|
|'''An individual natural person who may be dead or alive, but not imaginary.'''
|-
|PersonName
|Object
|[1..1]
|Name
|
|
|The family name and given name of a Person. At least one of the two must exist.
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|The identifier relation is used to link a Person to any formally issued Identifier for that Person.
|-
|DateOfBirth
|Object
|[0..1]
|DateObject
|
|
|The day on which the person was born.
|-
|Gender
|Datatype
|[0..1]
|Code
|udt:Code
|Human Sex
|The chromosomal state, and reproductive organs and structures of a Person that allows them to be distinguished as female or male or not applicable, not known or not stated.
|-
|MaritalStatus
|Datatype
|[0..1]
|Code
|udt:Code
|Marital Status
|An indicator of the marital status
|-
|PlaceOfBirth
|Object
|[0..1]
|LocationAddress
|
|
|The Location where the person was born
|-
|Citizenship
|Object
|[0..*]
|Jurisdiction
|
|
|The citizenship relationship links a Person to a Jurisdiction that has conferred citizenship rights on the individual such as the right to vote, to receive certain protection from the community or the issuance of a passport.
|-
|'''Jurisdiction'''
|'''Class'''
|
|
|
|
|'''The authority that an official organisation has, to make legal decisions about somebody/something.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cvb:JurisdictionID
|
|The value for the id property is a URI for that Jurisdiction.
|-
|Name
|Datatype
|[1..*]
|Text
|cbc:Name
|
|The name is simply a string that identifies the Jurisdiction, typically a country, with or without a language tag.
|-
|'''ConstrainedLocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of a location based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[1..1]
|Text
|cvb:AdminunitSecondline
|NUTS/LAU
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[1..1]
|Text
|cvb:AdminunitFirstline
|Country
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''LocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of the place of birth based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[0..1]
|Text
|cvb:AdminunitSecondline
|
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[0..1]
|Text
|cvb:AdminunitFirstline
|Country
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''Address'''
|'''Class'''
|
|
|
|
|'''Representation of address based on the INSPIRE Address Representation.'''
|-
|PoBox
|Datatype
|[0..1]
|Text
|cvb:PoBox
|
|The Post Office Box 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.
|-
|Thoroughfare
|Datatype
|[0..1]
|Text
|cvb:Thoroughfare
|
|Quoting from the INSPIRE guidelines, a thoroughfare is: "an address component that represents the name of a passage or way through from one location to another. A thoroughfare is not necessarily a road, it might be a waterway or some other feature.
|-
|LocatorDesignator
|Datatype
|[0..1]
|Text
|cvb:LocatorDesignator
|
|The locator designator is defined by the INSPIRE guidelines as "a number or a sequence of characters that uniquely identifies the locator within the relevant scope(s). The full identification of the locator could include one or more locator designators." 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."
|-
|LocatorName
|Datatype
|[0..1]
|Text
|cvb:LocatorName
|
|Based on the INSPIRE guidelines, locator name is defined as: "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.
|-
|AddressArea
|Datatype
|[0..1]
|Text
|cvb:CvaddressArea
|
|Taking the definition from INSPIRE, the address area is: 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.
|-
|PostName
|Datatype
|[0..1]
|Text
|cvb:PostName
|
|The key postal division of the address, usually the city. (INSPIRE's definition is "One or more names created and maintained for postal purposes to identify a subdivision of addresses and postal delivery points.)
|-
|PostCode
|Datatype
|[0..1]
|Text
|cvb:PostCode
|
|The post code (a.k.a postal code, zip code etc.). Post codes are common elements in many countries' postal address systems.
|-
|'''Name'''
|'''Class'''
|
|
|
|
|'''A name of a person that includes the family and given name.'''
|-
|FamilyName
|Datatype
|[0..*]
|Text
|cbc:FamilyName
|
|A family name is usually shared by members of a family. 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 field so that, for example, Miguel de Cervantes Saavedra's Family Name would be recorded as "de Cervantes Saavedra".
|-
|GivenName
|Datatype
|[0..*]
|Text
|cvb:GivenName
|
|A given name, or multiple given names, are the denominator(s) that identify an individual within a family. These are given to a Person by his or her parents at birth or may be legally recognised as 'given names' through a formal process. All given names are ordered in one field so that, for example, the given name for Johann Sebastian Bach is 'Johann Sebastian'.
|-
|'''DateObject'''
|'''Class'''
|
|
|
|
|'''Structured representation of date with year, month and day of the month.'''
|-
|Year
|Datatype
|[0..1]
|Year
|xsd:gYear
|
|A gregorian calendar year. The value space of Year is the set of Gregorian calendar years as defined in § 5.2.1 of ISO 8601. Specifically, it is a set of one-year long, non-periodic instances e.g. lexical 1999 to represent the whole year 1999, independent of how many months and days this year has.
|-
|Month
|Datatype
|[0..1]
|Month
|xsd:gMonth
|
|A gregorian month that recurs every year. The value space of Month is the space of a set of calendar months as defined in § 3 of ISO 8601. Specifically, it is a set of one-month long, yearly periodic instances.
|-
|Day
|Datatype
|[0..1]
|Day
|xsd:gDay
|
|A gregorian day that recurs, specifically a day of the month such as the 5th of the month. The value space of Day is the space of a set of calendar dates as defined in § 3 of ISO 8601. Specifically, it is a set of one-day long, monthly periodic instances.
|}

Canonical Evidence

2021-06-03T12:16:25Z

Ioannis.konstantinidis:

Canonical Evidence

2021-06-03T12:14:56Z

Ioannis.konstantinidis:

Canonical Evidence

2021-06-03T12:13:41Z

Ioannis.konstantinidis: Added MA canonical evidence types information

Domicile Registration Canonical Evidence

2021-06-03T12:08:51Z

Ioannis.konstantinidis:

==Description==
This class contains elements related to the Domicile Registration Evidence. The Canonical Evidence in [[Use Case "Request Address Change" (MA UC1)]].

== XSD ==
XSD files can be found on the [https://github.com/de4a-wp3/moving_abroad GitHub repository].

==Diagram==
[[File:DomicileRegistrationEvidence-UML.png|center]]
==Attribute Specification==
{| class="wikitable"
|+
!DE4A name
!Property type
!Cardinality
!Data type
!Related Vocabulary
!Controlled vocabulary
!Definition
|-
|'''DomicileRegistrationEvidence'''
|'''Class'''
|
|
|
|
|'''This class contains elements related to the Domicile Registration Evidence.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cva:Cvidentifier
|
|An unambiguous reference to the Domicile Registration Evidence.
|-
|IssueDate
|Datatype
|[1..1]
|Date
|udt:Date
|
|The most recent date on which the Domicile Registration Evidence instance was issued.
|-
|IssuingAuthority
|Object
|[1..1]
|PublicOrganisation
|
|
|A Public Organisation with official authority in charge of issuing the Domicile Registration Evidence.
|-
|IssuingPlace
|Object
|[1..1]
|LocationAddress
|
|
|The location address where the Domicile Registration Evidence was issued.
|-
|CertifiesDomicile
|Object
|[1..1]
|Domicile
|
|
|Attesting in a formal way that the Domicile is true.
|-
|'''PublicOrganisation'''
|'''Class'''
|
|
|
|
|'''Any organisation that is defined as being part of the public sector by a legal framework at any level.'''
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|Many organisations are referred to by an acronym or some other identifier. For example, among the EU institutions, the ECB is the identifier for the European Central Bank, OLAF for the European Anti-Fraud Office, and so on. These are formally recognised by the European Commission which provides a list of such acronyms. Analogous lists should be used in other contexts.
|-
|PrefLabel
|Datatype
|[1..*]
|Text
|udt:Text
|
|As defined in the ORG Ontology, a preferred label is used to provide the primary, legally recognised name of the organisation. An organisation 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.
|-
|'''Domicile'''
|'''Class'''
|
|
|
|
|'''This class contains elements related to the domicile'''
|-
|Inhabitant
|Object
|[1..1]
|Person
|
|
|Person, living in the residence or domicile
|-
|Domicile
|Object
|[1..1]
|ConstrainedLocationAddress
|
|
|Current domicile inhabited by person
|-
|'''Person'''
|'''Class'''
|
|
|
|
|'''An individual natural person who may be dead or alive, but not imaginary.'''
|-
|PersonName
|Object
|[1..1]
|Name
|
|
|The family name and given name of a Person. At least one of the two must exist.
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|The identifier relation is used to link a Person to any formally issued Identifier for that Person.
|-
|DateOfBirth
|Object
|[0..1]
|DateObject
|
|
|The day on which the person was born.
|-
|Gender
|Datatype
|[0..1]
|Code
|udt:Code
|Human Sex
|The chromosomal state, and reproductive organs and structures of a Person that allows them to be distinguished as female or male or not applicable, not known or not stated.
|-
|MaritalStatus
|Datatype
|[0..1]
|Code
|udt:Code
|Marital Status
|An indicator of the marital status
|-
|PlaceOfBirth
|Object
|[0..1]
|LocationAddress
|
|
|The Location where the person was born
|-
|Citizenship
|Object
|[0..*]
|Jurisdiction
|
|
|The citizenship relationship links a Person to a Jurisdiction that has conferred citizenship rights on the individual such as the right to vote, to receive certain protection from the community or the issuance of a passport.
|-
|'''Jurisdiction'''
|'''Class'''
|
|
|
|
|'''The authority that an official organisation has, to make legal decisions about somebody/something.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cvb:JurisdictionID
|
|The value for the id property is a URI for that Jurisdiction.
|-
|Name
|Datatype
|[1..*]
|Text
|cbc:Name
|
|The name is simply a string that identifies the Jurisdiction, typically a country, with or without a language tag.
|-
|'''ConstrainedLocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of a location based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[1..1]
|Text
|cvb:AdminunitSecondline
|NUTS/LAU
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[1..1]
|Text
|cvb:AdminunitFirstline
|Country
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''LocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of the place of birth based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[0..1]
|Text
|cvb:AdminunitSecondline
|
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[0..1]
|Text
|cvb:AdminunitFirstline
|Country
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''Address'''
|'''Class'''
|
|
|
|
|'''Representation of address based on the INSPIRE Address Representation.'''
|-
|PoBox
|Datatype
|[0..1]
|Text
|cvb:PoBox
|
|The Post Office Box 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.
|-
|Thoroughfare
|Datatype
|[0..1]
|Text
|cvb:Thoroughfare
|
|Quoting from the INSPIRE guidelines, a thoroughfare is: "an address component that represents the name of a passage or way through from one location to another. A thoroughfare is not necessarily a road, it might be a waterway or some other feature.
|-
|LocatorDesignator
|Datatype
|[0..1]
|Text
|cvb:LocatorDesignator
|
|The locator designator is defined by the INSPIRE guidelines as "a number or a sequence of characters that uniquely identifies the locator within the relevant scope(s). The full identification of the locator could include one or more locator designators." 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."
|-
|LocatorName
|Datatype
|[0..1]
|Text
|cvb:LocatorName
|
|Based on the INSPIRE guidelines, locator name is defined as: "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.
|-
|AddressArea
|Datatype
|[0..1]
|Text
|cvb:CvaddressArea
|
|Taking the definition from INSPIRE, the address area is: 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.
|-
|PostName
|Datatype
|[0..1]
|Text
|cvb:PostName
|
|The key postal division of the address, usually the city. (INSPIRE's definition is "One or more names created and maintained for postal purposes to identify a subdivision of addresses and postal delivery points.)
|-
|PostCode
|Datatype
|[0..1]
|Text
|cvb:PostCode
|
|The post code (a.k.a postal code, zip code etc.). Post codes are common elements in many countries' postal address systems.
|-
|'''Name'''
|'''Class'''
|
|
|
|
|'''A name of a person that includes the family and given name.'''
|-
|FamilyName
|Datatype
|[0..*]
|Text
|cbc:FamilyName
|
|A family name is usually shared by members of a family. 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 field so that, for example, Miguel de Cervantes Saavedra's Family Name would be recorded as "de Cervantes Saavedra".
|-
|GivenName
|Datatype
|[0..*]
|Text
|cvb:GivenName
|
|A given name, or multiple given names, are the denominator(s) that identify an individual within a family. These are given to a Person by his or her parents at birth or may be legally recognised as 'given names' through a formal process. All given names are ordered in one field so that, for example, the given name for Johann Sebastian Bach is 'Johann Sebastian'.
|-
|'''DateObject'''
|'''Class'''
|
|
|
|
|'''Structured representation of date with year, month and day of the month.'''
|-
|Year
|Datatype
|[0..1]
|Year
|xsd:gYear
|
|A gregorian calendar year. The value space of Year is the set of Gregorian calendar years as defined in § 5.2.1 of ISO 8601. Specifically, it is a set of one-year long, non-periodic instances e.g. lexical 1999 to represent the whole year 1999, independent of how many months and days this year has.
|-
|Month
|Datatype
|[0..1]
|Month
|xsd:gMonth
|
|A gregorian month that recurs every year. The value space of Month is the space of a set of calendar months as defined in § 3 of ISO 8601. Specifically, it is a set of one-month long, yearly periodic instances.
|-
|Day
|Datatype
|[0..1]
|Day
|xsd:gDay
|
|A gregorian day that recurs, specifically a day of the month such as the 5th of the month. The value space of Day is the space of a set of calendar dates as defined in § 3 of ISO 8601. Specifically, it is a set of one-day long, monthly periodic instances.
|}

Marriage Canonical Evidence

2021-06-03T12:08:09Z

Ioannis.konstantinidis:

==Description==
Official document or data proving the Marriage of two Persons. The Canonical Evidence in [[Use Case "Request an Extract or Copy of a Civil State Certificate" (MA UC2)]].

==XSD==
XSD files can be found on the [https://github.com/de4a-wp3/moving_abroad GitHub repository].

==Diagram==
[[File:MarriageEvidence-UML.png|center]]
==Attribute Specification==
{| class="wikitable"
|+
!DE4A name
!Property type
!Cardinality
!Data type
!Related vocabulary
!Controlled vocabulary
!Definitions
|-
|'''MarriageEvidence'''
|'''Class'''
|
|
|
|
|'''Official document or data proving the Marriage of two Persons.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cva:Cvidentifier
|
|An unambiguous reference to the Marriage Evidence.
|-
|IssueDate
|Datatype
|[1..1]
|Date
|udt:Date
|
|The most recent date on which the Marriage Evidence instance was issued.
|-
|IssuingAuthority
|Object
|[1..1]
|PublicOrganisation
|
|
|A Public Organisation with official authority in charge of issuing the Marriage Evidence.
|-
|IssuingPlace
|Object
|[1..1]
|ConstrainedLocationAddress
|
|
|The Location where the Marriage Evidence was issued.
|-
|CertifiesMarriage
|Object
|[1..1]
|Marriage
|
|
|Attesting in a formal way that the Marriage is true.
|-
|CertifiesEndOfMarriage
|Object
|[0..1]
|EndOfMarriage
|
|
|In case of divorce, this property includes information on the end of marriage
|-
|'''PublicOrganisation'''
|'''Class'''
|
|
|
|
|'''Any organisation that is defined as being part of the public sector by a legal framework at any level.'''
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|Many organisations are referred to by an acronym or some other identifier. For example, among the EU institutions, the ECB is the identifier for the European Central Bank, OLAF for the European Anti-Fraud Office, and so on. These are formally recognised by the European Commission which provides a list of such acronyms. Analogous lists should be used in other contexts.
|-
|PrefLabel
|Datatype
|[1..*]
|Text
|udt:Text
|
|As defined in the ORG Ontology, a preferred label is used to provide the primary, legally recognised name of the organisation. An organisation 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.
|-
|'''Marriage'''
|'''Class'''
|
|
|
|
|'''A legally accepted relationship between two Persons in which they live together.'''
|-
|DateOfMarriage
|Datatype
|[1..1]
|Date
|udt:Date
|
|The date on which the Marriage took place.
|-
|Spouse
|Object
|[2..2]
|MarriedPerson
|
|
|The Person who was married.
|-
|PlaceOfMarriage
|Object
|[0..1]
|LocationAddress
|
|
|The Location where the Marriage took place.
|-
|'''MarriedPerson'''
|'''Class'''
|
|
|
|
|'''A Person who has entered into a Marriage.'''
|-
|FamilyNameAfterMarriage
|Datatype
|[0..*]
|Text
|udt:Text
|
|This property contains the family name after the Marriage of the Person.
|-
|FamilyNameBeforeMarriage
|Datatype
|[0..*]
|Text
|udt:Text
|
|This property contains the family name before the Marriage of the Person.
|-
|MaritalStatusBeforeMarriage
|Datatype
|[0..1]
|Text
|udt:Code
|Marital Status
|Situation with regard to whether a Person was single, married, separated, divorced or widowed.
|-
|'''Person'''
|'''Class'''
|
|
|
|
|'''An individual natural person who may be dead or alive, but not imaginary.'''
|-
|DateOfBirth
|Datatype
|[0..1]
|DateObject
|
|
|The day on which the Person was born.
|-
|PersonName
|Object
|[1..1]
|Name
|
|
|The family name and given name of a Person. At least one of the two must exist.
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|The identifier relation is used to link a Person to any formally issued Identifier for that Person.
|-
|PlaceOfBirth
|Object
|[0..1]
|LocationAddress
|
|
|The Location where the Person was born.
|-
|Gender
|Datatype
|[1..1]
|Code
|udt:Code
|Human Sex
|The gender of an individual should be recorded using a controlled vocabulary that is appropriate for the specific context. In some cases the chromosomal or physical state of an individual will be more important than the gender that they express, in others the reverse will be true. What is always important is that the controlled vocabulary used to describe an individual's gender is stated explicitly.
|-
|Citizenship
|Object
|[0..*]
|Jurisdiction
|
|
|The citizenship relationship links a Person to a Jurisdiction that has conferred citizenship rights on the individual such as the right to vote, to receive certain protection from the community or the issuance of a passport.
|-
|'''Jurisdiction'''
|'''Class'''
|
|
|
|
|'''The authority that an official organisation has, to make legal decisions about somebody/something.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cvb:JurisdictionID
|
|The value for the id property is a URI for that Jurisdiction.
|-
|Name
|Datatype
|[1..*]
|Text
|cbc:Name
|
|The name is simply a string that identifies the Jurisdiction, typically a country, with or without a language tag.
|-
|'''ConstrainedLocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of a location based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[1..1]
|Text
|cvb:AdminunitSecondline
|
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[1..1]
|Text
|cvb:AdminunitFirstline
|Country
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''LocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of the place of birth based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[0..1]
|Text
|cvb:AdminunitSecondline
|
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[0..1]
|Text
|cvb:AdminunitFirstline
|Country
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''Address'''
|'''Class'''
|
|
|
|
|'''Representation of address based on the INSPIRE Address Representation.'''
|-
|PoBox
|Datatype
|[0..1]
|Text
|cvb:PoBox
|
|The Post Office Box 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.
|-
|Thoroughfare
|Datatype
|[0..1]
|Text
|cvb:Thoroughfare
|
|Quoting from the INSPIRE guidelines, a thoroughfare is: "an address component that represents the name of a passage or way through from one location to another. A thoroughfare is not necessarily a road, it might be a waterway or some other feature.
|-
|LocatorDesignator
|Datatype
|[0..1]
|Text
|cvb:LocatorDesignator
|
|The locator designator is defined by the INSPIRE guidelines as "a number or a sequence of characters that uniquely identifies the locator within the relevant scope(s). The full identification of the locator could include one or more locator designators." 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."
|-
|LocatorName
|Datatype
|[0..1]
|Text
|cvb:LocatorName
|
|Based on the INSPIRE guidelines, locator name is defined as: "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.
|-
|AddressArea
|Datatype
|[0..1]
|Text
|cvb:CvaddressArea
|
|Taking the definition from INSPIRE, the address area is: 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.
|-
|PostName
|Datatype
|[0..1]
|Text
|cvb:PostName
|
|The key postal division of the address, usually the city. (INSPIRE's definition is "One or more names created and maintained for postal purposes to identify a subdivision of addresses and postal delivery points.)
|-
|PostCode
|Datatype
|[0..1]
|Text
|cvb:PostCode
|
|The post code (a.k.a postal code, zip code etc.). Post codes are common elements in many countries' postal address systems.
|-
|'''EndOfMarriage'''
|'''Class'''
|
|
|
|
|'''Date and cause of end of marriage'''
|-
|DateOfEndOfMarriage
|Datatype
|[0..1]
|Date
|udt:Date
|
|
|-
|Cause
|Datatype
|[0..1]
|Text
|udt:Text
|
|
|-
|'''DateObject'''
|'''Class'''
|
|
|
|
|'''Structured representation of date with year, month and day of the month.'''
|-
|Year
|Datatype
|[0..1]
|Year
|xsd:gYear
|
|A gregorian calendar year. The value space of Year is the set of Gregorian calendar years as defined in § 5.2.1 of ISO 8601. Specifically, it is a set of one-year long, non-periodic instances e.g. lexical 1999 to represent the whole year 1999, independent of how many months and days this year has.
|-
|Month
|Datatype
|[0..1]
|Month
|xsd:gMonth
|
|A gregorian month that recurs every year. The value space of Month is the space of a set of calendar months as defined in § 3 of ISO 8601. Specifically, it is a set of one-month long, yearly periodic instances.
|-
|Day
|Datatype
|[0..1]
|Day
|xsd:gDay
|
|A gregorian day that recurs, specifically a day of the month such as the 5th of the month. The value space of Day is the space of a set of calendar dates as defined in § 3 of ISO 8601. Specifically, it is a set of one-day long, monthly periodic instances.
|-
|'''Name'''
|'''Class'''
|
|
|
|
|'''A name of a person that includes the family and given name.'''
|-
|FamilyName
|Datatype
|[0..*]
|Text
|cbc:FamilyName
|
|A family name is usually shared by members of a family. 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 field so that, for example, Miguel de Cervantes Saavedra's Family Name would be recorded as "de Cervantes Saavedra".
|-
|GivenName
|Datatype
|[0..*]
|Text
|cvb:GivenName
|
|A given name, or multiple given names, are the denominator(s) that identify an individual within a family. These are given to a Person by his or her parents at birth or may be legally recognised as 'given names' through a formal process. All given names are ordered in one field so that, for example, the given name for Johann Sebastian Bach is 'Johann Sebastian'.
|}

Birth Canonical Evidence

2021-06-03T12:06:51Z

Ioannis.konstantinidis:

== Description ==
Official document or data proving the Birth of a Child. Canonical evidence in the [[Use Case "Request an Extract or Copy of a Civil State Certificate" (MA UC2)]].

==XSD==
XSD files can be found on the [https://github.com/de4a-wp3/moving_abroad GitHub repository].

== Diagram ==

[[File:BirthEvidence-UML.png|center]]

== Attribute Specification ==
{| class="wikitable"
|+
!'''DE4A name'''
!'''Property type'''
!'''Cardinality'''
!'''Data type'''
!'''Related vocabulary'''
!'''Controlled Vocabulary'''
!'''Definition'''
|-
|'''BirthEvidence'''
|'''Class'''
|
|
|
|
|'''Official document or data proving the Birth of a Child.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cva:Cvidentifier
|
|An unambiguous reference to the Birth Evidence.
|-
|IssueDate
|Datatype
|[1..1]
|Date
|udt:Date
|
|The most recent date on which the Birth Evidence instance was issued.
|-
|IssuingAuthority
|Object
|[1..1]
|PublicOrganisation
|
|
|A Public Organisation with official authority in charge of issuing the Birth Evidence.
|-
|IssuingPlace
|Object
|[1..1]
|ConstrainedLocationAddress
|
|
|The Location where the Birth Evidence was issued.
|-
|CertifiesBirth
|Object
|[1..1]
|Birth
|
|
|Attesting in a formal way that the Birth is true.
|-
|'''PublicOrganisation'''
|'''Class'''
|
|
|
|
|'''Any organisation that is defined as being part of the public sector by a legal framework at any level.'''
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|Many organisations are referred to by an acronym or some other identifier. For example, among the EU institutions, the ECB is the identifier for the European Central Bank, OLAF for the European AntiN/AFraud Office, and so on. These are formally recognised by the European Commission which provides a list of such acronyms. Analogous lists should be used in other contexts.
|-
|PrefLabel
|Datatype
|[1..*]
|Text
|udt:Text
|
|As defined in the ORG Ontology, a preferred label is used to provide the primary, legally recognised name of the organisation. An organisation 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.
|-
|'''Birth'''
|'''Class'''
|
|
|
|
|'''The event indicating the moment a Child emerges from the body of another Person, i.e. start of life.'''
|-
|Child
|Object
|[1..1]
|Child
|
|
|The Person who is born at the Birth.
|-
|Parent
|Object
|[0..2]
|Parent
|
|
|The Parent of the Child.
|-
|'''Child'''
|'''Class'''
|
|
|
|
|'''A Person of any age, who is a son or daughter.'''
|-
|DateOfBirth
|Object
|[1..1]
|DateObject
|
|
|The day on which the Child was born.
|-
|Gender
|Datatype
|[1..1]
|Code
|udt:Code
|[https://op.europa.eu/en/web/eu-vocabularies/at-concept-scheme/-/resource/authority/human-sex/?target=Browse&uri=http://publications.europa.eu/resource/authority/human-sex Human Sex]
|The chromosomal state, and reproductive organs and structures of a Person that allows them to be distinguished as female or male or undetermined.
|-
|PlaceOfBirth
|Object
|[1..1]
|LocationAddress
|
|
|The Location where the Child was born.
|-
|'''Parent'''
|'''Class'''
|
|
|
|
|'''One of the two Persons who are jointly the cause of the Child's Birth, i.e. natural parent.'''
|-
|DateOfBirth
|Object
|[0..1]
|DateObject
|
|
|The day on which the Parent was born.
|-
|Gender
|Datatype
|[0..1]
|Code
|udt:Code
|[https://op.europa.eu/en/web/eu-vocabularies/at-concept-scheme/-/resource/authority/human-sex/?target=Browse&uri=http://publications.europa.eu/resource/authority/human-sex Human Sex]
|The chromosomal state, and reproductive organs and structures of a Person that allows them to be distinguished as female or male or undetermined.
|-
|PlaceOfBirth
|Object
|[0..1]
|LocationAddress
|
|
|The Location where the Parent was born.
|-
|'''Person'''
|'''Class'''
|
|
|
|
|'''An individual natural person who may be dead or alive, but not imaginary.'''
|-
|PersonName
|Object
|[1..1]
|Name
|
|
|The family name and given name of a Person. At least one of the two must exist.
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|The identifier relation is used to link a Person to any formally issued Identifier for that Person.
|-
|Citizenship
|Object
|[0..*]
|Jurisdiction
|
|
|The citizenship relationship links a Person to a Jurisdiction that has conferred citizenship rights on the individual such as the right to vote, to receive certain protection from the community or the issuance of a passport.
|-
|'''Jurisdiction'''
|'''Class'''
|
|
|
|
|'''The authority that an official organisation has, to make legal decisions about somebody/something.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cvb:JurisdictionID
|[https://op.europa.eu/en/web/eu-vocabularies/at-concept-scheme/-/resource/authority/country/?target=Browse&uri=http://publications.europa.eu/resource/authority/country Country]
|The value for the id property is a URI for that Jurisdiction.
|-
|Name
|Datatype
|[1..*]
|Text
|cbc:Name
|[https://op.europa.eu/en/web/eu-vocabularies/at-concept-scheme/-/resource/authority/country/?target=Browse&uri=http://publications.europa.eu/resource/authority/country Country]
|The name is simply a string that identifies the Jurisdiction, typically a country, with or without a language tag.
|-
|'''ConstrainedLocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of a location based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[1..1]
|Text
|cvb:AdminunitSecondline
|
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[1..1]
|Text
|cvb:AdminunitFirstline
|[https://op.europa.eu/en/web/eu-vocabularies/at-concept-scheme/-/resource/authority/country/?target=Browse&uri=http://publications.europa.eu/resource/authority/country Country]
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''LocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of the place of birth based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[0..1]
|Text
|cvb:AdminunitSecondline
|
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[0..1]
|Text
|cvb:AdminunitFirstline
|[https://op.europa.eu/en/web/eu-vocabularies/at-concept-scheme/-/resource/authority/country/?target=Browse&uri=http://publications.europa.eu/resource/authority/country Country]
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''Address'''
|'''Class'''
|
|
|
|
|'''Representation of address based on the INSPIRE Address Representation.'''
|-
|PoBox
|Datatype
|[0..1]
|Text
|cvb:PoBox
|
|The Post Office Box 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.
|-
|Thoroughfare
|Datatype
|[0..1]
|Text
|cvb:Thoroughfare
|
|Quoting from the INSPIRE guidelines, a thoroughfare is: "an address component that represents the name of a passage or way through from one location to another. A thoroughfare is not necessarily a road, it might be a waterway or some other feature.
|-
|LocatorDesignator
|Datatype
|[0..1]
|Text
|cvb:LocatorDesignator
|
|The locator designator is defined by the INSPIRE guidelines as "a number or a sequence of characters that uniquely identifies the locator within the relevant scope(s). The full identification of the locator could include one or more locator designators." 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."
|-
|LocatorName
|Datatype
|[0..1]
|Text
|cvb:LocatorName
|
|Based on the INSPIRE guidelines, locator name is defined as: "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.
|-
|AddressArea
|Datatype
|[0..1]
|Text
|cvb:CvaddressArea
|
|Taking the definition from INSPIRE, the address area is: 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.
|-
|PostName
|Datatype
|[0..1]
|Text
|cvb:PostName
|
|The key postal division of the address, usually the city. (INSPIRE's definition is "One or more names created and maintained for postal purposes to identify a subdivision of addresses and postal delivery points.)
|-
|PostCode
|Datatype
|[0..1]
|Text
|cvb:PostCode
|
|The post code (a.k.a postal code, zip code etc.). Post codes are common elements in many countries' postal address systems.
|-
|'''DateObject'''
|'''Class'''
|
|
|
|
|'''Structured representation of date with year, month and day of the month.'''
|-
|Year
|Datatype
|[0..1]
|Year
|xsd:gYear
|
|A gregorian calendar year. The value space of Year is the set of Gregorian calendar years as defined in § 5.2.1 of ISO 8601. Specifically, it is a set of one-year long, non-periodic instances e.g. lexical 1999 to represent the whole year 1999, independent of how many months and days this year has.
|-
|Month
|Datatype
|[0..1]
|Month
|xsd:gMonth
|
|A gregorian month that recurs every year. The value space of Month is the space of a set of calendar months as defined in § 3 of ISO 8601. Specifically, it is a set of one-month long, yearly periodic instances.
|-
|Day
|Datatype
|[0..1]
|Day
|xsd:gDay
|
|A gregorian day that recurs, specifically a day of the month such as the 5th of the month. The value space of Day is the space of a set of calendar dates as defined in § 3 of ISO 8601. Specifically, it is a set of one-day long, monthly periodic instances.
|-
|'''Name'''
|'''Class'''
|
|
|
|
|'''A name of a person that includes the family and given name.'''
|-
|FamilyName
|Datatype
|[0..*]
|Text
|cbc:FamilyName
|
|A family name is usually shared by members of a family. 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 field so that, for example, Miguel de Cervantes Saavedra's Family Name would be recorded as "de Cervantes Saavedra".
|-
|GivenName
|Datatype
|[0..*]
|Text
|cvb:GivenName
|
|A given name, or multiple given names, are the denominator(s) that identify an individual within a family. These are given to a Person by his or her parents at birth or may be legally recognised as 'given names' through a formal process. All given names are ordered in one field so that, for example, the given name for Johann Sebastian Bach is 'Johann Sebastian'.
|}

Marriage Canonical Evidence

2021-06-03T12:01:14Z

Ioannis.konstantinidis: Added link to the GitHub repository.

==Description==
Official document or data proving the Marriage of two Persons.

==XSD==
XSD files can be found on the [https://github.com/de4a-wp3/moving_abroad GitHub repository].

==Diagram==
[[File:MarriageEvidence-UML.png|center]]
==Attribute Specification==
{| class="wikitable"
|+
!DE4A name
!Property type
!Cardinality
!Data type
!Related vocabulary
!Controlled vocabulary
!Definitions
|-
|'''MarriageEvidence'''
|'''Class'''
|
|
|
|
|'''Official document or data proving the Marriage of two Persons.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cva:Cvidentifier
|
|An unambiguous reference to the Marriage Evidence.
|-
|IssueDate
|Datatype
|[1..1]
|Date
|udt:Date
|
|The most recent date on which the Marriage Evidence instance was issued.
|-
|IssuingAuthority
|Object
|[1..1]
|PublicOrganisation
|
|
|A Public Organisation with official authority in charge of issuing the Marriage Evidence.
|-
|IssuingPlace
|Object
|[1..1]
|ConstrainedLocationAddress
|
|
|The Location where the Marriage Evidence was issued.
|-
|CertifiesMarriage
|Object
|[1..1]
|Marriage
|
|
|Attesting in a formal way that the Marriage is true.
|-
|CertifiesEndOfMarriage
|Object
|[0..1]
|EndOfMarriage
|
|
|In case of divorce, this property includes information on the end of marriage
|-
|'''PublicOrganisation'''
|'''Class'''
|
|
|
|
|'''Any organisation that is defined as being part of the public sector by a legal framework at any level.'''
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|Many organisations are referred to by an acronym or some other identifier. For example, among the EU institutions, the ECB is the identifier for the European Central Bank, OLAF for the European Anti-Fraud Office, and so on. These are formally recognised by the European Commission which provides a list of such acronyms. Analogous lists should be used in other contexts.
|-
|PrefLabel
|Datatype
|[1..*]
|Text
|udt:Text
|
|As defined in the ORG Ontology, a preferred label is used to provide the primary, legally recognised name of the organisation. An organisation 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.
|-
|'''Marriage'''
|'''Class'''
|
|
|
|
|'''A legally accepted relationship between two Persons in which they live together.'''
|-
|DateOfMarriage
|Datatype
|[1..1]
|Date
|udt:Date
|
|The date on which the Marriage took place.
|-
|Spouse
|Object
|[2..2]
|MarriedPerson
|
|
|The Person who was married.
|-
|PlaceOfMarriage
|Object
|[0..1]
|LocationAddress
|
|
|The Location where the Marriage took place.
|-
|'''MarriedPerson'''
|'''Class'''
|
|
|
|
|'''A Person who has entered into a Marriage.'''
|-
|FamilyNameAfterMarriage
|Datatype
|[0..*]
|Text
|udt:Text
|
|This property contains the family name after the Marriage of the Person.
|-
|FamilyNameBeforeMarriage
|Datatype
|[0..*]
|Text
|udt:Text
|
|This property contains the family name before the Marriage of the Person.
|-
|MaritalStatusBeforeMarriage
|Datatype
|[0..1]
|Text
|udt:Code
|Marital Status
|Situation with regard to whether a Person was single, married, separated, divorced or widowed.
|-
|'''Person'''
|'''Class'''
|
|
|
|
|'''An individual natural person who may be dead or alive, but not imaginary.'''
|-
|DateOfBirth
|Datatype
|[0..1]
|DateObject
|
|
|The day on which the Person was born.
|-
|PersonName
|Object
|[1..1]
|Name
|
|
|The family name and given name of a Person. At least one of the two must exist.
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|The identifier relation is used to link a Person to any formally issued Identifier for that Person.
|-
|PlaceOfBirth
|Object
|[0..1]
|LocationAddress
|
|
|The Location where the Person was born.
|-
|Gender
|Datatype
|[1..1]
|Code
|udt:Code
|Human Sex
|The gender of an individual should be recorded using a controlled vocabulary that is appropriate for the specific context. In some cases the chromosomal or physical state of an individual will be more important than the gender that they express, in others the reverse will be true. What is always important is that the controlled vocabulary used to describe an individual's gender is stated explicitly.
|-
|Citizenship
|Object
|[0..*]
|Jurisdiction
|
|
|The citizenship relationship links a Person to a Jurisdiction that has conferred citizenship rights on the individual such as the right to vote, to receive certain protection from the community or the issuance of a passport.
|-
|'''Jurisdiction'''
|'''Class'''
|
|
|
|
|'''The authority that an official organisation has, to make legal decisions about somebody/something.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cvb:JurisdictionID
|
|The value for the id property is a URI for that Jurisdiction.
|-
|Name
|Datatype
|[1..*]
|Text
|cbc:Name
|
|The name is simply a string that identifies the Jurisdiction, typically a country, with or without a language tag.
|-
|'''ConstrainedLocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of a location based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[1..1]
|Text
|cvb:AdminunitSecondline
|
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[1..1]
|Text
|cvb:AdminunitFirstline
|Country
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''LocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of the place of birth based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[0..1]
|Text
|cvb:AdminunitSecondline
|
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[0..1]
|Text
|cvb:AdminunitFirstline
|Country
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''Address'''
|'''Class'''
|
|
|
|
|'''Representation of address based on the INSPIRE Address Representation.'''
|-
|PoBox
|Datatype
|[0..1]
|Text
|cvb:PoBox
|
|The Post Office Box 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.
|-
|Thoroughfare
|Datatype
|[0..1]
|Text
|cvb:Thoroughfare
|
|Quoting from the INSPIRE guidelines, a thoroughfare is: "an address component that represents the name of a passage or way through from one location to another. A thoroughfare is not necessarily a road, it might be a waterway or some other feature.
|-
|LocatorDesignator
|Datatype
|[0..1]
|Text
|cvb:LocatorDesignator
|
|The locator designator is defined by the INSPIRE guidelines as "a number or a sequence of characters that uniquely identifies the locator within the relevant scope(s). The full identification of the locator could include one or more locator designators." 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."
|-
|LocatorName
|Datatype
|[0..1]
|Text
|cvb:LocatorName
|
|Based on the INSPIRE guidelines, locator name is defined as: "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.
|-
|AddressArea
|Datatype
|[0..1]
|Text
|cvb:CvaddressArea
|
|Taking the definition from INSPIRE, the address area is: 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.
|-
|PostName
|Datatype
|[0..1]
|Text
|cvb:PostName
|
|The key postal division of the address, usually the city. (INSPIRE's definition is "One or more names created and maintained for postal purposes to identify a subdivision of addresses and postal delivery points.)
|-
|PostCode
|Datatype
|[0..1]
|Text
|cvb:PostCode
|
|The post code (a.k.a postal code, zip code etc.). Post codes are common elements in many countries' postal address systems.
|-
|'''EndOfMarriage'''
|'''Class'''
|
|
|
|
|'''Date and cause of end of marriage'''
|-
|DateOfEndOfMarriage
|Datatype
|[0..1]
|Date
|udt:Date
|
|
|-
|Cause
|Datatype
|[0..1]
|Text
|udt:Text
|
|
|-
|'''DateObject'''
|'''Class'''
|
|
|
|
|'''Structured representation of date with year, month and day of the month.'''
|-
|Year
|Datatype
|[0..1]
|Year
|xsd:gYear
|
|A gregorian calendar year. The value space of Year is the set of Gregorian calendar years as defined in § 5.2.1 of ISO 8601. Specifically, it is a set of one-year long, non-periodic instances e.g. lexical 1999 to represent the whole year 1999, independent of how many months and days this year has.
|-
|Month
|Datatype
|[0..1]
|Month
|xsd:gMonth
|
|A gregorian month that recurs every year. The value space of Month is the space of a set of calendar months as defined in § 3 of ISO 8601. Specifically, it is a set of one-month long, yearly periodic instances.
|-
|Day
|Datatype
|[0..1]
|Day
|xsd:gDay
|
|A gregorian day that recurs, specifically a day of the month such as the 5th of the month. The value space of Day is the space of a set of calendar dates as defined in § 3 of ISO 8601. Specifically, it is a set of one-day long, monthly periodic instances.
|-
|'''Name'''
|'''Class'''
|
|
|
|
|'''A name of a person that includes the family and given name.'''
|-
|FamilyName
|Datatype
|[0..*]
|Text
|cbc:FamilyName
|
|A family name is usually shared by members of a family. 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 field so that, for example, Miguel de Cervantes Saavedra's Family Name would be recorded as "de Cervantes Saavedra".
|-
|GivenName
|Datatype
|[0..*]
|Text
|cvb:GivenName
|
|A given name, or multiple given names, are the denominator(s) that identify an individual within a family. These are given to a Person by his or her parents at birth or may be legally recognised as 'given names' through a formal process. All given names are ordered in one field so that, for example, the given name for Johann Sebastian Bach is 'Johann Sebastian'.
|}

Birth Canonical Evidence

2021-06-03T12:00:50Z

Ioannis.konstantinidis: Added link to the GitHub repository.

== Description ==
Official document or data proving the Birth of a Child.

==XSD==
XSD files can be found on the [https://github.com/de4a-wp3/moving_abroad GitHub repository].

== Diagram ==

[[File:BirthEvidence-UML.png|center]]

== Attribute Specification ==
{| class="wikitable"
|+
!'''DE4A name'''
!'''Property type'''
!'''Cardinality'''
!'''Data type'''
!'''Related vocabulary'''
!'''Controlled Vocabulary'''
!'''Definition'''
|-
|'''BirthEvidence'''
|'''Class'''
|
|
|
|
|'''Official document or data proving the Birth of a Child.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cva:Cvidentifier
|
|An unambiguous reference to the Birth Evidence.
|-
|IssueDate
|Datatype
|[1..1]
|Date
|udt:Date
|
|The most recent date on which the Birth Evidence instance was issued.
|-
|IssuingAuthority
|Object
|[1..1]
|PublicOrganisation
|
|
|A Public Organisation with official authority in charge of issuing the Birth Evidence.
|-
|IssuingPlace
|Object
|[1..1]
|ConstrainedLocationAddress
|
|
|The Location where the Birth Evidence was issued.
|-
|CertifiesBirth
|Object
|[1..1]
|Birth
|
|
|Attesting in a formal way that the Birth is true.
|-
|'''PublicOrganisation'''
|'''Class'''
|
|
|
|
|'''Any organisation that is defined as being part of the public sector by a legal framework at any level.'''
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|Many organisations are referred to by an acronym or some other identifier. For example, among the EU institutions, the ECB is the identifier for the European Central Bank, OLAF for the European AntiN/AFraud Office, and so on. These are formally recognised by the European Commission which provides a list of such acronyms. Analogous lists should be used in other contexts.
|-
|PrefLabel
|Datatype
|[1..*]
|Text
|udt:Text
|
|As defined in the ORG Ontology, a preferred label is used to provide the primary, legally recognised name of the organisation. An organisation 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.
|-
|'''Birth'''
|'''Class'''
|
|
|
|
|'''The event indicating the moment a Child emerges from the body of another Person, i.e. start of life.'''
|-
|Child
|Object
|[1..1]
|Child
|
|
|The Person who is born at the Birth.
|-
|Parent
|Object
|[0..2]
|Parent
|
|
|The Parent of the Child.
|-
|'''Child'''
|'''Class'''
|
|
|
|
|'''A Person of any age, who is a son or daughter.'''
|-
|DateOfBirth
|Object
|[1..1]
|DateObject
|
|
|The day on which the Child was born.
|-
|Gender
|Datatype
|[1..1]
|Code
|udt:Code
|[https://op.europa.eu/en/web/eu-vocabularies/at-concept-scheme/-/resource/authority/human-sex/?target=Browse&uri=http://publications.europa.eu/resource/authority/human-sex Human Sex]
|The chromosomal state, and reproductive organs and structures of a Person that allows them to be distinguished as female or male or undetermined.
|-
|PlaceOfBirth
|Object
|[1..1]
|LocationAddress
|
|
|The Location where the Child was born.
|-
|'''Parent'''
|'''Class'''
|
|
|
|
|'''One of the two Persons who are jointly the cause of the Child's Birth, i.e. natural parent.'''
|-
|DateOfBirth
|Object
|[0..1]
|DateObject
|
|
|The day on which the Parent was born.
|-
|Gender
|Datatype
|[0..1]
|Code
|udt:Code
|[https://op.europa.eu/en/web/eu-vocabularies/at-concept-scheme/-/resource/authority/human-sex/?target=Browse&uri=http://publications.europa.eu/resource/authority/human-sex Human Sex]
|The chromosomal state, and reproductive organs and structures of a Person that allows them to be distinguished as female or male or undetermined.
|-
|PlaceOfBirth
|Object
|[0..1]
|LocationAddress
|
|
|The Location where the Parent was born.
|-
|'''Person'''
|'''Class'''
|
|
|
|
|'''An individual natural person who may be dead or alive, but not imaginary.'''
|-
|PersonName
|Object
|[1..1]
|Name
|
|
|The family name and given name of a Person. At least one of the two must exist.
|-
|Identifier
|Object
|[0..*]
|Identifier
|cva:Cvidentifier
|
|The identifier relation is used to link a Person to any formally issued Identifier for that Person.
|-
|Citizenship
|Object
|[0..*]
|Jurisdiction
|
|
|The citizenship relationship links a Person to a Jurisdiction that has conferred citizenship rights on the individual such as the right to vote, to receive certain protection from the community or the issuance of a passport.
|-
|'''Jurisdiction'''
|'''Class'''
|
|
|
|
|'''The authority that an official organisation has, to make legal decisions about somebody/something.'''
|-
|Identifier
|Object
|[0..1]
|Identifier
|cvb:JurisdictionID
|[https://op.europa.eu/en/web/eu-vocabularies/at-concept-scheme/-/resource/authority/country/?target=Browse&uri=http://publications.europa.eu/resource/authority/country Country]
|The value for the id property is a URI for that Jurisdiction.
|-
|Name
|Datatype
|[1..*]
|Text
|cbc:Name
|[https://op.europa.eu/en/web/eu-vocabularies/at-concept-scheme/-/resource/authority/country/?target=Browse&uri=http://publications.europa.eu/resource/authority/country Country]
|The name is simply a string that identifies the Jurisdiction, typically a country, with or without a language tag.
|-
|'''ConstrainedLocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of a location based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[1..1]
|Text
|cvb:AdminunitSecondline
|
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[1..1]
|Text
|cvb:AdminunitFirstline
|[https://op.europa.eu/en/web/eu-vocabularies/at-concept-scheme/-/resource/authority/country/?target=Browse&uri=http://publications.europa.eu/resource/authority/country Country]
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''LocationAddress'''
|'''Class'''
|
|
|
|
|'''The Address of the place of birth based on the INSPIRE Address representation. It is subclass of the class Address.'''
|-
|AdminUnitL2
|Datatype
|[0..1]
|Text
|cvb:AdminunitSecondline
|
|The region of the address, usually a county, state or other such area that typically encompasses several localities.
|-
|AdminUnitL1
|Datatype
|[0..1]
|Text
|cvb:AdminunitFirstline
|[https://op.europa.eu/en/web/eu-vocabularies/at-concept-scheme/-/resource/authority/country/?target=Browse&uri=http://publications.europa.eu/resource/authority/country Country]
|The uppermost administrative unit for the address, almost always a country. Best practice is to use the ISO 3166-1 code.
|-
|'''Address'''
|'''Class'''
|
|
|
|
|'''Representation of address based on the INSPIRE Address Representation.'''
|-
|PoBox
|Datatype
|[0..1]
|Text
|cvb:PoBox
|
|The Post Office Box 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.
|-
|Thoroughfare
|Datatype
|[0..1]
|Text
|cvb:Thoroughfare
|
|Quoting from the INSPIRE guidelines, a thoroughfare is: "an address component that represents the name of a passage or way through from one location to another. A thoroughfare is not necessarily a road, it might be a waterway or some other feature.
|-
|LocatorDesignator
|Datatype
|[0..1]
|Text
|cvb:LocatorDesignator
|
|The locator designator is defined by the INSPIRE guidelines as "a number or a sequence of characters that uniquely identifies the locator within the relevant scope(s). The full identification of the locator could include one or more locator designators." 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."
|-
|LocatorName
|Datatype
|[0..1]
|Text
|cvb:LocatorName
|
|Based on the INSPIRE guidelines, locator name is defined as: "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.
|-
|AddressArea
|Datatype
|[0..1]
|Text
|cvb:CvaddressArea
|
|Taking the definition from INSPIRE, the address area is: 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.
|-
|PostName
|Datatype
|[0..1]
|Text
|cvb:PostName
|
|The key postal division of the address, usually the city. (INSPIRE's definition is "One or more names created and maintained for postal purposes to identify a subdivision of addresses and postal delivery points.)
|-
|PostCode
|Datatype
|[0..1]
|Text
|cvb:PostCode
|
|The post code (a.k.a postal code, zip code etc.). Post codes are common elements in many countries' postal address systems.
|-
|'''DateObject'''
|'''Class'''
|
|
|
|
|'''Structured representation of date with year, month and day of the month.'''
|-
|Year
|Datatype
|[0..1]
|Year
|xsd:gYear
|
|A gregorian calendar year. The value space of Year is the set of Gregorian calendar years as defined in § 5.2.1 of ISO 8601. Specifically, it is a set of one-year long, non-periodic instances e.g. lexical 1999 to represent the whole year 1999, independent of how many months and days this year has.
|-
|Month
|Datatype
|[0..1]
|Month
|xsd:gMonth
|
|A gregorian month that recurs every year. The value space of Month is the space of a set of calendar months as defined in § 3 of ISO 8601. Specifically, it is a set of one-month long, yearly periodic instances.
|-
|Day
|Datatype
|[0..1]
|Day
|xsd:gDay
|
|A gregorian day that recurs, specifically a day of the month such as the 5th of the month. The value space of Day is the space of a set of calendar dates as defined in § 3 of ISO 8601. Specifically, it is a set of one-day long, monthly periodic instances.
|-
|'''Name'''
|'''Class'''
|
|
|
|
|'''A name of a person that includes the family and given name.'''
|-
|FamilyName
|Datatype
|[0..*]
|Text
|cbc:FamilyName
|
|A family name is usually shared by members of a family. 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 field so that, for example, Miguel de Cervantes Saavedra's Family Name would be recorded as "de Cervantes Saavedra".
|-
|GivenName
|Datatype
|[0..*]
|Text
|cvb:GivenName
|
|A given name, or multiple given names, are the denominator(s) that identify an individual within a family. These are given to a Person by his or her parents at birth or may be legally recognised as 'given names' through a formal process. All given names are ordered in one field so that, for example, the given name for Johann Sebastian Bach is 'Johann Sebastian'.
|}