HR Data Load [Self-Hosting Customers]

PROPRIETARY


Enterprise Human Resource (HR) systems store and maintain critical information about personnel working for the organization. These systems are updated daily as people join, change positions, leave, return, etc., resulting in a very large number of key data elements that must be accurately collected and tracked. The way data is stored in an enterprises HR system depends largely on both the system being used and the way it’s been configured.


Table of Contents


Options

Common Features Across Both Options

Regardless of which option you choose, here are some key things to keep in mind:

Data Quality Rejection: Sometimes, a record might not be accepted because it doesn't meet the required standards. If this happens, the record will be rejected based on a Data Quality Rejection Rules listed below. You'll be able to see the reasons of why it was rejected.

Audit Trail: For every record, we keep a detailed audit trail. This means we track every change that happens - whether the record is created, updated, or approved.


Option 1 - Standard

This is the more straightforward process. Here’s how it works:

Extract and Process the Data: Our system will extract the data that you provided and process the changes.

Match by SSN: The system checks if the SSN of a record already exists in Access Commander.

If a match is found (meaning the SSN already exists in Access Commander), the record will simply update with the new/modified information provided.

If a match is not found (meaning the SSN does not exist in Access Commander), the record will be created in Access Commander.

 

Option 2 - Approval

This option adds an extra step to ensure greater control and approval over the changes. Here’s how it works:

Extract and Process the Data: Our system will extract the data that you provided and process the changes.

Match by SSN: Just like in Option 1, the system will check if the SSN already exists in Access Commander.

If no match is found a new record will be created.

If a match is found, the system will look at specific attributes listed below of record to see if there are changes.

Approval Process

If any of the attributes listed below have changed, the system will lock the record and require approval from an end user before the changes can be processed. This means someone needs to review the record and approve it for changes to happen.

Last Name

First Name

Middle Name

Suffix

Facility Code

Status

Employee Type

Employee Number

Gender

Citizenship

Date of Birth

If no changes are found in those attributes, the record will be updated automatically without needing approval.


What You Need to Know

Getting the Data Ready

⚠️ MathCraft will not be writing any code or logic for extracting the data from your HRIT system.

You will be responsible to source the data from your HRIT system and load it into the DB.HR_EMP_CSTMR_STG table in the Access Commander database.


Data Elements

Data Elements -- Column to Field Mapping


Attribute
Properties
Table Column HeaderDescriptive Name of the AttributeData
Type
Length

Comments

RequiredLAST_NMELast NameText40
RequiredFIRST_NMEFirst NameText40
 MIDDLE_NMEMiddle NameText40

SUFFIXSuffixText128Has an associated System Profile (Drop Down).
If Personnel has no Suffix, pass as an Empty String or NULL.

NICK_NMENicknameText40
RequiredFCLTY_CDFacility CodeText25Facility must exist in Facility Management module as a Host Facility
Required
Unique
SSNSocial Security NumberText11Must be formatted as ###-##-####
RequiredEMP_NMR_TXTEmployee NumberText15
RequiredEMP_TYP_DESCEmployee TypeText128Has an associated System Profile (Drop Down)
RequiredEMP_STS_DESCStatusText128Has an associated System Profile (Drop Down)
 WORK_PHONE_NMRWork PhoneNumeric20Only Numbers allowed
Required
Unique
WORK_EMAIL_TXTWork EmailText384

HIRE_DTHire DateDate
Must be formatted as YYYY-MM-DD

REHIRE_DTRehire DateDate
Must be formatted as YYYY-MM-DD

START_DTStart DateDate
Must be formatted as YYYY-MM-DD

TRMNTN_DTTermination DateDate
Must be formatted as YYYY-MM-DD

KEY_MGMT_PRSNL_FLGKey Management PersonnelBit
Expects 1 for True and 0 for False

SR_MGMT_OFFCL_FLGSenior Management OfficialBit
Expects 1 for True and 0 for False
Required
Unique
NTWRK_LOGIN_ID_TXTLogin IdText384This column helps define the username for any future User Accounts used by any of our products.
Customers with SSO configuration should have this match the UPN in the IdP.

GNDR_DESCGenderText1Expects M for Male, F for Female or U for Unknown
RequiredCTZNSHP_DESCCitizenship DescriptionText128Has an associated System Profile (Drop Down)

BIRTH_DTDate of BirthDateMust be formatted as YYYY-MM-DD

BIRTH_CNTRYCountry of BirthText128Has an associated System Profile (Drop Down)

BIRTH_CITYCity of BirthText60

BIRTH_ST_CDState of BirthText60

LCTN_TXTLocationText128

BSNS_UNIT_TXTBusiness UnitText128

ORG_NME_TXTOrganizationText128

DVSN_TXTDivisionText128

TITLE_TXTTitleText128

GRADE_TXTGradeText128

COST_CENTERCost CenterText25

HOME_ADDR1Home Address 1Text60

HOME_ADDR2Home Address 2Text30

HOME_CITYHome CityText20

HOME_STATE_CDHome StateText2Only US State Abbreviations Allowed

HOME_ZIP5Home ZipText5Only Numbers Allowed

PERSNL_EMAIL_TXTPersonal EmailText50

CELL_NMRCell Phone NumberText20

MGR_EMP_NMRManager Employee NumberText15For purposes of Portal Commander, this individual will be granted the Supervisor Role


Rules

Rejection Rules

Rule TypeCan Be DisabledRule Description
System DefinedNoDuplicate Social Security Number found in HR Data Source
System DefinedNoLast Name is Missing/Blank in HR Data Source
System DefinedNoFirst Name is Missing/Blank in HR Data Source
System DefinedNoNetwork Login Username is Missing/Blank in HR Data Source
System DefinedNoFacility Code is Missing/Blank in HR Data Source
System DefinedNoSocial Security Number is formatted incorrectly in HR Data Source
System DefinedNoUnable to find a match for Facility Code
System DefinedNoUnable to find a System Profile match for Suffix
System DefinedNoUnable to find a System Profile match for Employee Type
System DefinedNoUnable to find a System Profile match for Employee Status
CustomYesEmployee ID is Missing/Blank in HR Data Source
CustomYesDate of Birth is Missing/Blank in HR Data Source


Customer may request Custom Rejection Rules to be implemented.

Implementation of the request may result in additional time and material charges.

  1. Submit a Product Enhancement Ticket.

  2. Ensure you have described the Rejection Rule precisely.

    Please be advised that Rejection Rules is the very first thing that executes in the pipeline.


Post Processing Rules

Customer may request Custom Post Processing Rules to be implemented.

Implementation of the request may result in additional time and material charges.

  1. Submit a Product Enhancement Ticket.

  2. Ensure you have described the Post Processing Rule precisely.

    Please be advised that Post Processing Rule is the very last thing that executes in the pipeline and is applicable for attributes that don't need an approval.