How to make Notification/Email Links dynamic when accessing via Desktop & Mobile
This Article provides you an idea on how you can make a link that acts dynamically based on the Device Type that you are accessing the link.
Use Case:
- I want to send a notification/email to the Fulfiller when the Requestor submits a catalog item request.
- I want to provide a link within that Email to direct him to take to the RITM to see what Requestor submitted
- If the Fulfiller opens the email using his Mobile, the RITM should opens using the Servicenow Agent Mobile App & if the Fulfiller opens the email using desktop, it should redirect him to the resolver view.
Servicenow API: MobileDeepLinkGenerator
There is an OOTB API called MobileDeepLinkGenerator where you can utilize this to construct the URL dynamically.
Reference: Click here
Step by Step Configuration
- Create a Portal Page and name it as “devicetype”
- Create a Script Include called “LinktoOpen” and add the below code
-
var LinktoOpen = Class.create(); LinktoOpen.prototype = Object.extendsObject(AbstractAjaxProcessor, { getLink: function() { var mb = this.getParameter('sysparm_mobile'); var tbl = this.getParameter('sysparm_tbl'); var sysid = this.getParameter('sysparm_sysid'); var link = 'sc_req_item.do?sys_id=' + sysid; if(mb) { var deepLinkGenerator = new global.MobileDeepLinkGenerator("agent"); link = deepLinkGenerator.getScreenLink("119ed9cf2f2460102dab2aa62799b6dd"); //SYS_ID OF YOUR APPLET } return link; }, type: 'LinktoOpen' });
- Create a Widget called “dtype” and add the below code
-
Server Script (function() { /* populate the 'data' object */ /* e.g., data.table = $sp.getValue('table'); */ data.tbl = $sp.getParameter('tbl'); data.sysid = $sp.getParameter('sysid'); })(); Client Controller function me($scope, $window) { var c = this; var isMobile = window.orientation > -1; var ga = new GlideAjax('LinktoOpen'); ga.addParam('sysparm_name','getLink'); ga.addParam('sysparm_mobile',isMobile); ga.addParam('sysparm_tbl',c.data.tbl); ga.addParam('sysparm_sysid',c.data.sysid); ga.getXML(getlnk); function getlnk(response) { var answer = response.responseXML.documentElement.getAttribute("answer"); $window.location.href = answer; } }
- Create a Notification Script and name it as “mobile_deeplink”
-
(function runMailScript( /* GlideRecord */ current, /* TemplatePrinter */ template, /* Optional EmailOutbound */ email, /* Optional GlideRecord */ email_action, /* Optional GlideRecord */ event) { var link = 'https://dev23541.service-now.com/sp?id=devicetype&tbl=sc_req_item&sysid=' + current.getValue('sys_id'); try { var hr = '<a href="' + link + '"' + ' target="_blank">Go to the RITM</a>'; template.print(hr); } catch (e) { } })(current, template, email, email_action, event);
- Create a Notification and configure
-
- “When to send” to On insert of RITM
- Recipients as the Resolver (You may include a default Resolver within the workflow of your catalog item just to see whether he is getting the email)
- Also, make sure you configure Email properties to send the email & have the email field on sys_user filled with a proper email.
Notification “What it will contain” Tab can be like this
Message HTML
Number: ${number}
Click below to open the Ticket. It opens with your NOW Mobile App when you are using your Mobile & Opens the SP Portal Status page when you are in Desktop.
${mail_script:mobile_deeplink}Now, Submit a request and see what happens on both Desktop & Mobile when you receive the email
Mobile View
Desktop View
When you click from desktop, it opens like this
When you click from Mobile, it opens like this
Please bookmark & mark it as helpful. Let me know in case of any further information required.
Thanks,
Narsing
