Direct Links to Objects in the Web App

Alloy Navigator Express uses e-mail notifications to communicate information about workflow-related events to technicians, and the majority of those notifications contain direct links to objects in the Web App. A technician just clicks the link in the email message, and the object from the notification opens in the Web App. For example, when an automated email notifies technicians about new ticket assignment, that email includes a direct link to the assigned ticket in the Web App.

To make this happen, the Web App supports short direct links to all objects.

The default workflow includes all the necessary macros and a number of ready-to-use notifications that use those macros to generate direct links to objects. Everything you need to do is to tell Alloy Discovery the URL of your Web App. You specify this URL when configuring the Web App using the Web Configuration tool.

INFO: For instructions, see Installation Guide: Customizing the Web Portal Link Macro.

More information about direct links

Direct links to objects in the Web App must be in the following format:

[ WebApp URL]/Go/[ObjectID]

where:

  • [WebAppURL] is the URL of your Web App ;
  • [ObjectID] is the object identifier, such as the number or KB Article ID.

For example, to refer to the #T000018 in the Web App installed at http://example.com/wp/, use this URL:

http://example.com/wp/Go/T000018

You can use macros to generate such links. For example, this macro could be used:

[Your WebApp URL]/Go/%[DBF OID]%

In this example:

  • [YourWebAppURL] is the URL of your Web App ;
  • %[DBF OID]% is the placeholder for the object’s identifier.

The default workflow provides a system macro holding only the link to the Web App (i.e. its URL): the Web Portal Link (%[SYS Web Portal Link]%). Other macros simply use that system macro in a combination with the placeholder for the object identifier. For example:

%[SYS Web Portal Link]%Go/%[DBF OID]%

When used in E-mail Notifications, this string will be replaced with the direct link to the object at runtime.

The default workflow contains a number of ready-to-use user macros based on the Web Portal Link system macro, and E-mail Notifications that use those macros. You can create your own user macros, if needed.

INFO: For instructions on creating macros, see Creating User Macros.