< Previous | Cookbook Contents

Overview

Organizations with an existing ecosystem of Domino applications may wish to enable notifications sent from those applications today to be surfaced as Embedded Experiences. With XPages in IBM Notes and Domino Social Edition, this is easy. A new "Send Mail" simple action can be used to send a URL Embedded Experience, with the URL pointing to the XPage application. When the Embedded Experience renders, end users will see the XPage application right in their e-mail.

Ryan Baxter and Stanton Sievers presented a webinar that walked through the Embedded Experiences concepts and enabling an XPage to send Embedded Experiences. It can be found on YouTube: Webinar 07/23/13: How to enhance Email with Embedded Experiences

Send Mail Simple Action

Developers building XPages in Domino Designer 9.0 will have access to a new simple action to send e-mails, including Embedded Experience e-mails. For more information, see Send Mail (Simple actions)

Enabling XPage Embedded Experiences

See the "Enabling a URL for an embedded experience" section of Creating OpenSocial widgets 9.0 or Creating OpenSocial widgets 9.0.1. The URL should use a wildcard as needed to ensure that all URL Embedded Experience e-mails sent are covered by the trust that is to be established by the creation of this Widget.

Handling Authentication

Because a URL Embedded Experience does not have access to OAuth and because there is currently no OAuth provider on the Domino server, any XPage application that is to be used an Embedded Experience will need an alternate form of authentication. If no action is taken, users may be prompted to login when they render the Embedded Experience, which results in a poor user experience.

Handling Authentication in Notes

In Notes, the preferred mechanism to handle authentication with a Domino server is via the Accounts framework. Administrators wishing to deploy XPage Embedded Experiences can push a managed account by policy to end users. This will allow the Notes client to SSO with the Domino server, making for a seamless user experience. If no account exists, end users will be prompted to login.

For more information on managed accounts, see Administrative accounts for management of client plug-ins. For an example account configuration, see the Sample Application section below

Handling Authentication in iNotes

In iNotes, if the iNotes server is in an SSO domain with the server on which the XPage is hosted, there are no extra considerations. If these servers are not in an SSO domain, end users will be prompted to login.

Sample Application

The Social Business Toolkit (SBT) examples within the Trouble Tickets application on OpenNTF exemplify the use of an XPage application to send Embedded Experiences that render an XPage.

Sample Account Configuration for Trouble Tickets

As mentioned in the "Handling Authentication in Notes" above, an account should be used in Notes when an XPage Embedded Experience requires authentication. Here is an example account using DOMINO-SSO for the Trouble Tickets application.

< Previous | Cookbook Contents