SAP ABAP IMG Activity SIMGVC_APB_ISR_C_OVS (Set Up OVS Value Help)
Hierarchy
☛ SAP_BASIS (Software Component) SAP Basis Component
   ⤷ BC-MUS-LP (Application Component) Launchpad
     ⤷ APB_ISR (Package) Internal Service Request on ABA
IMG Activity
ID SIMGVC_APB_ISR_C_OVS Set Up OVS Value Help  
Transaction Code S_ABA_72000407   (empty) 
Created on 20090407    
Customizing Attributes SIMGVC_APB_ISR_C_OVS   Set Up OVS Value Help 
Customizing Activity SIMGVC_APB_ISR_C_OVS   Set Up OVS Value Help 
Document
Document Class SIMG   Hypertext: Object Class - Class to which a document belongs.
Document Name VC_APB_ISR_C_OVS    

Use

In this Customizing activity you define the attributes for OVS-enhanced search help. For more information about OVS, see SAP NetWeaver Library under SAP NetWeaver Developer's Guide -> Fundamentals -> Using ABAP -> Core Development Tasks -> UI Technology -> Web Dynpro for ABAP -> Web Dynpro ABAP: Development in Detail -> Advanced Concepts -> Input Help -> OVS Value Help.

The Basic Internal Service Request Web Dynpro application (APB_ISR_UI_FORM) is used to start the form for the relevant scenario.

Requirements

You have implemented the Form Processing Business Add-In (BAdI).

Standard settings

Activities

Setting up advanced search help involves activities in Customizing, and also in the Form Builder and Form Processing BAdI.

Cusomizing Activity

  1. Enter a scenario (and select a version if there is more than one available) and choose Characteristics for OVS.
    1. In the Field name field, specify the characteristic for which you want to set up the search help.
    2. Select the Active checkbox.
  2. Choose Input/Output Fields to define the input and output fields for search help for this field.
    1. Enter a Field name. You can use all the characteristics of the selected scenario for this.
    2. Define the category of the field:
      3. - Input field to use it as a search criteria for the search help
      - Output field: is displayed in the result list (can be suppress by setting the Hide Field on Output List indicator) and the value in this field will be transferred to the form when the entry is choosen in the result list

Form Builder

In the Form Builder (transaction SFP), you have to adjust the form layout for the search help. To do so, add one of the following objects that you can find under Insert:

  • -> ISR Native Controls -> ISR Text Edit - OVS
  • -> ISR Native Controls -> ISR Text Edit - Value Help
  • -> WebDynproNative -> Value Help

    In the script, specify the usual data binding in the Click event handler of the inserted object and enter the relevant field name

    var fieldName = "<FieldNameToBeReplaced>";

    Note: Replace the <FieldNameToBeReplaced> (or <REPLACE_THIS>) placeholder with the name of the relevant field.

    To determine the field name, click the search help input field, choose the tab page Object and then the tab page Binding (or Data). The field name is displayed on this tab page as Name.

    If you want the system to automatically check the entered value in the ERP back-end system once the user has made entries in the input help, insert the following script in the Exit event handler of the Value Help object on the form:

    xfa.record.CONTROL_PARAM.ISR_EVENT.value = "<EVENT_NAME>";

    Note: Replace the <EVENT_NAME> placeholder with the relevant event name.

Form Processing BAdI

The search help programming is carried out entirely in the scenario-specific BAdI implementation of the Form Processing BAdI, specifically in the INIT and SET_ADDITIONAL_VALUES methods.

Enter all possible output values of the output fields in the transfer table ADDITIONAL_DATA. This data is the basis for the search. The actual results list is then determined during runtime based on the entry in the search fields of the OVS.

  • Field FIELDINDEX: Counter, beginning with 1
  • Field FIELDNAME: Characteristic name
  • Field FIELDVALUE: Value

    Please note the following points during implementation:

  • You can control the sorting of lines in the results list using the FIELDINDEX counter.
  • It is necessary to enter the exact characteristic name as the FIELDNAME; the characteristic name must not have any additional ending, such as _KEY, as required for programming the dropdown list box (DDLB). You can continue to program other fields on the form as DDLB.
  • The APB_ISR_CUST_SCEN_VALHLP_GET function module supplies all Customizing information concerning the value help of a scenario.
  • The system runs the SET_ADDITIONAL_VALUES method after every event on the form, but only runs the INIT method the first time the form is called.

    Program example for Form Processing BAdI

    You want to set up the PERSON field as OVS search help. The maximum results list in which you want to search consists of the output fields FIRSTNAME, LASTNAME, TITLE, and USER.

    The entries in the ADDITIONAL_DATA table may look as follows. This example contains three data records.

    DATA:
    ls_additional_value TYPE qisrsspecial_param.
    ...
    ls_additional_value-fieldindex = 1.
    ls_additional_value-fieldname = 'FIRSTNAME'.
    ls_additional_value-fieldvalue = 'Jim'.
    APPEND ls_additional_value TO additional_data.
    ls_additional_value-fieldname = 'LASTNAME'.
    ls_additional_value-fieldvalue = 'Smith'.
    APPEND ls_additional_value TO additional_data.
    ls_additional_value-fieldname = 'TITLE'.
    ls_additional_value-fieldvalue = 'Mr.'.
    APPEND ls_additional_value TO additional_data.
    ls_additional_value-fieldname = 'USER'.
    ls_additional_value-fieldvalue = 'JSMITH1'.
    APPEND ls_additional_value TO additional_data.
    CLEAR ls_additional_value.

    ls_additional_value-fieldindex = 2.
    ls_additional_value-fieldname = 'FIRSTNAME'.
    ls_additional_value-fieldvalue = 'Linda'.
    APPEND ls_additional_value TO additional_data.
    ls_additional_value-fieldname = 'LASTNAME'.
    ls_additional_value-fieldvalue = 'Green'.
    APPEND ls_additional_value TO additional_data.
    ls_additional_value-fieldname = 'TITLE'.
    ls_additional_value-fieldvalue = 'Ms.'.
    APPEND ls_additional_value TO additional_data.
    ls_additional_value-fieldname = 'USER'.
    ls_additional_value-fieldvalue = 'LGREEN'.
    APPEND ls_additional_value TO additional_data.
    CLEAR ls_additional_value.

    ls_additional_value-fieldindex = 3.
    ls_additional_value-fieldname = 'FIRSTNAME'.
    ls_additional_value-fieldvalue = 'Sara'.
    APPEND ls_additional_value TO additional_data.
    ls_additional_value-fieldname = 'LASTNAME'.
    ls_additional_value-fieldvalue = 'Miller'.
    APPEND ls_additional_value TO additional_data.
    ls_additional_value-fieldname = 'TITLE'.
    ls_additional_value-fieldvalue = 'Ms.'.
    APPEND ls_additional_value TO additional_data.
    ls_additional_value-fieldname = 'USER'.
    ls_additional_value-fieldvalue = 'SMILLER'.
    APPEND ls_additional_value TO additional_data.
    CLEAR ls_additional_value.

Business Attributes
ASAP Roadmap ID 259   Establish Forms and Messages 
Mandatory / Optional 3   Nonrequired activity 
Critical / Non-Critical 2   Non-critical 
Country-Dependency A   Valid for all countries 
Maintenance Objects
Maintenance object type C   Customizing Object 
Assigned objects
Customizing Object Object Type Transaction Code Sub-object Do not Summarize Skip Subset Dialog Box Description for multiple selections
VC_APB_ISR_C_OVS C - View cluster SM34  
History
Last changed by/on SAP  20090407 
SAP Release Created in 730