All Collections
Outlook for NetSuite
Getting Started
For Admins
Admin: Understand CloudExtend Outlook Client, Server, and NetSuite Prerequisites
Admin: Understand CloudExtend Outlook Client, Server, and NetSuite Prerequisites

OLNS | Learn about what's required for Exchange Server, Microsoft 365, and Outlook clients to effectively use CloudExtend Outlook

Updated over a week ago

We highly recommend that your org license Microsoft 365 for email hosting as well as your Office Applications. Standalone versions of Microsoft Outlook do not receive APi updates from Microsoft. A Microsoft 365 subscription will ensure maximum compatibility with CloudExtend both now and in the future as we leverage new Microsoft technologies that may only be available in the latest versions.

Minimum Requirements to install and use Microsoft Outlook Add-Ins

For Outlook add-ins to load and function properly, there are several requirements for both the servers and the clients. In addition, for CloudExtend add-ins, there are several NetSuite prerequisites.


NetSuite Prerequisites

Company-Wide Settings

NetSuite Administrators need to enable SOAP Web Services (1) and Token Based Authentication (2) globally by navigating to Setup> Company> Enable Features> SuiteCloud and checkboxes 1 and 2 below.
โ€‹

End-User Settings

  • Ensure that the role is not set to a Web Services Only role and that the role has the necessary permissions for each record type the user will be working with.

  • Enable the user preference Rich Text Editing in NetSuite ( Home> Set Preferences> Appearance). While not required we have found that certain emails with HTML may transfer as blank or with all the HTML coding if this setting is not enabled at the user level. This may result in a NetSuite error such as The field message containing more than the maximum number (1000000) of characters allowed.

  • Ensure that the following permissions are enabled on any and all roles that will be logging in and using CloudExtend Outlook (Setup > Users/Roles > Manage Roles) :

  1. SOAP Web Services

  2. User Access Tokens

  3. SAML Single Sign-On (ONLY if your company uses Single Sign-On, ie OKTA, OneLogin, etc. - If you enable SSO and do not actually use SSO, users will NOT be able to login to NetSuite until you remove it).

  4. Allow JS/HTML uploads if your user will need to upload .js and .htm files

  5. Documents and Files (if users will be attaching files): Minimum permission required is Create.
    ๐Ÿ’ก Note: Full access is required only for users that have enabled the legacy attach method.

  6. Track Messages: Minimum permission required is Create.


Outlook and Exchange Prerequisites

Below is a list of minimum prerequisites to run Microsoft Add-Ins built for Outlook. It is compiled from this Microsoft support article. We highly recommend that your org use Microsoft 365 for email hosting as well as your Office Applications. This will ensure maximum compatibility with CloudExtend both now and in the future as we leverage new Microsoft technologies only available in the latest versions.

Outlook Client Prerequisites

The client must be connected to an Exchange server or Microsoft 365 using a direct connection. When configuring the client, the user must choose an Exchange, Office 365, or Outlook.com account type. If the client is configured to connect with POP3 or IMAP, add-ins will not load.ย 

CloudExtend OneDrive and Sharepoint for Business is designed only to work with OneDrive and SharePoint for Business accounts and not personal OneDrive accounts.

The following clients support Outlook add-ins:

  • Outlook with a Microsoft 365 subscription*

  • Outlook 2016 or later for Windows (limited functionality without a Microsoft 365 subscription)

  • Outlook 2016 or later for Mac

  • Outlook for iOS

  • Outlook on Android

  • Outlook on the web for Exchange 2016 and Office 365

  • Outlook on the web for Exchange 2013

  • Outlook.com


Mail Server Prerequisites

Exchange Servers on Microsoft 365 or outlook.com

If the user is connected to Microsoft 365 or Outlook.com, mail server requirements are all taken care of already.ย 

On-Premises Exchange Servers

For users connected to on-premises installations of Exchange Server, the following requirements apply.

  • The server must be Exchange 2013 or later.

  • Exchange Web Services (EWS) must be enabled and must be exposed to the Internet. Many add-ins require EWS to function properly.

  • The server must have a valid authentication certificate in order for the server to issue valid identity tokens. New installations of Exchange Server include a default authentication certificate. For more information, see Digital certificates and encryption in Exchange 2016 and Set-AuthConfig.

  • To access add-ins from the Office Store (Appsource), the client access servers must be able to communicate with AppSource

  • Not all CloudExtend features (such as but not limited to Autopilot) will function on on-premise Exchange Servers

๐Ÿ’ก Some current features such as categorization of emails and many future features are dependent on the latest API's from Microsoft and are only available on Microsoft 365 online Exchange Servers combined with Microsoft 365 client subscriptions. A Microsoft 365 subscription ensures that you will receive feature updates (new and improved API's) from Microsoft and CloudExtend.


Shared mailbox support

In order to support shared mailboxes, the users must be added to the shared mailboxes by their Exchange Admin and should not manually add them to their Outlook profile. See this article for more details.

Did this answer your question?