Payroll Control Center - Check Implementation Guide

Payroll Control Center Check implementation

Customer

Contents Introduction & Prerequisites Customizing Coding a Check

© 2014 SAP AG or an SAP affiliate company. All rights reserved.

Public

2

Introduction & Prerequisites

Prerequisites •

You have installed declustering on your system (notes 1774918 and 1846500 plus country-dependent note)

•

You have installed HR Renewal 2.0

•

The Payroll Control Center has been set up according to the implementation guide.

While this is no prerequisite for following this implementation guide it is recommended to have declustered payroll data available for testing purposes. You should listen to the recorded expert session (ca 2 hrs) before using this guide, as it assumes familiarity with the Payroll Control Center and the terminology used. This check implementation guide will take you through an implementation of a parameterized generic wage type check for the Payroll Control Center. This is not a full documentation on the IMG or customizing and we will not touch on the meaning of every field therein.

© 2014 SAP AG or an SAP affiliate company. All rights reserved.

Public

4

Customizing

Customizing 1 Set up parameter types First, go to the IMG "Payroll Data Source Framework“ and select the step “Create Data Source Types.” We will start by defining the parameters of the check. Some parameters are delivered by SAP and can be used. Select „Define Result Detail Types/Parameter Types.“ There are three additional parameters we need: •

A lower limit (amount)

•

An upper limit (amount)

•

A wage type

Z1AMT_LOW Z1AMT_HIGH

Z1LGART

© 2014 SAP AG or an SAP affiliate company. All rights reserved.

Public

6

Customizing 2 Define the amount parameters Lower and upper limit differ only in their description. However, the check does need two distinct parameters to allow the limits to be set correctly, so both are needed. We are implementing a US-specific check, so we set MOLGA to 10 and the currency to USD. The EDM type allows you to choose between a decimal and a string important for conversion. Here we have a decimal of system type MAXBT, and precision, digits, and data element are set accordingly. The parameter reflects an amount and it is an input parameter, so both checkboxes are set. It is not a result - the result for this check will be a list of personnel numbers. The lower limit is also an amount (USD, for the US), and is configured the same way, except for the description.

© 2014 SAP AG or an SAP affiliate company. All rights reserved.

Public

7

Customizing 3 Define the wage type parameter The wage type has no numerical properties, and those fields remain empty. We still make this a US specific parameter in this example. That means we will only be able to use it in US specific checks.

We do not assign attributes in any of the other steps for these parameters.

Note: These parameters do not necessarily have to be country specific. This is an example only, and we recommend experimentation.

© 2014 SAP AG or an SAP affiliate company. All rights reserved.

Public

8

Customizing 4 Create the data source type Go to the next IMG step “Create Data Source Types.” Create a new data source type „Z_PYC_HRUS_GEN_WT_BT“ Give the new data source type a text a short text. Set the country grouping to 10, for the US, and „Transparent results“ to „Supported.“ The run time class is ZCL_PYD_GENCHECK_WT_BETWEEN. We will create this class later. At this point in time it does not exist.

© 2014 SAP AG or an SAP affiliate company. All rights reserved.

Public

9

Customizing 5 Assign input and result type parameters Select “Assign input type parameters.” We want our check to be able to select by a range of parameters, including the three we defined just now. Assign those parameters as shown on the right. „Fixed“ parameters are entered in customizing, and used to create a specific check instance, e.g a check for „>= 1000 USD gross“ for students employed part-time. „Mandatory“ parameters are just that. All non-mandatory parameters do not need to be set. Select “Assign result type parameters.” Assign PERNR as result type. This example checks for authorization on infotype 8. If you have no authorizations for the data source framework customized you can leave the field empty for this example. The parameters and optional/mandatory need to be handled by the check code.

© 2014 SAP AG or an SAP affiliate company. All rights reserved.

Public

10

Customizing 6 Assign Result Details With parameter PERNR selected, select “Assign Result Detail Type.” We want to show an employee header with generic information on the employee, a generic overview, and – for this check – the payroll results in form of a wage type list. These three generic views are delivered by SAP. Add the views as shown in the image on the right. The flag „Is header“ puts the employee information in the header bar. The flag „Is default“ opens the generic overview when an employee is selected. The sort order defines in which order the icons are displayed. These views are filled by the check code. That means for different checks you can display different details.

© 2014 SAP AG or an SAP affiliate company. All rights reserved.

Public

11

Customizing 7 Assign Status Change Reasons Select “Status Change Reasons.” (The parameter PERNR should still be selected from the previous step. If you have gone out of that view you will need to select it again.) For this generic check we expect exceptions that we might set to „OK“ manually for additional wage types or retrocalculation differences. Add these two reasons as shown. The reasons you have configured here will be shown as possible selections in the pop-up that appears when you set an employee to „OK“ manually.

© 2014 SAP AG or an SAP affiliate company. All rights reserved.

Public

12

Customizing 8 Setting up the UI: Tiles We will now set up tiles, folders, and check instances that form the structure we see on the UI. In this example, we restrict ourselves to one tile, with one folder, and a few instances of our check. Leave this IMG step entirely and go to Classify Data Sources / Set Up Data Source Classes. Create a class Z_US_TEST with the name „US Payroll Result Checks.“ This will create a tile on the UI with that name. The class category is PY_COCKPIT. All check classes have this category. It is delivered by SAP. Parameter type is ABKRS- Payroll Area. This class works on payroll area level. Note: Empty tiles will not appear on the UI. You need to finish this customizing section before you can expect to see anything.

© 2014 SAP AG or an SAP affiliate company. All rights reserved.

Public

13

Customizing 9 Setting up the UI: Folders Select “Folder.” Create a folder „Earnings“ for country grouping 10 – US. We will create a few check instances for earnings and assign them to this folder.

© 2014 SAP AG or an SAP affiliate company. All rights reserved.

Public

14

Customizing 10 Setting up the UI: Assign data source types to folders Select “Assignment data source type to folder.” Create a folder „Earnings“ for country grouping 10 – US. We will assign our data source type to this folder. Its instances will appear here.

© 2014 SAP AG or an SAP affiliate company. All rights reserved.

Public

15

Customizing 11 Defining check instances Leave the previous IMG step and go to “Define Data Source Instances.” We define two instances: Low retrocalculation difference ( /552