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.
/ [VerificationType]/ EligibleForRehire	- xsd:boolean - S (0/1)	A boolean value to indicate if the person is eligible for rehire. A value of False would indicate that the person would not be considered for rehire.
/ [VerificationType]/ AttendanceRating	- RatingType - S (0/1)	A rating of the person's on-the-job attendance.
/ [VerificationType]/ OverallPerformanceRating	- RatingType - S (0/1)	An overall performance rating. The rating may be numeric or a string value from a set of enumerations.
/ [VerificationType]/ QuestionAnswerPair	- EmploymentQuestionAnswerPairType - S (0/*)	Results of a specific question.

4 Appendix A - Document Version History

Date	Description
2003-Feb-26	Approved recommendation by HR-XML Consortium. The default and targetNamespaces of all HR-XML schemas have been standardized. This recommendation is available as part of the HR-XML 2_0 architecture.
2003-June-13	Added JobGrade for resume information. Also changed ContactMethod to multiple occurrences for EmployerContactInfo and Verification Contact Info.
2003-July-28	Changed structure for JobGrade. Added Competencies and JobLevel to PositionHistory. All changes based on membership review/feedback.
2006-Feb-28	Approved by Consortium
2007-Apr-15	Approved by Consortium

5 Appendix B – Related Documents

Reference	Link
Entity Identifiers	http://ns.hr-xml.org/2_5/HR-XML-2_5/CPO/EntityIdentifiers.html
Date/Time data types	http://ns.hr-xml.org/2_5/HR-XML-2_5/CPO/DateTimeDataTypes.html
Contact Method	http://ns.hr-xml.org/2_5/HR-XML-2_5/CPO/ContactMethod.html
Person Name	http://ns.hr-xml.org/2_5/HR-XML-2_5/CPO/PersonName.html
PostalAddress	http://ns.hr-xml.org/2_5/HR-XML-2_5/CPO/PostalAddress.html

6 Appendix C – Reference Examples

6.1 Resume

This example shows how employment information may be used within the HR-XML Resume. This is not a complete XML document.

</PersonName>

</Telephone>

<InternetEmailAddress>jdoe@fakeaddress.com</InternetEmailAddress>

<Municipality>Brooklyn</Municipality>

<StreetName>Pine Street</StreetName>

</DeliveryAddress>

</PostalAddress>

</ContactMethod>

</ContactInfo>

<Objective> To obtain a leadership position in the field of Electronic Commerce</Objective>

<EmployerOrgName>General Electric</EmployerOrgName>

<Title>E-Business Program Manager - Business to Business integration (B2Bi) Program</Title>

<OrganizationName>Aircraft Engines (GEAE)</OrganizationName>

</OrgName>

<Description>Key Player in the GE growth initiative bringing IT leadership into our acquisition/ JV strategy. Ensured fundamental IT capabilities were present in acquisition targets in order to maintain a competitive advantage and ensure future growth. Led cross-functional team on due diligence, and negotiations activity for $100M+ acquisitions. Led several new market opportunity assessments and Instrumental in acquisition strategy development including negotiation of partnership structures and negotiating potential new market opportunities.</Description>

</StartDate>

</PositionHistory>

<Title>E-Business Program Manager - Business to Business integration (B2Bi) Program</Title>

<OrganizationName>Aircraft Engines (GEAE)</OrganizationName>

</OrgName>

<Description>Supply Chain and Customer Integration- Led B2Bi initiative and interface that enabled us to exchange business critical information while leveraging XML and the Internet within a secure communication framework. Key Member of GE Aircraft Engines E-Business Leadership Team Led Strategy, Development, and Execution for $4.1 million $ B2BI program Reducing operational business costs through digitization. Customer Facing Role- Personally managed and Created Customer Relationships as well as Led B2Bi Installations.

Led cross-functional team that led to industry XML standards adoption. Used Six Sigma methodology to drive continuous improvement and cycle time and cost reductions.

Web Site was eWeeks 2000 First Place award winner in the B2B E-Commerce Category.</Description>

</StartDate>

</EndDate>

</PositionHistory>

</EmployerOrg>

</EmploymentHistory>

</StructuredXMLResume>

</Resume>

6.2 Background Check

This example shows how employment information may be used within the HR-XML Background Check schema. This is not a complete XML document.

</ReferenceId>

<EmployerOrgName>Sally's Contact Company</EmployerOrgName>

<Title>Supervisor</Title>

<OrganizationName>Sally's Contact Company</OrganizationName>

</OrgName>

</StartDate>

</EndDate>

</Compensation>

<FormattedName type="presentation">Sally's Contact Name</FormattedName> </PersonName>

<Location>office</Location>

</Telephone>

<Municipality>Joliet</Municipality>

</DeliveryAddress>

</PostalAddress>

</ContactMethod>

</ContactInfo>

<VerifyEmployment>false</VerifyEmployment>

<EligibleForRehire>false</EligibleForRehire>

</AttendanceRating>

</OverallPerformanceRating>

<Question>Have you ever received any reprimands?</Question>

</QuestionAnswerPair>

<Question> What was the nature of the reprimands?</Question>

<Answer>The 1st occurrance,I vandalized the bosses car. The 2nd time was for trashing his office.</Answer>

</QuestionAnswerPair>

</Verification>

</PositionHistory>

</EmployerOrg>

</EmploymentHistory>

</SearchEmployment>

</Screening>