OfficeDev/Outlook-Add-in-On-Send

Name: Outlook-Add-in-On-Send

Owner: Office Developer

Description: Learn how to check for restricted words in an Outlook email message body, add a recipient to the CC line and check that there is a subject in the email on send.

Created: 2017-03-21 06:55:13.0

Updated: 2018-05-17 21:49:42.0

Pushed: 2018-03-14 19:57:06.0

Homepage: null

Size: 116

Language: JavaScript

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Outlook add-in on send code sample

Learn how to check for restricted words in an Outlook email message body, add a recipient to the CC line and check that there is a subject in the email on send.

Note:

Table of Contents
Change history

April 2017

Prerequisites
Configuring and installing the sample
  1. Download or fork the repository.

  2. Open app.js. In addCCOnSend function, change Contoso@contoso.onmicrosoft.com to your own email address.

  3. Deploy the add-in files to a directory on your web server. The files to upload are app.js and index.html.

  4. Open Contoso Message Body Checker.xml and Contoso Subject and CC Checker.xml manifest files in a text editor. Replace all instances of https://localhost:3000 with the HTTPS URL of the directory where you uploaded the files in the previous step. Save your changes.

    For more information about:

  5. running Outllook add-ins, see Running an Outlook add-in in an Office 365 account

  6. manifests, see Outlook add-in manifests

Upload the manifests
  1. Logon to Outlook Web App.

  2. Click Settings (the gear cog in the upper right corner of the page) to open the Settings page (as shown in the following screenshot).

    The settings page

  3. In Your app settings section of the Settings page, choose Mail.

  4. In the Options page, select General and then Manage add-ins (as shown in the following screenshot).

    The manage add-ins page

  5. On the Manage add-ins page, click the '+' icon, select Add from file. Browse to the Contoso Message Body Checker.xml manifest file included in the project. Click Next, then click Install. Finally, click OK.

  6. Repeat step 5 to install Contoso Subject and CC Checker.xml manifest file.

  7. Return to the Mail view in Outlook Web App.

Run the add-in
Subject and CC Checker
  1. Compose a new Outlook Web App email message.

  2. Leave the subject line blank.

  3. Add a recipient in the To line.

  4. Click Send.

  5. A carbon copy is added to the CC line. In this sample, it's Contoso@contoso.onmicrosoft.com.

  6. The email is blocked from being sent and an error message displayed on the information bar to notify sender to add a subject. (as shown in the following screenshot).

    The subject and CC checker information bar

  7. Add a subject line.

  8. A [Checked]: is added to the front of the subject line and email is sent.

Message Body Checker
  1. Create a new Outlook Web App email message.

  2. In the body of the message, type blockedword, blockedword1 or blockedword2. (These are the array of restricted words in the app.js file of the checkBodyOnlyOnSendCallBack function).

  3. Add a recipient in the To line.

  4. Click Send.

  5. The email is blocked from being sent because of blocked words found in the message body.

  6. An error message displayed on the information bar to notify sender of blocked words found (as shown in the following screenshot).

    The message body checker information bar

  7. To send the email, remove the blocked words.

Questions and comments

We'd love to get your feedback about this sample. You can send your feedback to us in the Issues section of this repository.

Questions about Microsoft Office 365 development in general should be posted to Stack Overflow. If your question is about the Office JavaScript APIs, make sure that your questions are tagged with [office-js] and [API].

Additional resources
Copyright

Copyright (c) 2016 Microsoft Corporation. All rights reserved.

This project has adopted the Microsoft Open Source Code of Conduct. For more information, see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.