This specification provides a method to exchange historical employment information between trading partners. The schema is not intended to be stand-alone, rather it should be included within other HR-XML schemas. The historical employment information may be used for a wide-range of Human Resource business processes. Therefore, it is considered a cross-process object.

The following enhancements were made to allow for exchanging more complete resume information.

§ JobLevelInfo, Competency, and JobCategory added to Position History.

§ Contact Method changed to allow multiple occurrences within the employer organization and verification contact information. This allows more than one contact phone number or other pertinent contact information.

1.1 Objective

The objective of this specification is to create a flexible employment history schema. This version will be backwards compatible with both the Resume 2.0 and BackgroundCheck 1.0. It will also allow for the flexibility required for new development.

1.2 Design Requirements

Design requirements include:

· Syntax MUST be self-documenting

· Schema MUST be easy to understand and use

· Schema MUST use approved CPO standards

· Designed for easy reuse

· Backwards compatible with the components used in Resume 2.0 and BackgroundCheck 1.0

2 Business Process Supported

This schema may be used in a wide-range of Human Resource business processes. The following are only two examples that might use the EmploymentHistory schema.

2.1 Recruiting

An individual seeking a job may provide employment experience information pertinent to a job. For example, an individual that processed payroll runs during their prior employment could use that experience to apply for a payroll clerk job. This employment history is typically provided on a resume or CV. The HR-XML Resume 2.0 schema includes employment history information.

2.2 Employee Screening

Often, an employer will request information on a potential employee during the hiring process. This request may include information about work history. This might be used to verify data entered on a resume or job application. For example, an applicant might claim he worked as a Procurement Officer. The screening company may request verification of this claim by using the EmploymentHistory schema in a data exchange between the screening company and a previous employer or to provide feedback to the potential employer. The HR-XML BackgroundCheck 1.0 schema includes employment history information.

3 Schema Design

3.1 Schema Diagram

3.2 Element Definitions

Elements and Attributes [Global types listed alphabetically in following table.]	ContentModel* Data type Occurrence: Sequence \| Choice \| All (minOccurs/maxOccurs) Attributes	Definition
/ EmploymentHistory	- EmploymentHistoryType - (1/1)	A container for previous positions a person held.
/ EmploymentHistory/ EmployerOrg	- EmployerOrgType - S (1/*)	Container for information about the entity that paid or pays the person, or carried/carries the legal liability for the person while the work is performed.
/ EmploymentHistory/ EmployerOrg/ EmployerOrgName	- xsd:string - S (1/1)	The name of the entity that paid or pays the person, or carried/carries the legal liability for the person while the work is performed.
/ EmploymentHistory/ EmployerOrg/ EmployerContactInfo	- EmpContactInfoType - S (0/1)	The primary contact information for the EmployerOrg as it relates to the employment verification of the HumanResource.
/ EmploymentHistory/ EmployerOrg/ PositionHistory	xsd:extension base: PositionHistoryType	A single position that the person previously held or currently holds. A position is a coherent collection of duties under a single engagement. A change in employer or position organization usually marks the start of a new position.

Global types (alphabetically listed)	ContentModel* Data type Occurrence: Sequence \| Choice \| All (minOccurs/maxOccurs) Attributes	Definition
/ [contactTypes]	xsd:restriction base: xsd:string [Enumerations]: recruiter, HRRep, directSupervisor	Globally scoped data type. See element or attribute declaration for definition.
/ [ContactTypeStringExtensionType]	- [Union]: contactTypes,xsd:string	Globally scoped data type. See element or attribute declaration for definition.
/ [EmpContactInfoType]	contactType - ContactTypeStringExtensionType - PersonName - [see include/import] - S (0/1) ContactMethod - ContactMethodType - S (0/1) LocationSummary - EmploymentLocationSummaryType - S (0/1) InternetDomainName - InternetDomainNameType - S (0/*)	Globally scoped data type. See element or attribute declaration for definition.
/ [EmpContactInfoType] / contactType	- ContactTypeStringExtensionType -	The role of the contact as it relates to the organization.
/ [EmpContactInfoType]/ ContactMethod	- ContactMethodType - S (0/1)	Defines the methods of contacting a person or organizations.
/ [EmpContactInfoType]/ LocationSummary	- EmploymentLocationSummaryType - S (0/1)	Information on where the entity is located. This information may include a municipality, region, country and postal code.
/ [EmpContactInfoType]/ InternetDomainName	- InternetDomainNameType - S (0/*)	This is a domain name intended as a practical identifier for the organization. When used in OrganizationType, it designates a domain typically used for web and e-mail. It is not intended as a web address (URL).
/ [EmployerOrgType]	employerOrgType - EmpOrgTypeStringExtensionType - EmployerOrgName - xsd:string - S (1/1) EmployerContactInfo - EmpContactInfoType - S (0/1) PositionHistory - PositionHistoryType - S (1/*) UserArea - [see include/import] - S (0/1)	Globally scoped data type. See element or attribute declaration for definition.
/ [EmployerOrgType] / employerOrgType	- EmpOrgTypeStringExtensionType -	The type of relationship the EmployerOrg has/had to the HumanResource (Sole employer, Agent, Broker, etc.)
/ [employerOrgTypes]	xsd:restriction base: xsd:string [Enumerations]: soleEmployer, agent, broker, self	Globally scoped data type. See element or attribute declaration for definition.
/ [EmploymentHistoryType]	EmployerOrg - EmployerOrgType - S (1/*)	Globally scoped data type. See element or attribute declaration for definition.
/ [EmploymentLocationSummary Type]	Municipality - xsd:string - S (0/1) Region - xsd:string - S (0/*) CountryCode - [see include/import] - S (0/1) PostalCode - xsd:string - S (0/1)	Globally scoped data type. See element or attribute declaration for definition.
/ [EmploymentLocationSummaryType]/ Municipality	- xsd:string - S (0/1)	Represents the city, town, village, or hamlet.
/ [EmploymentLocationSummaryType]/ Region	- xsd:string - S (0/*)	Represents the State, Province, and/or County.
/ [EmploymentLocationSummaryType]/ PostalCode	- xsd:string - S (0/1)	Codes established by postal authorities for purposes of sorting and delivering mail. See PostalAddress Recommendation.
/ [EmploymentQuestionAnswer PairType]	Question - xsd:string - S (1/1) Answer - xsd:string - S (0/1)	Globally scoped data type. See element or attribute declaration for definition.
/ [EmploymentQuestionAnswerPairType]/ Question	- xsd:string - S (1/1)	A question in a question/answer pair
/ [EmploymentQuestionAnswerPairType]/ Answer	- xsd:string - S (0/1)	An answer in a question/answer pair.
/ [EmpOrgTypeStringExtensionType]	- [Union]: employerOrgTypes,xsd:string	Globally scoped data type. See element or attribute declaration for definition.
/ [intervalTypes]	xsd:restriction base: xsd:string [Enumerations]: hourly, daily, weekly, monthly, quarterly, yearly, semi-monthly, biweekly, fortnightly	Globally scoped data type. See element or attribute declaration for definition.
/ [IntervalTypeStringExtensionType]	- [Union]: intervalTypes,xsd:string	Globally scoped data type. See element or attribute declaration for definition.
/ [NumericRatingType]	xsd:restriction base: xsd:integer	Globally scoped data type. See element or attribute declaration for definition.
/ [organizationTypes]	xsd:restriction base: xsd:string [Enumerations]: department, group, team, branch, company, subsidiary, unit, headquarters	Globally scoped data type. See element or attribute declaration for definition.
/ [OrganizationTypeStringExtension Type]	- [Union]: organizationTypes,xsd:string	Globally scoped data type. See element or attribute declaration for definition.
/ [PositionCompensationType]	StartingCompensation - xsd:string - S (0/1) EndingCompensation - xsd:string - S (0/1) Comments - xsd:string - S (0/1) OtherCompensation - xsd:string - S (0/*)	Globally scoped data type. See element or attribute declaration for definition.
/ [PositionCompensationType]/ StartingCompensation	xsd:extension base: xsd:string currency - CurrencyCodeType - required intervalType - IntervalTypeStringExtensionType - optional validFrom - AnyDateTimeNaType - optional validTo - AnyDateTimeNaType - optional	Amount the Human Resource was compensated as of the PositionStartDate.
/ [PositionCompensationType]/ StartingCompensation/ currency	- CurrencyCodeType -	A three-letter code identifying the currency of a monetary amount. Currency is represented in accordance with ISO 4217. This may be at an individual or group level.
/ [PositionCompensationType]/ StartingCompensation/ intervalType	- IntervalTypeStringExtensionType -	Describes the time interval on which the compensation is based.
/ [PositionCompensationType]/ StartingCompensation/ validFrom	- AnyDateTimeNaType -	The date the event begins, is active or valid.
/ [PositionCompensationType]/ StartingCompensation/ validTo	- AnyDateTimeNaType -	The date through which the event is active.
/ [PositionCompensationType]/ EndingCompensation	xsd:extension base: xsd:string currency - CurrencyCodeType - required intervalType - IntervalTypeStringExtensionType - optional validFrom - AnyDateTimeNaType - optional validTo - AnyDateTimeNaType - optional	Amount the person was compensated as of the position end date.
/ [PositionCompensationType]/ EndingCompensation/ currency	- CurrencyCodeType -	A three-letter code identifying the currency of a monetary amount. Currency is represented in accordance with ISO 4217. This may be at an individual or group level.
/ [PositionCompensationType]/ EndingCompensation/ intervalType	- IntervalTypeStringExtensionType -	Describes the time interval on which the compensation is based.
/ [PositionCompensationType]/ EndingCompensation/ validFrom	- AnyDateTimeNaType -	The date the event begins, is active or valid.
/ [PositionCompensationType]/ EndingCompensation/ validTo	- AnyDateTimeNaType -	The date through which the event is active.
/ [PositionCompensationType]/ Comments	- xsd:string - S (0/1)	Describes the contextual information relating to a group of elements.
/ [PositionCompensationType]/ OtherCompensation	xsd:extension base: xsd:string type - xsd:string - validFrom - AnyDateTimeNaType - optional validTo - AnyDateTimeNaType - optional	Additional information relating to the compensation.
/ [PositionCompensationType]/ OtherCompensation/ type	- xsd:string -	Further defines the associated element in the context provided.
/ [PositionCompensationType]/ OtherCompensation/ validFrom	- AnyDateTimeNaType -	The date the event begins, is active or valid.
/ [PositionCompensationType]/ OtherCompensation/ validTo	- AnyDateTimeNaType -	The date through which the event is active.
/ [PositionHistoryType]	positionType - PositionTypexStringPatternExtensionType - currentEmployer - xsd:boolean - optional Title - xsd:string - S (0/1) OrgName - PositionOrgNameType - S (1/1) OrgInfo - PositionOrgInfoType - S (0/) OrgIndustry - PositionOrgIndustryType - S (0/) OrgSize - xsd:string - S (0/1) Description - xsd:string - S (1/1) StartDate - FlexibleDatesType - S (1/1) EndDate - FlexibleDatesType - S (0/1) Compensation - PositionCompensationType - S (0/1) Comments - xsd:string - S (0/1) Verification - VerificationType - S (0/1) JobLevelInfo - JobLevelInfoType - S (0/) JobCategory - OccupationalCategoryType - S (0/) Competency - [see include/import] - S (0/*) UserArea - [see include/import] - S (0/1)	Globally scoped data type. See element or attribute declaration for definition.
/ [PositionHistoryType] / positionType	- PositionTypexStringPatternExtensionType -	The type of arrangement under which the position is/was undertaken.
/ [PositionHistoryType] / currentEmployer	- xsd:boolean -	Indicates if the position is for the current employer.
/ [PositionHistoryType]/ Title	- xsd:string - S (0/1)	The name or title within a given context.
/ [PositionHistoryType]/ OrgName	- PositionOrgNameType - S (1/1)	The name of the organization for which the HumanResource performs work.
/ [PositionHistoryType]/ OrgInfo	- PositionOrgInfoType - S (0/*)	Contains information about the position's organization.
/ [PositionHistoryType]/ OrgInfo/ PositionLocation	- PostalAddressType - S (0/1)	Information about the location of the position organization.
/ [PositionHistoryType]/ OrgInfo/ WebSite	- InternetWebAddressType - S (0/1)	Contains a URL for the position organization's website.
/ [PositionHistoryType]/ OrgInfo/ LocationSummary	- EmploymentLocationSummaryType - S (0/1)	Information on where the entity is located. This information may include a municipality, region, country and postal code.
/ [PositionHistoryType]/ OrgIndustry	- PositionOrgIndustryType - S (0/*)	The type of industry to which the position organization belongs.
/ [PositionHistoryType]/ OrgSize	- xsd:string - S (0/1)	The number of employees of the position organization.
/ [PositionHistoryType]/ Description	- xsd:string - S (1/1)	Describes the contextual information relating to a specific element.
/ [PositionHistoryType]/ StartDate	- FlexibleDatesType - S (1/1)	Contains the (inclusive) date, period, or interval the event becomes active or begins.
/ [PositionHistoryType]/ EndDate	- FlexibleDatesType - S (0/1)	Contains the (inclusive) date, period, or interval the event becomes inactive or ends.
/ [PositionHistoryType]/ Compensation	- PositionCompensationType - S (0/1)	Container for information regarding compensation for a position.
/ [PositionHistoryType]/ Verification	- VerificationType - S (0/1)	Container for information allowing verification of previous employment in a specific position. In the case where the employer organization is different from the position organization, only employer organization contact information should be used.
/ [PositionHistoryType]/ JobLevelInfo	- JobLevelInfoType - S (0/*)	Defines a level associated with a position.
/ [PositionHistoryType]/ JobCategory	- OccupationalCategoryType - S (0/*)	A grouping of jobs under one or more classification schemes that is meaningful to an organization.
/ [PositionOrgIndustryType]	primaryIndicator - xsd:boolean - required IndustryDescription - xsd:string - S (0/1) IndustryCode - xsd:string - S (0/1)	Globally scoped data type. See element or attribute declaration for definition.
/ [PositionOrgIndustryType] / primaryIndicator	- xsd:boolean -	If there is more than one instance of the associated element, this attribute identifies which one is primary within the transaction.
/ [PositionOrgIndustryType]/ IndustryDescription	- xsd:string - S (0/1)	A description that specifies the type of industry to which the position organization belongs.
/ [PositionOrgIndustryType]/ IndustryCode	xsd:extension base: xsd:string classificationName - xsd:string - optional	A code that specifies the type of industry to which the entity belongs.
/ [PositionOrgIndustryType]/ IndustryCode/ classificationName	- xsd:string -	The name of the agency or organization that issued the classification code.
/ [PositionOrgInfoType]	PositionLocation - PostalAddressType - S (0/1) WebSite - InternetWebAddressType - S (0/1) LocationSummary - EmploymentLocationSummaryType - S (0/1)	Globally scoped data type. See element or attribute declaration for definition.
/ [PositionOrgInfoType]/ PositionLocation	- PostalAddressType - S (0/1)	Information about the location of the position organization.
/ [PositionOrgInfoType]/ WebSite	- InternetWebAddressType - S (0/1)	Contains a URL for the position organization's website.
/ [PositionOrgInfoType]/ LocationSummary	- EmploymentLocationSummaryType - S (0/1)	Information on where the entity is located. This information may include a municipality, region, country and postal code.
/ [PositionOrgNameType]	organizationType - OrganizationTypeStringExtensionType - optional OrganizationName - xsd:string - S (1/1) OrgName - PositionOrgNameType - S (0/1)	Globally scoped data type. See element or attribute declaration for definition.
/ [PositionOrgNameType] / organizationType	- OrganizationTypeStringExtensionType -	The type of organizational unit.
/ [PositionOrgNameType]/ OrganizationName	- xsd:string - S (1/1)	The name by which an organization or enterprise is known as established under the laws of a country, state, province or ruling governmental body for the purpose of conducting business transactions.
/ [PositionOrgNameType]/ OrgName	- PositionOrgNameType - S (0/1)	The name of the organization for which the HumanResource performs work.
/ [positionTypes]	xsd:restriction base: xsd:string [Enumerations]: directHire, contract, temp, contractToHire, tempToHire, volunteer, internship	Globally scoped data type. See element or attribute declaration for definition.
/ [PositionTypexStringPattern ExtensionType]	- [Union]: positionTypes,xStringPatternExtensionType	Globally scoped data type. See element or attribute declaration for definition.
/ [RatingType]	NumericValue - xsd:double - C (1/1) StringValue - xsd:string - C (1/1)	Globally scoped data type. See element or attribute declaration for definition.
/ [RatingType]/ NumericValue	xsd:extension base: xsd:double minValue - xsd:double - maxValue - xsd:double - description - xsd:string -	The content of NumericValue is a rating value. The minValue, maxValue, and name/description attributes of NumericValue provide information about the rating scale that is being used, so that the rating value can be interpreted.
/ [RatingType]/ NumericValue/ minValue	- xsd:double -	The minimum value of the rating scale.
/ [RatingType]/ NumericValue/ maxValue	- xsd:double -	The maximum value of the rating scale.
/ [RatingType]/ NumericValue/ description	- xsd:string -	This optional attribute is available to provide additional information.
/ [RatingType]/ StringValue	xsd:extension base: xsd:string minValue - xsd:string - maxValue - xsd:string - description - xsd:string -	The content of StringValue is a rating value. The minValue, maxValue, and name/description attributes of StringValue provide information about the rating scale that is being used, so that the rating value can be interpreted.
/ [RatingType]/ StringValue/ minValue	- xsd:string -	The minimum value of the rating scale.
/ [RatingType]/ StringValue/ maxValue	- xsd:string -	The maximum value of the rating scale.
/ [RatingType]/ StringValue/ description	- xsd:string -	This optional attribute is available to provide additional information.
/ [StringRatingType]	- [Union]: StringRatingTypes,xStringPatternExtensionType	Globally scoped data type. See element or attribute declaration for definition.
/ [StringRatingTypes]	xsd:restriction base: xsd:string [Enumerations]: poor, good, excellent	Globally scoped data type. See element or attribute declaration for definition.
/ [VerificationType]	ContactInfo - [complexType] - S (1/1) ReasonForLeaving - xsd:string - S (0/1) PermissionToContact - xsd:boolean - S (0/1) VerifyEmployment - xsd:boolean - S (0/1) EligibleForRehire - xsd:boolean - S (0/1) AttendanceRating - RatingType - S (0/1) OverallPerformanceRating - RatingType - S (0/1) QuestionAnswerPair - EmploymentQuestionAnswerPairType - S (0/*)	Globally scoped data type. See element or attribute declaration for definition.
/ [VerificationType]/ ContactInfo	PersonName - [see include/import] - S (1/1) ContactMethod - ContactMethodType - S (0/1)	Contains information to contact a person or entity.
/ [VerificationType]/ ReasonForLeaving	- xsd:string - S (0/1)	The reason a person left a prior position. For example. Death, Disability, Retirement.
/ [VerificationType]/ PermissionToContact	- xsd:boolean - S (0/1)	The person agrees/does not agree that the organization may be contacted to verify performance or other position-related details. .
/ [VerificationType]/ VerifyEmployment	- xsd:boolean - S (0/1)	An indicator whether to verify that the applicant was employed at the specified employer.