Military History
Recommendation, 2007 April 15
Editors:
Kim Bartkus, HR-XML Consortium, Inc.
Contributors:
Chuck Allen, HR-XML Consortium, Inc.
Kim Bartkus, HR-XML Consortium, Inc.
Members of the Recruiting & Staffing workgroup
Members of the Screening workgroup
Copyright © 2007 HR-XML Consortium, Inc.
Abstract
This document describes the military history schema, including a few examples of how it might be used.
Table of Contents
4 Appendix A - Document Version History
5 Appendix B – Related Documents
6 Appendix C – Reference Examples
This specification provides a method to exchange historical military 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 military information may be used for a wide-range of Human Resource business processes. Therefore, it is considered a cross-process object.
The objective of this specification is to create a flexible military history schema. This version will be backwards compatible with both the Resume and BackgroundCheck. It will also allow for the flexibility required for new development.
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 and BackgroundCheck
This schema may be used in a wide-range of Human Resource business processes. The following are only two examples that might use the MilitaryHistory schema.
An individual seeking a job may provide military experience information pertinent to a job. For example, an individual that maintained military vehicles during their service years could use that experience to apply for an auto mechanic job. This military history is typically provided on a resume or CV. The HR-XML Resume schema includes military history information.
Often, an employer will request information on a potential employee during the hiring process. This request may include information about military service. 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 in the Army. The screening company may request verification of this claim by using the MilitaryHistory schema in a data exchange between the screening company and Army Administration or to provide feedback to the potential employer. The HR-XML BackgroundCheck schema includes military history information.

|
Component Name [Global types listed at the end of the table.] |
ContentModel* |
Definition |
|
|
/ |
MilitaryHistoryType - (1/1)
CountryServed
- CountryCodeType - S
(1/1) |
Contains information on a person's military service, including country served, branch of service, rank achieved, Dates of Service, Areas of special training or experience, Recognition or honors received, Status of Discharge. |
|
|
/
MilitaryHistory/ |
- CountryCodeType - S (1/1) |
Name of the country for which the Military service was performed. |
|
|
/
MilitaryHistory/ |
- EntityIdType - S (0/1) |
A person's "serial number" or other personal identifier related to a period of military service. |
|
|
/
MilitaryHistory/ |
UnitOrDivision
- xsd:string - S
(0/1) |
Contains a collection of information about service within a particular branch of the military |
|
|
/
[MilitaryHistoryType]/ ServiceDetail/ |
- xsd:string - |
Branch of military where where human resource was assigned (Army, Navy, Royal Guard). |
|
|
/
MilitaryHistory/ ServiceDetail/ |
- xsd:string - S (0/1) |
The unit of division within the service branch, e.g., infantry, division 211. |
|
|
/
MilitaryHistory/ ServiceDetail/ |
RankAchievedType - S (0/1)
StartRank
- xsd:string - S
(0/1) |
The level or rank achieved during the course of Military service. |
|
|
/
MilitaryHistory/ ServiceDetail/ RankAchieved/ |
- xsd:string - S (0/1) |
The level or rank when active service began. |
|
|
/
MilitaryHistory/ ServiceDetail/ RankAchieved/ |
- xsd:string - S (0/1) |
The level or rank when active service ended. If blank, the military service is active or current. |
|
|
/
MilitaryHistory/ ServiceDetail/ |
DatesOfServiceType - S (1/1)
StartDate
- FlexibleDatesType - S (1/1) |
The interval of time that the person was active in the Military. |
|
|
/
MilitaryHistory/ ServiceDetail/ DatesOfService/ |
- FlexibleDatesType - S (1/1) |
The beginning effective date for the specified supporting information. |
|
|
/
MilitaryHistory/ ServiceDetail/ DatesOfService/ |
- FlexibleDatesType - S (0/1) |
The ending effective date for the specified supporting information. |
|
|
/
MilitaryHistory/ ServiceDetail/ |
- xsd:string - S (0/*) |
(Department of Defense) A series of related military operations aimed at accomplishing a strategic or operational objective within a given time and space. |
|
|
/
MilitaryHistory/ ServiceDetail/ |
- xsd:string - S (0/*) |
Special training received or expertise gained during the course of Military service (Demolitions, Air Traffic Control, etc.) |
|
|
/
MilitaryHistory/ ServiceDetail/ |
- xsd:string – S (0/*) |
Honors or awards received for Military service (Purple Heart, Good Conduct medal, etc.) |
|
|
/
MilitaryHistory/ ServiceDetail/ |
- xsd:string – S (0/*) |
Disciplinary action taken or pending. If the action is pending, set the pending attribute = true. |
|
|
/
MilitaryHistory/ ServiceDetail/ |
- xsd:string – S (0/1) |
Status of Discharge from Military Service (Honorable, Medical, etc.) |
|
|
/
MilitaryHistory/ |
- xsd:string – S (0/1) |
Describes the current military status of the person. For example, retired, reserve, separated, civilian, etc. |
|
|
/
MilitaryHistory/ |
- xsd:string – S (0/1) |
A descriptive field used to further comment on the military history. |
|
|
|
|
|
|
|
Date |
Description |
||
|
2002-Dec-05 |
Initial Draft |
||
|
2002-Dec-11 |
Added user areas. Added screening example. |
||
|
2003-Jan-20 |
Updated doc to reflect TSC/CPO feedback. |
||
|
2003-02-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. |
||
|
2006-Feb-28 |
Approved by Consortium |
|
|
2007-Apr-15 |
Approved by Consortium |
||
|
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 |
This example shows how military information may be used within the HR-XML Resume. This is not a complete XML document.
<Resume>
<StructuredXMLResume>
<ContactInfo>
<PersonName>
<FormattedName>John Doe</FormattedName>
</PersonName>
<ContactMethod>
<Telephone>
<FormattedNumber>123-456-7890</FormattedNumber>
</Telephone>
<InternetEmailAddress>jdoe@fakeaddress.com</InternetEmailAddress>
<PostalAddress>
<CountryCode>US</CountryCode>
<Region>MA</Region>
<Municipality>Brooklyn</Municipality>
<DeliveryAddress>
<AddressLine>27 </AddressLine>
<StreetName>Pine Street</StreetName>
</DeliveryAddress>
</PostalAddress>
</ContactMethod>
</ContactInfo>
<Objective>To obtain a leadership position in the field of Electronic Commerce</Objective>
<MilitaryHistory>
<CountryServed>US</CountryServed>
<ServiceNumber>
<IdValue>977246</IdValue>
</ServiceNumber>
<ServiceDetail branch="Army">
<UnitOrDivision>Fort SIll, OK</UnitOrDivision>
<RankAchieved>
<CurrentOrEndRank>Captain</CurrentOrEndRank>
</RankAchieved>
<DatesOfService>
<StartDate>
<AnyDate>1991-02-01</AnyDate>
</StartDate><EndDate>
<AnyDate>1998-06-01</AnyDate>
</EndDate>
</DatesOfService>
<Campaign>Gulf War</Campaign>
<AreaOfExpertise>Successfully led field logistics and maintenance operation centers and developed operational and combat standard operation procedures (SOP). Developed and implemented a battalion recovery operation procedure, which saved critical training time and funds. Led maintenance teams to win Corps level awards in maintenance excellence four different times. As both a battery operations officer and battalion maintenance officer I successfully led the tactical deployments of my respective units. </AreaOfExpertise>
<RecognitionAchieved>Army Good Conduct Medal</RecognitionAchieved>
</ServiceDetail>
</MilitaryHistory>
</StructuredXMLResume>
</Resume>
This example shows how military information may be used within the HR-XML Background Check schema. This is not a complete XML document.
<Screening type="military">
<ReferenceId>
<IdValue>9XO</IdValue>
</ReferenceId>
<CountryCode>US</CountryCode>
<ClientReferences>
<IdValue name="ref1">3666</IdValue>
<IdValue name="ref2">Client Reference 2</IdValue>
<IdValue name="ref3">Client Reference 3</IdValue>
</ClientReferences>
<SearchMilitary>
<MilitaryHistory>
<CountryServed>US</CountryServed>
<ServiceNumber>
<IdValue>977246</IdValue>
</ServiceNumber>
<ServiceDetail branch="Army">
<UnitOrDivision>Fort SIll, OK</UnitOrDivision>
<RankAchieved>
<CurrentOrEndRank>Captain</CurrentOrEndRank>
</RankAchieved>
<DatesOfService>
<StartDate>
<AnyDate>1991-02-01</AnyDate>
</StartDate><EndDate>
<AnyDate>1998-06-01</AnyDate>
</EndDate>
</DatesOfService>
<Campaign>Gulf War</Campaign>
<AreaOfExpertise>Successfully led field logistics and maintenance operation centers and developed operational and combat standard operation procedures (SOP). Developed and implemented a battalion recovery operation procedure, which saved critical training time and funds. Led maintenance teams to win Corps level awards in maintenance excellence four different times. As both a battery operations officer and battalion maintenance officer I successfully led the tactical deployments of my respective units. </AreaOfExpertise>
<RecognitionAchieved>Army Good Conduct Medal</RecognitionAchieved>
</ServiceDetail>
</MilitaryHistory>
</SearchMilitary>
</Screening>