Testing

Payroll Testing

The following test methods exist for testing the payroll

Test method	Test scope	Payroll Console	JSON Extension
Case Available Test	Test for case availability	CaseTest	.ct.json
Case Build Test	Test for case build	CaseTest	.ct.json
Case Validate Test	Test for validating the case	CaseTest	.ct.json
Payrun Test	Test the company payroll run	PayrunTest	.pt.json
Payrun Employee Test	Test the employee payroll run	PayrunEmployeeTest	.et.json
Report Build Test	Test the report build	ReportTest	.rt.json
Report Execute Test	Test the report execution	ReportTest	.rt.json

Case Testing

The following case test shows the validation of the salary lower limit from the start example.

Example Case Validation Test Test.Salary.ct.json:

1{
2  "$schema": "PayrollEngine.CaseTest.schema.json",
3  "testName": "Test.Salary",
4  "tenantIdentifier": "StartTenant",
5  "userIdentifier": "lucy.smith@foo.com",
6  "employeeIdentifier": "mario.nuñez@foo.com",
7  "payrollName": "StartPayroll",
8  "validateTests": [
9    {
10      "testName": "Employee.Salary.499.Test",                        
11      "input": {
12        "userIdentifier": "lucy.smith@foo.com",
13        "employeeIdentifier": "mario.nuñez@foo.com",
14        "divisionName": "StartDivision",
15        "case": {
16          "caseName": "Salary",
17          "values": [
18            {
19              "caseFieldName": "Salary",
20              "value": "499",
21              "start": "2023-02-01T00:00:00.0Z",
22              "created": "2023-02-15T18:22:45.0Z"
23            }
24          ]
25        }
26      },
27      "output": {
28        "issues": [
29          {
30            "caseFieldName": "Salary",
31            "issueType" : "CaseInvalid",
32            "number": 400
33          }
34        ]
35      }
36    },
37    {
38      "testName": "Employee.Salary.500.Test",
39      "input": {
40        "userIdentifier": "lucy.smith@foo.com",
41        "employeeIdentifier": "mario.nuñez@foo.com",
42        "divisionName": "StartDivision",
43        "case": {
44          "caseName": "Salary",
45          "values": [
46            {
47              "caseFieldName": "Salary",
48              "value": "500",
49              "start": "2023-02-01T00:00:00.0Z",
50              "created": "2023-02-15T18:22:45.0Z"
51            }
52          ]
53        }
54      },
55      "output": {
56        "values": [
57          {
58            "caseFieldName": "Salary",
59            "value": "500",
60            "start": "2023-02-01T00:00:00.0Z",
61            "created": "2023-02-15T18:22:45.0Z"
62          }
63        ]
64      }
65    }
66  ]
67}

The steps for testing the case in detail:

• 2: Path to the JSON schema (adapt this to your local environment)
• 10: Name for invalid salary test
• 11-26: Invalid salary test input
• 15-25: Invalid salary test case
• 20: Invalid salary test case value 499
• 27-35: Invalid salary test output
• 31: Expected issue CaseInvalid
• 32: Expected HTTP error code 400
• 37-65: Valid salary test input
• 43-53: Valid salary test case
• 48: Valid salary test case value 500
• 55-64: Valid salary test output
• 59: Expected value 500

The command 5 Test.Salary.cmd runs the case test.

See also example Case Test.

Payrun Testing

The payrun test is available in two variants

• Tenant payrun test - tenant exists only during the test
• Employee payrun test - the test is performed on the copy of an employee.

Testing the payrun is described in the Basic payroll example and Advanced payroll example.

See also the Payrun tests.

Report Testing

In payroll reports, both report creation (report parameters) and report execution can be tested. The report tests can be defined by configuration (JSON) or by programming (C# with Client Services).

See also the Report Test