HR ABAP Agenda • • • • • • • • • • Overview and Features in HR programming Difference between Conventional ABAP Concepts of Infotypes Logical Databases in HR Macros in HR Clusters in HR Enhancement and creation of Infotype Reporting in HR User Exits and BAdIs Authorization Objects in HR Overview and Features in HR Programming • • The aim in the Human Resources component is to be able to process employee related data according to business requirements in an effective structure. The Human Resources module uses a system of data grouped together called infotypes. The Human Resources module uses a system of data grouped together called infotypes. And storing bulk data like time management and Payroll data in Cluster files. HR Programming involves data extraction and manipulation from these infotypes and clusters using LDB/MACRO and function modules. Infotypes mirror a quantity of connected data records; infotypes are identifiable through a four character numerical string [e.g. infotype Addresses (0006)] . You can save the infotypes as time-dependent to enable a retroactive evaluation of Employee data. The infotypes appear as an entry screen for the user, through which you can maintain infotype records. Infotypes can be processed individually or in fast entry mode. • • • Difference between Conventional ABAP • Advanced Business Application Programming ABAP is SAP's fourth generation language. All of R/3's applications and even parts of its basic system are developed in ABAP. ABAP is used for customization and modification of SAP applications. In HR ABAP use of select statements significantly less than in other areas of ABAP development, Logical databases have limited applications in other modules but are very useful in HR. Also, you really need to understand the infotype time constraint concept since the data organization in HR is Employee-Time based, When you cannot get the information that you need out of the logical DB look at the function modules starting with HR* and RH*. These function modules will provide you with multiple ways of accessing data to save time. Worst-case scenario, use a select statement. In addition to the LDB, HR programming also involves the use of Macros for data extraction The storage an access of data is different Authorization checks • • • • Concepts of Infotypes An infotype represents a group of related data fields, provide information structure, facilitates data entry, and allows time dependent storage. In other words we can say infotypes are information units used to enter the time dependent data of the employee. Master data in HR is stored in infotypes .Each infotype pertains to a specific type of data. Each infotype has a database table associated with it. Time constraints: Enable you to determine how the validity periods of Infotype data records interact. 1. Time constraint 1: Exactly one valid data record of the infotype in question must exist for the entire time that the employee belongs to the enterprise. 2. Time constraint 2: No more than one valid data record of the infotype in question can exist at any one time. 3. Time constraint 3: Any number of valid data records of the infotype in question can exist at any one time. Concepts of Infotypes Transparent tables for infotype • • Each infotype has a transparent table. Each logical field for an infotype has a corresponding physical field on the database. One physical table is stored on the database for each transparent table. The names of the physical table and logical table definition in the Dictionary are compatible. The following naming convention applies to infotype tables; nnnn stands for the infotype number: PAnnnn for transparent tables in Personnel Administration PBnnnn for transparent tables in Recruitment HRPnnnn for transparent tables in Personnel Planning Example : For Infotype 0000, the corresponding database table associated with it is PA0000 • • • • • Concepts of Infotypes Transparent tables for infotype It is not true always that a Personnel Administration/Recruitment/Personnel Planning etc has a transparent table like PAnnnn or PBnnnn or HRPnnnn. One such example is TEVEN table for IT 2011.It is better to use the Function module HR_INFOTYPE_DATABASETABLE_GET to get the Infotype table name for an infotype. CALL FUNCTION 'HR_INFOTYPE_DATABASETABLE_GET' EXPORTING INFTY = <INFTY> TCLAS = <TCLAS> “Transaction Class with values ‘A’ or ‘B’ or ‘T’ IMPORTING DBNAME = <DBTAB> EXCEPTIONS ENTRY_NOT_FOUND = 1 OTHERS = 2. You can also use the database table T777D to find the database table associated with an infotype. Concepts of Infotypes Technical Data Structure of Info Types PA Infotypes The transparent table for PA Infotype is PAnnnn where nnnn is the infotype number. Structure PAKEY: This is nothing but primary key of transparent table PAnnnn • PERNR: the personnel number is the only unique key within a client for identifying an employee. It is used to access the display and maintenance screens for an employee’s master data and working time data (infotypes). SUBTY: subtypes are subdivisions of infotypes. An infotype’s subtypes can have different time constraints and form their own histories. OBJPS: the object identification is used to make a distinction between records with the same infotype, subtype, lock indicator, start date, and end date. For example, the child number in infotype 0021 Family/Related Person. • • Concepts of Infotypes • SPRPS: the lock indicator for HR master data is used to lock and unlock data records, which enables the “double verification principle” to be put into practice. In accordance with this principle, at least two users are involved in the process of writing an active data record to the database. One of the users creates a locked infotype record, and the other user unlocks - that is, activates the data record. ENDDA: end date. BEGDA: start date. SEQNR: The Sequential Number is used to make a distinction between infotype records that have the same key and time constraint '3' (any number of valid infotype data records at any one time). Unlike the object identification, it is assigned by the system automatically Note: Structure PAKEY should never be changed • • • Concepts of Infotypes Structure PSHD1: In addition to structure PAKEY, there is another basic structure that is identical for all infotypes in personnel administration – that is, the structure PSHD1. Structure PSHD1 should never be changed Concepts of Infotypes Structure PSHDR: This is a meta structure and contains the structures PSHDR and PSKEY. Structure PSHDR should never be changed Structure Pnnnn: This structure contains the includes PSHDR and PS0002, where PSHDR in turn contains the include structures PSKEY and PSHD1. Concepts of Infotypes Element Definition Includes Can be changed by customer PAKEY PSHD1 PSHDR PSnnnn Structure Structure Structure Structure PSKEY PSHD1 No No No (field definitions) PS9nnn:Yes CI_Pnnnn PS0nnn-PS8nnn: No PSHDR PSnnnn P9nnn:Yes P0nnn-P8nnn:No Pnnnn Structure Concepts of Infotypes Element Definition Includes Can be changed by customer PAnnnn Transparent Table MANDT PAKEY PSHD1 PSnnnn - PA9nnn:Yes PA0nnn- PA8nnn :No CI_nnnn Structure Yes Concepts of Infotypes Technical Data Structure of Info Types Personnel Infotypes Structure: HRIKEY • • • • • • • • • • MANDT: This field contains the clients. PLVAR: It is a two-character alphanumeric Key for the plan versions that enables us to differentiate between alternative plan versions. OTYPE: This field contains the object type key, which is a maximum of two alphanumeric characters in length. OBJID: This field contains an eight-digit key that represents a single object. SUBTY: Contains specification of sub type ISTAT: This field is one-digit numeric key in which the planning status is indicated. There is a status for all objects and for the infotypes that describe them. BEGDA: This contains start date of the validity period ENDDA: This contains end date of the validity period VARYF: This contains the target object of a relationship SEQNR: This specifies a sequence number for Infotypes of time constraint class 3. Concepts of Infotypes Structure HRIKEYL: The structure HRIKEYL is a variant of the structure HRIKEY. This supports language-dependant infotypes. Concepts of Infotypes Structure HRIADMIN: The structure HRIADMIN is a data structure contains administrative information on each infotype. Concepts of Infotypes Structure HRInnnn: The infotype-specific data fields for an infotype are defined in the structure HRInnnn. Here nnnn stands for four-digit infotype number, as appropriate. Transparent Table HRPnnnn: The transparent table now contains the structures HRIKEY(key fields), HRADMIN and HRInnnn. Logical structure Pnnnn: Like the infotypes in Pa, the structure Pnnnn is also found in the infotypes of personnel planning. It contains the includes HRIPKEY, HRIADMIN and HRInnnn. Concepts of Infotypes Table Infotypes: Table infotypes are a special form of infotype used in personnel planning. Table infotypes are infotypes for which the data part has a repetitive structure of arbitary length. The repetitive structures could be texts with any number of lines, or it could, for example, be a course schedule with any number of days. In order to provide the option of saving repetitions of any length, the data part must have repetitive structure and it must be saved in a separate data table. This repetition part of the table part is described in the logical structure PTnnnn and stored in separate table HRTnnnn. While maintaining the entry in table T777D for infotypes, the table infotype will be having the T777D-TBTAB field will be filled with HRTnnnn. Concepts of Infotypes External Object Types: External Object types refer to those object types that are not stored in the data structure of personnel planning. From a technical point of view there is no record in HRP1000 for external objects. External Object types are only referenced in the context of a relationship record. Technically, this means that data records on the relationship are only held in HRP1001. For internal object types, relationships can exist in two directions, top-down (B) and bottom-up (A). This results in the creation of two records in IT 1001, relationships. External Object types are limited in this respect. In order to create an inverse relationship for an external object type, the key structure of the external object type must be an eight-digit numeric string type NUMC of length 8). It must be therefore be defined with the same type as the field object ID (HRPnnnnOBJID). Whether external object types have only one relationship – or if inverse relationships are also possible – is established for each object type in the table T77EO. Concepts of Infotypes External Infotypes: Infotypes that are needed for planning purposes in personnel planning, but are not stored in transparent infotype tables of the type HRPnnnn are referred to as external infotypes. This information can be physically available, for example, in the tables of personnel administration. An identifier for an external infotype appears in table T777D in the field EXT_INFTY. Concepts of Infotypes Element Definition Includes Can be changed by customer HRIKEY HRIKEYL HRIADMIN HRInnnn Structure Structure Structure Structure - No No No (field definitions) HRI9nnn:Yes CI_Pnnnn HRI0nnnHRI8nnn: No HRIPKEY HRIADMIN HRInnnn P9nnn:Yes P0nnn-P8nnn:No Pnnnn Structure Concepts of Infotypes Element Definition Includes Can be changed by customer HRPnnnn Transparent Table HRIKEY or HRIKEYL and HRIADMIN - HRP9nnn:Yes HRP0nnnHRP8nnn: No PT9nnn:Yes PT0nnn-PT8nnn: No HRT9nnn:Yes HRT0nnnHRT8nnn : No Yes PTnnnn Structure HRTnnnn Transparent Table Structure PTnnnn CI_nnnn - Logical Databases in HR To reduce programming Efforts, it often helps to use the logical databases when creating reports. Logical databases are special ABAP Programs that provide selection screens, additional features and so on. The main objects of a LDB are Structure, Selection and Database Program. An LDB has another advantage for the option of central authorization checking. Logical Databases used In HR: 1. PAP 2. PNP 3. PNPCE - Enhanced version of PNP available form SAP Enterprise version onwards 4. PCH 5. PTRVP The LDB PAP is for Applicant administration, PNP and PNPCE for Personnel Management, PCH for Organisational Management and PTVRP for Travel Management. The Logical Databases PNP/PNPCE and PCH are mostly used. Macros in HR Like subroutines and function modules, macro modules can be used to modularize programs. Macro modules are frequently used in HR. • These macros are defined in program SAPDBPNP (include DBPNPMAC) with the keyword DEFINE. They can be used in any program that uses the logical database PNP. • If you want to use these macros in reports that do not use the logical database PNP, you must include program DBPNPMAC with the keyword INCLUDE. • You can also define your own macros. In accordance with the naming convention, the first two letters stand for the application. • Some macros are also stored in the Macros in ABAP Programs table (TRMAC) Example of Macros are 1. RP_PROVIDE_FROM_LAST which is available in the include DBPNPMAC 2. RP-PROVIDE-FROM-FRST which is available in table TRMAC • Macros in HR • • The RP_PROVIDE_FROM_LAST macro retrieves the last valid data record in the data selection period. The parameters for RP_PROVIDE_FROM_LAST are: infotype, subtype, start date, and end date. If you do not want to specify a particular subtype, enter SPACE. You can process not only the last valid data record in the data selection period, but also the first valid data record using the RP_PROVIDE_FROM_FRST macro. The macro return code PNP-SW-FOUND has the value 1 if a suitable entry exists in the infotype table for the specified period. If no entry is found, the value is 0. • • Clusters in HR D a ta b a s e T a b le s P C L n PCLn A1 A2 A3 S A P A G 1999 Clusters in HR • • • • • Database tables of type PCLn are divided into subareas known as data clusters. Data clusters can be identified by their twocharacter IDs. The respective subareas within Human Resources work on their own cluster. A separate data key is defined for each subarea. The PCLn database tables are a type of import/export database table. Clusters in HR Clusters in HR Cluster table PCL1: PCL1 contains the following data areas B1 Time events/PDC G1 Group incentive wages L1 Individual incentive wages PC Personal calendar TE Trip costs/accounting results TC Trip costs/credit card data TX Infotype texts Z1 Interface PDC -> cost accounting/materials management This table is maily used for retrieving data from the following data areas: 1. B1 2. TX Clusters in HR Cluster table PCL2: PCL2 contains the following data areas: B2 Time accounting results CUCluster directory PS Generated schema PT Texts for generated schemas RX Payroll results/international Xy Payroll results/country-specific, whereby xy represents the relation ID. This is from RELID field of table T500L for the country. ZL Personal work schedule Clusters in HR DB Table Adm inistration/ PCLn PCLn IM PORT A1 A2 EXPORT TABLES: PCLn. 1. The PCLn import/export database tables are managed by the ABAP commands IMPORT and EXPORT. 2. We can use these commands to store any data object - such as fields, structures or internal tables - on the database, or to read them from the database. 3. Data is read and written using a unique key. Clusters in HR T a b le S tru c tu re / P C L n F ie ld n a m e K E Y C L IE N T R E L ID SRTFD SRTF2 X X X X L e n g th 3 2 40 10 Text C lie n t R e la tio n ID W o rk a re a k e y S o rt fie ld fo r d u p lic a te k e y E x a m p le o f in te rn a tio n a l p a yro ll re s u lts : R E L ID S R T F D RX 00001911 00001 RX 00001911 00002 RX 00001911 00003 ... Clusters in HR The structure of PCLn database tables provides a basic structure for individual subareas. The name of each subarea must include a two-character cluster name or relation ID. A key structure must also be defined; 40 bytes are available in field SRTFD for this purpose. In the international payroll results, for example, the field RELID contains the cluster name RX and the field SRTFD contains the eight-digit personnel number as well as a five-digit sequence number for each individual payroll result for a payroll period. To enable the import of a record from a PCLn database table, the RELID field must contain the cluster identifier and the SRTFD field must contain the cluster key. The fields CLIENT and SRTF2 are filled by the system. Clusters in HR U tilitie s /D e le tin g a C lu s te r U T IL IT Y PCLn PCLn Utility transaction PU00 enables us to delete payroll results in xy clusters for specific personnel numbers. 1. Utility programs RPUPnD00 and RPUPnD10 - where n stands for database table PCL1 or PCL2 - enable us to delete one or more records from any cluster. 2. We can delete payroll results using the program RPUDEL20. 3. Caution: The deletion utilities should only be used for testing. Archiving takes place to reduce the amount of data in the database. Enhancement and Creation of Infotypes Enhancement of Infotypes Enhancement and Creation of Infotypes Infotype needs to be enhanced sometimes to add our own fields to the existing infotype fields. Before Enhancing any infotype, CI_ Include must be available. Enhancement of PA Infotypes In PA we can enhance the Single screen as well as list screen. Enhancing the single screen • Procedure 1. Start the transaction Enhance Infotype, (transaction code PM01). The Create Infotype screen appears. 2. Choose Enhance Infotype Tab Enhancement and Creation of Infotypes 3. In the Infotype Number field, enter the four-digit number of the infotype you want to enhance When you enter the infotype number, remember to enter any leading zeros. Note: It is not possible to enhance a single screen for the Actions infotype (0000), or the Time Management infotypes. Enhancement and Creation of Infotypes 4. Choose the button ‘Create All’ The following screen appears: 5. Press Enter. Then create the fields required on the screen. In this case Train Route Enhancement and Creation of Infotypes 6. The following screen appears. 7. Now if we go to Infotype 0006 of any employee we can see the field added. Enhancement and Creation of Infotypes Note: While enhancing the single screen of an infotype a module pool program ZPnnnn00 will be created and that can be modified by ourselves. We have to modify the screen number 0200 for adjusting the screen elements and appearance of the enhanced screen. The module pool program of a PA Infotype will be MPnnnn00. For every infotype there is a dialog module associated with it. It will be RP_nnnn for PA infotypes. The single screen of an Infotype will be 2000 and the list screen will be 3000. Here nnnn denotes 4-digit infotype number. Enhancement and Creation of Infotypes Enhancing the single screen • Procedure 1. Start the transaction Enhance Infotype, (transaction code PM01). The Create Infotype screen appears. 2. Choose Enhance List screen Tab 3. In the Infotype Number field, enter the four-digit number of the infotype you want to enhance the list screen. Enhancement and Creation of Infotypes 4. Choose the button ‘Create All’ The following screen appears: 5. Press Enter. Then create the fields required on the screen. In this example Train Route Enhancement and Creation of Infotypes 6. The following screen appears. 6. Now if we go to Infotype 0006 overview screen of any employee we can see the field added . Enhancement and Creation of Infotypes Note: While enhancing the list screen of an infotype a module pool program ZPnnnn00 will be created (if it is not available already) with an include ZPnnnn40. We cannot modify the screen appearance of the added field since it will be directly added to the list screen 3000 of the module pool MPnnnn00. Enhancement and Creation of Infotypes Enhancement of Personnel Infotypes Use the transaction PPCI to enhance Personnel Infotypes. Enhancing the single screen • Procedure 1. Start the transaction Enhance Infotype, (transaction code PPCI). The following screen appears. Enter the 4 digit infotype number. Click on extend button. Enhancement and Creation of Infotypes 2. The following screen appears. Click on ‘Create All’ Button. 3. Enter the fields and activate the include CI_Pnnnn and the fields entered will appear in the infotype. Enhancement and Creation of Infotypes Enhancing the list screen • Procedure 1. Start the transaction Enhance Infotype, (transaction code PPCI). The following screen appears. Enter the 4 digit infotype number. Select the menu Infotype Enhance list screen. Enhancement and Creation of Infotypes 2. The following screen appears. Click on ‘Create All’ Button. 3. Enter the fields and activate the structure ZPLISnnnn and these fields entered will appear in the infotype's overview screen. Enhancement and Creation of Infotypes Creation of Infotypes Enhancement and Creation of Infotypes Infotype needs to be created when you cannot store the required information in any of the standard infotypes. Creation of PA Infotypes 1. 2. 3. Start the transaction Enhance Infotype, (transaction code PM01). The Create Infotype screen appears. Enter the four digit Infotype number ( starting from 9000-9999). Then click on the ‘Create All’ button. Enhancement and Creation of Infotypes 3. The following popup appears. Press Enter. 4. The new screen for entering the required infotype field appears. Activate the structure PSnnnn and the required infotype details are created. Enhancement and Creation of Infotypes 5. Then our major duty is to maintain the infotype characteristics. For that from the PM01 transaction select the button ‘Infotype Characteristics’. Copy the entry from existing infotype to the newly created one and change the characteristics of our infotype accordingly. The characteristics can also be maintained through IMG or by using the customizing view V_T582A. New Infotype Enhancement and Creation of Infotypes Details of customization Enhancement and Creation of Infotypes If you goto PA30 transaction for Infotype 9nnn you can find the infotype fields entered. Enhancement and Creation of Infotypes Creation of Personnel Infotypes Field Infotypes For Field infotypes we have to create the structure HRI9nnn though the transaction SE11 before we are creating the infotype. Table Infotypes For Table infotypes we have to create the structure HRI9nnn and PT9nnn though the transaction SE11 before we are creating the infotype. Other than these the creation of both types of Infotype remain the same. Enhancement and Creation of Infotypes Let us see the procedure of creating a table Infotype, 9700. Goto SE11 transaction and create the structures HRI9700 and PT9700 Enhancement and Creation of Infotypes 1. 2. 3. Start the transaction Enhance Infotype, (transaction code PPCI). The Create Infotype screen appears. Enter the four digit Infotype number ( starting from 9000-9999. In our example it is 9700). Also enter the description of the Infotype. Then click on the ‘Create’ button. The following screen appears. Enhancement and Creation of Infotypes 4. Select the radio button ‘Table infotype and click on the ‘Create’ Button. The following popup appears. Select ‘Yes’. 5. Finally an information message appears as follows: Enhancement and Creation of Infotypes 6. Then our major duty is to maintain the infotype characteristics. Do it through IMG or by using the customizing table T777I. What we have to add is the Time constraint and Infotypes per object type. Enhancement and Creation of Infotypes I have added this to Object type O and with time constraint 2. Similarly I can add the infotypes per object type as follows Enhancement and Creation of Infotypes Finally If I goto PP01 transaction for the maintenance of Organization Unit, I can see the infotype. Enhancement and Creation of Infotypes Reporting in HR Special ABAP Statements for HR 1. 2. 3. 1. INFOTYPES PROVIDE ENDPROVIDE INFOTYPES The syntax for this statement is: INFOTYPES nnnn. - nnnn between 0000 and 0999: HR master data info types - nnnn between 1000 and 1999: HR planning data info types - nnnn between 2000 and 2999: HR time data info types - nnnn between 3000 and 8999: Not yet used - nnnn between 9000 and 9999: Customer-specific info types There are some variants for INFOTYPES statement 1. … NAME c 2. … OCCURS n 3. … MODE N 4. … VALID FROM comp1 TO comp2 Reporting in HR The effect of ‘INFOTYPES’ statement is that it will create an internal table Pnnnn as follows: DATA BEGIN OF Pnnnn OCCURS 10. INCLUDE STRUCTURE Pnnnn. DATA END OF Pnnnn VALID BETWEEN BEGDA AND ENDDA. (eg) INFOTYPES 0001. Variant 1: … NAME c , c 20 character field This will create an internal table with the name c DATA BEGIN OF c OCCURS 10. INCLUDE STRUCTURE Pnnnn. DATA END OF c VALID BETWEEN BEGDA AND ENDDA. (eg) INFOTYPES 0006 NAME ADDRESS. Reporting in HR Variant 2: … OCCURS n, n numeric value This will create an internal table as follows: DATA BEGIN OF Pnnnn OCCURS n. INCLUDE STRUCTURE Pnnnn. DATA END OF Pnnnn VALID BETWEEN BEGDA AND ENDDA. (eg) INFOTYPES 0005 OCCURS 2. Variant 3: …MODE N Applies only to the HR logical databases PNP, PNPCE and PCH. The info type tables are not filled by GET PERNR (logical database PNP) or GET OBJEC (logical database PCH). The effect of the INFOTYPES statement is then the same as the data declaration of an internal table (as described above). Generally used for Time Infotypes. (eg) INFOTYPES 2001 MODE N. Reporting in HR Variant 4: … VALID FROM comp1 TO comp2 This should be used only with LDBs PNP and PNPCE GET PERNR retrieves only those info type records which are valid within the time range ( comp1 and comp2) specified. comp1 and comp2 are dates with the format YYYYMMDD. (eg) INFOTYPES 0007 VALID FROM 19910101 TO 19911231. Reporting in HR 2. PROVIDE The syntax for this statement is: PROVIDE f1 f2 … FROM itab1 g1 g2 … FROM itab2 … BETWEEN f AND g. - We can use * instead of individual field names - itab1, itab2 etc will be of structure Pnnnn - f and g are from and to dates. This statement will retrieve the contents of the specified fields from the internal tables ( itab1, itab2, ...) and places them in the table header lines within the required range. Also executes the processing block enclosed by the PROVIDE and ENDPROVIDE statements for each range. Reporting in HR 3. ENDPROVIDE The syntax for this statement is: ENDPROVIDE. - This statement will close the loop introduced by PROVIDE. Reporting in HR Data Retrieval 1. Create data structures for infotypes INFOTYPES: 0001, 0002, 0007. "Organizational Assignment" "Personal Data" "Planned Working Time" 2. Fill the data structures with the infotype records GET PERNR. SAP AG 1999 Reporting in HR • Structure PERNR contains standard selections for HR master data reporting. They consist of the personnel number, the fields of infotypes 0000 and 0001, and a number of additional fields. When the GET event occurs, the data structures of declared infotypes are filled with all of the records that exist for a personnel number. The PERNR structure is fílled with the data from the above infotypes. You can access the data in this structure for processing. • Reporting in HR Processing M aster Data TABLES: PERNR. INFOTYPES: 0001, 0002, 0006, .... "Actions "Personal Data "Addresses GET PERNR. PROVIDE * FROM P0002 BETWEEN PN-BEGDA AND PN-ENDDA. WRITE... ENDPROVIDE. SAP AG 1999 Reporting in HR • • • Filled infotype structures are stored in the main memory for the GET PERNR event keyword. The infotype records are imported to internal tables Pnnnn (for example, P0006 for infotype 0006). These tables are then processed in a PROVIDEENDPROVIDE loop. The infotype records whose validity period overlaps the period selected in the selection screen (PN-BEGDA and PN-ENDDA) by at least one day are placed one after the other in the header of the respective infotype table Pnnnn. For example, if you choose the current year in the selection screen, PNBEGDA contains the first day of the year and PN-ENDDA contains the last day of the year. If you do not enter any data for the period in the selection screen, PN-BEGDA contains the low date (01/01/1800) amd PNENDDA contains the high date (31/12/9999). Note: If you have entered period date in the selection screen, the contents of fields Pnnnn-BEGDA and Pnnnn-ENDDA are also reset in the header of the infotype table Pnnnn. For example, if the date in PnnnnENDDA is after the date in PN-ENDDA, Pnnnn-ENDDA is given the value from PN-ENDDA. • • Reporting in HR Loop Nesting GET PERNR. PROVIDE * FROM P0002 BETWEEN PN-BEGDA AND PN-ENDDA. WRITE... ENDPROVIDE. or: LOOP AT P0002 WHERE ENDDA GE PN-BEGDA AND BEGDA LE PN-ENDDA. WRITE... ENDLOOP. PROVIDE * FROM P0006 BETWEEN PN-BEGDA AND PN-ENDDA WHERE P0006-SUBTY = '1'. WRITE... ENDPROVIDE. END-OF-SELECTION. SAP AG 1999 Infotype loop Infotype loop Employee loop Infotype loop Reporting in HR • • HR data is processed in two nested loops: A GET PERNR loop for all of the personnel numbers selected. It is concluded implicitly by the next event, for example, END-OF-SELECTION. Subordinate loops per infotype, for the processing of all infotype records for the selected personnel number. With this form of processing, you should note that the data for the Personal Data (0002) and Address (0006) infotypes is listed sequentially and is not linked. You can also process the infotype tables with a LOOPENDLOOP. • • • Reporting in HR P e r io d -B a s e d D a ta (1 ) J A N U A R Y - A P R IL M AY - AUGUST Ms Y SEPTEM BER - DECEM BER S A P A G 1999 Infotype data is period-based, in other words, it is only valid for specific periods. For this reason, each record has a start date and an end date. This example shows the jobs that an employee has performed over the course of a year. The decision on how to retrieve data is made for each individual infotype. Reporting in HR REPORTS IN PERSONNEL ADMINISTRATION Reporting in HR Some important fields 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. PERNR WERKS BTRTL PERSG PERSK ABKRS LGART BETRG ANZHL MOLGA BEGDA ENDDA MOABW Personnel Number Personnel Area Personnel Subarea Employee Group Employee Subgroup Payroll Area Wage Type Amount Number Country code Start Date End Date Personnel subarea grouping for absence and attendance types Reporting in HR Report which is based on reading data from infotypes and using LDBs REPORT zpsol010. *-- Declaration TABLES: pernr. INFOTYPES: 0002. "Personal Data SELECT-OPTIONS: language FOR p0002-sprsl. *-- Selection screen INITIALIZATION. pnptimed = 'D'. Reporting in HR *-- Processing GET pernr. PROVIDE * FROM p0002 BETWEEN pn-begda AND pn-endda. CHECK language. WRITE: / p0002-pernr, sy-vline, pernr-ename, sy-vline, p0002-sprsl, sy-vline, p0002-gbdat. ENDPROVIDE. Reporting in HR Example for understanding the repetitive structure Say, for an employee you want to know that for what all wage type an employee is eligible for the latest period you mentioned on the selection screen. REPORT ZRP_REPETITIVE_STR NO STANDARD PAGE HEADING. TABLES pernr. INFOTYPES 0008. *** you have to declare a structure same as repetitive structure in the ** 0008 infotype DATA: BEGIN OF s_wagetypes, wagetype TYPE p0008-lga01, amount TYPE p0008-bet01, hours TYPE p0008-anz01, unit TYPE p0008-ein01, ind TYPE p0008-opk01, END OF s_wagetypes. GET pernr. DO 20 TIMES VARYING s_wagetypes FROM p0008-lga01 NEXT p0008-lga02. IF s_wagetypes-wagetype IS INITIAL. EXIT. ELSE. WRITE: / s_wagetypes-wagetype, s_wagetypes-amount. ENDIF. ENDDO. Reporting in HR Importance of Dates and Periods • • Here is a simple ABAP example of reading DATE types stored in infotype 0041. There can be a maximum of 12 dates stored in this infotype. Here is an example of an infotype 0041 record: Reporting in HR The date types are stored in PA0041-DAR01, PA0041-DAR02, etc. In the example above, PA0041-DAR01 is “01”, PA0041-DAR02 is “09”. The dates themselves are stored in PA0041-DAT01, PA0041DAT02, etc To read through this in ABAP, the easiest way is to use the DO VARYING statement. Here is a simple demonstration ABAP: Note: to print the text of the date type, e.g. “Leave year entry” select from table T548T. Reporting in HR REPORT ZDATES1 . TABLES: PERNR. DATA: BEGIN OF MYDATES, DAR LIKE P0041-DAR01, DAT LIKE P0041-DAT01, END OF MYDATES. INFOTYPES 0041. GET PERNR. WRITE: PERNR-PERNR, PERNR-ENAME. "show employee number and name RP-PROVIDE-FROM-LAST P0041 SPACE PN-BEGDA PN-ENDDA. IF PNP-SW-FOUND = 1. *** Processing of repetitive structures ************* DO 12 TIMES VARYING mydates FROM p0041-dar01 NEXT p0041-dar02. IF mydates-dar NE space. WRITE: /,MYDATES-DAR, MYDATES-DAT. ENDIF. ENDDO. ENDIF. Reporting in HR M acro M o d u les T ABLES: PERNR . I NFOTYP ES: 0 001, 0 002, 0 006, . ... "Or ganiza tional Assig nment "Per sonal Data "Ad dresse s G ET PER NR. R P_PROV IDE_FR OM_LA ST P00 01 SPA CE PN- BEGDA PN-EN DDA. W RITE.. . * * * In cl ud e pr og ra m DB PN PM AC . DE FI NE R P_ PR OV ID E_ FR OM _L AS T. PN P- SW -F O U ND = ' 0' . . . . EN D- OF -D EF IN IT IO N. S A P A G 1999 Reporting in HR R e ad in g th e G ro u p T a b le U sin g th e P e rso n n e l A rea/S u b a re a F ie ld s TABLES: PERNR, T001P. INFOTYPES: 0001, .... P e rs o n n e l Are a /S u b a re a T a b le P e rs Are a ... CABB ... S u b a re a 00 0 1 G ro u p in g s . . . 01 01 GET PERNR. RP_PROVIDE_FROM_LAST P0001 SPACE PN-BEGDA PN-ENDDA. RP-READ-T001P P0001-WERKS P0001-BTRTL SPACE. S A P A G 1 99 9 Reporting in HR • It is often necessary to read the groupings stored in the Personnel Area/Subarea table because they are required as keys for other tables. This must take place individually for each personnel number to be processed. Each employee's assignment to a personnel area and subarea is stored in infotype 0001. The parameters of the macro are: Personnel areas Personnel subareas Reaction, if no entry is found: X = Termination of report with error message ‘No entry found in table ...’ SPACE = SY-SUBRC is set to 4. Alternatively, if you only want to determine the country indicator, you can use the function module HR_COUNTRY_GROUPING_GET. • • • • • • • • Reporting in HR R e a d in g In fo t y p e s W ith o u t L o g ic a l D B (1 ) P Annnn I . C ' N . A H FOTYPES: <nnnn>. . LL FUNCTION R_READ_INFOTYPE'... SA P AG 1999 You can also read infotype records for a particular personnel number without using the logical database. To do this, use the function module HR_READ_INFOTYPE. However, you must ensure that the internal table for the required infotype is declared with the INFOTYPE statement. Reporting in HR Reading Infotypes Without Logical DB (2) INFOTYPES: 0002. DATA: return LIKE SY-SUBRC. CALL FUNCTION 'HR_READ_INFOTYPE' EXPORTING . . . PERNR = <person> INFTY = '0002' BEGDA = <begdat> ENDDA = <enddat> IMPORTING SUBRC TABLES INFTY_TAB EXCEPTIONS INFTY_NOT_FOUND OTHERS = return = P0002 = 1 = 2. SAP AG 1999 Reporting in HR • The function module reads the HR infotype records for a person (employee or applicant) in accordance with the specified selection criteria. Values are returned in an internal table, the structure of which corresponds to the appropriate infotype table. In the calling program, such tables can be declared with the INFOTYPES statement, for example. An infotype record is selected if its validity period overlaps with the specified period. The function module performs an authorization check. The following specifications are possible for the return code: 0: The return table contains all required records 4: The return table contains all records, however, it is incomplete due to missing authorization 8: The return table is empty because no records were found with the specified criteria 12: The return table is empty due to missing authorization Note: You should not use this function module in reports that use the logical database PNP. If you want to read an infotype separately in one of these reports, you can call the subroutine READ-INFOTYPE directly in the database program SAPDBPNP (PERFORM READINFOTYPE(SAPDBPNP)). . .). If this is the case, you declare the infotypes in the statement INFOTYPES with supplement MODE N. • • • Reporting in HR Determining the Entry Date INFOTYPES: 0001. DATA: hire_date LIKE P0016-EINDT. CALL FUNCTION 'RP_GET_HIRE_DATE' EXPORTING PERSNR = P0001-PERNR CHECK_INFOTYPES = '0000' * DATUMSART = '01' * STATUS2 = '3' * P0016_OPTIONEN = ' ' IMPORTING HIREDATE = hire_date EXCEPTIONS OTHERS = 1. SAP AG 1999 Reporting in HR • With this function module, you can determine the initial start date of an employee. You can take the following infotypes into account when you determine this date: - P0000 Actions - P0001 Organizational Assignment - P0016 Contract Elements - P0041 Date Specifications The transfer parameter CHECK_INFOTYPES is used to determine which of these infotypes are taken into account. The employment status (parameter STATUS2) can also be specified for infotype P0000. In infotype P0016, only the Entry data field (P0016-EINDT) is taken into account. For infotype P0041, the corresponding date type can be given in the transfer parameter DATUMSART. The date type '01' is usually used for the technical entry date. Most function modules in HR have the letters 'HR' or 'RP' in the first two characters of their name. To find additional modules, use the search function in the Function Builder. • • Reporting in HR Updating Infotype Records (1) DATA: return_struc TYPE BAPIRETURN1, . . . CALL FUNCTION 'BAPI_EMPLOYEE_ENQUEUE' EXPORTING NUMBER = PERNR-PERNR IMPORTING RETURN = return_struc. IF NOT return_struc IS INITIAL. WRITE: / return_struc-TYPE,... ENDIF. . . . * Update Infotype Records . . . CALL FUNCTION 'BAPI_EMPLOYEE_DEQUEUE' EXPORTING NUMBER = PERNR-PERNR IMPORTING RETURN = return_struc. SAP AG 1999 Reporting in HR • Before you change employee data, you must lock the personnel number. You can do this with the function module BAPI_EMPLOYEE_ENQUEUE. Messages are returned in the parameter RETURN. If an error occurs, this structure contains the following information:- Message type (field TYPE)- Message text (field MESSAGE).If the step is successful, the structure is blank. If an employee's data has been locked, only the user who has locked the data can access the data records linked to the employee. For other users, access is denied. For this reason, you must remove the lock after the data has been changed. You can do this with the function module BAPI_EMPLOYEE_DEQUEUE. • • Reporting in HR Updating Infotype Records (2) DATA: return_struc TYPE bapireturn1, record_key TYPE bapipakey. . . . GET PERNR. LOOP AT P0002 WHERE. . . CALL FUNCTION 'HR_INFOTYPE_OPERATION' EXPORTING INFTY = '0002' NUMBER = P0002-PERNR LOCKINDICATOR = P0002-SPRPS VALIDITYEND = P0002-ENDDA VALIDITYBEGIN = P0002-BEGDA RECORDNUMBER = P0002-SEQNR RECORD = P0002 OPERATION = 'MOD' DIALOG_MODE = '1' IMPORTING RETURN = return-struc KEY = record_key. ENDLOOP. SAP A G 1999 Reporting in HR • With this function module, you can maintain the employee and applicant master data. You can specify one data record. All validations that would normally take place if the infotypes were maintained online with the individual maintenance screens are also carried out here. The module returns the same error messages as in the online operation. This means the error messages for the individual maintenance screens are displayed rather than interpreted. The update is carried out by a 'Call dialog' to the module pool for the infotype. This means that some restrictions apply to the infotypes processed in that way (see documentation for module). The following values are amongst those available for the parameter OPERATION: MOD (change), COPY (copy), DEL (delete), INS (insert), LIS9 (delimit). With the parameter DIALOG_MODE, you specify whether the action is generally run in the background or whether it only runs in the background until an error occurs, or whether the changes are generally carried out in the dialog mode. Possible values:'0' The changes are generally processed in the background. If an error occurs (with an E or A message), the complete step is terminated and the module returns the corresponding error message in the structure 'RETURN'. '1' The changes are generally processed in the background. If an error occurs, the system switches to dialog mode so that the user can correct the entries. '2' The changes are processed in the dialog mode. • • Reporting in HR U p d atin g In fo typ e R eco rd s (3 ) PARAMETERS: natio_o LIKE P0002-NATIO DEFAULT 'DE', natio_n LIKE P0002-NATIO DEFAULT 'D'. * Update infotype records UPDATE PA0002 SET NATIO WHERE PERNR AND NATIO = natio_n = P0002-PERNR = natio_o. IF SY-SUBRC = 0. WRITE: 'Modified records', SY-DBCNT. ENDIF. S A P A G 1999 Reporting in HR Indirect Valuation: Some times entries in Infotype 0008, 0014, 0015 etc are stored for indirect valuation (ie the wagetype has to be valuated indirectly). The entries will not be stored in the infotype tables. We have to use any of the function modules for indirect valuation to read the data. (Eg) HR_INDVAL_READ_INFOTYPE Reporting in HR Join and Projections Joins: • • • • Any number of infotypes can be linked by a JOIN. Note that changing data in any one of the infotypes linked by a join causes a split in the selection period. Joins are only possible for infotypes with time constraint 1 or 2. If infotypes linked by a JOIN have subtypes, processing must be restricted to one subtype using a WHERE condition, in which a subtype is queried. Reporting in HR J o in / S u b t y p e s TABLES: PERNR. INFOTYPES: 0001, 0002, 0006, .... GET PERNR. PROVIDE "Organizational "Personal Data "Addresses Assignment FROM P0002 FROM P0006 BETWEEN PN-BEGDA WHERE P0006-SUBTY = '1'. IF P0006_VALID = 'X'. WRITE... ENDIF. ENDPROVIDE. * * AND PN-ENDDA SAP A G 1999 Using variable Pnnnn_VALID, the system recognizes that one partial interval only contains incomplete data. When the report is run, this variable is created for each Pnnnn infotype included in a join. If a partial interval for infotype Pnnnn contains data, its Pnnnn_VALID variable is filled with X. Reporting in HR Projections: • • • • Selecting one or more infotype fields for processing is called PROJECTION. Using projection for specific fields enables you to specify that only the contents of these fields and time-based changes to the contents, are relevant to an evaluation. Like joins, projections are logical data views concentrated on one or more fields within an infotype. Projection is also an operation performed on the time axis. New validity periods are created when the contents of one of the projection fields change. The values stored in fields that are not included in the projection are in an undefined condition, which means they are no longer relevant to output. If the contents of a field included in the projection remain unchanged in several data records, the validity periods of these data records are combined. The process of combining data records during projection is called contraction. JOIN and PROJECTION can be combined in a PROVIDE statement. • • • Reporting in HR Jo in an d P ro jectio n / C o d in g TABLES: PERNR. INFOTYPES: 0001, 0002, .... "Organizational Assignment "Personal Data GET PERNR. PROVIDE STELL ENAME FROM P0001 GBDAT FROM P0002 BETWEEN PN-BEGDA AND PN-ENDDA. WRITE... ENDPROVIDE. S A P A G 1999 Reporting in HR Calling R eports U sing D ynam ic Actions Table of D ynam ic Actions IType STy. Field FC No S Variable function part 0008___ 0008___ 0008___ 0008___ 0008___ SPRPS SPRPS SPRPS SPRPS SPRPS 06 06 06 06 06 0 1 2 3 4 _ P F I W *----------- Lock indicator set?----------------* P0008-SPRPS<>SPACE COMPUT E_DATE(ZPFORM01) INS,0019,10 P0019-VTRMN=RP50D-DAT E1 REPORT zpform01. TABLES: RP50D, "Return fields for dyn. actions PRELP. "HR Master Data Buffer . . * Calculate date FORM compute_date. RP50D-DATE1 = PRELP-BEGDA -14. ENDFORM. SA P AG 1999 Reporting in HR • • • • The 'Dynamic Actions' table (T588Z) is a control table that triggers steps taken when an infotype record is maintained. Such steps include maintaining another infotype record, performing a routine, or sending a mail. OP stands for a user operation where 02 stands for Change, 04 for Insert, and 08 for Delete a record. The values can be added, for example, 06 means that an action is performed if the current record has been changed or inserted. A stands for an action performed by the system, for example, P = Check a condition, F = Call a routine, I = Maintain an infotype record, W = Set default values when inserting a record. You can call internal (defined in the module pool) and external routines. In an external routine, the name of the program is given in parentheses after the name of the routine. You cannot enter the USING parameter. The fields of the structure that is not used in the standard system (RP50D) are available to return the values from the routine. They can be filled by the routine and then used for default values (W statements). This structure can be enhanced with customer fields in a customer include. In this example, the routine COMPUTE_DATE calculates a date in the subroutine pool ZPFORM01 and places it in field RP50D-DATE1. This date is calculated by subtracting 14 days from the start date of the locked record. • Reporting in HR Calling Features from Reports TABLES: PME04. " Field string for feature ABKRS DATA: ret_value(2). " Return value for feature * Fill decision fields for feature with values . PME04-PERSK = P0001-PERSK, . . . * Call feature CALL FUNCTION 'HR_FEATURE_BACKFIELD' EXPORTING FEATURE = 'ABKRS' STRUC_CONTENT = PME04 IMPORTING BACK = ret_value EXCEPTIONS ERROR_OPERATION = 2 NO_BACKVALUE = 3 FEATURE_NOT_GENERATED = 4. SAP AG 1999 Reporting in HR • • • • • • This function module reads the decision tree for a feature with the accompanying field contents and determines the return values for the field contents. To identify which fields in the field string for the feature (PMEnn) are used for the decisions in the feature, view the structure and decision tree in feature maintenance (transaction PE03). The field string PMEnn must be declared in the data declaration part of your program using a TABLES statement. Define a field to contain the return value of the feature. In your program, enter values in the decision fields used in your feature. Call the function module and enter the name of the feature to be used and the name of the field string. The return value for the feature is transferred to the main program with the BACK parameter. Possible errors when processing the decision tree: a) An error occurred in the feature (ERROR_OPERATION) b) No return value is available for the current contents of the decision field (NO_BACKVALUE) c) The feature was no generated (FEATURE_NOT_GENERATED) If the return value for a feature consists of a table, use the function module HR_FEATURE_BACKTABLE. • Reporting in HR T im e D a ta a n d V a lid it y P e r io d D a t a s e le c t io n p e r io d Leave 15 days PROVIDE... WRITE... ENDPROVIDE. 15 days S A P A G 1999 Note: Don’t use PROVIDE statement for Time Infotypes Reporting in HR Im p o r t in g T im e D a ta (1 ) D a ta s e le c tio n p e r io d INFOTYPES: 2001, 2002, 2005, 2010. Remuneration Info GET PERNR. "Absences "Attendances "Overtime "Employee P A nnnn S A P A G 1999 A principle of the logical database is that all of the infotype records between the lowest and highest system date are read, irrespective of the data selection period, when the GET PERNR event occurs. If there is a large number of time records, this gives rise to problems with the main memory and bad performance times. In particular, if positive recording has been implemented, the quantity of infotype records soon overloads the main memory. Reporting in HR Im p o rt in g T im e D a ta (2 ) INFOTYPES: 0001, 0002, ... 2005 MODE N. GET PERNR. RP_PROVIDE_FROM_LAST P0001 SPACE PN-BEGDA PN-ENDDA. . . . . RP_READ_ALL_TIME_ITY PN-BEGDA PN-ENDDA. . . . . LOOP AT P2005. WRITE... ENDLOOP. S A P A G 1999 To control the amount of time required to read time infotypes, MODE N is assigned to the infotypes in the declaration. This ensures that infotype tables are not filled when GET PERNR occurs. The time infotype tables are subsequently filled using the RP_READ_ALL_TIME_ITY macro, however, only in the specified period. Reporting in HR Importing Time Data to Internal Tables TYPES: BEGIN OF overtime, bukrs LIKE P0001-BUKRS, werks LIKE P0001-WERKS, btrtl LIKE P0001-BTRTL, stdaz LIKE P2005-STDAZ, END OF overtime. DATA: tab TYPE TABLE OF overtime WITH HEADER LINE. GET PERNR. RP_PROVIDE_FROM_LAST P0001 SPACE PN-BEGDA PN-ENDDA. MOVE-CORRESPONDING P0001 TO tab. RP_READ_ALL_TIME_ITY PN-BEGDA PN-ENDDA. LOOP AT P2005. MOVE-CORRESPONDING P2005 TO tab. COLLECT tab. (oder: APPEND tab.) ENDLOOP. bukrs werks btrtl stdaz Work area(header line) Data area SAP AG 1999 • If you want to evaluate absence data according to organizational units, it is a good idea to use an internal table to group together the information from different database tables (PA0001 and PA2005). Reporting in HR P ro c e s s in g T im e D a ta w ith In te rn a l T a b le s END-OF-SELECTION. L O O P A T ta b . A T F I R ST . ... ENDAT. AT NEW bukrs. ... ENDAT. ta b BUKRS 0 0 01 0 0 01 0 0 02 0 0 02 W ERKS 0 0 01 0 0 01 0 0 02 0 0 02 BTRTL 0 0 01 0 0 02 0 0 03 0 0 04 AT NEW werks. ... ENDAT. H ea d e r p ro c es sin g Single record processing A T E N D O F w e rk s . ... ENDAT. A T E N D O F b u kr s . ... ENDAT. F o o ter p ro ce ss in g S A P A G 199 9 A T L A S T. ... ENDAT. ENDLOOP. Reporting in HR Example report using ABAP List viewer REPORT zpsol060. *-- declaration TYPE-POOLS: slis. TABLES: pernr, t548t. INFOTYPES: 0001, 0041. DATA: BEGIN OF dtype, dar LIKE p0041-dar01, dat LIKE p0041-dat01, END OF dtype. "Date Types "Org.Assignment "Date Specifications "Workarea for IT0041 TYPES: BEGIN OF data_struc, "Data table structure pernr LIKE pernr-pernr, ename LIKE p0001-ename, eindt LIKE p0016-eindt, dar LIKE p0041-dar01, dtext LIKE t548t-dtext, dat LIKE p0041-dat01, END OF data_struc. DATA: data_tab TYPE TABLE OF data_struc, data_tab_wa TYPE data_struc. DATA: alv_fieldcat TYPE slis_t_fieldcat_alv, alv_layout TYPE slis_layout_alv. DATA: filled_lines LIKE sy-index, stru_disvar TYPE disvariant. Reporting in HR SELECT-OPTIONS: datetype FOR p0041-dar01 DEFAULT '01 *-- Processing GET pernr. DESCRIBE TABLE p0041 LINES filled_lines. IF filled_lines GT 0. rp_provide_from_last p0001 space pn-begda pn-endda. IF pnp-sw-found EQ 0. REJECT. ELSE. DO 12 TIMES VARYING dtype FROM p0041-dar01 NEXT p0041-dar02. IF dtype-dar IS INITIAL. EXIT. ELSE. IF dtype-dar IN datetype. rp_provide_from_last p0001 space pn-begda pn-endda CLEAR data_tab_wa. MOVE-CORRESPONDING p0001 TO data_tab_wa. MOVE-CORRESPONDING dtype TO data_tab_wa. PERFORM read_hiredate. PERFORM re548t USING sy-langu dtype-dar. MOVE t548t-dtext TO data_tab_wa-dtext. APPEND data_tab_wa TO data_tab. ENDIF. ENDIF. ENDDO. ENDIF. ENDIF. Reporting in HR END-OF-SELECTION. PERFORM fieldcat_init USING alv_fieldcat. alv_layout-colwidth_optimize = 'X'. alv_layout-zebra = 'X'. CALL FUNCTION 'REUSE_ALV_GRID_DISPLAY' EXPORTING * I_INTERFACE_CHECK ='' * I_BUFFER_ACTIVE ='' i_callback_program = 'ZPSOL060' * I_STRUCTURE_NAME = * I_BACKGROUND_ID ='' I_GRID_TITLE = 'Date Specifications' * I_GRID_SETTINGS = is_layout = alv_layout it_fieldcat = alv_fieldcat * I_DEFAULT = 'X' I_SAVE = 'A' IS_VARIANT = stru_disvar IT_EVENTS = IT_EVENT_EXIT = IS_PRINT = IS_REPREP_ID = I_SCREEN_START_COLUMN = 0 I_SCREEN_START_LINE =0 I_SCREEN_END_COLUMN =0 I_SCREEN_END_LINE =0 IT_ALV_GRAPHICS = IT_ADD_FIELDCAT = IT_HYPERLINK = IMPORTING E_EXIT_CAUSED_BY_CALLER = ES_EXIT_CAUSED_BY_USER = TABLES t_outtab = data_tab EXCEPTIONS program_error =1 OTHERS = 2. * * * * * * * * * * * * * * Reporting in HR *-------------------------------------------------------------* * FORM READ_HIREDATE *-------------------------------------------------------------* * Retrieving hiredate from infotype 0000 *-------------------------------------------------------------* FORM read_hiredate. CALL FUNCTION 'RP_GET_HIRE_DATE' EXPORTING persnr = p0001-pernr check_infotypes = '0000' IMPORTING hiredate = data_tab_wa-eindt EXCEPTIONS OTHERS = 1. ENDFORM. *-------------------------------------------------------------* * FORM RE548T * Read date specification texts *-------------------------------------------------------------* * --> VALUE(LANGUAGE) * --> VALUE(DTYPE) *-------------------------------------------------------------* FORM re548t USING value(language) value(dtype). CHECK t548t-sprsl NE language OR t548t-datar NE dtype. SELECT SINGLE * FROM t548t WHERE sprsl EQ language AND datar EQ dtype. IF sy-subrc NE 0. CLEAR t548t. ENDIF. ENDFORM. Reporting in HR *-------------------------------------------------------------* * FORM FIELDCAT_INIT *-------------------------------------------------------------* FORM fieldcat_init USING p_fieldcat TYPE slis_t_fieldcat_alv. DATA: ls_fieldcat TYPE slis_fieldcat_alv. CLEAR ls_fieldcat. ls_fieldcat-fieldname = 'PERNR'. ls_fieldcat-ref_tabname = 'PERNR'. ls_fieldcat-key = 'X'. APPEND ls_fieldcat TO p_fieldcat. CLEAR ls_fieldcat. ls_fieldcat-fieldname = 'ENAME'. ls_fieldcat-ref_tabname = 'P0001'. APPEND ls_fieldcat TO p_fieldcat. CLEAR ls_fieldcat. ls_fieldcat-fieldname = 'EINDT'. ls_fieldcat-ref_tabname = 'P0016'. APPEND ls_fieldcat TO p_fieldcat. CLEAR ls_fieldcat. ls_fieldcat-fieldname = 'DAR'. ls_fieldcat-ref_tabname = 'PERNR'. ls_fieldcat-ref_tabname = 'P0041'. APPEND ls_fieldcat TO p_fieldcat. CLEAR ls_fieldcat. ls_fieldcat-fieldname = 'DTEXT'. ls_fieldcat-ref_tabname = 'T548T'. APPEND ls_fieldcat TO p_fieldcat. CLEAR ls_fieldcat. ls_fieldcat-fieldname = 'DAT'. ls_fieldcat-ref_fieldname = 'DAT01'. ls_fieldcat-ref_tabname = 'P0041'. APPEND ls_fieldcat TO p_fieldcat. ENDFORM. Reporting in HR REPORTS IN PERSONNEL PLANNING Reporting in HR D a ta M o d e l re p o rts to / is lin e s u p e rv is o r of C o s t C e n te r A llo c a tio n O rg a n iz a tio n a l b e lo n g s t o in c o rp o ra te s is d e s c rib e d by d e s c rib e s is d e s c rib e d by is d e s c rib e d by C o s t c e n te r C o s t C e n te r A llo c a tio n b e lo n g s t o in c o rp o ra te s Job d e s c rib e s P o s itio n o c c u p ie s H o ld e r W o rk c e n te r d e s c rib e s Task P e rs o n /u s e r S A P A G 1999 Reporting in HR • Organizational Management is based on the idea of representing each element within an organization as a separate object with its own characteristics. These objects are created and maintained separately. Relationships are used to link one to the other (see graphic). This gives rise to a network that is flexible enough to facilitate personnel planning, projections, and evaluations. The cost center is an external object type because it is not maintained in Organizational Management. Customizing enables you to enhance the existing data model by defining new object types, for example, and establishing new relationships between the various object types. Each standard object type consists of two letters, whereas the customer namespace is 00 to 99. This data model (object types and relationships) also constitutes the basis of other applications within Personnel Planning, such as Training and Event Management (business event hierarchies) and Personnel Development (for example, qualification catalog). • • • Reporting in HR Relationship Betw een Jobs and Positions The job "describes" the position. The position "is described by" the job. Relationship A/B 007 Adm inistrative assistant for m arketing departm ent Adm inistrative assistant for executive board Job: Adm inistrative assistant Adm inistrative assistant for research departm ent SAP AG 1999 Reporting in HR • • "Job" is used as a general classification, such as secretary or head of department. More than one employee can have the same job. For example, twenty employees can have the job of secretary. A position is the assignment of an individual employee in your enterprise, for example, sales manager, secretary in the marketing department. You form the structure of your enterprise by creating positions and linking them to each other. • Reporting in HR O b je c t/In fo ty p e S ta tu s O b je c t R e la tio n s h ip (In fo typ e 1 0 0 0 ) (In fo typ e 1 0 0 1 ) P la n n e d S u b m itte d R e je c te d A c tiv e A p p ro v e d S A P A G 1999 Reporting in HR A status is assigned to each object/infotype. • Active means that an object or infotype record can be used at this time. • Planned means that an object or infotype record has been proposed but is not yet active, which means it cannot be used. • Submitted means that an object or infotype record is currently being checked by a person or group of persons before it is approved or rejected. • Approved means that a submitted object/infotype record has been accepted. • Rejected means that a submitted object/infotype record has not been approved. • You can create objects with the status "planned" or "active". Reporting in HR Evaluation Paths Organizational unit Job Position Person O C S P Org.unit O Org.unit S Position O Org.unit S Position Position P Person P Person Employee SAP AG 1999 Reporting in HR • An evaluation path describes a set of relationships between objects in a hierarchical structure. Evaluation path O-S-P, for example, describes the set of relationships found between organizational units, positions, and persons. Evaluation paths are used to select objects for structural evaluations. You choose an evaluation path, and the system evaluates the structure along the evaluation path. The report only evaluates objects that it finds in the specified evaluation path. Every standard report has a defined standard evaluation path. They are predetermined in the system and must not be changed. The standard selection screen enables you to choose evaluation paths. You can also create new evaluation paths to meet the particular requirements of your enterprise. Report RHWEGID0 displays all possible evaluation paths between the starting object type and the target object type. • • • Reporting in HR Available In ternal In form ation TABLES: OBJEC, GDSTR. INFOTYPES: nnnn. . . . GET OBJEC. LOOP AT Pnnnn . . . Pnnnn Internal infotype table O B JE C O bject inform ation G D STR R oot of structure ENDLOOP. STR U C Structure inform ation S A P A G 1999 Reporting in HR Sequential Evaluations-Coding TABLES: OBJEC. INFOTYPES: 0002, 1003, .... GET OBJEC. LOOP AT Pnnnn WHERE BEGDA LE PC-ENDDA AND ENDDA GE PC-BEGDA. WRITE... ENDLOOP. "Personal Data "Addresses SAP AG 1999 Reporting in HR S t r u c t u r a l E v a lu a t io n s - C o d in g TABLES: OBJEC, GDSTR. INFOTYPES: 0002, 1003, .... GET OBJEC. LOOP AT Pnnnn WHERE BEGDA AND ENDDA WRITE... ENDLOOP. "Personal Data "Addresses LE GE PC-ENDDA PC-BEGDA. S A P A G 1999 The only difference between a structural and sequential evaluation is the additional GDSTR entry in the TABLES statement. Reporting in HR E va lu a tin g T a b le In fo ty p e s INFOTYPES: 1002. "Description TABLES: OBJEC. DATA: ipt1002 LIKE PT1002 OCCURS 0 WITH HEADER LINE. . . . GET OBJEC. WRITE: / OBJEC-OTYPE, OBJEC-OBJID. LOOP AT P1002. RH-GET-TBDAT P1002-INFTY P1002-TABNR ipt1002. LOOP AT ipt1002. WRITE: / ipt1002-TLINE. ENDLOOP. ENDLOOP. S A P A G 1999 Reporting in HR • RH-GET-TBDAT is a macro for logical database PCH. These macros are defined in include DBPCHCOM. With this macro, you can import the data for an infotype with a repetitive structure. See also Table Infotypes. The parameters for macro RH-GET-TBDAT are: Parameter 1 : Infotype Parameter 2 : Reference field Parameter 3 : Table for structure PTnnnn Macros for logical database PCH must not be confused with macros for logical database PNP. Please note that you cannot use macros for logical databases PCH and PNP at the same time. • • Reporting in HR R ea d in g In fo typ e s W ith F u n c tio n M o d u les IN F OT Y PE S : 1 00 1 . " Re l at i on s hi p s DA T A: ih r ob j ec t L I KE HR O BJ E CT OC C UR S 1 0 . . . . CA L L F UN C TI O N ' RH _ RE A D_ I NF T Y' EX P OR T IN G . . . I NF T Y = ' 1 00 1 ' B EG D A = < b eg d at > E ND D A = < e nd d at > TA B LE S I NN N N = P 1 00 1 O BJ E CT S = i h ro b je c t EX C EP T IO N S A L L_ I NF T Y_ W IT H _S U BT Y = 1 N O TH I NG _ FO U ND = 2 N O _O B JE C TS = 3 W R ON G _C O ND I TI O N = 4 O T HE R S = 5. S A P A G 1999 Reporting in HR • RH-GET-TBDAT is a macro for logical database PCH. These macros are defined in include DBPCHCOM. With this macro, you can import the data for an infotype with a repetitive structure. See also Table Infotypes. The parameters for macro RH-GET-TBDAT are: Parameter 1 : Infotype Parameter 2 : Reference field Parameter 3 : Table for structure PTnnnn Macros for logical database PCH must not be confused with macros for logical database PNP. Please note that you cannot use macros for logical databases PCH and PNP at the same time. • • Reporting in HR Example Report REPORT zhsol010. TABLES: objec, gdstr. INFOTYPES: 0002, 0006, 1003. DATA: stabs LIKE p1003-stabs, name LIKE p0001-ename. INITIALIZATION. pchotype = 'O'. pchwegid = 'O-S-P'. Reporting in HR GET objec. IF objec-otype = 'S'. CLEAR stabs. LOOP AT p1003 WHERE begda LE pc-endda AND endda GE pc-begda. IF p1003-stabs = 'X'. stabs = 'X'. WRITE : / objec-objid, objec-short, objec-stext. ENDIF. ENDLOOP. ENDIF. IF objec-otype = 'P' AND stabs = 'X'. PROVIDE vorna nachn FROM p0002 subty telnr FROM p0006 BETWEEN pc-begda and pc-endda WHERE p0006-subty = '1'. IF p0006_valid = 'X'. CONCATENATE p0002-vorna p0002-nachn INTO name SEPARATED BY SPACE. WRITE: / name, p0006-telnr. SKIP. ENDIF. ENDPROVIDE. ENDIF. Reporting in HR READING CLUSTER DATA Reporting in HR Export The syntax for exporting the data to cluster table is EXPORT var1…varn itab1 itab2…itabn TO DATABASE dbtab(ID) [FROM wa] ID key. Import The syntax for exporting the data to cluster table is IMPORT var1…varn itab1 itab2…itabn FROM DATABASE dbtab(ID) [TO wa ] ID key. Reporting in HR E x p o r tin g D a ta TABLES: PCLn. INCLUDE: RPCnxxy0. * Fill cluster-KEY "Import/export table "Cluster definition xy-KEY-FIELD = <VALUE>. . . . . * Fill data object * Export record TO DATABASE PCLn(xy) ID xy-KEY. EXPORT IF TABLE1 SY-SUBRC EQ 0. WRITE: / 'Update ENDIF. successful'. S A P A G 1999 The cluster definition is included using the INCLUDE statement. The EXPORT command writes one or more data objects with xy-KEY to cluster xy. If the export is successful, the return code is 0. Reporting in HR E x p o rt U s in g B u ffe r * Buffer definition INCLUDE: RPPPXD00. DATA: BEGIN OF COMMON PART buffer. INCLUDE RPPPXD10. DATA: END OF COMMON PART buffer. . . . * Data export to buffer RP-EXP-Cn-xy. RP-EXP-Cn-xy. . . . * Save PERFORM PREPARE_UPDATE USING 'V'. . . . * Buffer Administration Routines INCLUDE: RPPPXM00. M a in m e m o ry b u ffe r PCLn xy S A P A G 1999 Reporting in HR • If data is exported using macros, the data records are not written directly to the database. Instead, they are written to a main memory buffer. The data is diverted by a USING parameter in the EXPORT statement, which accesses a buffer administration routine. If data is exported successfully, the RP-IMP-xySUBRC = 0 return code is set. At the end of the program, the buffered records must be saved on a PCLn database. To save the data, the PREPARE_UPDATE routine is accessed with USING parameter V. • • • Reporting in HR C L U S T E R - D e fin itio n in P r o g r a m R p c n x y z 0 * KEY-Definition DATA: BEGIN OF xy-key, FIELD1, FIELDn, END OF xy-key. * Definition of Data Objects DATA: BEGIN OF table1 OCCURS 10, COLUMN1, COLUMNn, END OF table1. DATA: BEGIN OF table2 OCCURS 10, . . . S A P A G 1999 Reporting in HR • • • • • • The data definitions of a work area are stored in separate programs using a fixed naming convention. They are defined as INCLUDE programs. Their names follow convention RPCnxyz0, where. n = 1 or 2 for PCL1 or PCL2 xy = Cluster, for example, RX z = 0 for international clusters or country indicator from table T500L for country-specific clusters. Example: The program RPC1TX00 contains the data definition of cluster TX. In this cluster, the database table PCL1 contains the texts stored for infotypes. The key structure of the cluster is stored in a field string xyKEY where the personnel number is the first element. The data objects (field strings and tables) are named individually per cluster. • • Reporting in HR Im p o r t in g D a ta TABLES: PCLn. INCLUDE: RPCnxyz0. "Import/export table "Cluster definition * Fill Cluster-KEY xy-KEY-FIELD1 = <VALUE>, . . . * Import Record IMPORT table1 table2 FROM DATABASE PCLn(xy) ID xy-KEY. * Display Data object IF SY-SUBRC EQ 0. LOOP AT table1. WRITE. . . ENDLOOP. ENDIF. S A P A G 1999 The IMPORT command reads data objects with the specified key values from the import/export database table. If a record is read successfully, the return code is 0. If a record is not read successfully, the return code is 4. Reporting in HR Importing/Exporting With Macros Macro H ic PAYM ACRO DEFINE RP-IMP-Cn-xy. IMPORT table1 table2 . . . . . . FROM DATABASE PCLn(xy) ID xy-KEY USING PCLn_EXP_IMP. END-OF-DEFINITION. ... RP-IMP-Cn-xy. ... SAP AG 1999 Reporting in HR • • • • To ensure consistency when data is exported and imported, the IMPORT/EXPORT commands are defined as macros. It is possible to import only a portion of the data objects in a cluster. The naming conventions for the macros are RP-IMP-Cn-xy and RP-EXP-Cn-xy, where n is the file name and xy is the cluster name. The macros for the import of payroll results are defined in include programs for the payroll driver with the name HicPAYMACRO (ic = ISO code, for example, HUSPAYMACRO for the USA) using the DEFINE keyword. These include programs are generated and must not be changed manually. The macro for importing infotype texts to cluster TX is contained in the table Macros in ABAP Programs. The macros use routines that carry out two tasks: 1. Data buffering 2. Cluster authorization check • • Reporting in HR Im p o r t in g /E x p o r t in g U s i n g a B u f f e r P ro g ra m E x p o rt UPDATE PCLn Im p o r t B u ffe r S A P A G 1999 Reporting in HR • To minimize the number of times that the database is accessed, import and export data is buffered in the main memory. If a test run is performed, the database is not updated. However, the payroll results of the previous period form the basis of the calculation used to determine the results of the subsequent period. For this reason, a difference arises between the results of a live payroll run and the results of a test run if test runs are performed for several periods. Using the buffer enables you to access the required results from the previous period. • • Reporting in HR Im p o rtin g U s in g a B u ffe r * Buffer definition INCLUDE: RPPPXD00. DATA: BEGIN OF COMMON PART BUFFER. INCLUDE RPPPXD10. DATA: END OF COMMON PART buffer. * Fill cluster KEY . . . * Data import RP-IMP-Cn-xy. . . . * Buffer Administration Routines INCLUDE: RPPPXM00. M a in m e m o ry b u ffe r PCLn xy S A P A G 1999 Reporting in HR • If data is imported using macros, the data records are not read directly from table PCLn. Instead, the buffer directory is checked to determine whether the main memory already contains a record with the same key. If this is not the case, the record is read from PCLn to the buffer, and retrieved from the buffer by the report. If data is read using a buffer, the system checks the cluster authorization. The standard import programs follow the RPCLSTxy naming convention, where xy = cluster name. • Reporting in HR Example program to read data from PCL1 Cluster This example reads long text data from Infotype 0024. REPORT ZRP_READ_PCL1_TX. TABLES: pernr. INFOTYPES 0024 NAME qualifications. INCLUDE rpc1tx00. START-OF-SELECTION. GET pernr. rp_provide_from_last qualifications space pn-begda pn-endda. tx-key-pernr = qualifications-pernr. tx-key-infty = qualifications-infty. tx-key-subty = qualifications-subty. tx-key-objps = qualifications-objps. tx-key-sprps = qualifications-sprps. tx-key-endda = qualifications-endda. tx-key-begda = qualifications-begda. tx-key-seqnr = qualifications-seqnr. rp-imp-c1-tx. LOOP AT ptext. WRITE ptext-line. ENDLOOP. Reporting in HR Example program to read data from PCL1 Cluster This example reads data from PCL1 for RELID B1. REPORT ZRP_READ_PCL1_B1. TABLES: pernr. INCLUDE rpc1b100. START-OF-SELECTION. GET pernr. b1-key-pernr = pernr-pernr. * rp-imp-c1-b1. IMPORT nt1 nt2 ift1 ift2 ert nct qt st itp1 itp7 itp50 pdppm FROM DATABASE pcl1(b1) ID b1-key. Reporting in HR Example program to read data from PCL2 Cluster This example reads data from PCL2 for RELID B2. REPORT ZRP_READ_PCL2_B2. TABLES: pernr. INCLUDE rpc2b200. START-OF-SELECTION. GET pernr. b2-key-pernr = pernr-pernr. b2-key-pabrj = pn-begda+0(4). b2-key-pabrp = pn-begda+4(2). b2-key-cltyp = '1'. *** ZL --> Time Wage Types (Table ZL) IMPORT zl FROM DATABASE pcl2(b2) ID b2-key. LOOP AT zl. *** Process the itab zl.... ENDLOOP. Reporting in HR Payroll International Payroll driver program: RPCALCX0 Reporting in HR The international payroll driver program is RPCALCX0. We are having customized payroll driver programs for most of the countries viz: 1. RPCALCA0 for Austria 2. RPCALCC0 for Switzerland 3. RPCALCD0 for Germany 4. RPCALCE0 for Spain 5. RPCALCG0 for Great Britain 6. RPCALCU0 for USA 7. HINCALC0 for India 8. HBRCALC0 for Brazil etc. Reporting in HR Display Payroll results Program: RPCLSTRX Reporting in HR Reporting in HR Reporting in HR P a y r o ll R e s u lts REPORT H99_DISPLAY_PAYRESULT P a y r o ll r e s u lt K a th y C a lc W T01 W T02 W T03 /1 0 1 . . . . J a n u a ry 1 9 x x UNI UNI UNI UNI S t a n d a r d s a la r y 5 0 0 0 Bonus 300 O v e r tim e 200 T o ta l g r o s s a m t 5 5 0 0 S A P A G 1999 Reporting in HR • With this report, you can display the payroll results for any country. The indicator behind each name shows whether results exist in the selected period. Green: Results exist Red: No results exist Gray: No authorization for displaying personnel numbers Payroll results are stored as structures and internal tables on the database. Each payroll result has a status indicator: 1. 2. 3. A P O = = = Current result Previous result All other results • • Reporting in HR D a ta F lo w in P a y ro ll S c h e m a s & ru le s PAnnnn RPC ALCn0 PCL2 PCL2 xy xy H 9 9 _ D IS P L A Y _ P A Y R E S U L T R PCE D Tn0 S A P A G 1999 Reporting in HR • The payroll driver, RPCALCn0, uses HR data (stored in the database tables PAnnnn) and the last payroll result (stored in the database table PCL2) to run the payroll for the specified period The program (payroll driver) imports the processing logic in the form of a schema. The schema contains functions that call the subroutines contained in the payroll driver. In many cases, the function is enhanced by rules for specific control of the subroutines. The payroll result generated by the payroll driver is stored in cluster xy of the database table PCL2. Report H99_DISPLAY_PAYRESULT displays the payroll results for PCL2 and, from Release 4.6C, replaces reports RPCLSTxy and HxyCLSTR. The report is used in all country versions and the overview of payroll results is automatically displayed according to the particular country. Report RPCEDTn0, for example, lists the formatted result as a payroll form (n = HR country indicator from table T500L). • • • • Reporting in HR R e a d in g th e C lu s te r D ir e c to ry *Table containing directory of payroll results DATA: BEGIN OF RGDIR OCCURS 100. INCLUDE STRUCTURE PC261. DATA: END OF RGDIR. DATA: COUNTRY LIKE T001P-MOLGA. ... CALL FUNCTION 'CU_READ_RGDIR' EXPORTING PERSNR = PERNR-PERNR IMPORTING MOLGA = country TABLES IN_RGDIR = RGDIR EXCEPTIONS NO_RECORD_FOUND = 1 OTHERS = 2. S A P A G 1999 Reporting in HR • Table RGDIR contains the directory (cluster directory) for all of an employee's payroll results and is contained in cluster CU. A directory entry with the payroll area, forperiod, in-period, status indicator, and the five-digit sequence number is required, together with the personnel number, to construct the key for each payroll result for an employee. The function module CU_READ_RGDIR reads table RGDIR from cluster CU. The personnel number whose payroll directory is to be read is transferred to the function module. If the MOLGA parameter is active, the function module returns the HR country indicator. • • Reporting in HR D eterm in in g C u rren t P a yro ll R esu lt (1 ) DATA: number LIKE PC261-SEQNR. . . . GET PERNR. . . . CALL FUNCTION 'CU_READ_RGDIR' . . . CALL FUNCTION 'CD_READ_LAST' EXPORTING BEGIN_DATE = PN-BEGDA END_DATE = PN-ENDDA IMPORTING OUT_SEQNR = number TABLES RGDIR = RGDIR EXCEPTIONS NO_RECORD_FOUND = 1 OTHERS = 2. S A P A G 1999 Reporting in HR • The function module CD_READ_LAST determines the current payroll result for a for-period to be evaluated. To determine the correct start date and end date of the for-period, you specify the period by entering the payroll period in the selection screen. If you specify report class XXM00004 in the attributes of your report, the payroll period is entered and the start date (PNBEGDA) and the end date (PN-ENDDA) are determined using the Payroll Periods table (T549Q). You enter the start and end date of the for-period for the evaluation as well as table RGDIR. The function module then gives you the sequential number (OUT_SEQNR) for the current (A) result of the for-period. You can also use the following function modules: CD_READ_PREVIOUS (reads the record that precedes the payroll record) CD_READ_PREVIOUS_ORIGINAL (reads the last original result that precedes the original payroll result) • • Reporting in HR D e te r m in in g C u r re n t P a y r o ll R e s u lt (2 ) DATA: result TYPE PAY99_RESULT. DATA: rt_header TYPE LINE OF HRPAY99_RT. . . . CALL FUNCTION 'PYXX_READ_PAYROLL_RESULT' EXPORTING CLUSTERID = 'RX' EMPLOYEENUMBER = p0001-pernr SEQUENCENUMBER = number * READ_ONLY_BUFFER = ' ' * READ_ONLY_INTERNATIONAL = ' ' * CHECK_READ_AUTHORITY = 'X' . . . CHANGING PAYROLL_RESULT = result EXCEPTIONS . . LOOP AT result-INTER-RT INTO rt_header. WRITE: / rt_header-LGART, ... ENDLOOP. S A P A G 1999 Reporting in HR • With the function module PYXX_READ_PAYROLL_RESULT, you can read a complete payroll result from the database table PCL2 or from the buffer. The payroll result is then transferred to parameter PAYROLL_RESULT. This mmust be declared in the calling report as a complex structure that corresponds to structure PAYic_RESULT (ic = ISO code). With the READ ONLY INTERNATIONAL parameter, you can specify that only the international part is imported. The READ_ONLY_BUFFER means that the database is not accessed. If the parameter CHECK_READ_AUTHORITY is active and set to blank, the cluster authorization check is deactivated. Anonymous evaluations can then be carried out by users without cluster authorizations. • • Reporting in HR D a ta S tru c tu re fo r P a yro ll R e s u lts S tru ctu re : P A Y 9 9 _ R E S U L T EVP S tru c tu re P C 26 1 IN T E R S tru c tu re P AY 9 9_ IN T E R N A T IO N A L N AT BT D um m y fo r n a tio n a l p a rt VERSC Type P C 202 RT Type H R P AY99_R T CRT Type H R P AY99_C R T DATA: result TYPE PAY99_RESULT. DATA: rt_header TYPE LINE OF HRPAY99_RT. . . . * Access to payroll result data WRITE: result-INTER-VERSC-FPPER, . . . LOOP AT result-INTER-RT INTO rt_header. WRITE: / rt_header-LGART, . . . ENDLOOP. S A P A G 1999 Reporting in HR • The data structures for the international payroll results (RX) are described in the Dictionary in structure PAY99_RESULT. The structure contains the components EVP (directory information), INTER (international), and NAT (country-specific part). The components INTER and NAT also contain the tables (for example, RT, CRT, and so on) and field strings (for example, VERSC) for the payroll results as substructures. In cluster RX, NAT consists of a dummy field. The structures PAYic_RESULT (ic = ISO code, for example, PAYUS_RESULT for the USA) exist for the country-specific results. Here, the component NAT contains the substructures for the country-specific results. If you want to evaluate payroll results, you need a data structure with the type PAYic_RESULT. For each table in the payroll results to be processed, you need a header with the type HRPAYic_table name (for example, HRPAY99_RT for the results table RT). • • Reporting in HR C o u n tr y -S p e c ific P a y ro ll R e s u lts L in e typ e : P A Y ic _ R E S U L T EVP S tr u c tu re P C 2 6 1 IN T E R S tru c tu re P A Y 9 9 _ IN T E R N A T IO N A L N AT BT VERSC Type P C 202 RT Type H R P AY99_R T CRT Type H R P AY99_C R T s tru c tu re P A Y ic _ N A T IO N A L ta b le T y p e H R P A Y ic _ ta b le D A T A : r e s u l t _ t a b T Y P E P A Y ic _ R E S U L T OCCURS 0 WITH HEADER LINE, r e s u l t _ h e a d e r T Y P E P A Y ic _ R E S U L T . D A T A : t a b l e _ h e a d e r T Y P E L I N E O F H R P A Y ic _ t a b l e . ... LOOP AT result_tab INTO result_header. . . . LOOP AT result_header-NAT-table INTO table_header. WRITE. . . ENDLOOP. ENDLOOP. S A P A G 1999 Reporting in HR Example program for reading and processing of payroll results - 1 REPORT zpsol090. TABLES: pernr, t512t, t549a. "Payroll areas INFOTYPES: 0001. "Organizational Assignment DATA: result_tab TYPE hrpay99_tab_of_results, result_header TYPE pay99_result. Reporting in HR DATA: rgdir LIKE pc261 OCCURS 0 WITH HEADER LINE. DATA: period LIKE pc261-inper. SELECT-OPTIONS: p_status FOR result_header-evp-srtza DEFAULT 'A'. START-OF-SELECTION. SELECT SINGLE * FROM t549a WHERE abkrs = pnpxabkr. period = pn-paper. Reporting in HR GET pernr. rp_provide_from_last p0001 space pn-begda pn-endda. CALL FUNCTION ‘PYXX_GET_EVALUATION_PERIODS’ EXPORTING clusterid = 'RX' employeenumber = p0001-pernr inper_modif = t549a-permo inper = period TABLES rgdir = rgdir evaluated_periods = result_tab EXCEPTIONS no_payroll_results = 1 no_entry_found_on_cu = 2 import_error =3 OTHERS = 4. Reporting in HR IF sy-subrc NE 0. WRITE: / 'No payroll result found for'(001), pn-paper. ELSE. LOOP AT result_tab INTO result_header. CHECK p_status. PERFORM print_rx. ENDLOOP. ENDIF. Reporting in HR *-------------------------------------------------------------* * FORM PRINT_RX *-------------------------------------------------------------* * Print Payroll Result *-------------------------------------------------------------* FORM print_rx. FORMAT INTENSIFIED ON. WRITE: / p0001-pernr, (15) p0001-ename, p0001-werks, p0001-btrtl. FORMAT INTENSIFIED OFF. SKIP 1. WRITE: / 'For period/payroll area: '(003), 30 result_header-inter-versc-fpper+4(2), result_header-inter-versc-fpper+0(4), result_header-inter-versc-abkrs, / 'In-period/payroll area: '(004), 30 result_header-inter-versc-inper+4(2), result_header-inter-versc-inper+0(4), result_header-inter-versc-iabkrs. SKIP 1. WRITE: 'Results table: '(005). SKIP 1. Reporting in HR LOOP AT result_header-inter-rt INTO rt_header. PERFORM re512t USING result_header-inter-versc-molga rt_header-lgart. WRITE: / rt_header-lgart, T512T-LGTXT, rt_header-betrg CURRENCY rt_header-amt_curr. ENDLOOP. ENDFORM. *-------------------------------------------------------------* * FORM RE512T *-------------------------------------------------------------* * Read Wage Type Texts *-------------------------------------------------------------* FORM re512t USING value(country_grouping) value(wtype). CHECK t512t-sprsl NE sy-langu OR t512t-molga NE country_grouping OR t512t-lgart NE wtype. SELECT SINGLE * FROM t512t WHERE sprsl EQ sy-langu AND molga EQ country_grouping AND lgart EQ wtype. IF sy-subrc NE 0. CLEAR t512t. ENDIF. ENDFORM. Reporting in HR Example program for reading and processing of payroll results – 2 Reading RT results REPORT zhpyr00134 NO STANDARD PAGE HEADING LINE-SIZE 130 LINE-COUNT 60. * Declare internal tables TABLES: pernr, t511. INFOTYPES: 0000, 0001, 0002. DATA: BEGIN OF gt_data OCCURS 0, pernr LIKE p0000-pernr, perid LIKE p0002-perid, sname LIKE p0001-sname, lgart LIKE t511-lgart, betrg LIKE pc207-betrg, bukrs LIKE p0001-bukrs, END OF gt_data. SELECTION-SCREEN BEGIN OF BLOCK 1 WITH FRAME TITLE text-h00. SELECT-OPTIONS: s_stat2 FOR p0000-stat2. SELECT-OPTIONS: s_lgart FOR t511-lgart OBLIGATORY. SELECTION-SCREEN END OF BLOCK 1. Reporting in HR START-OF-SELECTION. GET pernr. rp-provide-from-last p0000 space pn-begda pn-endda. IF pnp-sw-found NE '1' OR NOT p0000-stat2 IN s_stat2. REJECT. ENDIF. rp-provide-from-last p0001 space pn-begda pn-endda. IF pnp-sw-found NE '1'. REJECT. ENDIF. rp-provide-from-last p0002 space pn-begda pn-endda. IF pnp-sw-found NE '1'. REJECT. ENDIF. PERFORM get_payroll. END-OF-SELECTION. PERFORM disp_result. Reporting in HR **************************************************************** FORM get_payroll. **************************************************************** DATA: ls_hrpy_rgdir LIKE hrpy_rgdir. DATA: lt_payresult TYPE payus_result, lt_rt LIKE pc207 OCCURS 0 WITH HEADER LINE. DATA: lw_fpper LIKE hrpy_rgdir-fpper. IF pnppabrp IS INITIAL. CONCATENATE pnpdispj pnpdispp INTO lw_fpper. ELSE. CONCATENATE pnppabrj pnppabrp INTO lw_fpper. ENDIF. SELECT SINGLE * INTO ls_hrpy_rgdir FROM hrpy_rgdir WHERE pernr = pernr-pernr AND fpper = lw_fpper AND abkrs = p0001-abkrs AND srtza = 'A'. IF sy-subrc NE 0. EXIT. ENDIF. CLEAR gt_data. gt_data-pernr = pernr-pernr. gt_data-perid = p0002-perid. gt_data-sname = p0001-sname. gt_data-bukrs = p0001-bukrs. Reporting in HR CALL FUNCTION 'PYXX_READ_PAYROLL_RESULT' EXPORTING clusterid = 'RU' employeenumber = ls_hrpy_rgdir-pernr sequencenumber = ls_hrpy_rgdir-seqnr CHANGING payroll_result = lt_payresult EXCEPTIONS illegal_isocode_or_clusterid = 1 error_generating_import =2 import_mismatch_error =3 subpool_dir_full =4 no_read_authority =5 no_record_found =6 versions_do_not_match =7 OTHERS = 8. IF sy-subrc NE 0. APPEND gt_data. EXIT. ENDIF. lt_rt[] = lt_payresult-inter-rt[]. LOOP AT lt_rt WHERE lgart IN s_lgart. gt_data-lgart = lt_rt-lgart. gt_data-betrg = lt_rt-betrg. APPEND gt_data. ENDLOOP. ENDFORM. "get_payroll Reporting in HR **************************************************************** FORM disp_result. **************************************************************** SORT gt_data BY pernr. IF p_dwnld = 'X'. LOOP AT gt_data. WRITE:/1 gt_data-pernr, 10 gt_data-perid USING EDIT MASK '___-__-____', 22 gt_data-sname(25), 50 gt_data-bukrs, 65 gt_data-lgart, 71 gt_data-betrg. ENDLOOP. ELSE. FORMAT COLOR COL_HEADING INTENSIFIED ON. WRITE:/1(130) 'Employee#', 15 'S.S#', 30 'Name', 60 'Company Code'. WRITE:/1(130) sy-uline. Reporting in HR LOOP AT gt_data. AT NEW pernr. FORMAT COLOR COL_HEADING INTENSIFIED OFF. READ TABLE gt_data INDEX sy-tabix. WRITE:/1(130) gt_data-pernr, 15 gt_data-perid USING EDIT MASK '___-__-____', 30 gt_data-sname, 60 gt_data-bukrs. ENDAT. IF gt_data-lgart IS NOT INITIAL. FORMAT COLOR COL_NORMAL INTENSIFIED OFF. WRITE:/1(130) '', 15 'Wage type/Amount >>>', 40 gt_data-lgart, 60(15) gt_data-betrg. ENDIF. ENDLOOP. ENDIF. SKIP 2. FORMAT COLOR COL_BACKGROUND INTENSIFIED OFF. WRITE:/1(130) '>>> End of Report <<<' CENTERED. SKIP 1. ENDFORM. "disp_result User Exits and BAdIs Some of the user Exits available are: 1. 2. 3. 4. 5. PBAS0001 PA: Pers.Admin./Recruitment: Default values and checks HRCTRCU0 Enhancement for Customer Exits for RPCTRCU0. RHALE001 HR-CA: Enhancement for ALE functionality in HR PCMP0009 Compensation Management: Calculation Base PCMP0010 Compensation Management: Activate Compensation Adjustments User Exits and BAdIs 1. PBAS0001 PA: Pers.Admin./Recruitment: Default values and checks This is mainly used for validation of infotype entries when maintaining data through PA40 or PA30 transactions. Two Function modules EXIT_SAPFP50M_001 and EXIT_SAPFP50M_002 are associated with this Enhancement. The first one is called in PBO module and second one in PAI module. Reporting in HR Goto transaction CMOD Reporting in HR Reporting in HR The function exit EXIT_SAPFP50M_001 allows you to enter Defaultvalues in the single screen when you are creating or copying infotypes. The following are available for determining these default values: TCLAS INNNN the transaction class (A= employees, B= applicants) the infotype created IPSYST workfields for dialog control and selected fields for organizational assignment (IT 0001) that are valid on the start date of the current record (INNNN-BEGDA). I001P Table T001P (Personnel Subareas) determined with the current organizational assignment (IPSYST-WERKS, IPSYST-BTRTL), I503 Table T503 (Employee Subgroups) determined with the current organizational assignment (IPSYST-PERSG, IPSYST-PERSK). IPREF Assignment values for HR objects Reporting in HR Based on this data, the additional data can be returned to parameter INNNN. Error messages or exceptions are not provided for in this function exit. Note the following: 1 The function exit is executed when you Create or Copy a record. 2 As long as the enhancement is active, the function exit is called up for every infotype, as the following steps are necessary: - declaration of structure with desired infotype structure (I0008 LIKE P0008) - infotype query in CASE statement - temporary storage of transfer parameter INNNN in infotype structure - an example of the coding for this function exit is stored in include LXPADF01. Reporting in HR The function exit EXIT_SAPFP50M_002 allows you to execute an additional check after entries have been made on the single screen and the fields have been verified. The following are available for determining these default values: TCLAS the transaction class (A= employees, B= applicants) INNNN the infotype created PSAVE Infotype prior to modification IPSYST workfields for dialog control and selected fields for organizational assignment (IT 0001) that are valid on the start date of the current record (INNNN-BEGDA). I001P Table T001P (Personnel Subareas) determined with the current organizational assignment (IPSYST-WERKS, IPSYST-BTRTL), I503 Table T503 (Employee Subgroups) determined with the current organizational assignment (IPSYST-PERSG, IPSYST-PERSK). IPREF Assignment values for HR objects Reporting in HR Created infotype records will be returned INNNN. Error messages can be returned. Note: 1. You can still change the created infotype record in function exit. Whoever is responsible for the enhancement project must make sure that the field contents are consistent! In order to that field values can be displayed again, Show_data_again must be switched on. 2. As soon as the enhancement is active, the function exit will be called up for each infotype. The following steps are required in order to do this: - Declaration of a field string with the desired infotype structure (I0008 LIKE P0008) - Query of infotype in a case statement - Store transfer parameter INNNN temporarily in the infotype field string - Determine the default value - Return infotype to transfer parameter INNNN 3. There is an example of the coding for this function exit in include LXPADF01. Reporting in HR Function Module EXIT_SAPFP50M_001 Reporting in HR Reporting in HR Function Module EXIT_SAPFP50M_002 Reporting in HR Reporting in HR Reporting in HR Business Add-Ins (BAdI) Business add-ins are programmer-defined places in source code where software customers (industry sectors, partners, customers, and so on) can add their own code, without modifying the original object. Business add-ins are designed for users who require certain functions in the R/3 System that are too specialized to be included in the standard system, but are needed often, and therefore have been designed to be integrated into the R/3 System. A user who wants to use a business add-in can create their own during implementation, or use one of the delivered standard solutions. The interface of a business add-in is forward compatible, thus ensuring that these add-ins and their interface still function after a release upgrade. They do not need to be registered in SSCR. While customer exits (enhancements using SMOD/CMOD) are designed for use in a twolevel system landscape (SAP, customers), business add-ins are designed for use in a multiple-level system landscape (SAP, country versions, IS solutions, partners, customers, and so on). Business add-ins can be created at any level of the system landscape. In addition, business add-ins can be created and delivered at all software levels. Enhancements created using business add-ins can be implemented either exactly once, or for an infinite number of customers simultaneously. Business add-ins can also be defined according to a filter (for example, an add-in could be implemented according to "country" or other criteria). Interfaces can be designed for ABAP source code, screens, GUI interfaces, and tables. Customers can then add their own enhancements to the standard system. Interfaces are required to execute a task are combined in one business add-in. Reporting in HR BAdI for PA Infotypes Now let me explain the method of creating implementation/s for a BAdI with the example of HRPAD00INFTY. Go to Transaction: SE18 Enter the definition name as HRPAD00INFTY. Reporting in HR Click on the display button. The following screen appears. Reporting in HR By seeing the attributes we can make out that this is a Multiple use BAdI which means there can be more than one active implementation at a time. Choose the menu Implementation Overview. The following screen will appear which suggests that PY_UPD_T5RIC is the active implementation for the BAdI which is a standard one. Is this BAdI a complete replacement for the enhancement PBAS0001? Yes. The enhancement PBAS0001 can be completely avoided by the BAdI. Reporting in HR How to implement our own Implementation of the BAdI Definition? Choose the menu Implementation Overview. The following screen will appear. Click on the create button The following popup appears. Enter the new implementation name as ZRAJESH_P_NAIR_INFTY (for Example) and press enter. The following screen will appear. Enter the description of the implementation and save it. Reporting in HR Now select the interface tab Reporting in HR Reporting in HR Here we are having three methods viz: BEFORE_OUTPUT (PBO) - Equivalent to EXIT_SAPFP50M_001 of the enhancement PBAS0001. AFTER_INPUT (PAI) - Equivalent to EXIT_SAPFP50M_002 of the enhancement PBAS0001. IN_UPDATE (While Saving the Infotype) We can write our code inside any of the methods depending upon the requirement. For Example, let us take a scenario; In Info Type 0001 if the employee subgroup is “1A” then the payroll area entered should be only “01”. Let us how can we implement this using BADI. Obviously, we have to write the code in the method “AFTER_INPUT”. Reporting in HR The code is as follows: METHOD if_ex_hrpad00infty~after_input. DATA p0001 TYPE p0001. CASE new_innnn-infty. WHEN '0001'. p0001 = new_innnn. IF p0001-persk = '1A' AND p0001-abkrs NE '01'. MESSAGE e000(fv) WITH 'Only payroll area 01 is allowed' ' for emp subgroup 1A’. ENDIF. ENDCASE. ENDMETHOD. Reporting in HR For viewing the parameters which can be accessed inside the method, we can use the “Signature” button in the application toolbar. Screen with signature option Reporting in HR Screen without signature option Reporting in HR Activating the BAdI: So far we have identified the BAdI definition created our own implementation and written our own code. Now the final step is activating the BAdI. As discussed earlier, ours is a multiple use BAdI that means the activation of our implementation will not affect the existing active implementations. If we do not want the existing active implementation, we can deactivate it. For activating, we can go to the transaction SE19 and enter the implementation name as ZRAJESH_P_NAIR_INFTY and click on the activate icon in the application toolbar. We will get a message “BAdI implementation ZRAJESH_P_NAIR_INFTY has been activated!” upon activation. Reporting in HR Reporting in HR You can even do the activation of the implementation from the BAdI definition itself. Note: If the active implementation is of standard SAP, then we can deactivate it easily, but if we want to activate it again we need the access key. Now let us see how this is affected in PA30 transaction for Info Type 0001. Reporting in HR Now let us see how this is affected in PA30 transaction for Info Type 0001. Go to Transaction PA30. Enter the Personnel Number as 92510(Example). Reporting in HR Click on change icon and goto the next screen. Enter the payroll area as W0. Reporting in HR Now we will get the error message as follows: Reporting in HR De-activating the BAdI: For de-activating, we can go to the transaction SE19, enter the implementation name as ZRAJESH_P_NAIR_INFTY, and click on the Deactivate icon in the application toolbar. Reporting in HR We will get a message “BAdI implementation ZRAJESH_P_NAIR_INFTY has been deactivated!” upon deactivation. Authorization Objects in HR All the HR related Authorization objects are included in the Authorization Class HR. Goto SU21 transaction select the authorization class HR (Human Resources) and it will list all the authorization objects associated with it. Reporting in HR Authorization Objects in HR Some of the important HR authorization Objects are described below: Object: PLOG Personnel Planning Fields: PLVAR Plan Version OTYPE Object Type INFOTYP Infotype SUBTYP Subtype ISTAT Planning Status PPFCODE Function Code Definition: The present object is used by the authorization check for PD data. Authorization Objects in HR Field Details: PLVAR - Plan version This field defines which plan version(s) the user may access. OTYPE - Object type This field defines which object types the user may access. INFOTYP - Infotype This field defines, which infotypes, that is, attributes, of an object the users (generally) may access. SUBTYP - Subtype This field determines which subtypes the user may access for given infotypes. Relationships are special subtypes for infotype 1001. Consequently, the relationships for which a user should have access authorization can also be limited in this field. ISTAT_D - Planning status This field determines in which planning status the user may access information. OKCODE - Function code This field defines for which type of information processing (Display, Change ) the user is authorized. The possible values are defined in table T77FC. This protection against unauthorized access is extended by the structural authorization check. Two types of function codes are distinguished in HR management. By marking the processing method Maintenance in table T77FC the function codes are indicated, with which objects may be maintained within the structure; Otherwise, only Display is allowed. The function code has effects in connection with the structural authorization. In table T77PR, authorization profiles can be indicated which are to have maintenance authorization for the structure. Without this authorization, you can only display structures. Consequently, the overall authorization results from the intersection between basis authorization and structural authorization. Authorization Objects in HR Object: P_ABAP HR: Reporting Fields: REPID ABAP Program Name COARS Degree of simplification for authorization check Definition: The authorization object HR reporting (P_ABAP) is used in many ways: HR Reporting with HR Reporting are reports with the SAPDBPNP logical database PNP . Report: RPUAUD00 Logged changes in infotype data Processing person-related data using payment medium programs from Accounting. To 1. You can use the relevant authorization for these objects to control how the objects P_ORGIN HR: Master data (P_ORGIN), P_ORGXX HR: Master data - extended check (P_ORGXX) are used in specified reports to check the authorization for INFTY HR infotypes . In this way, you can carry out a fine-tuned control on reports for infotype authorization. This can be useful for functional reasons or to improve performance at runtime of the corresponding reports. For this object, specify the report name(s) and the degree of simplification to be used for the authorization check. Authorization Objects in HR Note: HR: Reporting , however, overrides the HR infotype authorization check for selected reports, with the result that the authorization checks are weakened or completely switched off. Object HR: Master data (P_ORGIN) Fields are: INFTY Infotype SUBTY Subtype AUTHC Authorization level PERSA Personnel Area PERSG Employee Group PERSK Employee Subgroup VDSK1 Organizational Key Authorization Objects in HR Object: P_ORGXX HR: Master Data - Extended Check Fields: INFTY Infotype SUBTY Subtype AUTHC Authorization level SACHA Payroll Administrator SACHP Administrator for HR Master Data SACHZ Administrator for Time Recording SBMOD Administrator Group Definition: The object HR: Master data - Extended check (P_ORGXX) can be used to check authorization for personal data INFTY (HR infotypes) This check is not active in the standard system. The program switch HR: Master data - Extended check (ORGXX) can be used to add this check in the standard system or set it as an alternative to P_ORGIN HR: master data . The main switch settings can be processed using transaction HR: Authorization switch (OOAC) Authorization Objects in HR Object: P_PCLX HR: Clusters Fields: RELID Area identifier for cluster in tables PCLx AUTHC Authorization level Definition: This object is used in the authorization check when accessing PCLx (x = 1, 2, 3,4) HR files using the PCLx buffer (interface supported by HR). Field Details: Cluster ID: enter the cluster name in this field. Authorization level: in this field you must specify the operation to be carried out on the cluster along with the cluster ID specified above. The values which can be entered here are R (read), U (update database) and S (export data to PCLx buffer without database update).