Converting Notes® document links to web links

Notes® links that are contained in mail messages and viewed on HCL Traveler clients will now include an additional URL hotspot which points to the web address of the application server. It may be possible to open the linked application using a browser on the mobile device, similar to how applications can be opened using an iNotes® application.

There are a number of restrictions to consider with this functionality and some additional server configuration may be necessary:
  • The link can only be accessed if a connection can be made from the mobile device to the user's Domino® mail server and to the Domino® application server specified in the link. Generally, this requires that the mobile device use a virtual private network connection (VPN) to tunnel into the company intranet, or that the device is connected to a WiFi system which has access to these systems.
  • The application must be web enabled. This means that the Domino® HTTP service must be running on the Domino® application server and the application design must have enabled access from web clients. Some applications will look better than others when using a web browser. In particular, Domino® applications designed to use Domino® xPages design elements will be optimized for web viewing and for viewing from mobile devices.
  • The Domino mail server for the user receiving the document link must be version 8.5.3 or higher.

If the default settings are used, and a mail document that contains Notes® document links or views is synced to the mobile device, the Notes® link is preserved in the mail and an additional "web" link URL is added to the document in the same location. If this mail message was forwarded or replied to on the device, the recipient using a Notes® client would still be able to open the Notes® link if desired. The mobile user will need to click on the web link icon in order to launch a mobile device browser. The initial link will direct the browser to the user's mail server and then the browser will be redirected to the application server that was specified in the link. To avoid having to login to both the mail server and the application server, it is recommended that multi-server session authentication be configured on all Domino® servers so that single-sign is available and only one login prompt is necessary.

If the user's mail server is using a non-standard port or SSL is required at the mail server, then additional configuration parameters should be set on the HCL Traveler server. NTS_DOMINO_LINK_PORT can be used to change the default port number (if 80 or 443 are not in use) and NTS_DOMINO_LINK_PROTOCOL can be used to force the connection over SSL. The following table provides more information on these parameters as well as some other options parameters that can be set to influence the behavior of Notes® links within HCL Traveler mail messages. All parameters can be set using Domino® configuration commands, such as set config key=value.

Table 1. Notes Links Parameters
Parameter Value Description
NTS_DOMINO_LINK_BASE_REF URL. Default is not set. Rarely used. If this value is set, then all links will redirect to this URL prefix instead of a user's mail server. The value format would be similar to If a protocol and/or port is specified in the URL, then those values will override any value that might have been set for NTS_DOMINO_LINK_PROTOCOL or NTS_DOMINO_LINK_PORT.
NTS_DOMINO_LINK_PORT Number. Default is not set. Set to a specific TCP port number if the Domino® HTTP service running on your mail servers is using a port other than 80 or 443. This port will be used for all mail servers. As a result, it is important that these servers be configured consistently.
NTS_DOMINO_LINK_PROTOCOL "http" or "https". Default is not set. If your Domino® mail servers are configured to use SSL, set this value to https. If not, use the value http. This setting will be used for all mail servers. As a result, it is important that these servers are configured consistently.
NTS_DOMINO_LINK_SUPPORT 0 or 1. Default is 1. Set to 0 to disable Notes® link conversion to web links, 1 to enable it.
NTS_LINKHTMLALT 0 or 1. Default is 1. Set to 1 to use the text "Link" and "Notes® Link" for the link conversions. Set to zero to use graphical images.
NTS_OFFERNOTESURLINLINK 0 or 1. Default is 1. Set to 1 to include the original Notes® link in the mail as well as the web link. Set to 0 to only include the web link.