Including URLs (Smart URLs)

You can include links to the items that require the recipients' attention in your notifications.You can configure notifications to include the Web address (URL) for the following entities:

  • Packages

  • Requests

  • Request types

  • Projects

  • Tasks

  • Workflows

  • Validations

  • Object types

  • Environments

A user viewing email with a web-based mail reader (such as Microsoft® Outlook) can click the URL in the notification to go directly to the referenced entity.

For workflows, request types, validations, object types and environments the notification can use the entity ID or the entity name as the parameter in the URL. This will bring you to the correct window in the PPM Workbench and open the detail window for the specified entity.

Table 3-2.Smart URL tokens lists the most commonly used smart URL tokens for packages and requests.

Table 3-2.Smart URL tokens

Smart URL Token

Description

PACKAGE_URL

Provides a URL that loads the package details page in the standard interface.

WORKBENCH_PACKAGE_URL

Provides a URL that loads the package window in the PPM Workbench.

REQUEST_URL

Provides a URL that loads the request details page in the standard interface.

If you use an HTML-formatted message, you must use an alternate token to provide a link to requests. (You can also use this token in plain-text formatted notifications.) The smart URL token (for HTML format) for requests is REQUEST_ID_LINK.

The REQUEST_ID_LINK token provides a link that loads the request detail page in the standard interface. This token resolves to the following format:

<a href="http://URL">Request Name</a>

In the notification, the link is displayed as a linked entry.