Service Portal Woes

Two items I have to call out. First, this was inspired by Ratesh Shah's post. Second, you can read "Official" client script restrictions here on the docs.

Client Scripting issues

The Service Portal has more restrictions on it then the classic UI. In the past, any DOM manipulation or access and use of window across scripts was frowned on. With the Service Portal ServiceNow has removed the ability to mess with the Document Object Model (DOM). If you want to use those you'll have to change your scripts below.

Unsupported client scripting globals

The following globals and APIs are unavailable in client scripts in the Service Portal.

ThingDescription of the thing
windowThis is a object used by all browsers
documentThis is a object used by all browsers
$Prototypejs selector
$$Prototypejs css selector
$jAlias for jQuery
gelShortcut for window.getElementByID()

Re-usable utility functions

Macros and any Jelly are not supported on Service Portal. Two ways around this is Widget dependencies or the ScriptLoader utility.

Widget Dependencies

In Service Portal, you can add widget dependencies for re-usable utility functions.


Another way would be to add a ScriptLoader to the client script.

UI Type for Catalog Client Scripts and Catalog UI Policies

If you want a catalog client script to work on both service portal / mobile and regular platform, you must select UI Type = ALL or service portal / mobile. It may be tempting to update every client script's UI Type to All. for all catalog client scripts, but it may not be a good idea for performance reasons. Sometimes, there is a valid reason not to make the catalog client script available on portal due to functional reasons.

If you want a catalog UI policy to work on both service portal / mobile and regular platform, you must select Run scripts in UI Type = All. Use All, Desktop or Service Portal / Mobile based on your ask as explained above. This field is not available on the form, you can change it from list view.

You can use window object to detect if your catalog item is being used in Service Portal or CMS (Rest of platform).

if (window) {
// you are in CMS
} else {
// you are in Service Portal</em>