Documentation View

We are hiring and constantly growing! Have a look through our vacancies to find the right role for you!

ECSFO001 - IS-U: Data Finder Enhancments in Customer Interaction Center

ECSFO001 - IS-U: Data Finder Enhancments in Customer Interaction Center

CL_GUI_FRONTEND_SERVICES - Frontend Services   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
This documentation is copyright by SAP AG.
SAP E-Book

Enhancement

Enhancement ESCFO001 enables you to modify the search functions of the IS-U data finder in the Customer Interaction Center (CIC).

You can use the following modifications:

  • Enhancement of the structure of all the displayable search criteria and fields
  • Function module that evaluates user-defined search fields before data finder searches for data
  • Enhancement subscreen for the CIC component ISUFINDER
  • Enhancement subscreen for the CIC component ISUSDPART

Descriptions of theses modifications follow. You can implement each modification independently of the others.

Enhancement of the structure of all the displayable search criteria and fields

This enhancement consists of the following components:

  • Customer include CI_EFINDD
Include all the fields in the CI_EFINDD include that you want to appear on your customer subscreen, and that are not already contained in the EFINDPAR structure. To view the all the fields to be inserted into the customer subscreen, see the EFINDD_CIC structure.
You can use the field as additional search criteria for the free selection of the IS-U data finder (see below), or to provide the action box calls with parameter values. Note that you can only do the latter if you are using the ISUFINDER component in the old layout.

Function module that evaluates user-defined search fields before data finder searches for data

This enhancement consists of the following components:

  • Function module EXIT_SAPLEECIC_COMP00_001
The system calls this function module before executing the data search. In the function module, you can structure your search criteria in the CI_EFINDD structure (see above) for the free selection of the data finder. This enables the data finder to evaluate the values you specified while it searches for data.
For more information see the function module documentation.

Enhancement subscreen for the CIC component ISUFINDER

This enhancement enables you to display user-defined subscreens for the CIC search criteria. In the old layout, the enhancement affects the ISUFINDER component that formats the search criteria for implicit finder-searches using the action box.

This enhancement consists of the following components:

  • Enhancement subscreen in the XEECICCOMP02 function group (screen 0100 or any other screens)
In the enhancement function group, create one or more subscreens with the maximum size of 80 columns by 18 rows (if you use the component variant with frames, or display your user-defined subscreen in addition to the original fields, the system reduces the maximum subscreen accordingly). Arrange you fields you require from the EFINDD_CIC structure on the subscreen. The system automatically exchanges the values of these required fields with the ISUFINDER component. If you want to use fields that are not contained on the standard settings, you must have included these fields in the CI_EFINDD include. The fields of this enhancement are automatically contained in the EFINDD_CIC structure.
  • Function module EXIT_SAPLEECIC_COMP02_001
The system calls this function module before PBO for your enhancement subscreen. Here you obtain the values for the searchc criteria (from the EFINDD_CIC structure), the name of the field on which the cursor is located, as well the current action box profile.
The system expects to receive the number of the screen to be displayed as a return value. You can use the return value to determine whether your subscreen appears underneath the data finder screen or whether your subscreen replaces the data finder screen entirely. At runtime you can use the active profile of the action box to determine which of your subscreens is displayed.
If you do not use this enhancement, or use the screen number 0000, the system uses the standard settings instead.
  • Function module EXIT_SAPLEECIC_COMP02_002
The system calls this function module after PAI of your user-defined subscreen. The function module is used to copy the values of the search criteria (from the EFINDD_CIC structure) to the ISUFINDER component. If necessary, the function module also copies the name of the field on which the cursor is located.

Enhancement subscreen for the CIC component ISUSDPART

This enhancement enables you to display user-defined subscreens for the search criteria in the CIC. In the new L-shaped layout, this affects ISUSDPART business partner component used to identify and display the current business partner.

The enhancement consists of the following components:

  • Enhancement subscreen in the XEECICCOMP02 function group (Screen 0099 oor any other screens)
In the enhancement subscreen, create one or more subscreens with the maximum size of 35 columns by 5 lines. If you create a subscreen larger than this, then you must scroll across the subscreen to view all the data. Arrange the fields you require from the EFINDD_CIC structure on the subscreen. The system automatically exchanges the values of these required fields with the ISUDPART component. If you want to use fields that are not contained on the standard settings, you must have included these fields in the CI_EFINDD include. The fields of this enhancement are automatically contained in the EFINDD_CIC structure. Note that, unlike the ISUFINDER component, you cannot use you the search fields to provider parameter values for action box calls.
In this enhancement, the subscreen replaces the screen area containing the business partner fields. Note that you can still automatically view the function keys; you do not have to include them on your user-defined subscreen.
  • Function module EXIT_SAPLEECIC_SD_001
The system calls this function module before PBO for your enhancement subscreen. It copies the values for the search criteria (from the EFIND_CIC structure), the name of the field on which the cursor is located, as well as the current action box profile. You also obtain a field that indicates whether the component is search mode (search criteria ready for input) or in partner display mode. In partner display mode, you can only see fields that relate to the business partner, which are not ready for input.
The system expects to receive the number of the screen to be displayed as a return value. At runtime you can use the active profile of the action box to determine which of your subscreens is displayed.
If you do not use this enhancement, or use the screen number '0000', the system uses the standard settings instead. For example, you can use a user-defined subscreen in search mode, and use the standard settings- or another subscreen- in display mode.
  • Function module EXIT_SAPLEECIC_SD_002
The system calls this function module before PAI for your subscreen. The function module is used to copy the values for the search criteria (from the EFINDD_CIC structure) to the ISUDPART structure. If necessary, the system also copies the name of the field on which the cursor is located. Note that this function module only operates in search mode.

Note

To integrate pushbuttons in a user-defined subscreen, proceed as follows:

  1. Insert the pushbutton using the screen painter
  2. Assign the pushbutton an OK code. Ensure that this OK code is not used by any other CIC component.
  3. Create a new CIC component that subscribes to the OK code and executes the action required by the pushbutton.
You can copy the EECIC_COMP01 function as a template for this CIC component and modify it as required.

The ISUFINDER component contains simplified implementation procedures for the following exceptional cases:

  • Pushbutton for full screen display of data finder
  • Pushbutton for initialization of search fields

In these cases, you only have to include the pushbuttons in the user-defined subscreen and assign the OK codes 033M or 034M.

Example

The XEECICCOMP02 function group contains sample coding for the integration of user-defined subscreens for the search criteria of the ISUFINDER and ISUSDPART components. This sample coding is for function modules, screen process flow logic, as well as for the PBO and PAI modules.

The coding for ISUFINDER also contains sample coding that enables you to calculate the icon for the All Search Criteria pushbutton.

Include Example
LXEECICCOMP02F01 User exit EXIT_SAPLEECIC_COMP02_001
LXEECICCOMP02F02 User exit EXIT_SAPLEECIC_COMP02_002
LXEECICCOMP02F03* User exit EXIT_SAPLEECIC_COMP00_001
LXEECICCOMP02F04 User exit EXIT_SAPLEECIC_SD_001
LXEECICCOMP02F05 User exit EXIT_SAPLEECIC_SD_002
LXEECICCOMP02_TO TOP Include that matches the user exits
LXEECICCOMP02_DY Customer subscreen flow logic
LXEECICCOMP02_PB Customer subscreen PBO module
LXEECICCOMP02_PA Customer subscreen PAI module
LXEECICCOMP02_FO Subprograms (FORMS)

(* Include contains no coding)

You can adopt the sample coding contained in the enhancement function modules. To do this, proceed as follows:

  1. Go to transction CMOD (Project Management of SAP Enhancements). Select Enhancement Components and choose Change.
  2. Position the cursor on the function enhancement you require and choose Edit -> Adopt SAP Source Text.

Create your own includes and adopt the other sample coding contained in the XEECICCOMP02 function group to these includes using Cut & Paste.






SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   Addresses (Business Address Services)  
This documentation is copyright by SAP AG.

Length: 11611 Date: 20211204 Time: 150725     sap01-206 ( 173 ms )