Classifier Mail Add-in Manifest

VERSION 3.13.1

RELEASE NOTE

Boldon James

April 2022

RN567107

CONTENTS

INTRODUCTION

SYSTEM REQUIREMENTS

INSTALLATION INSTRUCTIONS

FURTHER INFORMATION

DOCUMENTATION

COMPARISON WITH PREVIOUS RELEASES

CONTACT US

1.   INTRODUCTION

Classifier Mail Add-in provides Classifier functionality in Outlook Web App in Exchange Server 2016, Exchange Server 2019 and Exchange Online in Office 365.

The Classifier Mail Add-in Manifest is the file used to install the Classifier Mail Add-in into Exchange Server 2016, Exchange Server 2019 or Exchange Online in Office 365. Classifier Mail Add-in Manifest requires a Classifier Mail and Office Add-in Website. The Classifier Mail Add-in Manifest requires updating with the location of your Classifier Mail and Office Add-in Website installation.

Note: Please ensure Classifier Mail and Office Add-in WebSite and Manifest file versions are kept in step.  If upgrading the Website the corresponding manifest must also be upgraded.

Back to contents

2.   SYSTEM REQUIREMENTS

2.1 Software - Server

• Exchange 2016 (Cumulative Update 20 or later), Exchange Server 2019 (Cumulative Update 9 or later) or Exchange Online in Office 365
• Classifier Mail and Office Add-in Website installed and configured

Back to contents

3.   INSTALLATION INSTRUCTIONS

Enabling Mail Add-ins On Send Functionality

By default, the Mail Add-ins On Send functionality is disabled for all users.The Mail Add-ins On Send functionality must be enabled for all Classifier Mail Add-in users for the Classifier Mail Add-in to operate correctly.

The Mail Add-ins On Send functionality is enabled by applying an OWA Mailbox Policy which has the On Send functionality enabled to all Classifier Mail Add-in users. OWA Mailbox Policies are configured using Exchange or Exchange Online PowerShell cmdlets.

Use the Set-OWAMailboxPolicy powershell cmdlet to set the OnSendAddinsEnabled property to $true on all OWA Mailbox Policies which are or will be applied to Classifier Mail Add-in users.

All Classifier Mail Add-in users must have an OWA Mailbox Policy assigned to them which has the OnSendAddinsEnabled property set to $true. The Set-CASMailbox powershell cmdlet can be used to apply a OWA Mailbox Policy to users using the OwaMailboxPolicy property.

Please note that it can take several hours or days for changes to OWA Mailbox Polices to be applied to users.

Pre-requisites and Recommendations

The supplied Classifier Mail Add-in Manifest file "ClassifierMail.xml" must be edited to include the name of the website hosting the Classifier Mail and Office Add-in Website.

Replace all "REPLACE_WITH_YOUR_SERVERNAME" references with the host, and optionally the port number, from the authority part of the URL for your Classifier Mail and Office Add-in Website.

E.g. if your Classifier Mail and Office Add-in Website has the URL "https://myserver.mydomain.com/" then the replacement value for "REPLACE_WITH_YOUR_SERVERNAME" would be "myserver.mydomain.com".

A requirement for a Mail Add-in is that the website it references must use a SSL secured https connection. To support this:

• The Classifier Mail and Office Add-in Website must be configured to use a https binding.
• The Classifier Mail Add-in Manifest must use https URLs for that Classifier Mail and Office Add-in Website.

Installation

1. Open the Exchange Admin Center.
2. Select the "Organisation" section.
3. Select the "Add-ins" option.
4. Click on the Plus icon and select "Add from file".
5. Browse to the "ClassifierMail.xml" file modified in the "Pre-requisites and Recommendations" section
6. Click on Next to add the Classifier Mail Add-in.
7. Click on "Classifier" from the list of add-ins to select it.
8. Click on the Pen icon to edit the "Classifier" add-in.
9. Select the "Make this add-in available to users in your organization" option to make this add-in available to your users.
10. Select the "Mandatory, always enabled. Users can't disable this add-in." option to make this add-in always available to your users.
11. Click on Save to save the settings.

Uninstallation

1. Open the Exchange Admin Center.
2. Select the "Organisation" section.
3. Select the "Add-ins" option.
4. Click on "Classifier" from the list of Add-ins to select it.
5. Click on the Bin icon to remove the "Classifier" add-in.
6. Select Yes to confirm you wish the remove the "Classifier" add-in.

Back to contents

4.   FURTHER INFORMATION

Disabling Office Add-in when COM add-in is running in desktop Office

When running "Email and Office Classifier" COM add-in on desktop machines, users will likely prefer to disable the web Mail Add-in to prevent confusion. This can be done by following the Microsoft documentation found here: Make your Office Add-in compatible with an existing COM add-in.

The following id's will be required to complete the Microsoft guide:

• Mail Add-in Id: 979B9530-E85F-4199-B083-4AB91236010B
• COM Add-in ProgId: BoldonJames.SAFEoffice.Addin.Connect

Limitations

• Classifier Mail Add-in is not available in Basic Mode in Outlook Web App. Outlook Web App Basic Mode does not support Mail Add-ins.
• Classifier Mail Add-in does not support offline mode in Outlook Web App.
• Classifier Mail Add-in only supports messages. Other item types, including meetings and appointments, are not supported.
• Attached MSG and EML message files types cannot be classified using Classifier Mail Add-in.
• Classifier Mail Add-in does not support Shared mailboxes.
• Classifier Mail Add-in does not support Group mailboxes.
• All clients accessing the Classifier Mail Add-in require an Internet connection to access the Microsoft "appsforoffice" Content Delivery Network.
• "Check for label change" rules are only supported when forwarding or replying to message items.
• "Check for additional recipients on reply or forward" not supported
• "Check clearance for recipients" rules only support SMTP domain clearances.
• "Check for expired selectors" rules are not supported.
• "Add these addresses" rules are not supported.
• "Apply S/MIME security to the message" rules are not supported.
• "Apply a delivery report request" rules are not supported.
• "Apply a read receipt request" rules are not supported.
• "Apply this importance value" rules are not supported.
• "Apply this sensitivity value" rules are not supported.
• "Apply this expiry value" rules are not supported.
• Classifier visual markings are applied when messages are sent. If the message send is stopped by subsequent processing or user actions after the Classifier Mail Add-in has updated the visual markings, then the visual markings are not removed from the message.
• Mail Add-ins cannot expand distribution lists. This has been raised to Microsoft as issue 937 for OfficeDev office-js. It is recommended that the Classifier Application Setting "Always use distribution list clearances" is set to Enabled for Outlook Web Access while this Microsoft issue has not been fixed.
• Mail Add-ins running within the Office 365 environment cannot prepend portion marking to selected ranges and will overwrite selection.  See issue 1178 for OfficeDev.
• Inserting a portion marking when the message body is not in focus may cause previously selected text to be overwritten.
• Selector value tooltips are not supported for "Single selection list" or "Date offset list" selectors when configured to display as list.
• Selectors configured to display values as a list do not support displaying colours or images.
• Marking format setting 'Use Plain text style' is not supported.

Back to contents

5.   DOCUMENTATION

The main product suite documentation is installed with the Classifier Administration Console.

Back to contents

6.   COMPARISON WITH PREVIOUS RELEASES

6.1      Classifier Mail Add-in Manifest version 3.13.1

• Added support for new "Message Body Length" condition type. See the Classifier Administration Server User Guide for more details.

6.2      Classifier Mail Add-in Manifest version 3.13.0

• Closed Network support
• Rule conditions (Originator email address only)
• Clearance Masking based on Dynamic Clearances (Originator email address only)

6.3      Classifier Mail Add-in Manifest version 3.12.0

• Added Portion Marking feature
• Added support for Exchange Server 2019

6.4      Classifier Mail Add-in Manifest version 3.10.1

• No changes.

6.5      Classifier Mail Add-in Manifest version 3.10.0

• Updated for the 3.10.0 release of the Classifier Mail and Office Add-in Website
• Exchange Server 2016 must have Cumulative Update 6 or later installed.
• Exchange Server 2013 is not supported.
• Mail Add-ins On Send Functionality must enabled for all Classifier Mail Add-in users
• Only messages are supported. Other item types, including meetings and appointments, are not supported.
• Classifier rules checking when a message is sent.
• Classification selection uses a dialog.

6.6      Classifier Mail Add-in Manifest version 3.8.2

• Updated for the 3.8.2 release of the Classifier Mail Add-in Website
• All clients accessing the Classifier Mail Add-in require an Internet connection to access the Microsoft "appsforoffice" Content Delivery Network.

6.7      Classifier Mail Add-in Manifest version 3.8.1

• First release.

Back to contents

7.   CONTACT US

All contact with Boldon James regarding this product should be directed to:

Electronic mail	Phone/Fax	Postal address
support@boldonjames.com (support desk) info@boldonjames.com (general enquiries) sales@boldonjames.com (sales team)	Support: +44(0) 1270 507810 Fax.: +44(0) 1270 507801 Tel.: +44(0) 1270 507800 (general and sales enquiries)	Boldon James Ltd, 1 Westmere Court, Westmere Drive, Crewe, Cheshire, England CW1 6ZE

The support services available are as defined in the current support agreement.

Back to contents