8.04 onmessage()

Purpose

The onmessage() command triggers actions when messages are received from SAP. This  command behaves as an independent screen block, similar to the onscreen command.

Syntax

onmessage

Example

The following example demonstrates the onmessage() command on VA01 transaction.

Create a function that will execute when the user hits Enter key. We will use the onUIEvents command to trigger the function and we will use the message command to display it. If an incorrect code is entered, the onmessage() command will capture that and display the message on the screen as following:

Enter an incorrect value in the Sold-to field and press Enter key. The specified error message appears, as shown in above figure.

Script

Go to the VA01 script file and create a new inputfield with the following code:

//SAPMV45A.E0101.sjs

inputfield([3,1],"Sold-to",[3,22],{"name":"z_va01_soldto","size":10});
onUIEvents['Enter'] = va01_entersoldto;
function va01_entersoldto(){
                onscreen 'SAPMV45A.4001'
                       set("F[Sold-to party]","&V[z_va01_soldto]");
                enter();
                onmessage
                        message("E:" + _message);
                enter("/nva01");
}

Usage Details

• copytext-using variables for line numbers with onmessage()

• Update multiple item fields based on the screen size with onmessage()

• Update Text Content with Editor using onmessage()

• Change readonly status dynamically with onmessage()

• Get required sales order data from SAP table with onmessage()

• Logging Capability with onmessage()