Homepage deprecation help tool features

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 3 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Homepage Deprecation Help Tool Features

    The Homepage deprecation help tool enables ServiceNow customers to manage and transition their homepages to dashboards effectively. Users can find all existing homepages, convert them to dashboards, retire them, or restore retired homepages as dashboards. Access the tool via All > Homepage deprecation help tool > Overview.

    Show full answer Show less

    Before using the tool, ensure the following steps are completed by an admin user:

    • Set the system property com.glideapp.home.deprecatehomepages to true to disable new homepage creation and set dashboards as the default landing page.
    • Populate the homepage migration status table by a user with either the admin role or the combination of dashboardadmin and flowdesigner roles.

    Key Features

    The Homepage deprecation dashboard consists of four tabs:

    • Overview: Start the deprecation process and view the general status of homepages.
    • Personal Homepages: Lists homepages owned by inactive or locked users.
    • Menus and Favorites: Displays homepages connected to menus and those marked as favorites by users; requires reconfiguration to point to new dashboards.
    • Usage: Shows homepages not viewed in the last 30 days, indicating potential candidates for retirement.

    The Overview tab also provides various reports to help track homepage statuses, including:

    • Homepages not deprecated
    • Converted homepages
    • Retired homepages
    • Restored homepages
    • Homepages assigned to users or groups
    • All converted homepages

    Key Outcomes

    Utilizing the Homepage deprecation help tool allows ServiceNow customers to streamline the migration from homepages to dashboards, ensuring a more efficient user experience. By identifying and managing the status of homepages, customers can enhance system usability and maintain organizational effectiveness during the transition process.

    Use the Homepage deprecation help tool to find all of your homepages in one place and convert them to dashboards, retire them, and restore retired homepages as dashboards.

    To access the Homepage deprecation dashboard, navigate to All > Homepage deprecation help tool > Overview.

    Before you use the homepage deprecation help tool, perform these two steps. A user with the admin role must change the system property. A user with the admin role or a user with both the dashboard_admin and flow_designer roles can populate the homepage migration status table.
    1. Disable the creation of new homepages: Set the system property com.glideapp.home.deprecate_homepages to true.
      Important:
      When set to true, this property disables the creation of new homepages and sets the default start page or landing page to Dashboards. Menu items and URLs that open homepages will continue to point to those homepages. Otherwise, homepages are unavailable and should be migrated using this tool.
    2. Populate the homepage migration status table.
    The Homepage deprecation dashboard has four tabs:
    Overview
    The overview enables you to start the deprecation process and view the general status of the homepages on your instance.
    Personal homepages
    A list of all the homepages that are owned by individuals who are inactive or locked out of the instance. Personal homepages are different than Global homepages, which are accessible to all users.
    Menus and Favorites
    Lists of homepages that appear on configured menus and homepages that are marked as favorites by users. In the first case, you must reconfigure the menu item to point to the converted dashboard. In the second case, you must alert users to mark the new converted dashboard as a favorite.
    Usage
    A list of all the homepages that have not been viewed in the last 30 days.
    Figure 1. Homepage deprecation dashboard
    Animated gif of homepage deprecation dashboard that scrolls through all four tabs

    Overview tab

    The Overview tab includes links for getting started and several reports that enable you to choose homepages that need attention.

    In the How to start section, admins have links to disable creation of new homepages and to populate the homepage migration status table.

    Report Type Description
    Homepages not deprecated Single score Number of homepages that you have not converted or retired. Select this report to see the associated homepages on the Homepage migration status table.
    Converted homepages Single score Number of homepages that you’ve converted to responsive dashboards. Select this report to see the associated homepages on the Homepage migration status table.
    Retired homepages Single score Number of homepages that you’ve retired. Select this report to see the associated homepages on the Homepage migration status table.
    Restored homepages Single score Number of retired dashboards that you’ve restored as responsive dashboards. Select this report to see the associated homepages on the Homepage migration status table.
    Assigned to users Bar report Homepages that are assigned to users. The bar labeled empty accounts for homepages that don’t have any assigned users. Select any bar in this report to see the associated homepages on the Homepage migration status table.
    Assigned to groups Bar report Homepages that are assigned to groups. The bar labeled empty accounts for homepages that don’t have any assigned groups. Select any bar in this report to see the associated homepages on the Homepage migration status table.
    All converted homepages from app and other actions List report All dashboards that have been converted from homepages, whether in the help tool, or by other means.

    Personal homepages

    Shows a list of the homepages whose owners are inactive or otherwise locked out. These homepages may be good candidates for retirement. Select the link to open a filtered list containing only the personal homepages to retire or convert them.

    Menus and Favorites

    The Menus and Favorites tab has three lists.
    Homepages connected to menus
    Shows the homepages that are connected menus in the filter navigator. When you convert or retire these homepages, you must point the menu item to the new dashboard or remove the menu item.
    Homepages connected to favorites
    Shows homepages that users identify as a favorite. When you convert or retire these homepages, you must inform the user that they should mark the new dashboard as a favorite.
    Menus and Modules connected to Homepages
    Shows homepages that appear in the filter navigator as either menu items or modules. You must edit the menu and module items to point to the new dashboard. If the menu or module items point to retired homepages, remove them.

    Usage

    The Usage tab shows a list of all homepages not viewed in the last 30 days. These homepages may be good candidates for retirement.