Skip to content

Candidate Person (level 1)

3.5 /CandidatePerson (level 1)

3.5.1 CandidatePerson Element Description

graph TD
subgraph CandidatePersonType
A[CandidatePerson]
B[Attributes]
C[hr:PersonID]
D[hr:PersonLegalID]
E[PersonName]
F[Communication]
G[ResidencyCountryCode]
H[NationalityCode]
I[hr:BirthDate]
J[GenderCode]
K[PrimaryLanguageCode]
L[eures:Disability]
M[MottoInLife]

A --> B
B --> C
B --> D
B --> E
B --> F
B --> G
B --> H
B --> I
B --> J
B --> K
B --> L
B --> M

style A fill:#fff,stroke:#333,stroke-width:2px
style B fill:#fff,stroke:#333,stroke-width:2px
style C fill:#fff,stroke:#333,stroke-width:2px
style D fill:#fff,stroke:#333,stroke-width:2px
style E fill:#fff,stroke:#333,stroke-width:2px
style F fill:#fff,stroke:#333,stroke-width:2px
style G fill:#fff,stroke:#333,stroke-width:2px
style H fill:#fff,stroke:#333,stroke-width:2px
style I fill:#fff,stroke:#333,stroke-width:2px
style J fill:#fff,stroke:#333,stroke-width:2px
style K fill:#fff,stroke:#333,stroke-width:2px
style L fill:#fff,stroke:#333,stroke-width:2px
style M fill:#fff,stroke:#333,stroke-width:2px
end

A -- "It contains personal details of the person seeking a job, such as his/her name, age, gender, and so on." --> A
A -- "A collection of demographic and personal data about a candidate -|- a person being considered for, or who has
otherwise..." --> A
Element Description Cardinality Rule Examples
CandidatePerson Personal details of the person seeking a job, such as the name, 1 N/A N/A
age, gender, and so on.
Sub-elements
PersonID Systemic identifiers only for this person “Usually fed by the document sender, the recipient also may (and usually does) add his/her own ID, in order to build complex transaction paths”. 0..n N/A N/A
PersonLegalID An identifier issued to a person by a governmental organisation, like a social security or driver’s license number. 0..n N/A N/A
PersonName A detailed set of data about the candidate’s names, such as his/her GivenName, FamilyName, MiddleName, Former Family Name, etc. 1 N/A N/A
See section /CandidatePerson/PersonName for more information
Communication The candidate’s contact information. ChannelCode, Address, URI –for email, for instance—, etc. 0..n BR-COM-10: If the Communication element is filled in, at least one of its sub elements should be filled in too.

See section /CandidatePerson/Communication for more information
N/A
ResidencyCountryCode Code specifying the country where the Candidate usually lives 0..1 CountriesAndNationalities [ECV02], AuxCountriesAndNationalities [ECV10] code list must be used. Europass2:
CountriesAndNationalities [ECV02],
Europass2:
AuxCountriesAndNationalities [ECV10]
NationalityCode Code specifying the candidate’s nationality 0..n CountriesAndNationalities [ECV02], AuxCountriesAndNationalities [ECV10] code list must be used.

BR-COM-43: Multiple entries of this code list are allowed.
Europass2:
CountriesAndNationalities [ECV02],
Europass2:
AuxCountriesAndNationalities [ECV10]
BirthDate The person’s date of birth 0..1 BR-COM-06: Compulsory Date Format: YYYY-MM-DD, YYYY-MM, YYYY or YYYY-MM-DDThh:mm:ss. 1987-08-05
GenderCode Code indicating the candidate’s gender (“NotKnown”, 0..1 Compulsory use of ECV01-GenderType lists. Europass2: GenderType [ECV01]
“Male”, “Female”, “NotSpecified”)
PrimaryLanguageCode The candidate’s primary or preferred language or languages 0..n ECV08: Languages
BR-COM-43: Multiple entries of this code list are allowed.
Europass2: Languages [ECV06]
Disability Describes a disability associated with a specific person. 0..n The absence of a Disability element for a candidate will mean “No disabilities”. N/A
See section /CandidatePerson/Disability for more information
MottoInLife Aims to capture, in a short sentence, a personal belief, a saying or a purpose (e.g. “Keep calm, take photos”) 0..1 limited to 99 characters “Keep calm, take photos”

3.5.2 CandidatePerson Attributes

graph TD
subgraph CandidatePersonType
A[CandidatePerson]
B[Attributes]
C[hr:EffectiveDateAttributeGroup]
D[@ validFrom]
E[@ validTo]
F[HR-XML's 3.0 architecture makes a distinction between effective-date meta data and effective dating that is an
integral...]
G[A collection of demographic and personal data about a candidate -+ a person being considered for, or who has
otherwise...]

A --> B
A -- "It contains personal details of the person seeking a job, such as his/her name, age, gender, and so on." --> A
B --> C
C --> D
C --> E
D -- "+" --> D
E -- "+" --> E
F --> C
G --> A
end
Attributes Description Card. Rule
validFrom Validity start date for this entity's information 0..1 BR-COM-05: If not specified, the “validFrom” date will default to “assigned by EURES on reception”.
BR-COM-06: Compulsory Date Format is: YYYY-MM-DD, YYYY-MM, YYYY or YYYY-MM-DDThh:mm:ss.
validTo Validity end date for this entity's information 0..1 BR-COM-06: Compulsory Date Format is: YYYY-MM-DD, YYYY-MM, YYYY or YYYY-MM-DDThh:mm:ss.

PersonID attributes

Attributes Description Card. Rule
Refer to IdentifierType Attributes for additional attributes.

PersonLegalID attributes

Attributes Description Card. Rule
Refer to IdentifierType Attributes for additional attributes.

PersonName attributes

Attributes Description Card. Rule

See section /CandidatePerson/PersonName for more information

Communication attributes
Attributes Description Card. Rule
See section /CandidatePerson/Communication for more information
ResidencyCountryCode attributes
Attributes Description Card. Rule
validFrom Validity start date as a resident of the country 0..1 BR-COM-06: Compulsory Date Format is: YYYY-MM-DD, YYYY-MM, YYYY or YYYY-MM-DDThh:mm:ss.
validTo Validity end date as a resident of the country 0..1 BR-COM-06: Compulsory Date Format is: YYYY-MM-DD, YYYY-MM, YYYY or YYYY-MM-DDThh:mm:ss.

Refer to CodeListAttributeGroup Attributes for additional attributes.

NationalityCode attributes
Attributes Description Card. Rule
The same as ResidencyCountryCode attributes
BirthDate attributes
Attributes Description Card. Rule
This sub-element has no attributes.
GenderCode attributes
Attributes Description Card. Rule
Refer to CodeListAttributeGroup attributes for additional attributes.
PrimaryLanguageCode attributes
Attributes Description Card. Rule
typeCode It specifies type of the selected language: NORMAL, SIGN, CLASSSIC or FREETEXT. 0..1 The values must be: NORMAL, SIGN, CLASSSIC or FREETEXT.

Refer to CodeListAttributeGroup attributes for additional attributes.

Disability attributes
Attributes Description Card. Rule
See section /CandidatePerson/Disability for more information
MottoInLife attributes
Attributes Description Card. Rule
languageID The language in which the name of the Party is mentioned. 0..1