samantharamon / Outlook-Add-In-Actionable-Message

A sample Outlook add-in that is activated by an actionable message. Shows how to retrieve initialization context from the action.

page_type	products	languages	extensions
sample	office-365 office-outlook	javascript	contentType technologies createdDate samples Add-ins 10/19/2017 1:01:24 PM

Outlook Add-in: Actionable Message Activation

The sample demonstrates how to activate an add-in from an actionable message and pass an intialization context to the add-in.

Running the sample

In order to run this sample, you will need to host the included files on a web server. The choice of web server is completely up to you. The only requirement is that the web server be protected by a valid SSL certificate.

Update the manifest

Before loading the add-in, you must update the manifest to replace all instances of localhost:8080 with the base URL of the server where you are hosting your add-in.

Install the add-in

Follow the instructions in Sideload Outlook add-ins for testing to sideload the actionable-add-in.xml file to install the add-in.

Use the add-in

The add-in adds two buttons to the ribbon when you are reading email messages.

• Send Add-in Activation - This button allows you to send yourself an actionable email message with buttons that invoke add-ins.
• View Initialization Context - This button opens a taskpane and displays the current initialization context (if present).

Note: The initialization context is only present when the taskpane is invoked from an actionable message. If you open the taskpane by using the ribbon button, you will see a message letting you know that you need to invoke the add-in from a message.

1. Click the Send Add-in Activation button. A dialog opens to send the message:

   

2. (Optional): Modify the initialization context.

3. Click the Send Message button.

4. When the message arrives in your inbox, open it.

   

5. Click the Invoke "View Initialization Context" button.

6. The add-in taskpane opens and displays the initialization context.

   

Try on-demand installation of store add-in

You can use the second button in the actionable message to see how on-demand installation of store add-ins works. Before trying it, if you already have the Message Header Analyzer, be sure to uninstall it.

This project has adopted the Microsoft Open Source Code of Conduct. For more information, see the Code of Conduct FAQ or contact [e-mail] with any additional questions or comments.