Default Notification Header Text

Introduction

Various posts over the years have expressed similar requirements: Loosely quoted they read:

“How can I default a (standard) text into the notification header text? I want my end users to be prompted to complete a set of questions”

The following document provides sufficient detail for this requirement to be achieved.

Realization Approach

Many posts have suggested the use of standard texts and the SAP supplied enhancement QQMA0025 – PM/SM Default values when adding a notification. The solution outlined in this document utilizes standard texts and the SAP supplied enhancement.

Standard Text

It is assumed that the text to be defaulted into the notification header text is defined as a standard text. Standard texts are maintained with the transaction SO10 in an SAP ECC system and can be read with the function READ_TEXT.

SAP Enhancement QQMA0025

The SAP enhancement is designed to allow the setting of default values in the notification, and dependent objects like activities, items and tasks. The interface provides the notification header, notification type configuration and the notification dependent objects.

Solution 1: Default Standard Text in the notification long text

Step 1: Read the standard text

the standard text can be read with the function module READ_TEXT; In this case reading a text with the name ZPMWOCMN_01.

 CALL FUNCTION 'READ_TEXT'      EXPORTING        ID                      = 'ST'        LANGUAGE                = SY-LANGU        NAME                    = 'ZPMWOCMN_01'        OBJECT                  = 'TEXT'      TABLES        LINES                   = LT_LINES_STD      EXCEPTIONS        ID                                =  1     LANGUAGE                = 2        NAME                          = 3        NOT_FOUND              = 4        OBJECT                       = 5        REFERENCE_CHECK         = 6        WRONG_ACCESS_TO_ARCHIVE = 7        OTHERS                  = 8. 

Step 2: Initiate the notification long text processing

 CALL FUNCTION 'INIT_TEXT'      EXPORTING        ID       = 'LTXT'        LANGUAGE = I_VIQMEL-KZMLA        NAME     = wa_notification_text_name        OBJECT   = 'QMEL'      IMPORTING        HEADER   = WA_HEADER      TABLES        LINES    = LT_LINES_NOT      EXCEPTIONS        ID       = 1        LANGUAGE = 2        NAME     = 3        OBJECT   = 4 OTHERS   = 5 

Step 3: Merge the standard text lines with the notification lines and save

 APPEND LINES OF LT_LINES_STD TO LT_LINES_NOT.    CALL FUNCTION 'SAVE_TEXT'      EXPORTING        HEADER   = WA_HEADER      TABLES        LINES    = LT_LINES_NOT      EXCEPTIONS        ID       = 1        LANGUAGE = 2        NAME     = 3        OBJECT   = 4 OTHERS   = 5. 

Step 4: Update indicator in header that long text exists

 

  E_VIQMEL-INDTX = 'X'.

Solution 2: Default Standard Text in the notification long text and branch to long text editor

similar to above, except after Step 1, the following steps:

Step 2: Merge standard text text and count lines

 APPEND LINES OF LT_LINES_STD TO LT_LINES_NOT. L_CNT_LINES = LINES( LT_LINES_NOT ). 

Step 3: Call long text editor

 CALL FUNCTION 'LANGTEXT_ONLY'      EXPORTING        OBJECT                = 'QMEL'        OBJECT_NR             = wa_notification_text_name        SPRAS                 = SY-LANGU        TXTID                 = 'TEXT'        X_XAKTYP              = 'H' "Creation mode        SAVE_MODE             = 'X'        TEXT_HISTORY          = I_TQ80-QMLTXT01        TEXT_PROPERTY         = I_TQ80-QMLTXT02        COUNT_INLINE          = L_CNT_LINES        IV_SUPPRESS_END_SPACE = SPACE                     TABLES        T_INLINES             = LT_LINES_NOT. 

Hints and Tips

You can review the subroutine TEXT_ANLEGEN_F50 in the function group IQS0 or the function module IQS0_ADD_NOTIFICATION_LONGTEXT for more details of notification text processing. There you will see how to protect lines of text and to create history lines.

Limitations

The SAP enhancement isn’t ideally suited to the generation of long text, because the interface does not allow the maintenance of the indicator (   WVIQMEL–INDTXTUPD ) used in the function group IQS0 to indicate text processing changes. Without the user processing the long text, the defaulted long text will not be saved.

Other Frequently Asked Questions

Is there a possibility using configuration?

In short – no. There is no possibility using configuration.