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 Header | Descriptive Name of the Attribute | Data Type | Length | Comments |
Required | LAST_NME | Last Name | Text | 40 | |
Required | FIRST_NME | First Name | Text | 40 | |
MIDDLE_NME | Middle Name | Text | 40 | ||
SUFFIX | Suffix | Text | 128 | Has an associated System Profile (Drop Down). If Personnel has no Suffix, pass as an Empty String or NULL. | |
NICK_NME | Nickname | Text | 40 | ||
Required | FCLTY_CD | Facility Code | Text | 25 | Facility must exist in Facility Management module as a Host Facility |
Required Unique | SSN | Social Security Number | Text | 11 | Must be formatted as ###-##-#### |
Required | EMP_NMR_TXT | Employee Number | Text | 15 | |
Required | EMP_TYP_DESC | Employee Type | Text | 128 | Has an associated System Profile (Drop Down) |
Required | EMP_STS_DESC | Status | Text | 128 | Has an associated System Profile (Drop Down) |
WORK_PHONE_NMR | Work Phone | Numeric | 20 | Only Numbers allowed | |
Required Unique | WORK_EMAIL_TXT | Work Email | Text | 384 | |
HIRE_DT | Hire Date | Date | Must be formatted as YYYY-MM-DD | ||
REHIRE_DT | Rehire Date | Date | Must be formatted as YYYY-MM-DD | ||
START_DT | Start Date | Date | Must be formatted as YYYY-MM-DD | ||
TRMNTN_DT | Termination Date | Date | Must be formatted as YYYY-MM-DD | ||
KEY_MGMT_PRSNL_FLG | Key Management Personnel | Bit | Expects 1 for True and 0 for False | ||
SR_MGMT_OFFCL_FLG | Senior Management Official | Bit | Expects 1 for True and 0 for False | ||
Required Unique | NTWRK_LOGIN_ID_TXT | Login Id | Text | 384 | This 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_DESC | Gender | Text | 1 | Expects M for Male, F for Female or U for Unknown | |
Required | CTZNSHP_DESC | Citizenship Description | Text | 128 | Has an associated System Profile (Drop Down) |
BIRTH_DT | Date of Birth | Date | Must be formatted as YYYY-MM-DD | ||
BIRTH_CNTRY | Country of Birth | Text | 128 | Has an associated System Profile (Drop Down) | |
BIRTH_CITY | City of Birth | Text | 60 | ||
BIRTH_ST_CD | State of Birth | Text | 60 | ||
LCTN_TXT | Location | Text | 128 | ||
BSNS_UNIT_TXT | Business Unit | Text | 128 | ||
ORG_NME_TXT | Organization | Text | 128 | ||
DVSN_TXT | Division | Text | 128 | ||
TITLE_TXT | Title | Text | 128 | ||
GRADE_TXT | Grade | Text | 128 | ||
COST_CENTER | Cost Center | Text | 25 | ||
HOME_ADDR1 | Home Address 1 | Text | 60 | ||
HOME_ADDR2 | Home Address 2 | Text | 30 | ||
HOME_CITY | Home City | Text | 20 | ||
HOME_STATE_CD | Home State | Text | 2 | Only US State Abbreviations Allowed | |
HOME_ZIP5 | Home Zip | Text | 5 | Only Numbers Allowed | |
PERSNL_EMAIL_TXT | Personal Email | Text | 50 | ||
CELL_NMR | Cell Phone Number | Text | 20 | ||
MGR_EMP_NMR | Manager Employee Number | Text | 15 | For purposes of Portal Commander, this individual will be granted the Supervisor Role |
Rules
Rejection Rules
Rule Type | Can Be Disabled | Rule Description |
System Defined | No | Duplicate Social Security Number found in HR Data Source |
System Defined | No | Last Name is Missing/Blank in HR Data Source |
System Defined | No | First Name is Missing/Blank in HR Data Source |
System Defined | No | Network Login Username is Missing/Blank in HR Data Source |
System Defined | No | Facility Code is Missing/Blank in HR Data Source |
System Defined | No | Social Security Number is formatted incorrectly in HR Data Source |
System Defined | No | Unable to find a match for Facility Code |
System Defined | No | Unable to find a System Profile match for Suffix |
System Defined | No | Unable to find a System Profile match for Employee Type |
System Defined | No | Unable to find a System Profile match for Employee Status |
Custom | Yes | Employee ID is Missing/Blank in HR Data Source |
Custom | Yes | Date 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.
Submit a Product Enhancement Ticket.
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.
Submit a Product Enhancement Ticket.
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.