Ansicht
Dokumentation

ESS_WDA_EDT_010 - BAdI: Define Settings

ESS_WDA_EDT_010 - BAdI: Define Settings

ABAP Short Reference   Addresses (Business Address Services)  
This documentation is copyright by SAP AG.
SAP E-Book

This Business Add-In (BAdI) is used in the ESS Based on WD ABAP (PA-ESS-XX-WDA) component. You use this BAdI to control the output of salary statements of your employees in Employee Self-Service (ESS).

This Business Add-In is active in the SAP standard system. The program code from the standard is executed automatically.

You use these methods to control the structure of the ESS page for displaying the salary statements of your employees in ESS:

Method PROVIDE_FILTERED_RGDIR: Restriction of the salary statements available in ESS

This method is called during the initialization of the service, and its purpose is to limit the available salary statements in ESS for an employee. These salary statements include those that are based on periodic payroll results, and in the U.S.A. for example, also salary statements that are based on off-cycle payroll results.

You can use this method to limit the available salary statements by removing the entries from table CT_FILTERED_RGDIR. All entries that should be available for selection in the service have to be contained in table CT_FILTERED_RGDIR. You have to transfer all entries that should be available in the service from internal table IM_IN_RGDIR to table CT_FILTERED_RGDIR.

Examples

You want to filter out all in-periods in which the payroll period is not closed. Proceed as follows:

  • In your implementation, check if the payroll period is closed for each entry in table CT_FILTERED_RGDIR.
  • If the payroll period is not closed, then you delete the entry from table CT_FILTERED_RGDIR.

You want to define the availability based on the payment date. Proceed as follows:

  • In your implementation, compare the payment date of each entry from table CT_FILTERED_RGDIR with the current date.
  • If the current date is before the payment date, then delete the entry from table CT_FILTERED_RGDIR.

Method PROVIDE_FILTER_LIST: Specify selection list and additional information

This method specifies which entries are offered for selection in the dropdown box for the salary statement, for example, the entries:

  • All Salary Statements
  • 3 Salary Statements
  • 6 Salary Statements

For each selection entry, you have to enter the sequence number of the oldest salary statement that is in the set of hits selected.

Method PROVIDE_FIELD_CATALOG: Field catalog of the overview table for the configuration

Using this method at the time of the configuration, you can specify the maximum possible field catalog (columns) for the configuration of the overview table. This takes place independently of the personnel number and other attributes!

For each column, you have to specify which field with the corresponding properties should appear in the configuration of the application:

Property Description
HEADER_TITLE Column title
READ_ONLY Read only
WIDTH Column width (in characters)
TOOLTIP Tooltip of column
VISIBILITY Column is visible

You can get additional properties from the structure FPMGB_S_LISTFIELD_DESCR.

Method ADJUST_FIELD_CATALOG: Adjustment of field catalog at runtime

Using this method, you can activate or deactivate different columns dependent on the personnel number and other attributes (such as, country grouping, off-cycle country).

Method PROVIDE_OVERVIEWTAB_LINE: Formatting of cell contents for an RGDIR line

This method specifies the contents of the overview table. The contents must conform to the layout of the table (see: method PROVIDE_FIELD_CATALOG). This method is called for each line (ES_OVERVIEW) of the overview table.

Method PROVIDE_TITLES: Title of application and title for popup

Using this method, the system can dynamically change the title of the application or the title of the popup; for example, the period being displayed appears in the title (along with the ApplicationDefaultTitle).

Method ADJUST_PRINTBUTTON_STATUS: Adjustment of the status for the pushbutton for printing

Using this method, you specify whether the Central Print pushbutton is active or inactive for the employee. The prerequisite for this is that the Central Print pushbutton was included in the configuration.

Note

The following applies for all methods that use the parameter ES_MESSAGE:

  • Messages of the categories A and E cause a termination of the service for ESS and take you to a general error page (administrator message).
  • Messages of the categories S, I and W are converted into messages of category A or E after the call of the BAdI.

Note the following in the case of a customer implementation:

The methods from the default implementation are no longer executed automatically. If you want to avoid this, then you can inherit from the class of the default implementation in your customer implementation. This means that you only have to newly define the methods that you really want to change.

For information about the implementation of BAdIs in the context of the Enhancement Concept, see SAP Library for SAP NetWeaver under BAdIs - Embedding in the Enhancement Framework.






CL_GUI_FRONTEND_SERVICES - Frontend Services   General Material Data  
This documentation is copyright by SAP AG.

Length: 7088 Date: 20240523 Time: 202351     sap01-206 ( 146 ms )