Take Control of Your System Homepages!

//Take Control of Your System Homepages!

Take Control of Your System Homepages!

For the most part, homepage administration in ServiceNow is pretty simple. The basic concepts (which are documented on the ServiceNow wiki) are almost always enough to get by on. There are a couple of homepage administration situations that I’ve seen come up quite often that aren’t as easily understood. In this article I’ll describe the following situations and show you how to deal with them in your ServiceNow implementation.

  • How can I give ESS users (users with no role) access to more than one homepage?
  • How can I restrict roled users (itil, etc.) from modifying, adding, or deleting homepages?

How can I give ESS users (users with no role) access to more than one homepage?

The standard homepage setup in ServiceNow allows ESS users (users with no roles) to view a single homepage. This will be the first homepage the system sees that uses the ‘ess’ view. This makes for much easier administration and there’s typically no need for an additional homepage for end users (especially since they have access to the Service Catalog homepage as well).

I learned from Kenny Caldwell that it is possible to allow ESS users to see additional homepages though. The single-page restriction is imposed by an AJAX Script called ‘Home Scripts’. To allow users to view more than one homepage, take the following steps.

  1. Navigate to the ‘AJAX Scripts’ table by typing ‘sys_script_ajax.list’ in your left navigation filter and de-activate the ‘Home Scripts’ record. This removes the single-page restriction, but it doesn’t necessarily make additional homepages available to your end users.
  2. Navigate to ‘Homepage Admin -> Pages’ and remove the contents of the ‘Read roles’ and ‘User’ fields on the homepage you want to make available to ESS users.
  3. Create a link for your users to access the homepage by. You can do this by creating a new module pointing to the new homepage view like this…
    https://demo.service-now.com/home.do?sysparm_view=YOUR_HOMEPAGE_VIEW_NAME_HERE

    You can also make the homepage show up in a list of available pages when users hover over the ‘Home’ icon in the top-right corner of the browser. To do this, you’ll need to make sure the ‘Selectable’ checkbox is checked in the homepage definition. Then you’ll need to open up the ‘getUserHomepages’ global business rule and comment out these lines at the top of the script…

    if (!gs.getUser().hasRoles())
    return;

Once you’ve completed these steps, ESS users will be able to view all of their available homepages by hovering over the ‘Home’ icon as shown here…
ESS Multiple Homepages

How can I restrict roled users (itil, etc.) from modifying, adding, or deleting homepages?

I’ve worked with other clients who wanted to do almost the reverse of what I’ve outlined above. Instead of giving ESS users more capabilities in homepages, they want to ensure that technicians (or some other users with roles) cannot modify existing homepages or create their own homepages. This customization is actually much simpler because it leverages a system property to disable the homepage options.
The ‘glide.home.add_content.role’ system property can be used to remove any of the ‘Add Content’ options from the homepages. You simply add a comma-separated list of roles that should be able to modify homepages. While this is very simple, it’s also important to note that this is an ALL OR NOTHING customization for given roles. You can’t lock down a page here or a page there.

The following screenshot shows what options are disabled or removed for users excluded by this system property.
Disable Homepage Add Content

By | 2018-07-09T15:11:26-06:00 April 6th, 2011|Categories: System Definition|Tags: , |21 Comments

About the Author:

21 Comments

  1. Carleen Greenlee April 6, 2011 at 7:05 am - Reply

    One thing that I have noticed is that many users don’t know how to push changes on a homepage into an update set. It is documented in the wiki, but it works slightly differently than recording changes to other tables.

    The following steps were copied from the wiki on this page
    http://wiki.service-now.com/index.php?title=Homep

    1. Navigate to Homepage Admin -> Pages.

    2. Right-click on the homepage in the list.

    3. Select Unload Portal Page.

    One important note is that clicking this UI action essentially takes a snapshot of the homepage, it does not track subsequent changes. So make sure to unload the portal page AFTER you have completed all of the changes you want to make.

    • Mark Stanger April 6, 2011 at 7:35 am - Reply

      Great point Carleen! Thanks.

  2. Sean Grison April 11, 2011 at 8:50 am - Reply

    I will be taking advantage of multiple homepages for ESS right away! Thanks a bunch Mark

  3. John Gilaspy May 25, 2011 at 6:46 am - Reply

    So, is there a way to publish a gauge to a homepage and make it available to certain ESS users? I have a role created that allows specific users to see certain homepages, and the homepages have a gauge, but the gauge shows up blank for them.

    • Mark Stanger May 25, 2011 at 6:49 am - Reply

      It sounds like your gauge is okay, but those users don’t have access to the content being displayed inside of the gauge. You may have an ACL or before query business rule restricting access to that data.

  4. Tim Harris January 26, 2016 at 10:01 am - Reply

    It seems that “getUserHomepages” BR is no longer being used in Geneva. Do you know where we can modify this now?

    • Mark Stanger January 27, 2016 at 11:09 am - Reply

      I think the problem is that the ‘Home’ icon isn’t even in the Geneva UI. I’m not sure of a way to solve that other than to work around the issue by creating left nav module links for the various homepages.

      • Marian Sherrin February 29, 2016 at 2:49 pm - Reply

        Anyone know if they will put it back in Helsinki? We were just about to add homepages (we are on Fuji) and this is scaring me if they will just dissapear in a few months when we upgrade.

        • Mark Stanger February 29, 2016 at 2:59 pm - Reply

          I doubt ServiceNow even knows. I’d reach out to their support group to ask.

  5. Sam Ammar June 1, 2016 at 12:10 pm - Reply

    Mark can you make a Homepage public. So that users dont have to log in at all to see the data ??

    • Mark Stanger June 1, 2016 at 12:18 pm - Reply

      There’s no way to do this as far as I know. You could create a UI page though and make that public.

  6. Simon Willson June 30, 2016 at 9:15 am - Reply

    Is there a way to hide the “Switch to page” drop-down menu? For me in Geneva, the ‘glide.home.add_content.role’ system property doesn’t affect the that menu.

    I could make it so that they don’t have access to any other page, but it would be cleaner if it just wasn’t showing.

    • Mark Stanger June 30, 2016 at 10:43 am - Reply

      Only way I can think of is a UI script hack, but that would be likely to break during a future upgrade.

  7. Netesh February 23, 2017 at 11:56 pm - Reply

    Hi Mark,

    Is there anyway we can share a homepage with one particular group.
    I have already searched this is community and found there is no OOB way of doing it today.

    • Mark Stanger February 24, 2017 at 7:29 am - Reply

      The only way is to grant those groups/users a role (which can be assigned in the ‘Read roles’ field of the homepage record).

  8. jaspreet March 14, 2017 at 6:56 am - Reply

    Still my users are not able to see homepage I created. Please suggest.

  9. David March 27, 2017 at 6:55 am - Reply

    Is there a way to open up the ESS homepage so that non-roled users see the same data as ITIL users? My company has multiple OPCO’s so ESS users are only seeing ticket data for their particular OPCO where i would like to present a ticket overview for the whole group.

    • Mark Stanger March 27, 2017 at 7:47 am - Reply

      Hey David, that is possible but would have to be done within the context of the license agreement your organization has with ServiceNow. It actually has nothing to do with the homepage itself however. What you would need to do is open up the security of every table that needs to be presented on that homepage so that the appropriate people can see it. That would be done through ACLs and before query business rules and is going to depend on your specific setup. This SNGuru post (along with the SN community site for specific questions) should help you along with those concepts.
      https://www.servicenowguru.com/showcase/servicenow-security-tips/

      • David March 27, 2017 at 8:46 am - Reply

        Hi Mark, thanks a lot for the info, looks like i’m gonna have some fun in dev 🙂

  10. Piyush September 12, 2017 at 8:50 pm - Reply

    Hi Mark,

    Need your help –

    I am repeating the above asked question again –

    “Need to share a homepage with group/groups or user/users.
    I have already searched this is community and found there is no OOB way of doing it today”

    Any fix or solution ?

  11. Piyush September 12, 2017 at 8:53 pm - Reply

    I tried creating new field in the form layout with type as – LIST pointing to user table. Still no luck 🙁

Leave A Comment