SAP ABAP IMG Activity _ISUCSCRM_000004 (Define User-Defined Utility Product Set Types)
Hierarchy
☛ IS-UT (Software Component) SAP Utilities/Telecommunication
   ⤷ IS-U (Application Component) SAP Utilities
     ⤷ EE80 (Package) IS-U: Customizing
IMG Activity
ID _ISUCSCRM_000004 Define User-Defined Utility Product Set Types  
Transaction Code S_KK4_82000430   (empty) 
Created on 20000810    
Customizing Attributes _ISUCSCRM_000004   Define User-Defined Utility Product Set Types 
Customizing Activity _ISUCSCRM_000004   Define User-Defined Utility Product Set Types 
Document
Document Class SIMG   Hypertext: Object Class - Class to which a document belongs.
Document Name _ISUCSCRM_000004    

Only perform this IMG activity if you want to define your own utiliy product set type, or enhance a standard SAP set type. You must make an entry in this table and develop in the ABAP Workbench. Creating set types is similar to creating an enhancement.

This is only necessary if :

  • You want to include additional fields that are not contained in an SAP set type in the configuration of a utility product.
  • You want to change the screen layout of the fields for a set.
  • You want to enhance or change the automatic assignment of set data, or the checks performed on set data (configuration).
  • You want to change the layout of the business partner and premise areas of the screen (include additional fields and so on).

Procedure

  1. Select an existing set type as a copy reference.

    Go to this node in the IMG activity, where the following information is available for each set type:

    • Name
    • Description
    • Dictionary structure
      • The dictionary structure for a set type defines the fields that can be maintained for a set type by the user, during creation of utility orders or utility quotations.
    • Program name
      • The program name identifies the function group that implements the set type.
    • Screen number
      • The screen number identifies the screen in the function group that is displayed in the transactions for creation of utility orders or utility quotations for the set type. The screen typically contains all fields for the above mentioned dictionary structure.
    • Check function module.
      • The check function module is called up in the transactions for creation of utility orders or utility quotations. For example, if the user executes the check function, a check of set type fields is implemented.
      If you want to change an existing set type, then you must make a note of the fields executed for this set type in this table.
      If you want to create a new set type, choose a set type that is similar to the planned set type and make a note of the field values executed for it in this table.
  2. Copy function group.

    Use the set type selected in step 1 as a copy reference to help create your own set type. Choose Tools -> ABAP Workbench -> Overview -> Object Navigator and copy the function group that you noted in step 1.

    We recommend that you use the function group of an SAP set type, such asset type ISU_SALES_SETTYPE_DISTRIB.

  3. Copy dictionary structure.

    Define which fields must appear in your new set type. Copy the dictionary structure that you made a note of in step 1 into your function group. Modify the new dictionary structure or set type structure so that it contains the fields you want.

    Ensure that all fields of the set type represent product characteristics that the user can configure for runtime. If an order or quotation is created with a utility product, then all fields of the dictionary structure appear as configuration characteristics of this product in the generated SD order or SD quotation.

  4. Obligatory declarations in the TOP include.

    To correctly include your own set types in the framework of the entry transaction in IS-U Sales Processing, you must include the following declarations in the TOP include of your function group:

    • TABLES: {name of your set type dictionary structure}.
    • DATA: sap_set_ref TYPE REF TO cl_isu_sales_order_set.
      • You need the TABLES statement to process the set type characteristics on your set type screen for runtime in ABAP.
      For more information see step 5.

      The SAP main program automatically provides variable SAP_SET_REF for runtime with reference to your set types. Otherwise SAP_SET_REF is used in step 6 to apply the main program services to your set type. These services are the task of the screen field modifications maintained in Customizing for the fields of your set type and cursor positioning. For example, field Output Only or Optional.

  5. Modify the set type screen.

    Now adjust the set type screen to fit your requirements. In step 2 you obtained the new function group by copying a function group from an SAP set type. Therefore you should already have a screen for your function group.

    • Screen layout:

      Include all fields of the set type structure in your screen. Ensure that all screen fields that represent product characteristics are defined with reference to the set type structure. Then the SAP main program can process the product characteristics correctly for runtime. Your dictionary structure has already been declared in ABAP in step 4 in the TOP include by TABLES statement. Now declare your screen fields in the Screen Painter with reference to this dictionary structure.

      You are now able to include any other fields, buttons, texts or screen elements on your screen. Make sure that you assign definite OK codes to your own functions. For example, assign a definite prefix for your own OK code.

    • Flow logic:
      • To include your own set type correctly in the framework of the creation transaction in IS-U Sales Processing, you must execute the following steps in your function group:
      Call up function module ISU_SALES_SET_PBO in a PBO module as follows:
      CALL FUNCTION 'ISU_SALES_SET_PBO'
      EXPORTING
      im_set_ref_object = sap_set_ref.
      Call up function module ISU_SALES_SET_PAI in a PAI module as follows:
      CALL FUNCTION 'ISU_SALES_SET_PAI'
      EXPORTING
      im_set_ref_object = sap_set_ref
      IMPORTING
      ex_ok_code = main_ok_code.
      Variable SAP_SET_REF is obligatory in both cases to process field modifications and cursor positioning established in Customizing.
      Variable MAIN_OK_CODE can be called up in another way. The main program returns the current OK code of the main screen in this variable for runtime. You can react to user activities in your set type. This is important if you have implemented certain functions such as push buttons. It is only possible to react to your own OK code in this way.
  6. Develop the check function module

    The check function module validates the field values of your set type. The values of your own set type are available along with the values of other set types that belong to the current order or quotation item for runtime.

    The check function module is called up by the SAP main program in four cases:

    1. Inclusion of a utility product in the order or quotation
      2. The check function module is called up to load the function groups of set types belonging to the utility product, into the main memory for the first time.
    2. User chooses Check function
    3. User chooses Simulate function
    4. User chooses Save function
      5. The set types CONSUMPTION and DISTRIBUTION, for example, were allocated to a utility product. The check function module of set type CONSUMPTION is now called up for runtime. It can also access the values of set type DISTRIBUTION for validation of its field values.
      It is also possible to change the field values of your own set type. You cannot change the field values of other set types in your check function module. These are write-protected by interface definition if_isu_sales_order_set. This also prevents check function modules of other set types from changing your own field values.
      An example of the procedure is demonstrated in check function module ISU_SALES_SETTYP_DISTRIB_CHECK of set type DISTRIBUTION.
      You obtain the references to interface if_isu_sales_order_set using internal table ALL_SET_VALUES. Call up method GET_VALUES for this reference to access the field values of a set type.

      You can add further validations to your set type screen. These are then executed according to PAI/PBO cycle.

  7. Activate the function group.
  8. Enter the new set type in the IMG.

    Go to this node in the IMG activity. Generate a new entry with the following data:

  • Name
  • Description
  • Dictionary structure

    Set type structure that you created in step 3

  • Program name

    SAPL + (name of function group)

    Function group that you created in step 2.

  • Screen number

    Number of screen in your function group that you created in step 5.

  • Check function module

    Name of function module that you created in step 6.

You can now allocate utility products to your new set type in Customizing, and maintain the associated configuration characteristics for the SD order or SD quotation for runtime.

Business Attributes
ASAP Roadmap ID 204   Establish Functions and Processes 
Mandatory / Optional 2   Optional activity 
Critical / Non-Critical 2   Non-critical 
Country-Dependency A   Valid for all countries 
Assigned Application Components
Documentation Object Class Documentation Object Name Current line number Application Component Application Component Name
SIMG _ISUCSCRM_000004 0 SK40000001 Integration: Customer Relationship Management 
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
ESALES_SETTYPE S - Table (with text table) SM30 Define User-Defined Utility Product Set Types 
History
Last changed by/on SAP  20000823 
SAP Release Created in 462