Position Preferences (level 2)

3.18 /CandidateProfile/CandidatePositionPreferences (level 2)

3.18.1 CandidatePositionPreferences Element Description

graph TD
A[PreferenceMatchingType] --> B(CandidatePositionPreferences)
B --> C(PreferredLocation)
B --> D(eures:JobCategory)
B --> E(hr:PositionTitle)
B --> F(hr:PositionOfferingTypeCode)
B --> G(hr:PositionScheduleTypeCode)
B --> H(hr:ShiftDescription)
B --> I(OfferedRemunerationPackage)
B --> J(eures:TravelPreference)
B --> K(eures:RelocationConsidered)
B --> L(WorkingLanguageCode)
B --> M(oa:Description)

subgraph CandidatePositionPreferences
direction LR
B -- "It contains a collection of information about a candidate's preferences in an position." --> B
C -- "It contains location of the preferred position." --> C
D -- "It contains the type or category of the job. May be used for occupational classification of the job." --> D
E -- "A short phrase describing the position as it would be listed on a business card or in a company directory. OED:
An..." --> E
F -- "These are values that are descriptive in classifying a position within advertising or communications of a
position..." --> F
G -- "Describes a position's general schedule." --> G
H -- "Descriptive information about a work shift. \"Shift\" refers to a portion or division of time during which
employees or..." --> H
I -- "It contains the remuneration offered." --> I
J -- "It contains travel preference details." --> J
K -- "It indicates if a candidate would consider moving to a new city or location for a suitable position." --> K
L -- "A code classifying the language or languages used within the workplace or associated with work. This is intended
to..." --> L
M -- "It contains a description of position preferences." --> M
end

Element	Description	Cardinalit y	Rule	Examples
CandidatePositionPreference s	Information about a candidate's preferences in a position	0..1	N/A	N/A
Sub-elements
PreferredLocation	Location of the preferred position	0..n	N/A	N/A

See section /CandidateProfile/CandidatePositionPreferences/PreferredLocation for more information

JobCategory	The type or category of the job. May be used for occupational classification of the job.	1..n	N/A	N/A
	See section /CandidateProfile/CandidatePositionPreferences/JobCategory for more information
PositionTitle	A short phrase describing the position as it would be listed on a business card or in a company directory	0..1	N/A	“President”, “Chief Executive Officer”, etc.
PositionOfferingTypeCode	These values are descriptive in classifying a position opportunity This is an HR-Open Standards open list.	0..n	BR-COM-38: Compulsory use of the “PositionOfferingCodeContentType” list. BR-COM-43: Multiple entries of this code list are allowed.	“DirectorHire”, “Temporary”, “TemporaryToHire”, “ContractToHire”, Etc. Full code list: “HR-Open/EURES: PositionOfferingCodeContentType [CL37]”
PositionScheduleTypeCode	Describes a position’s general schedule This is an HR-Open Standards open list.	0..n	BR-COM-39: Compulsory use of the “PositionScheduleCodeContentType” list. BR-COM-43: Multiple entries of this code list are allowed.	“FullTime”, “PartTime”, “FlexTime”, “Any” Full code list: “HR-Open/EURES: PositionScheduleCodeContentType [CL38]”
ShiftDescription	Descriptive information about a work shift. “Shift” refers to a portion or division of time during which employees or resources are scheduled to be engaged or on-duty.	0..1	N/A	“Description about a work shift”, etc.
OfferedRemunerationPackage	Remuneration offered	0..1	N/A	N/A
	See section /CandidateProfile/CandidatePositionPreferences/OfferedRemunerationPackage for more information
TravelPreference	Travel Preference details	0..1	N/A	N/A
	See section /CandidateProfile/CandidatePositionPreferences/TravelPreference for more information
RelocationConsidered	Indicates if a candidate would consider moving to a new city or location for a suitable position	0..1	N/A	N/A
	See section /CandidateProfile/CandidatePositionPreferences/RelocationConsidered for more information
WorkingLanguageCode	A code classifying the language or languages used within the workplace or associated with work. This is intended to communicate general information about the language(s) used within the work	0..n	Compulsory use of Languages [ECV06] code list. BR-COM-43: Multiple entries of this code list are allowed.	Europass2: Languages [ECV06]

	environment or general information about a candidate's specific language preferences. This component might be offered as descriptive "pre-qualification" information on a position announcement. It might appear within the context of a Candidate Profile as a general statement of a candidate's general language capabilities or preferences. WorkingLanguageCode is not intended as a statement of language proficiency or specific requirement relating to language proficiency. Specific information regarding language proficiency should be covered either within PersonCompetency or as may be appropriate.
Description	Description of position preferences	0..1	N/A	"Description of the position preferences", etc.

3.18.2 CandidatePositionPreferences Attributes

Attributes	Description	Card.	Rule
This element has no attributes.
OfferedRemunerationPackage attributes
Attributes	Description	Card.	Rule
See section /CandidateProfile/CandidatePositionPreferences/OfferedRemunerationPackage for more information
PositionTitle attributes
Attributes	Description	Card.	Rule
Refer to PositionTitleType Attributes section for additional attributes.
ShiftDescription attributes
Attributes	Description	Card.	Rule
Refer to DescriptionType Attributes section for additional attributes.
Description attributes
Attributes	Description	Card.	Rule
Refer to DescriptionType Attributes section for additional attributes.
PositionOfferingTypeCode attributes
Attributes	Description	Card.	Rule
Refer to CodeListAttributeGroup Attributes section for additional attributes.
PositionScheduleTypeCode attributes
Attributes	Description	Card.	Rule
Refer to CodeListAttributeGroup Attributes section for additional attributes.
WorkingLanguageCode attributes
Attributes	Description	Card.	Rule
typeCode	It specifies type of the selected language: NORMAL, SIGN, CLASSSIC or FREETEXT	0..1	Values must be: NORMAL, SIGN, CLASSSIC or FREETEXT
Refer to CodeListAttributeGroup Attributes section for additional attributes.
PreferredLocation attributes
Attributes	Description	Card.	Rule

See section /CandidateProfile/CandidatePositionPreferences/PreferredLocation for more information

RelocationConsidered attributes

Attributes	Description	Card.	Rule
See section /CandidateProfile/CandidatePositionPreferences/RelocationConsidered for more information

TravelPreference attributes

Attributes	Description	Card.	Rule
See section /CandidateProfile/CandidatePositionPreferences/TravelPreference for more information

JobCategory attributes

Attributes	Description	Card.	Rule
See section /CandidateProfile/CandidatePositionPreferences/OfferedRemunerationPackage/JobCategory for more information

3.18.3 Sub-element: /CandidateProfile/CandidatePositionPreference/PreferredLocation (level 3)

3.18.3.1 PreferredLocation Element Description

graph TD
subgraph " "
A(PreferredLocationType)
B(PreferredLocation)
C(hr:MaximumCommuteDistanceMeasure)
D(ReferenceLocation)
end
A -- "0..∞" --> B
B -- "It contains location of the preferred position." --> B
A -- "1..∞" --> C
C -- "The maximum distance required or preferred to commute." --> C
A -- "1..∞" --> D
D -- "A base location from which a distance, commuting time, or travel directions, etc. is calculated." --> D

Element	Description	Cardinality	Rule	Examples
PreferredLocation	Location of the preferred position	0..n	N/A	N/A

Sub-elements

MaximumCommuteDistance	The maximum distance required or preferred to commute	0..1	N/A	N/A
ReferenceLocation	A base location from which a distance, commuting time, or travel directions, etc. is calculated See section /CandidateProfile/CandidatePositionPreference/PreferredLocation/ReferenceLocation for more information	1..n		N/A

3.18.3.2 PreferredLocation Attributes

Attributes	Description	Card.	Rule
This element has no attributes.

MaximumCommuteDistanceMeasure attributes

Attributes	Description	Card.	Rule
Refer to MeasureType Attributes section for additional attributes.

ReferenceLocation attributes

Attributes	Description	Card.	Rule
See section /CandidateProfile/CandidatePositionPreference/PreferredLocation/ReferenceLocation for more information

3.18.4 Sub-element: /CandidateProfile/CandidatePositionPreference/PreferredLocation/ReferenceLocation (level 4)

3.18.4.1 ReferenceLocation Element Description

graph TD
A[ReferenceLocationType] --> B[oa:CityName]
A --> C[oa:CountrySubDivisionCode]
A --> D[CountryCode]
A --> E[oa:PostalCode]

subgraph ReferenceLocation
F[ReferenceLocation]
end

A -- "A base location from which<br>a distance, commuting<br>time, or travel directions,<br>etc. is calculated." --> F
F -- "A base location from which a distance, commuting time, or travel directions, etc. is calculated." --> A

Element	Description	Cardinality	Rule	Examples
ReferenceLocation	A base location from which a distance, commuting time, or travel directions, etc. is calculated	1..n		N/A
Sub-elements
CityName	Identifies the town or the city	0..1	N/A	"Brussels", "Barcelona", "London", etc.
CountrySubdivisionCode	Qualifies the further division of the Member States of Europe, which can be Districts, Regions, States, Provinces etc.	0..1	BR-COM-21: Compulsory use of the "EURES_CountrySubdivisionCodes-CodeList.gc" list defined by EURES. This is based on NUTS 2013 – Level 3. BR-COM-53: If CountryCode is specified, CountrySubDivisionCode value must correspond to CountryCode value.	"BE07", "CS01", etc. Full code list: "HR-Open/EURES: CountrySubdivisionCodes [CL08]"
CountryCode	Code of the country	0..1	Compulsory use of CountriesAndNationalities [ECV02], AuxCountriesAndNationalities [ECV10]	Europass2: CountriesAndNationalities [ECV02], Europass2: AuxCountriesAndNationalities [ECV10]
PostalCode	The Address' Postal Code.	0..1

3.18.4.2 ReferenceLocation Attributes

Attributes	Description	Card.	Rule
This element has no attributes
CityName attributes

Attributes	Description	Card.	Rule
Refer to NameType Attributes section for additional attributes
PostalCode attributes

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

Attributes	Description	Card.	Rule
Refer to CodeListAttributeGroup section for additional attributes
CountryCode 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.

3.18.5 Sub-element: /CandidateProfile/CandidatePositionPreference/JobCategory (level 3)

3.18.5.1 JobCategory Element Description

<img>Diagram showing "JobCategoryType" with "hr:JobCategoryCode" and "oa:Description"</img>

Element	Description	Cardinality	Rule	Examples
JobCategory	Category of the job	1..n	N/A	N/A
Sub-elements
JobCategoryCode	A code classifying the type or category of a job. This may be used for its occupational classification. The JobCategoryCode will usually be repeatable so that a single job could be classified across multiple dimensions. The JobCategoryCode could be used to classify the job by industry but note that an explicit IndustryCode is available in contexts such as PositionOrganizationDetails.	1	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. BR-COM-55: Compulsory use of the attributes “listVersionID”, “listName” and “listURI”.	“1” – Managers, “12” – Administrative, etc. Full code list: “HR-Open/EURES: ISCO2008 [CL20] HR-Open/EURES: ESCO_Occupations [CL20]
Description	Job category Description	0..1	N/A	“Description of job category”, etc.

3.18.5.2 JobCategory Attributes

Attributes	Description	Card.	Rule
This element has no attributes.
JobCategoryCode attributes
Attributes	Description	Card.	Rule
Refer to CodeType Attributes section for additional attributes.
Description attributes

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

3.18.6 Sub-element: /CandidateProfile/CandidatePositionPreference/OfferedRemunerationPackage (level 3)

3.18.6.1 OfferedRemunerationPackage Element Description

graph TD
subgraph OfferedRemunerationPackageType
OfferedRemunerationPackage --> @Attributes
OfferedRemunerationPackage --> hr:RemunerationBasisCode
OfferedRemunerationPackage --> RemunerationRange
OfferedRemunerationPackage --> eures:BenefitsSummary
OfferedRemunerationPackage --> oa:Description
end

@Attributes --> OfferedRemunerationPackage
hr:RemunerationBasisCode --> OfferedRemunerationPackage
RemunerationRange --> OfferedRemunerationPackage
eures:BenefitsSummary --> OfferedRemunerationPackage
oa:Description --> OfferedRemunerationPackage

OfferedRemunerationPackage -- "It contains the remuneration offered." --> OfferedRemunerationPackage
hr:RemunerationBasisCode -- "Position Remuneration Basis. Code A code classifying the primary method of payment for the
associated position or..." --> hr:RemunerationBasisCode
RemunerationRange -- "It contains remuneration range details." --> RemunerationRange
eures:BenefitsSummary -- "It contains summary of the benefits." --> eures:BenefitsSummary
oa:Description -- "It contains description of the remuneration offered." --> oa:Description

OfferedRemunerationPackage -- "Terms offered or agreed regarding remuneration for a position. May include pay as well as
benefits in-kind." --> OfferedRemunerationPackage

Element	Description	Cardinalit	Rule	Examples
OfferedRemunerationPackage	Remuneration offered	0..1	N/A	N/A

Sub-elements

RemunerationBasisCode	A code classifying the primary method of payment for the associated position or employment. This classifies the method by which remuneration for a position is provided or calculated. This is an HR-Open Standards open list.	0..1	BR-COM-30: Compulsory use of the "RemunerationBasisCodeContentType" list. Full code list: "HR-Open/EURES: RemunerationBasisCodeContentType [CL48]"	"Hourly", "Salaried", "SalariedPlusComission", "ComissionOnly"
RemunerationRange	Remuneration range details	0..n	BR-COM-31: All its sub elements must be expressed using the same currency.	N/A

erDiagram
OfferedRemunerationPackageType ||--o{ OfferedRemunerationPackage : "It contains the remuneration offered."
OfferedRemunerationPackage {
@Attributes
hr:EffectiveDateAttributeGroup
@ validFrom
@ validTo
}

See section /CandidateProfile/CandidatePositionPreference/OfferedRemunerationPackage/RemunerationRange for more information

BenefitsSummary	Summary of benefits	0..n	N/A	N/A
See section: /CandidateProfile/CandidatePositionPreference/OfferedRemunerationPackage/BenefitsSummary for more information
Description	Description of the remuneration offered	0..1	N/A	N/A

3.18.6.2 OfferedRemunerationPackage 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.

BenefitsSummary attributes

Attributes	Description	Card.	Rule
See section: /CandidateProfile/CandidatePositionPreference/OfferedRemunerationPackage/BenefitsSummary for more information

RemunerationRange attributes

Attributes	Description	Card.	Rule
See section /CandidateProfile/CandidatePositionPreference/OfferedRemunerationPackage/RemunerationRange for more information

RemnuerationBasisCode attributes

Attributes	Description	Card.	Rule
Refer to CodeListAttributeGroup Attributes section for additional attributes.

Description attributes

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

3.18.7 Sub-element: /CandidateProfile/CandidatePositionPreference/OfferedRemunerationPackage/RemunerationRange (level 4)

3.18.7.1 RemunerationRange Element Description

graph TD
subgraph RemunerationRangeType
A[RemunerationRange] --> B[hr:RemunerationTypeCode]
A --> C[RemunerationReferenceAmount]
A --> D[RemunerationMinimumAmount]
A --> E[RemunerationMaximumAmount]
A --> F[hr:RemunerationRateIntervalCode]
end

B -- "Remuneration Type Code The type of remuneration (e.g. BasePay, Bonus). CodeList: RemunerationTypeCodeType" -->
B_desc
C -- "A reference to an associated monetary amount. A monetary quantity. An attribute is available to express the
currency in..." --> C_desc
D -- "The minimum amount a person is willing to accept or an organization is willing to pay for a position." --> D_desc
E -- "The maximum amount a person is willing to accept or an organization is willing to pay for a position." --> E_desc
F -- "Remuneration Rate Interval Code A code identifying at what rate the remuneration is made. CodeList:..." --> F_desc

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

B_desc: It contains remuneration range details.
C_desc: The minimum and maximum range of work compensation. OED: Range n, A series or scale extending between certain
limits.

Element	Description	Cardinality	Rule	Examples
RemunerationRange	Remuneration range details	0..n	BR-COM-31: All its sub elements must be expressed using the same currency.	N/A
Sub-elements
RemunerationTypCode	A code classifying the type of pay or remuneration being described This is an HR-Open Standards open list.	0..1	BR-COM-32: Compulsory use of the “RemunerationCodeContentType” list.	“BasePay”, “Commission”, “Bonus”, “ShortTermIncentive”, “ShiftPremium” Full code list: “HR-Open/EURES: RemunerationCodeContentType [CL49]”
RemunerationReferenceAmount	A reference to an associated monetary quantity. An attribute is available to express the currency in which the amount is expressed.	0..1	N/A	“20000”, “35000”, etc.

RemunerationMinimumAmount	Description	Card.	Rule
0.1	The minimum amount a person is willing to accept, or an organization is willing to pay for a position.	N/A	"20000", "35000", etc.
RemunerationMaximumAmount	The maximum amount a person is willing to accept, or an organization is willing to pay for a position.	0.1	N/A
RemunerationRateIntervalCode	An interval of time or other basis used to express a rate of pay or remuneration	0.1	BR-COM-33: Compulsory use of the "RemunerationRateIntervalCodeContent Type" list. This is an HR-Open Standards open list.

Figure 139: Name Attributes Schema

3.18.7.2 RemunerationRange Attributes

Attributes	Description	Card.	Rule
This element has no attributes.
RemunerationMinimumAmount attributes
currencyID	The currency in which the maximal and minimal salary are indicated.	1	Compulsory use of the Europass2: Currency [ECV08]
RemunerationMaximumAmount attributes
The same as "RemunerationMinimumAmount"
RemunerationReferenceAmount attributes
The same as "RemunerationMinimumAmount"
RemunerationRateIntervalCode attributes
Refer to CodeListAttributeGroup Attributes for additional attributes.
RemunerationTypeCode attributes
Refer to CodeListAttributeGroup Attributes for additional attributes.

3.18.8 Sub-element: /CandidateProfile/CandidatePositionPreference/OfferedRemunerationPackage/BenefitsSummary (level 4)

3.18.8.1 BenefitsSummary Element Description

graph TD
A[BenefitsSummaryType] --> B(eures:BenefitsSummary)
B -- "It contains summary of the benefits." --> C
A --> D(OtherBenefits)
D -- "ABIE Benefits Summary. Details A summary of employee benefits ("fringe benefits," health, pension, etc.)
associated..." --> E

Element	Description	Cardinality	Rule	Examples
BenefitsSummary	Summary of benefits	0..n	N/A	N/A
Sub-elements
OtherBenefits	Details of benefits See section /CandidateProfile/CandidatePositionPreference/OfferedRemunerationPackage/BenefitsSummary/OtherBenefits for more information	0..1	N/A	N/A

3.18.8.2 BenefitsSummary Attributes

Attributes	Description	Card.	Rule
This element has no attributes.
OtherBenefits attributes

3.18.9 Sub-element: /CandidateProfile/CandidatePositionPreference/OfferedRemunerationPackage/BenefitsSummary/OtherBenefits (level 5)

3.18.9.1 OtherBenefits Element Description

graph TD
A[BenefitsSummaryType] --> B(OtherBenefitsType)
B --> C(OtherBenefits)
C -- "ABIE Benefits Summary. Details A summary of employee benefits ("fringe benefits," health, pension, etc.)
associated..." --> D
B --> E(hr:OtherBenefitsTypeCode)
B --> F(oa:Description)
E -- "BR-COM-40: Compulsory use of the \"EURES_SocialBenefitsCodes-CodeList.gc\" list defined by EURES." --> G

Element	Description	Cardinality	Rule	Examples
OtherBenefits	Details of the other benefits	0..1	N/A	N/A
Sub-elements
OtherBenefitsTypeCode	Code of benefits that the candidate would like	0..n	BR-COM-40: Compulsory use of the "EURES_SocialBenefitsCodes-CodeList.gc" list defined by EURES.	"0" = Accommodation included, "1" = Meals included, etc.

Description

Narrative details of benefits

0..1

N/A

BR-COM-43: Multiple entries of this code list are allowed. Full code list: "HR-Open/EURES: SocialBenefitsCodes [CL52]" "Description of other benefits", etc.

3.18.9.2 OtherBenefits Attributes

Attributes	Description	Card.	Rule
This element has no attributes.
OtherBenefitsTypeCode attributes
Attributes	Description	Card.	Rule
Refer to CodeType Attributes section for additional attributes
Description attributes
Attributes	Description	Card.	Rule
Refer to DescriptionType Attributes section for additional attributes

3.18.10 Sub-element: /CandidateProfile/CandidatePositionPreference/TravelPreference (level 3)

3.18.10.1 TravelPreference Element Description

<img>Diagram showing TravelPreferenceType with sub-elements WillingToTravelIndicator, TravelPercentage, and Description.</img>

Element	Description	Cardinality	Rule	Examples
TravelPreference	Travel Preference Details	0..1	N/A	N/A
Sub-elements
WillingToTravelIndicator	Indicates that a person is willing to travel within the capacity of his or her position	0..1	N/A	"True" or "False"
TravelPercentage	A rate, number or proportion per hundred. The percentage of time required for a position or the percentage of time a person is willing to travel for a particular position	0..1	N/A	"25", "35", etc.
Description	Description of the travel preference	0..1	N/A	N/A

3.18.10.2 TravelPreference Attributes

Attributes	Description	Card.	Rule
This element has no attributes.
Description attributes
Attributes	Description	Card.	Rule
Refer to DescriptionType Attributes section for additional attributes.
WillingToTravelIndicator attributes
Attributes	Description	Card.	Rule
This sub-element has no attributes.
TravelPercentage attributes
Attributes	Description	Card.	Rule
This sub-element has no attributes.

3.18.11 Sub-element: /CandidateProfile/CandidatePositionPreference/RelocationConsidered (level 3)

3.18.11.1 RelocationConsidered Element Description

graph TD
subgraph RelocationConsideredType
A[RelocationConsideredIndicator]
B[Description]
end
C[eures:RelocationConsidered]
D[It indicates if a candidate would consider moving to a new city or location for a suitable position.]

C --> D
C -- "*" --> A
C -- "*" --> B

Element	Description	Cardinality	Rule	Examples
RelocationConsidered	Indicates if a candidate would consider moving to a new city or location for a suitable position	0..1	N/A	N/A

Sub-elements

Element	Description	Cardinality	Rule	Examples
RelocationConsideredIndicator	Indicates whether relocation is an option for the candidate or considered by the hiring company	0..1	N/A	"True" or "False"
Description	Description of the relocation considered	0..1	N/A	N/A.

3.18.11.2 RelocationConsidered Attributes

Attributes	Description	Card.	Rule
This element has no attributes.

Description sub-element

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

RelocationConsidered sub-element

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