ShowTable of Contents
< 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