Administration Guide

Direct Links to Objects in the Web App

Alloy Navigator uses email and push notifications to communicate information about workflow-related events to technicians, and the majority of those notifications contain direct links to objects. A technician just clicks the link in the 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 Navigator the URL of your Web App. You specify this URL when configuring the Web App using the Web Configuration tool.

INFO: For instructions, see Specifying the Web App URL for Direct Links and Specifying the Self Service Portal URL for Direct Links.

More information about direct links

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

[WebAppURL]/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 https://example.com/wp/, use this URL:

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

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

[WebAppURL]/Go/%[DBF OID]%

In this example:

  • [WebAppURL] 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 one in a combination with the placeholder for the object identifier. For example:

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

When used in workflow, 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 also create your own user macros, if needed.

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