Skip to Content

Applies to: SAP ECC 6.0, SAP NW 7.0

This document explains how to use HRDSYS Logical Information Objects to link and store documentation text associated with an entry of a custom database table through its maintenance dialog, the same way it is been done by standard tables like V_T511K

Introduction

Sometimes, there is a requirement to store long descriptions or even text with format along with a database table record. This can be achieved in different ways, but when we are dealing with a Customizing table and all the records and all the associated documentation need to be transported to the Integration or Production environments, HRDSYS functionality gives us a very powerful tool to do it and with a high degree of transparency.

Audience

ABAP Technical Consultants

Purpose

The purpose of this document is to provide an option to attach a long text description to be shown as part of a table record while maintaining/displaying the Table/View through the SM30 transaction the very same way SAP does in several standard Tables/Views like the Payroll parameters View V_T511K

1.JPG

Dependencies / Pre-requisites / Assumption

Basic understanding of ABAP Programming and ABAP Dictionary is necessary to understand the process and the concepts used in this article.

Technical Process

Customizing Steps

First of all we need to create a Custom Document Class (in our case its name will be ZTEST). We can do that through the HR Documentation Maintenance (PDSY). Then we go to Extras à Document Class, and here we can create a new Document Class which it will be used to associate all the text description we’re going to store/retrieve.

2.JPG

Note:  In the field Object table, we have to introduce the name of our custom table. In this scenario, it would be ZTEST_HRDSYS. Note that this table must be already created and activated. We can also define a template, by clicking on the template button in the toolbar, so every time we need to create a new text for a record this default template will show up.

Development Steps

For demonstration purposes, we are going to use a Customizing Database Table with the following fields:

3.JPG

The next step will be to generate the Maintenance Dialog through Utilities à Table Maintenance Generator (this will be done as usual) and access it via SM30, so we can edit the default dynpro and add the button we are going to use to edit/show the HRDSYS documentation. (These steps will be omitted) The final appearance of the dynpro will be this (The position of the Info button in the screen is not relevant):

4.JPG

Note:  When editing this dynpro, we will assign the function code %%%% to the new Info Button

After all these steps, we’ll begin to write some ABAP code to link our table with the custom documentation object we’ve just created before. The first step will be to create a new Input Module in the default dialog screen. (It will be created at the very bottom of the After Input Process) We also have to create another PBO Module, so the button remains pushable when we are in display mode.

5.JPG

In the new input module we are going to use the standard FM HRDSYS_VIEW_DOCU_EDIT_2. This Function Module will manage the display/edit options of our HRDSYS objects. Note that all the parameters we need are global and available in our Maintenance dialog Function Group, so there’s no need to declare any variables at all. We just have to specify our custom documentation object, in this case ‘ZTEST’ under the parameter ‘OTYPE’, and the two key fields of our database table, in our case INFTY and SUBTY, under the ofield1 and ofield2 parameters. Also note that as we haven’t checked the country dependency option while creating our documentation class, there’s no need to use the MOLGA parameter.

6.JPG

7.JPG

Note: As you could have seen, there’s a limitation on the number of key fields we can use to associate a documentation object to. We can only use two key fields to generate different text objects, which in most cases is more than sufficient. 

After having done all this, we are now able to create different documentation objects for each row, but we have something still missing: we need to be able to transport all this long text along with a customizing request.

To do this, we need to use the following SAP standard FMs:

  • HRDSYS_VIEW_INITIALIZE
  • HRDSYS_VIEW_TRANSPORT_2
  • HRDSYS_VIEW_COPY_MARK_2
  • HRDSYS_VIEW_DELETE_WARNING
  • HRDSYS_VIEW_DELETE_WARNING_2
  • HRDSYS_VIEW_SAVE_02
  • HRDSYS_VIEW_SAVE_01_2

We’re going to embed all this FM’s in subroutines that will be called dynamically by the standard dialog maintenance control program the very same way it is been done in all standard maintenance views. To do that we have to specify which routines will be executed for the corresponding events. This can be done maintaining the standard view V_TVIMF.

8.JPG

Then the final step would be to create all those subroutines in a new include, so they will be called dynamically by the control program when it’s needed.


* base table related FORM-routines………….
INCLUDE lsvimftx .

***INCLUDE L0P11F01 .
FORM f_hrdsys_save_01.                 “WLIAHRK031345
  
CALL FUNCTION ‘HRDSYS_VIEW_SAVE_01_2’
     
EXPORTING
      ofield1        
= ‘INFTY’

      ofield2         = ‘SUBTY’
      action         
= <action>
      vim_total_struc
= <vim_total_struc>
TABLES
      total          
= total
*           x_namtab        = x_namtab
      hrdsys_actions 
= hrdsys_actions
EXCEPTIONS
      fieldname_error
= 0
     
OTHERS          = 0.
ENDFORM.                               ” f_hrdsys_save_01
*

    


FORM f_hrdsys_save_02.                 “WLIAHRK031345
 
CALL FUNCTION ‘HRDSYS_VIEW_SAVE_02’
   
EXPORTING
      otype         
= ‘ZTEST’
      corr_nbr      
= <status>corr_nbr
   
TABLES
      hrdsys_actions
= hrdsys_actions.
ENDFORM.                               ” f_hrdsys_save_02



FORM f_hrdsys_save_02_skoc.            “WLIPH9K003905
CALL FUNCTION ‘HRDSYS_VIEW_SAVE_02’
  
EXPORTING
      otype         
= ‘ZTEST’
      corr_nbr      
= <status>corr_nbr
  
TABLES
      hrdsys_actions
= hrdsys_actions.
ENDFORM.  

FORM f_hrdsys_delete_warning.

CALL FUNCTION ‘HRDSYS_VIEW_DELETE_WARNING_2’
  
EXPORTING
      ofield1 
= ‘INFTY’
      ofield2 
= ‘SUBTY’
      vim_total_struc
= <vim_total_struc>
      vim_extract_struc
= <vim_extract_struc>
      vim_xextract_key
= <vim_xextract_key>
  
TABLES
     
extract  = extract
      total   
= total
  
CHANGING
      xmark   
= <xmark>.


CALL FUNCTION ‘HRDSYS_VIEW_DELETE_WARNING’
  
TABLES
     
extract = extract
  
CHANGING
      xmark  
= <xmark>.


ENDFORM.                               ” f_hrdsys_delete_warning


FORM f_hrdsys_copy_mark.
FIELD-SYMBOLS:  <viewline>.
ASSIGN (x_headermaintview) TO <viewline>.  ” WLIK033680
CALL FUNCTION ‘HRDSYS_VIEW_COPY_MARK_2’
  
EXPORTING
      status_action  
= statusaction
      viewline       
= <viewline>
      vim_extract_struc
= <vim_extract_struc>
      ofield1        
= ‘INFTY’
      ofield2        
= ‘SUBTY’
     
TABLES
      hrdsys_actions  = hrdsys_actions
  
EXCEPTIONS
      fieldname_error
= 0
     
OTHERS          = 0.
ENDFORM.                               ” f_hrdsys_copy_mark


FORM f_hrdsys_transport.
CALL FUNCTION ‘HRDSYS_VIEW_TRANSPORT_2’
   
EXPORTING
      otype          
= ‘ZTEST’
      ofield1        
= ‘INFTY’
      ofield2        
= ‘SUBTY’
      xmark          
= <xmark>
      corr_action    
= corr_action
      status_action  
= statusaction
      e071k          
= e071k
      vim_extract_struc
= <vim_extract_struc>
   
TABLES
      corr_keytab    
= corr_keytab
   
EXCEPTIONS
      fieldname_error
= 0
     
OTHERS          = 0.
ENDFORM.                               ” f_hrdsys_transport


FORM f_hrdsys_transport_skoc.          ” WLIPH9K003905
CALL FUNCTION ‘HRDSYS_VIEW_TRANSPORT_2’
   
EXPORTING
      otype          
= ‘ZTEST’
      ofield1        
= ‘INFTY’
      ofield2        
= ‘SUBTY’
      xmark          
= <xmark>
      corr_action    
= corr_action
      status_action  
= statusaction
      e071k          
= e071k
      vim_extract_struc
= <vim_extract_struc>
   
TABLES
      corr_keytab    
= corr_keytab
   
EXCEPTIONS
      fieldname_error
= 0
     
OTHERS                   = 0

ENDFORM.                               ” f_hrdsys_transport_skoc


FORM f_hrdsys_initialize.
 
CALL FUNCTION ‘HRDSYS_VIEW_INITIALIZE’
      
TABLES
           hrdsys_actions
= hrdsys_actions
           transport_docu
= hrdsys_transport_objects
           corr_keytab   
= corr_keytab.
ENDFORM.                               ” f_hrdsys_initialize

We have to declare this tree variables in the TOP include.

9.JPG

After all this, we can test our maintenance dialog, create as many entries as we need and of course the associated document objects. After saving everything, we can check the customizing change request and see, that along with the table entries there are some HRDSYS Logical Object entries that have been created.

The final step would be to transport this change request to the Integration Environment and see that all the entries and custom text objects have been transported successfully.

To report this post you need to login first.

2 Comments

You must be Logged on to comment or reply to a post.

Leave a Reply