Employment History (level 2)

3.14 /CandidateProfile/EmploymentHistory (level 2)¶

3.14.1 EmploymentHistory Element Description¶

<img>A diagram showing "EmploymentHistoryType" with an "Attributes" group containing "@ validFrom", "@ validTo", and "hr:EffectiveDateAttributeGroup". It also shows "EmploymentHistory" with a description "Employment History records. Details of a particular tenure of employment or work with an organization." and "EmployerHistory" with a description "Details of a particular tenure of employment or work with an organization." The "EmploymentHistory" element has a cardinality of 0..1.</img>

Element	Description	Cardinality	Rule	Examples
EmploymentHistory	The prior and current details of a person's employment, work, or relevant experience as they would be reported in a professional profile, CV, resume, employment application, or similar document	0..1	N/A	N/A

Sub-elements


Employer History	Details regarding a person's tenure while working for an employer See section /CandidateProfile/EmploymentHistory/EmployerHistory for more information	0..n	N/A	N/A

3.14.2 EmploymentHistory Attributes¶

<img>A diagram showing "EmploymentHistoryType" with an "Attributes" group containing "@ validFrom", "@ validTo", and "hr:EffectiveDateAttributeGroup". It also shows "EmploymentHistory" with a description "Employment History records. Details of a particular tenure of employment or work with an organization." The "EmploymentHistory" element has a cardinality of 0..1.</img>

Attributes	Description	Card.	Rule
validFrom	Validity start 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.
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.

EmployerHistory attributes¶

Attributes	Description	Card.	Rule
See section “EmployerHistory Attributes” for more information

3.14.3 Sub-element: /CandidateProfile/EmploymentHistory/EmployerHistory (level 3)¶

3.14.3.1 EmployerHistory Element Description¶

graph TD
subgraph EmployerHistoryType
A[hr:OrganizationName]
B[OrganizationContact]
C[hr:IndustryCode]
D[eures:EmploymentPeriod]
E[PositionHistory]
F[eures:AttachmentReference]
G[Department]
H[Link]

A -- "Usually an official or legal name by which to refer to an organization." --> A
B -- "It contains the Educational Organisation's contact data." --> B
C -- "Industry. Classification. Code A code classifying the industry for the related organization, position, or other
entity...." --> C
D -- "It provides flexible options for representing employment period data." --> D
E -- "It contains details about the person's tenure within the position" --> E
F -- "It contains references to external documents attached." --> F
G -- "It aims to capture the department of the organization in which the candidate had worked." --> G
H -- "It specifies website link." --> H

A --- EmployerHistory
B --- EmployerHistory
C --- EmployerHistory
D --- EmployerHistory
E --- EmployerHistory
F --- EmployerHistory
G --- EmployerHistory
H --- EmployerHistory

EmployerHistory[EmployerHistory] -- "Details of a particular tenure of employment or work with an organization." -->
EmployerHistory
end

Element	Description	Cardinality	Rule	Examples
EmployerHistory	Details about a person's tenure while working for an employer. This element is optional as there could be candidates without work experience. If it is not filled out, it means that the candidate does not have work experience, or he/she does not want to fill it out.	0..n	N/A	N/A
Sub-elements
OrganizationName	Usually an official or legal name by which to refer to an organisation	0..1	N/A	"Wellness Healthcare", "Police Department", etc.
OrganizationContact	An Organisation's contact information See section /CandidateProfile/EmploymentHistory/EmployerHistory/OrganizationContact for more information	0..1	N/A	N/A
IndustryCode	A code classifying the industry of the related organisation, position, or other entity.	0..1	BR-COM-20: Compulsory use of the "NACE-CodeList.gc" list defined by EURES. This is based on EU NACE.	"01" = Agriculture, "02" = Forestry, etc.

				Full code list: "Open/EURES: NACE [CL31]"
EmploymentPeriod	Provides flexible options for representing employment period data See section /CandidateProfile/EmploymentHistory/EmployerHistory/EmploymentPeriod for more information	0..1	N/A	N/A
PositionHistory	Details about the person's tenure within the position See section /CandidateProfile/EmploymentHistory/EmployerHistory/PositionHistory for more information	1..n	N/A	N/A
AttachmentReference	Reference to external documents attached See section /CandidateProfile/EmploymentHistory/EmployerHistory/AttachmentReference for more information	0..n	N/A	N/A
Department	It aims to capture the department of the organization in which the candidate had worked.	0..1
Link	It specifies website link.	0..n

3.14.3.2 EmployerHistory Attributes¶

Attributes	Description	Card.	Rule
This element has no attributes.
OrganizationName attributes
Attributes	Description	Card.	Rule
validFrom	Validity start 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.
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.
languageID	Identifier of the language used in the organisation name	0..1
OrganizationContact attributes
Attributes	Description	Card.	Rule
See section /CandidateProfile/EmploymentHistory/EmployerHistory/OrganizationContact for more information
IndustryCode attributes
Attributes	Description	Card.	Rule
Refer to CodeType Attributes section for additional attributes.
EmploymentPeriod attributes
Attributes	Description	Card.	Rule
See section /CandidateProfile/EmploymentHistory/EmployerHistory/EmploymentPeriod for more information
PositionHistory attributes
Attributes	Description	Card.	Rule
See section /CandidateProfile/EmploymentHistory/EmployerHistory/PositionHistory for more information
AttachmentReference attributes
Attributes	Description	Card.	Rule
See section /CandidateProfile/EmploymentHistory/EmployerHistory/AttachmentReference for more information
Department attributes
Attributes	Description	Card.	Rule
Refer to TextType Attributes section for additional attributes.
Link attributes
Attributes	Description	Card.	Rule
It has no attributes.

3.14.4 Sub-element: /CandidateProfile/EmploymentHistory/EmployerHistory/OrganizationContact (level 4)¶

3.14.4.1 OrganizationContact Element Description¶

graph TD
subgraph OrganizationContactType
OC(OrganizationContact)
CNT[hr:ContactName]
COM[Communication]
end
OC -- "It contains the Educational Organisation's contact data." --> OC
OC -- "Method of communication of the related entity." --> COM
CNT --- OC
COM --- OC

Element	Description	Cardinality	Rule	Examples
OrganizationContact	Contact information for the organization	0..1	N/A	N/A
Sub-elements
ContactName	Name of the organization's contact person	1	N/A	"Lidia Smith"
Communication	Contact data/information of the contact person: ChannelCode, Address, URI –for email, for instance—, etc See section /CandidatePerson/Communication for more information	0..n	N/A	N/A

3.14.4.2 OrganizationContact Attributes¶

Attributes	Description	Card.	Rule
This element has no attributes.
ContactName attributes
Attributes	Description	Card.	Rule
Refer to TextType Attributes section for additional attributes.
Communication attributes
Attributes	Description	Card.	Rule
See section /CandidatePerson/Communication for more information

3.14.5 Sub-element: /CandidateProfile/EmploymentHistory/EmployerHistory/EmploymentPeriod (level 4)¶

3.14.5.1 EmploymentPeriod Element Description¶

graph TD
subgraph EmploymentPeriodType
EP(eures:EmploymentPeriod)
SD(StartDate)
ED(EndDate)
HRI(hr:CurrentIndicator)
end
EP -- "It provides flexible options for representing employment period data." --> EP
SD --- EP
ED --- EP
HRI --- EP

Element	Description	Cardinality	Rule	Examples
EmploymentPeriod	Provides flexible options for representing employment period data	1	N/A	N/A
Sub-elements
StartDate	A timestamp marking the beginning of employment period data	1	N/A	N/A

See section /CandidatePofile/EmploymentHistory/EmployerHistory/EmploymentPeriod/StartDate for more information

Attributes	Description	Card.	Rule	Examples
EndDate	A timestamp marking the end of employment period data	0..1	N/A	N/A
CurrentIndicator	Indicates whether the position is currently held or if employment or other status was current when reported	0..1	N/A	"true" = The position is currently held "false" = The position is not currently held

3.14.5.2 EmploymentPeriod Attributes¶

Attributes	Description	Card.	Rule
This element has no attributes
StartDate attributes
Attributes
See section /CandidatePofile/EmploymentHistory/EmployerHistory/EmploymentPeriod/StartDate for more information
EndDate attributes
Attributes
See section /CandidatePofile/EmploymentHistor/EmployerHistory/EmploymentPeriod/EndDate for more information
CurrentIndicator attributes
Attributes
validFrom	Validity start 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.
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.

3.14.6 Sub-element: /CandidateProfile/EmploymentHistory/EmployerHistory/EmploymentPeriod/StartDate (level 5)¶

3.14.6.1 StartDate Element Description¶

Element	Description	Cardinality	Rule	Examples
StartDate	A timestamp marking the beginning of the employment period data	1	BR-COM-16: At least one of its sub-elements must be provided.	N/A

Sub-elements

The same as /CandidateProfile/EducationHistory/EducationOrganizationAttendance/AttendancePeriod/StartDate

3.14.6.2 StartDate Attributes¶

Attributes	Description	Card.	Rule
The same as /CandidateProfile/EducationHistory/EducationOrganizationAttendance/AttendancePeriod/StartDate

3.14.7 Sub-element: /CandidateProfile/EmploymentHistory/EmployerHistory/EmploymentPeriod/EndDate (level 5)¶

3.14.7.1 EndDate Element Description¶

Element	Description	Cardinality	Rule	Examples
EndDate	A timestamp marking the end of the employment period data	0..1	BR-COM-16: At least one of its sub-elements	N/A

must be provided.

Sub-elements

The same as /CandidateProfile/EducationHistory/EducationOrganizationAttendance/AttendancePeriod/EndDate

3.14.7.2 EndDate Attributes¶

Attributes	Description	Card.	Rule
The same as /CandidateProfile/EducationHistory/EducationOrganizationAttendance/AttendancePeriod/EndDate

3.14.8 Sub-element: /CandidateProfile/EmploymentHistory/EmployerHistory/PositionHistory (level 4)¶

3.14.8.1 PositionHistory Element Description¶

graph TD
A[PositionHistoryType] --> B(PositionTitle)
A --> C(eures:EmploymentPeriod)
A --> D(oa:Description)
A --> E(hr:JobCategoryCode)
A --> F(PersonCompetency)
A --> G(City)
A --> H(Country)

subgraph PositionHistoryType
B -- "A short phrase describing the position as it would be listed on a business card or in a company directory." --> B
C -- "It provides flexible options for representing employment period data." --> C
D -- "It contains description of the position." --> D
E -- "A code classifying the type or category of job. This may be used for occupational classification of the job...."
--> E
F -- "A specified person competency is a skill within the context of a personal record (profile, appraisal and
assessment)..." --> F
G -- "It aims to capture the city where a candidate worked in a company in a specific position." --> G
H -- "Code identifying the country where a candidate has worked in a company." --> H
end

A -- "1..∞" --> I(PositionHistory)
I -- "It contains details about the person's tenure within the position" --> I

The details about a persons tenure within position.

Element	Description	Cardinality	Rule	Examples
PositionHistory	The details about the person's tenure within the position	1..n	N/A	N/A

Sub-elements


PositionTitle	A short phrase describing the position as it would be listed on a business card or in a company directory. OED: An appellation attached to a position in virtue of rank, function or office.	0..1	Use CL20-ESCO_Occupations	HR-Open/EURES: ESCO_Occupations [CL20].
EmploymentPeriod	Provides flexible options for representing employment period data	0..1	N/A	N/A

See section /CandidateProfile/EducationHistory/EmployerHistory/PositionHistory/EmploymentPeriod for more information

Description	Description of the position	Card.	N/A	"Description of the position", etc.
JobCategoryCode	A code classifying the job type or category. This may be used for occupational classification of the job. The JobCategoryCode will usually be repeatable so that a single job can be classified across multiple dimensions. The JobCategoryCode can be used to classify the job by industry but note that an explicit IndustryCode is available in contexts such as PositionOrganizationDetails.	0..n	BR-COM-29: Compulsory use of the "ISCO2008-CodeList.gc" list defined by EURES and based on ISCO-08. Alternatively, use of ESCO Occupations – version 1.0.	"1" – Managers, "12" – Administrative, etc. Full code list: "HR-Open/EURES: ISCO2008 [CL20] HR-Open/EURES: ESCO_Occupations [CL20]"
PersonCompetency	A specified person competency is a skill within the context of a personal record (profile, appraisal and assessment) that is assessed or asserted at specified level of proficiency. See section /CandidateProfile/EducationHistory/EmployerHistory/PositionHistory/PersonCompetency for more information	0..n	N/A	N/A
City	It aims to capture the city where a candidate worked in a company in a specific position.	0..1
Country	Code identifying the country where a candidate has worked in a company.	0..1	ECV02: Compulsory use of codelist defined by Europass CountriesAndNationalities	Europass2: CountriesAndNationalities [ECV02]

3.14.8.2 PositionHistory Attributes¶

Attributes	Description	Card.	Rule
This element has no attributes
PositionTitle attributes
Attributes	Description	Card.	Rule
Refer to PositionTitleType Attributes section for additional attributes.
EmploymentPeriod attributes
Attributes	Description	Card.	Rule
See section /CandidateProfile/EducationHistory/EmployerHistory/PositionHistory/EmploymentPeriod for more information
Description attributes
Attributes	Description	Card.	Rule
Refer to DescriptionType Attributes section for additional attributes.
JobCategoryCode attributes
Attributes	Description	Card.	Rule
Refer to CodeType Attributes section for additional attributes.
PersonCompetency attributes
Attributes	Description	Card.	Rule
See section /CandidateProfile/EducationHistory/EmployerHistory/PositionHistory/PersonCompetency for more information
City attributes
Attributes	Description	Card.	Rule
Refer to TextType Attributes section for additional attributes.
Country attributes
Attributes	Description	Card.	Rule
Refer to CodeListAttributeGroup Attributes section for additional attributes.

3.14.9 Sub-element: /CandidateProfile/EmploymentHistory/EmployerHistory/PositionHistory/EmploymentPeriod (level 5)¶

3.14.9.1 EmploymentPeriod Element Description¶

Element	Description	Cardinality	Rule	Examples
EmploymentPeriod	Provides flexible options for representing employment period data	0..1	N/A	N/A

Sub-elements

The same as /CandidateProfile/EducationHistory/EmployerHistory/EmploymentPeriod

3.14.9.2 EmploymentPeriod Attributes¶

Attributes	Description	Card.	Rule
The same as /CandidateProfile/EducationHistory/EmployerHistory/EmploymentPeriod

3.14.10 Sub-element: /CandidateProfile/EmploymentHistory/EmployerHistory/PositionHistory/PersonCompetency (level 5)¶

3.14.10.1 PersonCompetency Description¶

Element	Description	Cardinality	Rule	Examples
Person Competency	A specified person competency is a skill within the context of a personal record (profile, appraisal and assessment) that is assessed or asserted at specified level of proficiency.	0..n	N/A	N/A

Sub-elements

The same as /CandidateProfile/PersonQualifications/PersonCompetency

3.14.10.2 PersonCompetency Attributes¶

Attributes	Description	Card.	Rule
The same as /CandidateProfile/PersonQualifications/PersonCompetency

3.14.11 Sub-element: /CandidateProfile/EmploymentHistory/EmployerHistory/AttachmentReference (level 4)¶

3.14.11.1 AttachmentReference Element Description¶

<img>Diagram showing eures:AttachmentReference with cardinality 0..∞, connected to AttachmentReferenceType with cardinality 1..∞, which has attributes oa:Description (cardinality 1..∞) and hr:XPath (cardinality 1..∞). A note says "It contains references to external documents attached."</img>

Element	Description	Cardinality	Rule	Examples
AttachmentReference	Reference to the external documents attached	0..n	N/A	N/A

Sub-elements
XPath	Reference to an embedded document located in another element of the schema	1..n	N/A
Description	Narrative details of the external document attached	1..n	N/A	"Education History"

3.14.11.2 AttachmentReference Attributes¶

Attributes	Description	Card.	Rule
This element has no attributes.

XPath attributes

Attributes	Description	Card.	Rule
This sub-element has no attributes.

Description attributes

Attributes	Description	Card.	Rule
Refer to DescriptionType Attribute section for additional attributes.