Skip to content

Application Screen ^v2.7.212 ​

Returns an ApplicationScreen object from the application screens object.

Application Screen Object ​

Methods ​

  • id() ​

    Returns the screen id as a string.

  • title() ​

    Returns the screen title as a string.

  • page() ​

    Returns the configured page id as a string.

  • route() ​

    Returns the screen route as a string.

  • Returns the header page id as a string.

  • Returns the footer page id as a string.

  • pageType() ​

    Returns the configured page type as a string.

  • pageName() ​

    Returns the configured page name as a string.

  • setTitle(title) ​

    Updates the screen title.

    • title (string): The new title.
  • setPage(type, id) ​

    Updates the page assignment for the screen.

    • type (string): The page type. Valid values are "workview", "card", "page".
    • id (string): The page id.
  • setRoute(route) ​

    Updates the screen route.

    • route (string): The new route.
  • setHeader(header) ​

    Updates the screen header.

    • header (string): The new header value.
  • Updates the screen footer.

    • footer (string): The new footer value.
  • setHomepage() ​

    Marks this screen as the application homepage.

  • remove() ​

    Removes this screen from the application and returns true if the screen was removed, otherwise false.

  • json() ​

    Returns the screen as an object.

Examples ​

js
var app = security.application("My Application");
var screen = app.screens.get("Planner");

screen.setHomepage();

console.log(screen.json());