Guidelines for Loading Calculation Cards

Use HCM Data Loader for bulk-loading and maintaining payroll data.

You can navigate to the HCM Data Loader pages directly from the Payroll Checklist page. On the Checklist page, select the Initiate Data Loader task to open the HCM Data Loader object status page.

Use the HCM Data Loader to load these payroll objects:

  • Calculation Cards

For more info on how to load these business objects, refer the Integrating with HCM guide.

Creating the Files

  1. Run the SQL statements Insert.sql statement, which generates the output that has the METADATA required for the HDL file along with the MERGE statements for each assignment for whom the new card 'Statutory Deductions' needs to be added. New card needs to be added for these assignments.

    Sample:

    METADATA|CalculationCard|EffectiveStartDate|CardSequence|AssignmentNumber|DirCardDefinitionName|LegislativeDataGroupName
    METADATA|CardComponent|EffectiveStartDate|CardSequence|ComponentSequence|AssignmentNumber|DirCardDefinitionName|LegislativeDataGroupName|DirCardCompDefName|ParentComponentSequence|ParentDirCardCompDefName
    METADATA|ComponentDetail|EffectiveStartDate|CardSequence|ComponentSequence|DirInformationCategory|LegislativeDataGroupName|AssignmentNumber|DirCardDefinitionName|DirCardCompDefName|FLEX:Deduction Developer DF|taxRegime(Deduction Developer DF=HRX_IN_DIR_INCOME_TAX)
     MERGE|CalculationCard|1990/01/01|1|E955160008175673|Statutory Deductions|ZHRX_IN_Vision_LDG_Two
     MERGE|CardComponent|1990/01/01|1|1|E955160008175673|Statutory Deductions|ZHRX_IN_Vision_LDG_Two|Income Tax||
     MERGE|CardComponent|1990/01/01|1|1|E955160008175673|Statutory Deductions|ZHRX_IN_Vision_LDG_Two|Aggregation Information||
    MERGE|ComponentDetail|1990/01/01|1|1|HRX_IN_DIR_INCOME_TAX|ZHRX_IN_Vision_LDG_Two|E955160008175673|Statutory Deductions|Income Tax|HRX_IN_DIR_INCOME_TAX|Y
  2. For each assignment number picked up by the query, there are 4 rows as shown.

  3. Create a file CalculationCard.dat and copy the contents generated from step 1 into the file and save. Compress (zip) the file using a file name of your choice (example: CalculationCard_Insert.zip).

  4. Execute the SQL statement provided in the sql file Delete.sql. This gives the list of records that needs to be deleted. If there are more than one card attached to a single assignment, then there will be two rows with different CardSequence (example: 1,2)

    Sample:

    METADATA|CalculationCard|EffectiveStartDate|CardSequence|AssignmentNumber|DirCardDefinitionName|LegislativeDataGroupName
     DELETE|CalculationCard|1990/01/01|1|E955160008175673|Deduction Information|ZHRX_IN_Vision_LDG_Two
    
  5. Create a file CalculationCard.dat and copy the contents generated from step 4 and compress the file using a suitable file name (example: CalculationCard_Delete.zip)

    For each assignment number there are four rows in the output.

Importing and Loading the Files

  1. From the home page, click My Client Groups > Data Exchange.

  2. On the Data Exchange page, click Import and Load Data.

  3. Click Import File on the page header.

  4. In the File Explorer, drag the .zip file created in step 5 of Creating the Files task (CalculationCard_Delete.zip) to add the file.

    Or, click Choose File to search and select your file.

    Note: You need to load the CalculationCard_Delete.zip before loading CalculationCard_Insert.zip
  5. Click Submit.

  6. Click OK on the confirmation page.

  7. When the import and load process is complete, the old card Deduction Information needs to be deleted from the list of assignment number in the file.

  8. Repeat the same set of steps to load the file created in Step 3 of Creating the Files. Example: CalculationCard_Insert.zip

  9. When the import and load process is complete, the new card Statutory Deductions needs to be created for the list of assignment number in the file.

  10. Validate that the new card Statutory Deductions is created for the employee.

  11. Query for the employee using the Person Management screen.

  12. Navigate to Payroll > Calculation Cards.

    The calculation card displays as Statutory Deductions with the description Statutory deduction information for India.