Difference between revisions of "Unemployment Means Of Living Canonical Evidence"

From DE4A
Jump to navigation Jump to search
(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). ==...")
 
(Added UnemploymentMeansOfLiving Canonical Evidence information.)
 
Line 1: Line 1:
 
==Description==
 
==Description==
This evidence contains elements related to the Domicile Deregistration Evidence. The Canonical Evidence in [[Use Case "Request Address Change" (MA UC1)]].
+
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 ==
Line 6: Line 6:
  
 
==Diagram==
 
==Diagram==
[[File:DomicileDeregistrationEvidence-UML-1.7.drawio.png|alt=|center]]
+
[[File:UnemploymentMeansOfLivingEvidence-0.1.png|alt=|center|871x871px]]
  
 
==Attribute Specification==
 
==Attribute Specification==
 
{| class="wikitable"
 
{| class="wikitable"
|+
+
!DE4A name
!DE4A name
 
 
!Property type
 
!Property type
 
!Cardinality
 
!Cardinality
 
!Data type
 
!Data type
!Related Vocabulary
+
!Related vocabulary
!Controlled vocabulary
+
!Controlled Vocabulary
 
!Definition
 
!Definition
 
|-
 
|-
|'''DomicileRegistrationEvidence'''
+
|'''UnemploymentMeansOfLivingEvidence'''
 
|'''Class'''
 
|'''Class'''
|  
+
|
|  
+
|
|  
+
|
|  
+
|
|'''This  class contains elements related to the Domicile Registration Evidence.'''
+
|
 
|-
 
|-
 
|Identifier
 
|Identifier
Line 33: Line 32:
 
|cva:Cvidentifier
 
|cva:Cvidentifier
 
|
 
|
|An unambiguous reference to the Domicile Registration Evidence.
+
|An unambiguous reference to the Unemployment Means of Living Evidence
 
|-
 
|-
 
|IssueDate
 
|IssueDate
Line 41: Line 40:
 
|udt:Date
 
|udt:Date
 
|
 
|
|The most recent date on which the  Domicile  Registration Evidence instance was issued.
+
|The most recent date on which the Unemployment Means of Living Evidence instance was issued.
 
|-
 
|-
 
|IssuingAuthority
 
|IssuingAuthority
Line 49: Line 48:
 
|
 
|
 
|
 
|
|A Public Organisation with official authority in charge of issuing the  Domicile Registration Evidence.
+
|A Public Organisation with official authority in charge of issuing the Unemployment Means of Living Evidence.
 
|-
 
|-
|IssuingPlace
+
|Certifies
 
|Object
 
|Object
 
|[1..1]
 
|[1..1]
|LocationAddress
+
|UnemploymentMeansOfLivingInfo
 
|
 
|
 
|
 
|
|The  location address where the  Domicile  Registration Evidence was issued.
+
|Attesting in a formal way that the Unemployment data is true.
 
|-
 
|-
|CertifiesDomicile
+
|'''PublicOrganisation'''
|Object
+
|'''Class'''
|[1..1]
+
|
|Domicile
+
|
 
|
 
|
 
|
 
|
|Attesting  in a formal way that the Domicile is true.
+
|'''Any organisation that is defined as being part of the public sector by a legal framework at any level.'''
|-
 
|'''PublicOrganisation'''
 
|'''Class'''
 
|
 
|
 
|
 
|
 
|'''Any organisation that is defined as being part of the public sector by a legal framework at any level.'''
 
 
|-
 
|-
 
|Identifier
 
|Identifier
Line 81: Line 72:
 
|cva:Cvidentifier
 
|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.
+
|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
 
|PrefLabel
Line 89: Line 80:
 
|udt: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.
+
|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'''
+
|'''UnemploymentMeansOfLivingInfo'''
 
|'''Class'''
 
|'''Class'''
|  
+
|
|  
+
|
|  
+
|
|  
+
|
|'''This  class contains elements related to the domicile'''
+
|'''Information on unemployment benefits'''
 
|-
 
|-
|Inhabitant
+
|DataSubject
 
|Object
 
|Object
 
|[1..1]
 
|[1..1]
Line 105: Line 96:
 
|
 
|
 
|
 
|
|Person,  living in the residence or domicile
+
|The person who is subject to this information
 
|-
 
|-
|Domicile
+
|UnemploymentData
 
|Object
 
|Object
|[1..1]
+
|[0..1]
|ConstrainedLocationAddress
+
|UnemploymentData
 
|
 
|
 
|
 
|
|Current domicile inhabited by person
+
|Current unemployment data of the citizen
 
|-
 
|-
|'''Person'''
+
|'''UnemploymentData'''
 
|'''Class'''
 
|'''Class'''
|  
+
|
|  
+
|
|  
+
|
|  
+
|
|'''An  individual natural person who may be dead or alive, but not imaginary.'''
+
|'''One of the two Persons who are jointly the cause of the Child's Birth, i.e. natural parent.'''
 
|-
 
|-
|PersonName
+
|Status
|Object
+
|Datatype
|[1..1]
+
|[0..1]
|Name
+
|StatusTypeEnum
 
|
 
|
 
|
 
|
|The family name and given name of a Person. At least one of the two must exist.
+
|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
 
|-
 
|-
|Identifier
+
|PeriodOfTime
 
|Object
 
|Object
|[0..*]
+
|[0..1]
|Identifier
+
|PeriodOfTime
|cva:Cvidentifier
+
|
 
|
 
|
|The  identifier relation is used to link a Person to any formally issued  Identifier for that Person.
+
|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.
 
|-
 
|-
|DateOfBirth
+
|'''PeriodOfTime'''
|Object
+
|'''Class'''
|[0..1]
+
|
|DateObject
+
|
 
|
 
|
 
|
 
|
|The  day on which the person was born.
+
|'''Period of time'''
 
|-
 
|-
|Gender
+
|StartDate
 
|Datatype
 
|Datatype
 
|[0..1]
 
|[0..1]
|Code
+
|Date
|udt:Code
+
|udt:Date
|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.
+
|Effective start date of a period time. The format is YYYY-MM-DD
 
|-
 
|-
|MaritalStatus
+
|EndDate
 
|Datatype
 
|Datatype
 
|[0..1]
 
|[0..1]
|Code
+
|Date
|udt:Code
+
|udt:Date
|Marital  Status
+
|
|An indicator of the marital status
+
|Expected end date or effective end date in case of suspension/cancellation/finish. The format is YYYY-MM-DD
 
|-
 
|-
|PlaceOfBirth
+
|'''Person'''
|Object
+
|'''Class'''
|[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.
+
|'''An individual natural person who may be dead or alive, but not imaginary.'''
|-
 
|'''Jurisdiction'''
 
|'''Class'''
 
|
 
|
 
|
 
|
 
|'''The  authority that an official organisation has, to make legal decisions about  somebody/something.'''
 
 
|-
 
|-
 
|Identifier
 
|Identifier
 
|Object
 
|Object
|[0..1]
+
|[0..*]
 
|Identifier
 
|Identifier
|cvb:JurisdictionID
+
|cva:Cvidentifier
 
|
 
|
|The value for the id property is a URI for that Jurisdiction.
+
|The identifier relation is used to link a Person to any formally issued Identifier for that Person.
 
|-
 
|-
|Name
+
|SocialSecurityNumber
 
|Datatype
 
|Datatype
 
|[1..*]
 
|[1..*]
|Text
+
|Identifier
|cbc:Name
+
|cva:Cvidentifier
 
|
 
|
|The  name is simply a string that identifies the Jurisdiction, typically a  country, with or without a language tag.
+
|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.
 
|-
 
|-
|'''ConstrainedLocationAddress'''
+
|PersonName
|'''Class'''
+
|Object
|
 
|
 
|
 
|
 
|'''The  Address of a location based on the INSPIRE Address representation. It is  subclass of the class Address.'''
 
|-
 
|AdminUnitL2
 
|Datatype
 
 
|[1..1]
 
|[1..1]
|Text
+
|Name
|cvb:AdminunitSecondline
+
|
|NUTS/LAU
+
|
|The region of the address, usually a county, state or other such area that  typically encompasses several localities.
+
|The family name and given name of a Person. At least one of the two must exist.
 
|-
 
|-
|AdminUnitL1
+
|DateOfBirth
|Datatype
+
|Object
 
|[1..1]
 
|[1..1]
|Text
+
|DateObject
|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.
+
|The day on which the Person was born.
 
|-
 
|-
|AdminUnitL1
+
|'''DateObject'''
|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'''
 
|'''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.
+
|'''Structured representation of date with year, month and day of the month.'''
 
|-
 
|-
|AddressArea
+
|Year
 
|Datatype
 
|Datatype
 
|[0..1]
 
|[0..1]
|Text
+
|Year
|cvb:CvaddressArea
+
|xsd:gYear
 
|
 
|
|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.
+
|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.
 
|-
 
|-
|PostName
+
|Month
 
|Datatype
 
|Datatype
 
|[0..1]
 
|[0..1]
|Text
+
|Month
|cvb:PostName
+
|xsd:gMonth
 
|
 
|
|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.)
+
|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.
 
|-
 
|-
|PostCode
+
|Day
 
|Datatype
 
|Datatype
 
|[0..1]
 
|[0..1]
|Text
+
|Day
|cvb:PostCode
+
|xsd:gDay
 
|
 
|
|The post code (a.k.a postal code, zip code etc.). Post codes are common elements  in many countries' postal address systems.
+
|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'''
 
|'''Name'''
 
|'''Class'''
 
|'''Class'''
|  
+
|
|  
+
|
|  
+
|
|  
+
|
|'''A name of a person that includes the family and given name.'''
+
|'''A name of a person that includes the family and given name.'''
 
|-
 
|-
 
|FamilyName
 
|FamilyName
Line 329: Line 251:
 
|cbc:FamilyName
 
|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".
+
|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
 
|GivenName
Line 337: Line 259:
 
|cvb:GivenName
 
|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'.
+
|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.
 
 
|}
 
|}

Latest revision as of 23:14, 19 January 2023

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).

XSD

XSD files can be found on the GitHub repository.

Diagram

Attribute Specification

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'.