SapGuiVerifyStatusBarText Function


This function verifies the current statusbar text of the SapGui application.

Include file



SapGuiVerifyStatusBarText( in sValue    : string, 
                           in nOptions  : number optional,
                           in nSeverity : number optional := SEVERITY_ERROR ) : boolean;
Parameter Description
sValue Value to be compared with the current statusbar text.
nOptions This parameter specifies the type of check to be performed. Available options are:
  • SAPGUI_VERIFY_EQUAL. Verifies, whether the state of the checkbox's state is equal to the value specified in the second parameter.
  • SAPGUI_VERIFY_NOT_EQUAL. Verifies, whether the checkbox's state is not equal to the value specified in the second parameter.
nSeverity Optional: Severity of the error that is raised if the verification fails. Can be one of the following values:
  • SEVERITY_SUCCESS: Success; no error (numerical value: 0)
  • SEVERITY_INFORMATIONAL: Informational; no error (numerical value: 1)
  • SEVERITY_WARNING: Warning; no error (numerical value: 2)
  • SEVERITY_ERROR: (Default) Error; simulation continues (numerical value: 3)
  • SEVERITY_TRANS_EXIT: Error; the active transaction is aborted (numerical value: 4)
  • SEVERITY_PROCESS_EXIT: Error; the simulation is aborted (numerical value: 5)

Return value

  • true if successful
  • false otherwise


transaction TMain
    // Connecting to SAP
    sConnID := SapGuiOpenConnection( " /SAP_CODEPAGE=1100 /FULLMENU 0 /3");

    // SAP
    SapGuiSetActiveWindow("wnd[0]", "SAP", SAPGUI_MATCH_ExactNoCase);

    // Logon to SAP System
    // Before running a test you have to customize the password parameter!
    SapGuiLogon("ddic", "minisap", "000", "");
    SapGuiVerifyStatusBarText("verification", SAPGUI_VERIFY_EQUAL, SEVERITY_ERROR);
  end TMain;