Personnel

Personnel information is the human resource information maintained for each employee.  It includes such data as job code, employee status, department or place in the organization, and job-related skills.  Although generally maintained in a Human Resource Management System (HRMS), this information may also be needed and updated by manufacturing applications (workforce scheduling) or project management (resource allocation).

See http://www.openapplications.org/oagis/9.

Element information

Content

• Sequence [1..1]
  from type PersonABIEType
  ID [0..*]    Is the Identifiers of the given instance of an entity within the scope of the integration. The schemeAgencyID attribute identifies the party that provided or knows this party by the given identifier.
  from group PersonNameGroup
  Choice [0..1]
  • Name [0..*]    Identifies the Name of the object in which associated.
  • Sequence [1..1]
    1. Title [0..*]    Is the title of the person. For example Dr..
    2. SalutationPreferredName [0..*]    Way the person is addressed e.g. Honorable etc?
    3. GivenName [0..1]    Is the Persons given name or first name.
    4. NickName [0..*]    
    5. MiddleName [0..*]    Is the persons middle name.
    6. FamilyName [0..1]    Is the persons family name.
    7. MaidenName [0..1]    
    8. SuffixName [0..*]    
  Description [0..*]    
  GenderCode [0..1]    A Code indicating the sex of the individual in which it is associated.
  MaritalStatusCode [0..1]    A code indicating the martial status of the individual in which it is associated.
  BirthDateTime [0..1]    Is the date and time that an individual was born.
  DeathDateTime [0..1]    Is the date and time that an individual died.
  AgeMeasure [0..*]    
  LanguageCode [0..*]    
  NationalityCountryCode [0..1]    
  Address [0..*]    
  Communication [0..*]    
  from type EmployeeBaseType
  from group EmployeeGroup
  Sequence [0..1]
  1. JobTitle [0..*]    Is the position or designation of the pesron with whom associated within the given organization. Examples are Director, Software Engineer, Purchasing Manager etc
  2. JobCode [0..1]    This is a grouping of similar or equivalent job descriptions
  3. Responsibility [0..*]    A text description of the responsibility of the associated entity.
  4. DepartmentID [0..1]    Is the department in which the associated entity belongs within the given organization.
  5. CategoryCodes [0..1]    Provides a list of category codes that identify the capabilities and features of the associated object.
  6. CategoryClassification [0..*]    
  7. Qualification [0..*]    Represents the qualification of the associated object. When used in a RFQ and Quote scenarios may represents the response to selection criteria that will be used to evaluate the Party. It may also represent capabilities the party offers which are not requested. Examples include quality certifications (ISO-9000), CAD data compatibility (Pro/E), manufacturing operations (JIT), company size, and performance ratings.
  8. Skill [0..*]    Provides the information on the skills of the associated component.
  Status [0..1]    This is a code or identifier that describes the current work status of an employee. It indicates the condition of the employment of the employee. Also known as the employee category. Examples are: Active, Inactive, No longer employed, Part time, Full time, Temporary, Casual
  Classification [0..*]    This identifies the classification of an entity. An entity may be classified into mulitple groups for different reasons. Examples of Classification include Commodity Codes, Freight Classifications, Product Line classifications and so on. Suggested Values are COMMODITY, FREIGHT, PRODUCTLINE
  1. EffectiveTimePeriod [0..*]    Indicates the time in which the person works for the company. Typically the Start date is date in which the persons employment is effective and the Finish date is the the date in which the employee is terminated.
  2. PasswordEncrypted [0..1]    This is the confidential code entered by an employee to obtain access to a secured resource. An example of the use could be the code entered when entering their time worked on the manufacturing shop floor
  3. HROrganizationIDs [0..1]    This is the organization level that personnel are assigned
  4. Facility [0..1]    A Facility identifies a location within an entity. The facility may have sub-locators identified using a sequenced identification notation e.g. Warehouse A100 Sub-Location 11, Row R10 would be represented as an array of three Facility elements with values as A100, 11, R10, name attribute as Warehouse, Sub-Location and Row and sequence attribute as 1,2 and 3 respectively.
  5. GLEntityID [0..1]    A G/L entity is the smallest organizational unit for which individual financial statements must be drawn up according to relevant commercial law. It is normally the primary balancing segment of the GL Account structure. Typically, this is the owning entity for the transaction. Synonyms are Business Unit, Fund, G/L Company, Joint Venture, Non-Profit Association Name
  6. CostCenterID [0..1]    This is an accumulator of cost information that may be an organizational unit or area of responsibility. It is an organization code that allows a grouping of expenses and costs. SYNONYMS are Stocking Location, Work Group
  7. WorkCenterID [0..1]    This identifies an area consisting of one or more resources where production takes place. It is used to identify a specific Work Center on a Shop Floor or other manufacturing facility
  8. JobRestrictionCodes [0..1]    This indicates any limitations to complete a job assignment based on physical, mental, legal or any other conditions
  9. ScheduleType [0..1]    ScheduleType is a code or identifier that describes the specific schedule and can be used in a variety of contexts. When used in the context of employee, ScheduleType refers to the specific schedule for the employee or worker. When used in the context of a Schedule, ScheduleType indicates whether the Schedule is a demand schedule from a customer or a supply schedule from a supplier. Valid values for this context are: “Demand”, “Supplier”
  10. WorkShiftID [0..1]    This is the Employee Shift Identifier. ShiftId describes the regular or standard authorized work time for the employee
  11. WageType [0..1]    This is a code or identifier that describes the specific type a wage an employee or worker is paid. Examples include: Exempt from Overtime, Non-Exempt from Overtime
  12. WageGroupCode [0..1]    This is used to classify an employee’s wage
  13. OvertimeEligibleIndicator [0..1]    This indicates if the associated person or work is eligible to work overtime
  14. ContractReference [0..1]    Is a reference to a contract
  15. UserArea [0..1]    Allows the user of OAGIS to extend the specification in order to provide additional information that is not captured in OAGIS.This is done by defining the additional information in XML Schema and referencing the new schema in the xml instance document through the use of namespaces. Once this is done the additional information defined there can be carried in the BOD XML instance document.The Open Applications Group will make best efforts to quickly consider all proposed submissions.The USERAREA is always the last element in all components, except where the component has been extended inline.

Attributes

None

Used in

• Type GetPersonnelDataAreaType (Element DataArea)
• Type NotifyPersonnelDataAreaType (Element DataArea)
• Type OAGIS9NounsType (Element OAGIS9Nouns)
• Type ShowPersonnelDataAreaType (Element DataArea)
• Type SyncPersonnelDataAreaType (Element DataArea)

Sample instance

<Personnel>
   <ID>normalizedString</ID>
   <Name>string</Name>
   <Description>string</Description>
   <GenderCode>Male</GenderCode>
   <MaritalStatusCode>Divorced</MaritalStatusCode>
   <BirthDateTime>2000-01-01</BirthDateTime>
   <DeathDateTime>2000-01-01</DeathDateTime>
   <AgeMeasure unitCode="normalizedString">1.0</AgeMeasure>
   <LanguageCode>normalizedString</LanguageCode>
   <NationalityCountryCode>normalizedString</NationalityCountryCode>
   <Address>
      <ID>normalizedString</ID>
      <FormatCode>normalizedString</FormatCode>
      <AttentionOfName>string</AttentionOfName>
      <CareOfName>string</CareOfName>
      <AddressLine>string</AddressLine>
      <CitySubDivisionName>string</CitySubDivisionName>
      <CityName>string</CityName>
      <CountrySubDivisionCode>normalizedString</CountrySubDivisionCode>
      <CountryCode>normalizedString</CountryCode>
      <PostalCode>normalizedString</PostalCode>
      <Status>
         <Code>normalizedString</Code>
         <Description>string</Description>
         <EffectiveDateTime>2000-01-01</EffectiveDateTime>
         <ReasonCode>normalizedString</ReasonCode>
         <Reason>string</Reason>
         <TimePeriod>...
         </TimePeriod>
         <UserArea>
            <!--any element-->
         </UserArea>
      </Status>
      <Preference>
         <Sequence>1</Sequence>
         <Indicator>true</Indicator>
         <EffectiveTimePeriod>...
         </EffectiveTimePeriod>
         <UserArea>
            <!--any element-->
         </UserArea>
      </Preference>
      <UserArea>
         <!--any element-->
      </UserArea>
   </Address>
   <Communication>
      <ChannelCode>normalizedString</ChannelCode>
      <UseCode>normalizedString</UseCode>
      <CountryDialing>string</CountryDialing>
      <AreaDialing>string</AreaDialing>
      <DialNumber>string</DialNumber>
      <Extension>string</Extension>
      <Access>string</Access>
      <Preference>
         <Sequence>1</Sequence>
         <Indicator>true</Indicator>
         <EffectiveTimePeriod>...
         </EffectiveTimePeriod>
         <UserArea>
            <!--any element-->
         </UserArea>
      </Preference>
      <UserArea>
         <!--any element-->
      </UserArea>
   </Communication>
   <JobTitle>string</JobTitle>
   <JobCode>normalizedString</JobCode>
   <Responsibility>string</Responsibility>
   <DepartmentID>normalizedString</DepartmentID>
   <CategoryCodes>
      <Code>normalizedString</Code>
   </CategoryCodes>
   <CategoryClassification>
      <Codes>
         <Code>normalizedString</Code>
      </Codes>
      <Description>string</Description>
      <Note>string</Note>
      <UserArea>
         <!--any element-->
      </UserArea>
   </CategoryClassification>
   <Qualification>
      <Code>normalizedString</Code>
      <QualificationDateTime>2000-01-01</QualificationDateTime>
      <Description>string</Description>
      <Note>string</Note>
      <EffectiveTimePeriod>
         <InclusiveIndicator>true</InclusiveIndicator>
         <StartDateTime>2000-01-01</StartDateTime>
         <Duration>P1Y2M3DT10H</Duration>
      </EffectiveTimePeriod>
      <UserArea>
         <!--any element-->
      </UserArea>
   </Qualification>
   <Skill>
      <Code>normalizedString</Code>
      <Name>string</Name>
      <CompetencyCode>normalizedString</CompetencyCode>
      <LastUsedDateTime>2000-01-01</LastUsedDateTime>
      <TrainingDateTime>2000-01-01</TrainingDateTime>
      <EffectiveTimePeriod>
         <InclusiveIndicator>true</InclusiveIndicator>
         <StartDateTime>2000-01-01</StartDateTime>
         <Duration>P1Y2M3DT10H</Duration>
      </EffectiveTimePeriod>
      <UserArea>
         <!--any element-->
      </UserArea>
   </Skill>
   <Status>
      <Code>normalizedString</Code>
      <Description>string</Description>
      <EffectiveDateTime>2000-01-01</EffectiveDateTime>
      <ReasonCode>normalizedString</ReasonCode>
      <Reason>string</Reason>
      <TimePeriod>
         <InclusiveIndicator>true</InclusiveIndicator>
         <StartDateTime>2000-01-01</StartDateTime>
         <Duration>P1Y2M3DT10H</Duration>
      </TimePeriod>
      <UserArea>
         <!--any element-->
      </UserArea>
   </Status>
   <Classification>
      <Codes>
         <Code>normalizedString</Code>
      </Codes>
      <Description>string</Description>
      <Note>string</Note>
      <UserArea>
         <!--any element-->
      </UserArea>
   </Classification>
   <EffectiveTimePeriod>
      <InclusiveIndicator>true</InclusiveIndicator>
      <StartDateTime>2000-01-01</StartDateTime>
      <Duration>P1Y2M3DT10H</Duration>
   </EffectiveTimePeriod>
   <PasswordEncrypted mimeCode="normalizedString">GpM7</PasswordEncrypted>
   <HROrganizationIDs>
      <ID>normalizedString</ID>
   </HROrganizationIDs>
   <Facility>
      <IDs>
         <ID>normalizedString</ID>
      </IDs>
      <Name>string</Name>
      <Description>string</Description>
      <Note>string</Note>
      <Address>
         <ID>normalizedString</ID>
         <FormatCode>normalizedString</FormatCode>
         <AttentionOfName>string</AttentionOfName>
         <CareOfName>string</CareOfName>
         <AddressLine>string</AddressLine>
         <CitySubDivisionName>string</CitySubDivisionName>
         <CityName>string</CityName>
         <CountrySubDivisionCode>normalizedString</CountrySubDivisionCode>
         <CountryCode>normalizedString</CountryCode>
         <PostalCode>normalizedString</PostalCode>
         <Status>...
         </Status>
         <Preference>...
         </Preference>
         <UserArea>
            <!--any element-->
         </UserArea>
      </Address>
      <Coordinate>
         <Latitude>...
         </Latitude>
         <Longitude>...
         </Longitude>
         <AltitudeMeasure unitCode="normalizedString">1.0</AltitudeMeasure>
         <UserArea>
            <!--any element-->
         </UserArea>
      </Coordinate>
      <UserArea>
         <!--any element-->
      </UserArea>
   </Facility>
   <GLEntityID>normalizedString</GLEntityID>
   <CostCenterID>normalizedString</CostCenterID>
   <WorkCenterID>normalizedString</WorkCenterID>
   <JobRestrictionCodes>
      <Code>normalizedString</Code>
   </JobRestrictionCodes>
   <ScheduleType>normalizedString</ScheduleType>
   <WorkShiftID>normalizedString</WorkShiftID>
   <WageType>normalizedString</WageType>
   <WageGroupCode>normalizedString</WageGroupCode>
   <OvertimeEligibleIndicator>true</OvertimeEligibleIndicator>
   <ContractReference>
      <DocumentID>
         <ID>normalizedString</ID>
         <RevisionID>normalizedString</RevisionID>
         <VariationID>normalizedString</VariationID>
      </DocumentID>
      <AlternateDocumentID>
         <ID>normalizedString</ID>
         <RevisionID>normalizedString</RevisionID>
         <VariationID>normalizedString</VariationID>
      </AlternateDocumentID>
      <DocumentDateTime>2000-01-01</DocumentDateTime>
      <Description>string</Description>
      <Note>string</Note>
      <StatusCode>normalizedString</StatusCode>
      <Status>
         <Code>normalizedString</Code>
         <Description>string</Description>
         <EffectiveDateTime>2000-01-01</EffectiveDateTime>
         <ReasonCode>normalizedString</ReasonCode>
         <Reason>string</Reason>
         <TimePeriod>...
         </TimePeriod>
         <UserArea>
            <!--any element-->
         </UserArea>
      </Status>
      <ReleaseNumber>normalizedString</ReleaseNumber>
      <LineNumber>normalizedString</LineNumber>
      <ScheduleLineNumber>normalizedString</ScheduleLineNumber>
      <SubLineNumber>normalizedString</SubLineNumber>
      <UserArea>
         <!--any element-->
      </UserArea>
   </ContractReference>
   <UserArea>
      <!--any element-->
   </UserArea>
</Personnel>