Absence Diagnostic Auto Correct Doc
Absence Diagnostic Auto Correct Doc
Absence Diagnostic Auto Correct Doc
Introduction ............................................................................................................... 3
FAQs for Diagnostic Tests ........................................................................................ 3
What corruption does this diagnostics test deal with? ......................................... 3
What are the input parameters required for this diagnostics test? ...................... 3
What is the output of this diagnostic tests? ......................................................... 4
Does running this diagnostics test lead to any change of data? ......................... 4
How to check whether the corruptions are corrected after this test was run? ..... 4
What is the name of the backup table? ............................................................... 4
How to identify the records updated by the diagnostic test? ............................... 4
Roles required for executing the Diagnostic Tests .................................................... 5
Absences Diagnostic tests framework ...................................................................... 6
Test Name: Master Report – Absence Data Integrity Detection .......................... 6
Test Name: Absences - Delete Absences of Canceled Work Relationship......... 9
Test Name: Absences - Update Absence – Period_Of_Service_Id .................. 11
Test Name: Absences - Delete Orphan Time Card Entries............................... 13
Test Name: Absences - Delete Processing Data of Withdrawn Absences........ 15
Test Name: Absences - Update Assignment number for Work Schedule ......... 17
Test Name: Absences - Delete orphan ADJOTH/INIT entries .......................... 18
Test Name: Absences - Delete orphan COVREX entries ................................. 20
Test Name: Absences - Update Formula_id in Entitlement Band ..................... 22
Test Name: Absences - Delete Orphan FORFT entries .................................... 23
Test Name: Absences - Update Enrollments for Termination ........................... 25
Test Name: Absences - Delete Enrollments of Canceled work relationship...... 27
Test Name: Absences - Delete Calculation card entries - Absences ................ 29
Test Name: Absences - Delete Calculation card entries – Accruals ................. 31
Test Name: Absences – Withdraw/Unprocess absence ................................... 33
Test Name: Absences - Delete enrollments with end date prior to start date.... 35
Test Name: Absences - Delete Absences for end dated type ........................... 37
Running the diagnostic tests ................................................................................... 39
Sample Test Case Execution in different modes .................................................... 49
Validate Mode Execution: ................................................................................. 49
Commit Mode Execution: .................................................................................. 51
The “Absences Diagnostic Auto Correct” diagnostic test can be used to view and resolve absences-
related data corruptions, for which no decision-related input is needed.
What are the input parameters required for this diagnostics test?
The input parameters would be different for different diagnostic test executions. All the generic
input parameters used for these tests execution along with their description are as follows:
1. Person number or person numbers: This parameter specifies the person number or
person numbers for which the diagnostic test is run to detect any data related corruptions.
The user can enter a single person number (for example: 123), a comma-separated list of
person numbers (for example: 123,456,789) or keep the parameter blank. If left blank, the
diagnostic test will be run for the entire population.
2. Run mode: The two options for this parameter are “Validate” and “Commit”. If the
diagnostic test is run in Validate mode, the changes made by the diagnostic test will be
rolled back at the end instead of being committed to the database. If the diagnostic test is
run in Commit mode, the changes made by the diagnostic test will be committed to the
database.
3. Business Unit (BU): This parameter specifies a Business unit within the organization,
where a person or group of persons is an employee. It is required to be selected from the
group of values in dropdown.
4. Legislative Data Unit (LDG): An LDG is a boundary that can share the same setup and
still comply with the local laws. Based on the specific person, group of persons or
organization location or legislative code, it is required to be selected from the group of
values in dropdown box.
5. Legal Employer (LE): This parameter specifies the Legal Employer name, for which the
test is to be executed. It is required to be selected from the group of values in dropdown.
6. Plan Id: It is the unique id, associated to the Absence plan, so that the test would be
executed specific to that entered plan only.
7. Per Plan Enrollment Id: It is unique id, associated with the enrollment for any specific
plan within a period, so that the test would be executed specific to that plan enrollment
only.
8. Person Absence Entry Id: It is unique id, associated to the applied absence for a person.
This diagnostic test will generate a list of the known data corruptions based on the parameters
provided by the user.
If the diagnostic test is run in validate mode, the test will indicate a rollback at the end. However,
if the test is run in commit mode, the test will indicate that the changes are committed.
Yes, running this diagnostic test will cause data changes in the tables where the corruption is
present.
Any data that is changed because of this diagnostic test will first be saved in the appropriate
backup tables. This is to make sure that the original data is not lost.
The user can first try running the diagnostic test in Validate mode to verify the data changes and
make sure the changes were as per expectations (this can be verified from the messages
generated by the diagnostic test).
After verifying that the data changes were the intended modifications, the user can run the
diagnostic test in Commit mode with the other input parameters unchanged. The user can also
choose to run the diagnostic test in Commit mode directly, but recommended to verify first using
Validate mode.
How to check whether the corruptions are corrected after this test was
run?
Firstly, the user must check the messages generated by the diagnostic test to confirm whether
the changes have been successfully completed.
The user can then run this same diagnostic test in Validate mode for the person or persons for
whom the changes were made. The updated messages will indicate if the data was successfully
corrected in the previous run.
PER_DIAG_BKP_ROWS is the table used to store the backup data for all rows corrected via
diagnostic test. Backup data are stored in CLOB type with XML format only when diagnostic test
is executed in Commit Mode.
Diagnostic Test will update the LAST_UPDATED_BY column with 'DI:'||execution_id (For
Example DI:8CC1CC42DE2A4224E05333D6F00AEF17 ) and LAST_UPDATE_DATE with run
timestamp of the diagnostic test.
There are certain roles required for executing these diagnostic tests. Following are the
details for the same:
Kindly login with the admin user, who has the default access to Security
Console.
Go to Security Console and navigate to the User Accounts tab.
Search for the user, for whom the application diagnostics administrator role
is required.
Edit the same user details and click on the Add Role button on UI.
Search for the ‘application diagnostics administrator’ role and provide the
same role membership to the same user and save the user accounts detail.
The user would now have the required role and can able to perform the
diagnostics tests.
What are the functional error scenarios for running this diagnostic test?
This diagnostic test would be required to be executed when any of following scenarios occur:
1. This test is majorly executed to check the corruption in the system, either for all the tests
or a specific test.
What are the input parameters required for this diagnostic test?
Parameters:
Parameter Expected Value Mandatory
Business Unit One of the business unit from list of No
(BU) values provided.
Legislative Data One of the LDG from list of values No
Group (LDG) provided.
Legal Employer One of the LE from list of values No
(LE) provided.
Person Number Null (for whole population) No
Single Person number
Multiple (comma separated)
Test Code One of the predefined Test codes. No, if person number is not null,
(Currently the execution of test for Yes, if person number is null
the entire population is not allowed,
hence test code is mandatory when
person id is null)
3. Input is only test code and one of the filters (LDG, LE, BU).
The report contains all the information needed to take the next step in resolving the corruptions.
The person numbers for whom the corruptions will be identified depends on the input parameter
"Person Number".
How to check whether the corruption handled by this diagnostic test has been corrected
after it has run?
First, the user should check the messages generated by the diagnostic test to confirm whether
the changes have been successfully completed or not.
This test is ideally used to verify all the tests and verify whether the corruption is successfully
removed or not.
What are the functional error scenarios for running this diagnostic test?
This diagnostic test would be required to be executed when any of following scenarios occur:
1 Consider a case in which an employee tries to record an absence. While selecting the
type value, duplicate absence types are displayed. This happens due to the orphan period
of service id. This test would delete those absences having corrupted values.
What are the input parameters required for this diagnostic test?
Parameters:
Parameter Expected Value Mandatory
Business Unit One of the business unit from list of values No
(BU) provided.
Legislative Data One of the LDG from list of values provided. No
Group (LDG)
Legal Employer One of the LE from list of values provided. No
(LE)
Person Number Null (for whole population) No
Single Person number
Multiple (comma separated)
Mode Validate or Commit No
Default: Validate
Validate: Corrects the data without
committing it to the database.
Commit: Corrects the data and commits the
data to the database.
How to check whether the corruption handled by this diagnostic test has been corrected
after it has run?
First, the user should check the messages generated by the diagnostic test to confirm whether
the changes have been successfully completed or not.
What are the functional error scenarios for running this diagnostic test?
This diagnostic test would be required to be executed when any of following scenarios occur:
1 Consider a case in which an employee tries to record an absence. While selecting the
type value, we can able to see duplicate values, which happened due to the orphan
period of service id. This test would update the correct period of service id where the
corruptions are present.
What are the input parameters required for this diagnostic test?
Parameters:
Parameter Expected Value Mandatory
Business Unit One of the business unit from list of values No
(BU) provided.
Legislative Data One of the LDG from list of values provided. No
Group (LDG)
Legal Employer One of the LE from list of values provided. No
(LE)
Person Number Null (for whole population) No
Single Person number
Multiple (comma separated)
Mode Validate or Commit No
Default: Validate
Validate: Corrects the data without
committing it to the database.
Commit: Corrects the data and commits the
data to the database.
What are the functional error scenarios for running this diagnostic test?
This diagnostic test would be required to be executed when any of following scenarios occur:
1 Consider a case in which you try to submit a new time card entry. When we try to submit
a time card entry and receive an error “Absence record does not exist” on UI, it
specifically means that some absence in that period does not contain proper mapping,
and hence consider orphan absence entries.
What are the input parameters required for this diagnostic test?
Parameters:
Parameter Expected Value Mandatory
Business Unit One of the business unit from list of values No
(BU) provided.
Legislative Data One of the LDG from list of values provided. No
Group (LDG)
Legal Employer One of the LE from list of values provided. No
(LE)
Person Number Null (for whole population) No
Single Person number
Multiple (comma separated)
Mode Validate or Commit No
Default: Validate
Validate: Corrects the data without
committing it to the database.
Commit: Corrects the data and commits the
data to the database.
How to check whether the corruption handled by this diagnostic test has been corrected
after it has run?
First, the user should check the messages generated by the diagnostic test to confirm whether
the changes have been successfully completed or not.
The user can then run the diagnostic test Master Report – Absence Data Integrity Detection for
the person number(s) or parameters (BU/LE/LDG) with test code as ‘Absences - Delete Orphan
Time Card Entries’ for whom the changes were made.
If the changes were made successfully, the reported corruptions would be removed.
What are the functional error scenarios for running this diagnostic test?
This diagnostic test would be required to be executed when any of following scenarios occur:
1. Consider certain absences which are already in withdrawn status. Upon checking the
accrual balance in plan participation, it is seen that the accrual balance is also deducted
for those withdrawn absences which should ideally not be deducted. It means that the
accrual processing data is not deleted for those absences, although the absence is
withdrawn and deleted.
What are the input parameters required for this diagnostic test?
Parameters:
Parameter Expected Value Mandatory
Business Unit One of the business unit from list of values No
(BU) provided.
Legislative Data One of the LDG from list of values provided. No
Group (LDG)
Legal Employer One of the LE from list of values provided. No
(LE)
Person Number Null (for whole population) No
Single Person number
Multiple (comma separated)
Mode Validate or Commit No
Default: Validate
Validate: Corrects the data without
committing it to the database.
Commit: Corrects the data and commits the
data to the database.
What are the functional error scenarios for running this diagnostic test?
This diagnostic test would be required to be executed when any of following scenarios occur:
1. Consider a work schedule is not assigned to any user, but still we are not able to change
the work schedule setup, where it should be editable ideally.
What are the input parameters required for this diagnostic test?
Parameters:
Parameter Expected Value Mandatory
Mode Validate or Commit No
Default: Validate
Validate: Corrects the data without
committing it to the database.
Commit: Corrects the data and commits the
data to the database.
What are the functional error scenarios for running this diagnostic test?
This diagnostic test would be required to be executed when any of following scenarios occur:
1. Consider a person accrual balance is different than the intended balance, even after a
‘Other Adjustment’ or ‘INIT’ balance is provided to the same person.
What are the input parameters required for this diagnostic test?
Parameters:
Parameter Expected Value Mandatory
Business Unit One of the business unit from list of values No
(BU) provided.
Legislative Data One of the LDG from list of values provided. No
Group (LDG)
Legal Employer One of the LE from list of values provided. No
(LE)
Person Number Null (for whole population) No
Single Person number
Multiple (comma separated)
Mode Validate or Commit No
Default: Validate
Validate: Corrects the data without
committing it to the database.
Commit: Corrects the data and commits the
data to the database.
What are the functional error scenarios for running this diagnostic test?
This diagnostic test would be required to be executed when any of following scenarios occur:
1 Consider a person accrual balance is different than the intended balance, even after a
‘Carryover Expiration’ balance is provided to the same person.
What are the input parameters required for this diagnostic test?
Parameters:
Parameter Expected Value Mandatory
Business Unit One of the business unit from list of values No
(BU) provided.
Legislative Data One of the LDG from list of values provided. No
Group (LDG)
Legal Employer One of the LE from list of values provided. No
(LE)
Person Number Null (for whole population) No
Single Person number
Multiple (comma separated)
Plan Id Plan id for filtering the correction records No
Per Plan Per Plan enrollment id for filtering the No
enrollment Id correction records
Mode Validate or Commit No
Default: Validate
Validate: Corrects the data without
committing it to the database.
Commit: Corrects the data and commits the
data to the database.
Commit Mode:
It would delete those “Carryover Expiration” entries that do not have reference to any
carryover entries. Here, the changes would be indicated, and committed to the database at the
end of the test execution.
What are the functional error scenarios for running this diagnostic test?
This diagnostic test would be required to be executed when any of following scenarios occur:
1 Consider a case in which a person tries to record an absence of the qualification type,
and receive an error corresponding to the formula_id having 0 values. It means that the
formula_id is incorrect and needs to be updated with the correct value to resolve the
corruption.
What are the input parameters required for this diagnostic test?
Parameters:
Parameter Expected Value Mandatory
Mode Validate or Commit No
Default: Validate
Validate: Corrects the data without
committing it to the database.
Commit: Corrects the data and commits the
data to the database.
Commit Mode:
It would update the entries having Band detail row from ANC_ENTL_BANDS_DTL_F
with ENTL_DTL_OUTPUT_FORMULA_ID as 0. Here, the changes would be indicated, and
committed to the database at the end of the test execution.
What are the functional error scenarios for running this diagnostic test?
This diagnostic test would be required to be executed when any of following scenarios occur:
1. Consider a person accrual balance is different than the intended balance, even after a
‘Forfeiture’ balance is provided to the same person.
2. This test will delete orphan ORA_ANC_FORFT_REST entries also.
What are the input parameters required for this diagnostic test?
Parameters:
Parameter Expected Value Mandatory
Business Unit One of the business unit from list of values No
(BU) provided.
Legislative Data One of the LDG from list of values provided. No
Group (LDG)
Legal Employer One of the LE from list of values provided. No
(LE)
Person Number Null (for whole population) No
Single Person number
Multiple (comma separated)
Plan Id Plan id for filtering the correction records No
Mode Validate or Commit No
Default: Validate
Validate: Corrects the data without
committing it to the database.
Commit: Corrects the data and commits the
data to the database.
What are the functional error scenarios for running this diagnostic test?
This diagnostic test would be required to be executed when any of following scenarios occur:
1. Consider a person is terminated, and the enrollment assigned to that person is still
active, which means the enrollment is not end dated. This would mean that the
enrollment is corrupted, as it needs to be end dated upon the termination of person.
What are the input parameters required for this diagnostic test?
Parameters:
Parameter Expected Value Mandatory
Business Unit One of the business unit from list of values No
(BU) provided.
Legislative Data One of the LDG from list of values provided. No
Group (LDG)
Legal Employer One of the LE from list of values provided. No
(LE)
Person Number Null (for whole population) No
Single Person number
Multiple (comma separated)
Plan Id Plan id for filtering the correction records No
Mode Validate or Commit No
Default: Validate
Validate: Corrects the data without
committing it to the database.
Commit: Corrects the data and commits the
data to the database.
What are the functional error scenarios for running this diagnostic test?
This diagnostic test would be required to be executed when any of following scenarios occur:
1 Consider a case in which an admin tries to add or update enrollment for a specific or
group of persons. While selecting the enrollment, they can able to see duplicate values,
which happened due to the orphan period of service id. This test would delete those
enrollments where such corruption is present.
What are the input parameters required for this diagnostic test?
Parameters:
Parameter Expected Value Mandatory
Business Unit One of the business unit from list of values No
(BU) provided.
Legislative Data One of the LDG from list of values provided. No
Group (LDG)
Legal Employer One of the LE from list of values provided. No
(LE)
Person Number Null (for whole population) No
Single Person number
Multiple (comma separated)
Plan Id Plan id for filtering the correction records No
Mode Validate or Commit No
Default: Validate
Validate: Corrects the data without
committing it to the database.
Commit: Corrects the data and commits the
data to the database.
What are the functional error scenarios for running this diagnostic test?
This diagnostic test would be required to be executed when any of following scenarios occur:
1. Consider an absence is withdrawn or deleted from the system for a specific person.
Upon checking the payroll calculation card for the same person, it is seen that the
balance is deducted for the same absence, as ideally it should not be deducted.
What are the input parameters required for this diagnostic test?
Parameters:
Parameter Expected Value Mandatory
Business Unit One of the business unit from list of values No
(BU) provided.
Legislative Data One of the LDG from list of values provided. No
Group (LDG)
Legal Employer One of the LE from list of values provided. No
(LE)
Person Number Null (for whole population) No
Single Person number
Multiple (comma separated)
Mode Validate or Commit No
Default: Validate
Validate: Corrects the data without
committing it to the database.
Commit: Corrects the data and commits the
data to the database.
What are the functional error scenarios for running this diagnostic test?
This diagnostic test would be required to be executed when any of following scenarios occur:
1. Consider some accruals are removed for a specific person. Upon checking the payroll
calculation card for the same person, it is seen that the balance is deducted for the same
accruals, as ideally it should not be deducted.
What are the input parameters required for this diagnostic test?
Parameters:
Parameter Expected Value Mandatory
Business Unit One of the business unit from list of values No
(BU) provided.
Legislative Data One of the LDG from list of values provided. No
Group (LDG)
Legal Employer One of the LE from list of values provided. No
(LE)
Person Number Null (for whole population) No
Single Person number
Multiple (comma separated)
Mode Validate or Commit No
Default: Validate
Validate: Corrects the data without
committing it to the database.
Commit: Corrects the data and commits the
data to the database.
What are the functional error scenarios for running this diagnostic test?
This diagnostic test would be required to be executed when any of following scenarios occur:
1. Consider a case in which an absence is not able to withdraw from UI. It means that the
absence data is corrupted, so those absences can be withdrawn using this diagnostic
test.
What are the input parameters required for this diagnostic test?
Parameters:
Parameter Expected Value Mandatory
Person Absence The unique absence entry id, corresponding Yes
Entry ID to each applied absence. You can either
enter a single value or comma separated
multiple values.
Absence Mode Withdraw or Un process. No
Default: Un process
Un process: It would remove only the accrual
data from absence but does not withdraw it
completely.
Withdraw: It would withdraw the absences
completely.
Mode Validate or Commit No
Default: Validate
Validate: Corrects the data without
committing it to the database.
Commit: Corrects the data and commits the
data to the database.
What are the functional error scenarios for running this diagnostic test?
This diagnostic test would be required to be executed when any of following scenarios occur:
1. Consider a case in which a person is running the accrual for a specific plan enrollment,
and receive an error corresponding to the over lapping or inactive plan enrollments, it
means that certain enrollments are corrupted, and might be having a case in which the
end date is prior to its start date.
What are the input parameters required for this diagnostic test?
Parameters:
Parameter Expected Value Mandatory
Business Unit One of the business unit from list of values No
(BU) provided.
Legislative Data One of the LDG from list of values provided. No
Group (LDG)
Legal Employer One of the LE from list of values provided. No
(LE)
Person Number Null (for whole population) No
Single Person number
Multiple (comma separated)
Mode Validate or Commit No
Default: Validate
Validate: Corrects the data without
committing it to the database.
Commit: Corrects the data and commits the
data to the database.
Delete Mode TXN or ABS_TXN No
Default: TXN
TXN: Corrects the corrupted enrollments by
only deleting the accrual related data.
ABS_TXN: Corrects the corrupted
enrollments by deleting both the accrual and
absence related data.
What are the functional error scenarios for running this diagnostic test?
This diagnostic test would be required to be executed when any of following scenarios occur:
1 Consider a case in which an absence type is end dated to a specific date, and some
absences are already recorded with the future date in the same type. Now, those
absences would be considered as orphan, as the corresponding type is not active. It is
required to delete those orphan absences, to maintain consistency in the system.
What are the input parameters required for this diagnostic test?
Parameters:
Parameter Expected Value Mandatory
Business Unit One of the business unit from list of values No
(BU) provided.
Legislative Data One of the LDG from list of values provided. No
Group (LDG)
Legal Employer One of the LE from list of values provided. No
(LE)
Person Number Null (for whole population) No
Single Person number
Multiple (comma separated)
Mode Validate or Commit No
Default: Validate
Validate: Corrects the data without
committing it to the database.
Commit: Corrects the data and commits the
data to the database.
Following are the steps with screen shots to followed for executing the diagnostic tests in any of
the environment.
1 Click the user name in the global header region, and then click Run Diagnostics Tests from
the Settings and Actions menu.
3. Search for the Master Report – Absence Data Integrity Detection test in the Search
for Tests section. From the search result, select the check box and click Add to Run.
This will add the test to the Choose Tests to Run and Supply Inputs section on the right
panel.
6. Initially, the Diagnostic Test Run Status would be running, which specifies that the test is
currently executing.
8. Click the icon under the Report column in the Diagnostic Test Run Status table. A page is
displayed that contains the meta details on the test that was run
10. Just for fast output, you can skip the meta details of the test that was run and directly
access the actual diagnostic test output. To do this, expand the test you ran in the
Diagnostic Test Run Status table. Then, click the icon under the Report column of the
actual diagnostic test itself.
12. We are running this test with the same parameter, as described in the master test report,
to get the same result. We are first running the same in Validate mode, to check the
corruption.
14. Now, we would execute the same test in the Commit mode, to correct the corruptions, by
keeping all other parameters same as before.
17. It would now show that there are no corruption present for the same input in the same
test case, as done before.
Based on this report, it can be successfully verified that the corruptions are removed for the
same test case. This test can also be executed for other scenarios and test, whenever required
following the same step by step approach.
1. Search for the Absences - Update Absence - Period_Of_Service_Id in the Search for
Tests section. From the search result, select the check box and click Add to Run. This
will add the test to the Choose Tests to Run and Supply Inputs section on the right
panel.
3. Checking the test case execution completion for the above ran diagnostic test.
1. Search for the Absences - Update Absence - Period_Of_Service_Id in the Search for
Tests section. From the search result, select the check box and click Add to Run. This
will add the test to the Choose Tests to Run and Supply Inputs section on the right
panel.
3. After the execution of the test case, in the report generated, the corrupted data rows
would be corrected and the corruption would be commited to the database, as the
execution is done in the Validate and Commit mode.