SAP ABAP IMG Activity SIMGOHA_EFIGB_008 (Business Add-In (BAdI) for Employee Matching Process)
Hierarchy
☛ SAP_HRCGB (Software Component) Sub component SAP_HRCGB of SAP_HR
   ⤷ PY-GB (Application Component) United Kingdom
     ⤷ P08C (Package) HR customizing: UK
IMG Activity
ID SIMGOHA_EFIGB_008 Business Add-In (BAdI) for Employee Matching Process  
Transaction Code S_L6D_84000026   (empty) 
Created on 20040623    
Customizing Attributes SIMGOHA_EFIGB_008   Business Add-In (BAdI) for Employee Matching Process 
Customizing Activity SIMGOHA_EFIGB_008   Business Add-In (BAdI) for Employee Matching Process 
Document
Document Class SIMG   Hypertext: Object Class - Class to which a document belongs.
Document Name HR_EFI_DETPERNR    

Business Add-In for Employee Matching Process

Verwendung

In this step, you implement the Employee Matching Process Business Add-In (BAdI). This BAdI is called in the matching routine after all standard matching techniques have been exhausted.

In the SAP system, the following standard matching techniques are used to match the incoming form to an employee on the SAP system:

  • Matching the National Insurance (NI) number:

    If the NI number on the incoming record is matched perfectly 1 to 1 with the NI number of an employee on your SAP system, the match is successful.

  • Matching the works number provided:

    The works number supplied in the XML incoming record must be in the correct SAP number format. It must contain only digits and be no longer than eight characters. If the format is correct, then the routine checks that the works number is also a personnel number on the system. If this is so, the match is successful.

  • Matching via tax reference:

    Where an incoming record is matched to more than one employee on your system (for example, when more than one personnel number uses the same NI number), then a process of elimination is performed based on the incoming tax reference.

    An employee is assigned via payroll area to a particular PAYE reference. Furthermore, the incoming record also belongs to a particular PAYE reference. If there is a mismatch between the employees PAYE reference and the PAYE reference of the incoming record, then this personnel number is removed from the matched records. After the process of elimination, provided only one record remains, then this will result in a successful match.

Should the above procedure not result in an exact match, then the Business Add-In for Employee Matching Process is called.

Aktivitäten

After calling up the IMG activity, a dialog box appears in which you can enter a name for the implementation.

If you have already made other implementations for this BAdI, another dialog box appears in which the existing implementations are displayed. In this case, choose Create, and proceed as follows:

  1. In the dialog box, enter a name for the BAdI implementation in the Implementation field, and choose Create .

    The screen for creating BAdI implementations is now displayed.

  2. Enter a short text for the implementation in the Short text for implementation field.
  3. From the tab index, choose Interface.

    The name of implemented class field is already filled on the tab page, as a class name was automatically assigned to the implementation when you named it.

  4. Save your entries, and assign the implementation to a development class.
  5. Place the cursor on the method, and double-click to enter method processing.
  6. Enter the coding for the implementation between the statements method <Interface name> ~ <Name of method> and endmethod.
  7. Save and implement your coding. Return to the Edit Implementation screen.
  8. Save the entries on the Edit Implementation screen.

    Note: You can also create an implementation, and then activate it at a later time. In such a case, end the processing stage at this point.

  9. Choose Activate.

    The coding you stored in the method will be run when the application program is executed.

Further BADI Information

For more information on using Business Add-Ins, refer to the SAP Library under: mySAP Technology Components -> SAP Web Application Server -> ABAP Workbench (BC-DWB) -> Changing the SAP Standard (BC) -> Business Add-Ins.

Standardeinstellungen

BAdI Method DETERMINE_PERNR

The BAdI method 'DETERMINE_PERNR' is called after the standard matching routine has been unable to determine a match. This BAdI may be useful, for example, where your organisation supplies works numbers to the Inland Revenue in a format other than the SAP eight-digit format. It would also be possible to try to match on the employee's name, using this BAdI.

Interface

The BAdI Method DETERMINE_PERNR has the following interface:

Importing

works_no = The works number provide in incoming XML document

effda = The effective date of the form

name = The employee's full name in the format supplied in the

XML document

pernr_tab = Where a match has been made to more that 1 personnel

number the pernr_tab contains all matched numbers.

Exporting

pernr = If a successful match was determined the 'pernr' should

contain the single matched pernr.

Exceptions

no_pernr_determined = Exception should be raised by the exit if no

match to a single personnel number could be

found.

Business Attributes
ASAP Roadmap ID 203   Establish Master Data 
Mandatory / Optional 2   Optional activity 
Critical / Non-Critical 2   Non-critical 
Country-Dependency I   Valid for countries specified 
Customizing Attributes Country Key Country Name
SIMGOHA_EFIGB_008 GB United Kingdom
Maintenance Objects
Maintenance object type E   Business Add-In - Definition 
History
Last changed by/on SAP  20040625 
SAP Release Created in 500