Show TOC

Changing Suggested Message TextsLocate this document in the navigation structure

Use

When a message is to be created from an error list, a text is suggested containing all the relevant details about the error. The user also has to create their own error description. This error description is added to the suggested text and the error message is generated.

In some systems you might want the suggested text to have a different structure or you might want to change parts of it. To do this, you create a copy, which you can edit accordingly. To use the new text, you must enter the document name in a customizing table.

Caution

Note that your changes apply to the entire system and all users.

Procedure

To change the suggested text, you must perform the following steps:

Create Copy of Original Text

  1. Call transaction SE61 and enter the following in the fields on the initial screen:

    • Document Class: Dialog Text

    • Language: English

    • Dialog Text: ECATT_FAILURELIST_MESSAGE_T

    • Document Source: Local

  2. Execute the Copy [CTRL+F5] function.

  3. In the next dialog box, in the To subwindow, enter a new name in the Dialog Text field. Make sure that Dialog Text is selected as the documentation class. In the Save In field, make a selection.

  4. Execute the Copy [SHIFT+F4] function and work through the remaining dialogs to create a new object.

Edit Copy

  1. Call transaction SE61 and enter the following in the fields on the initial screen:

    • Document Class: Dialog Text

    • Language: <Your language> (if the text is available in your language)

    • Dialog Text: The name you specified when you created the copy

    • Document Source: Local

  2. Execute the Change Document [F6] function.

  3. Make your changes to the text and save your document by executing the Save [CTRL+S] and Save Active [CTRL+F12] functions.

Use Variable Data

The suggested default text (eCATT template) contains text symbols. Each text symbol represents a particular piece of information from the test in question and is replaced by this information.

The eCATT template (and its copies) contains all usable test-related text symbols. When you are editing your own copy you can use text symbols by choosing Start of the navigation path Include Next navigation step Symbols Next navigation step Text Symbols... End of the navigation path. You can also copy from the existing text or insert text at the required location. Text symbols are enclosed by ampersands, like this: &LOGID&.

The list below contains all the test-related text symbols you can use, in alphabetical order:

Text Symbol

Meaning

BO_NAME

ESF Business Object

BO_NODE_ID

ESF node ID

BO_NODE_NAME

ESF name of BO node

CALLING_OBJ_DESC

TWB object name or TWB package

CALLING_OBJ_ID

TWB ID (type-specific)

CALL_TYPE

TWB type (test plan, test package, and so on)

CONFIG

eCATT test configuration

CONFIG_TEXT

Short text for eCATT test configuration

ESF_CP

ESF client proxy

ESF_LIFETIME

ESF lifetime

ESF_SERVICE

ESF service

ESF_SYMPTOM

ESF symptom

EXCEPTION_CLASS

Exception class

EXCEPTION_ID

Exception ID

ECATT_DATE

Start date of test

ECATT_TIME

Start time of test

FUNC

eCATT command

FUNC_DATE

Start date of eCATT command

FUNC_OBJECT

Tested object

FUNC_TIME

Start time of eCATT command

LOGID

eCATT log number

MSGID

Message ID

MSGKIND

Message type, for example T100

MSGNR

Message number

MSGSOURCE

Message source

MSGTEXT

Message text

MSGTYP

Message type, for example E for error

MSGVAR1

Message variable 1

MSGVAR2

Message variable 2

MSGVAR3

Message variable 3

MSGVAR4

Message variable 4

PARAM_ID

eCATT command interface

PRECOND

Precondition handling

REF_SCRIPT

Referenced eCATT test script

REF_SCRIPT_TEXT

Short text of referenced eCATT test script

REF_VERSION

Referenced eCATT test script version

RFCDEST

RFC destination from eCATT system to SUT (system under test, that is, the system in which the test is running)

SCRIPT

eCATT test script

STARTUSER

User who started the test

SUT_CLIENT

Client of system under test

SUT_SYSID

System ID of system under test

SUT_USER

User in system under test

SYSID

eCATT system

TESTPLAN

TWB test plan

TOP_SCRIPT_TEX

Short text for eCATT test script

TWB_CLIENT

TWB client

TWB_RFCDEST

RFC destination from TWB system to eCATT system

TWB_SYSID

TWB system

USER_TEXT

Error description entered by user (The dialog for entering the problem description is only displayed if this text symbol is contained in the SE61 text.)

VARIANT_TEXT

Short text for eCATT variant

VAR_ID

eCATT variant

VERSION

eCATT test script version

Customizing

To enable the new message text to be used, the dialog text must be set for the system in transaction SECATT_UTIL, using the Enter Template for Error List function.

The text displayed in the system depends on the Customizing entry in transaction SECATT_UTIL, the logon language, and the languages in which the template is available. If the name of the dialog text is maintained in Customizing, this text is used; otherwise the default text is used (ECATT_FAILURELIST_MESSAGE_T). The system searches for the document, first in the logon language, then in English, then in the original language. If the document is not available in any of these languages, the process is canceled. It is not possible to create the message. An error message is displayed.

Create a Message

If the symbol for your own text is available in the user template (USER_TEXT), the text editor for creating texts is displayed. You have to enter the text. The respective default message is also displayed. The text symbols are replaced by current values. The message is transferred to the respective message system (CSS) and displayed.