Scripting alert, info, and error messages

  • Release version: Yokohama
  • Updated January 30, 2025
  • 1 minute to read

    • You can send messages to customers as alerts, informational messages, or error messages.

    Table 1. Business rule and other general use scripts
    Script Result
    current.field_name.setError("Hello World"); Adds Hello World below the specified field in a red error message.
    gs.addInfoMessage("Hello World"); Adds Hello World at the top of the browser window in a blue info message.
    gs.addErrorMessage("Hello World"); Adds Hello World at the top of the browser window in a red error message.
    gs.print("Hello World"); Writes Hello World to the text log on the file system but not to the sys_log table in the database.
    gs.log("Hello World"); Writes Hello World to the database and the log file.
    Note:
    gs.log can adversely affect performance if used too frequently.
    Table 2. Client side scripts
    Script Result
    alert("Hello World"); Displays a window with Hello World and an OK button.
    Note:
    Rather than use JavaScript alert(), for a cleaner look, you can display an error on the form itself with thee showFieldMsg() and hideFieldMsg() methods. For more information, see Display field messages.
    confirm("Hello World"); Displays a window with Hello World? and OK and Cancel buttons.
    g_form.showFieldMsg("field_name", "Hello World", "error"); Adds Hello World below the specified field in a red error message.
    g_form.hideFieldMsg("field_name"); Hides the most recent message for the specified field.
    Important:
    The methods in this table are only for use in client scripts.
    It is also possible to add other custom messages to your forms if necessary using client scripting.

    The text size of info and error messages at the top of the screen is customizable. Two properties control this. If you configured your forms, you may need to add these properties.

    Note:
    The client script alert option is not available for use with Automated Test Framework (ATF).
    Table 3. Error and alert text size properties
    Property Description
    css.outputmsg.info.text.font-size Sets the size for info messages. Default is 11pt.
    css.outputmsg.error.text.font-size Sets the size for error messages. Default is 11pt.