Exchange

Defines a connection to the Microsoft Exchange mail server platform.

Remarks

ExchangeBinding provides a CMIS-compatible binding for connecting Grooper to Microsoft Exchange mail servers (on-premises or Exchange Online) via Exchange Web Services (EWS).

---

Overview

• Enables Grooper to access, search, and manage mail messages, appointments, contacts, and tasks from one or more Exchange mailboxes.
• Connectivity is established using EWS, supporting both on-premises Exchange and Exchange Online (Office 365).

---

Supported Content Types

Type	File Type / Extension	Description
Message	message/rfc822 (.eml)	Email messages
Appointment	text/calendar (.ics)	Calendar appointments
Contact	text/x-vcard (.vcf)	Contact records
Task	text/plain (.txt)	Tasks

Each type is exposed as a CMIS document type with its own set of queryable properties.

---

Repository Mapping

• Each mailbox in the MailboxList property is mounted as a separate CMIS repository.
• The login account must have access to all mailboxes listed (see Microsoft documentation on delegate access).
• Folders and items within each mailbox are exposed as a hierarchical tree structure.

---

Authentication

• Supports multiple authentication methods:
  • Auto (Windows credentials)
  • Basic (username/password)
  • NTLM
  • OAuth 2.0 (for Exchange Online)
• See the AuthenticationMethod property for configuration.

---

Search Capabilities

• All document types are full-text searchable and expose type-specific queryable properties.
• Full-text search finds exact substrings in the document body. Operators such as AND/OR are not supported within a single CONTAINS() predicate; use multiple predicates for complex logic.
• The UseSearchFolder property enables use of a dedicated Exchange Search Folder for fast queries and total counts (applies to Message type, root-level queries without CONTAINS()).

---

Usage Notes

1. Configure Mailboxes
   • Add one or more email addresses to MailboxList.
   • Ensure the login account has access to each mailbox.
2. Set Authentication
   • Choose and configure the appropriate AuthenticationMethod.
3. Enable Search Folder (Optional)
   • Set UseSearchFolder to true for improved query performance on large mailboxes.
4. Import Repositories
   • Use Grooper's CMIS Connection UI to import and manage repositories.

---

Security Considerations

• Access to mailboxes is governed by Exchange permissions and the selected authentication method.
• For delegated access, configure permissions in Exchange as documented by Microsoft.
• OAuth is recommended for Exchange Online for enhanced security.

---

Limitations

• Only EWS-compatible Exchange servers are supported.
• Some advanced search operators and predicates may not be available.
• Full-text search is substring-only; logical operators must be expressed as multiple predicates.
• Search Folder optimization applies only to certain query types (see UseSearchFolder).

---

References

• Microsoft Exchange
• Exchange Web Services (EWS)
• Grooper CMIS Documentation

---

> Note: This class is intended for use within Grooper's CMIS infrastructure and is not a general-purpose Exchange client.

Properties

Name	Type		Description
Host Name	String	►	The host name or IP address of the Microsoft Exchange server. For example: 'outlook.office365.com' is the hostname for Exchange Online. If no value is specified, auto-discovery will be used to obtain the host name from the email address provided.
Authentication Method	HTTP Authentication Method	►	Specifies the method used to authenticate user credentials. ConverterAuth Method Converter Requiredtrue Can be one of the following types: Value Description Exchange OAuth Implements OAuth 2.0 authentication for connecting Grooper to Microsoft Exchange Online (Office 365) using Azure AD. OAuth Service Login Implements OAuth 2.0 authentication using the client credentials flow for secure server-to-server access in Grooper. Anonymous Authentication Implements HTTP authentication where no credentials or identity are provided to the server. Auto Authentication Authenticates HTTP requests using the credentials of the current Windows user. Basic Authentication Implements Basic HTTP Authentication for connecting to external content platforms in Grooper. NTLM Authentication Implements NTLM (Windows Integrated) Authentication for connecting to external content platforms in Grooper. OneDrive OAuth Implements OAuth 2.0 authentication for connecting Grooper to Microsoft OneDrive and SharePoint Online using a Microsoft account. SharePoint OAuth Implements OAuth 2.0 authentication for connecting Grooper to SharePoint Online (365) using Azure AD. When using Basic Authentication, enter the e-mail address as the user name.
Mailbox List	List(Of String)[]	►	Specifies a list of mailboxes to be mounted as repositories. EditorString List Editor ConverterPg String Collection Converter This list should contain one email address per line. The login account used must have access to each mailbox listed. Refer to Microsoft documentation on configuring delegate access when connecting to mailboxes other than the login user's primary email account.
Use Search Folder	Boolean	►	Enables the use of an Exchange "Search Folder" to enhance query functionality. DefaultFalse When enabled, a search folder provides two primary advantages: Searches execute fast. A total count of matching items will be returned. Grooper will automatically create a Search Folder named "Grooper Search" which indexes all mail items below the root of the message store. The search folder will be created automatically the first time a query is executed, or can be created manually using the Exchange - Rebuild Search Folder command, available on the right-click menu from the Property Grid. When a search is performed, the Search Folder will be used only when the following conditions are true: The content type being queried is "Message". The query applies to the entire message store (i.e. no IN_FOLDER or IN_TREE predicates have been used). The WHERE clause does not include a CONTAINS Predicate.
Timeout	Int32	►	The connection timeout, in seconds. Default100 Min1 Max1000

Context Menu Commands

Command	Shortcut	Description
youtube_searched_for Rebuild Search Folder		Deletes and recreates the dedicated Exchange Search Folder used by Grooper for optimized message queries.

See Also

Exchange OAuthOAuth Service LoginAnonymous AuthenticationAuto AuthenticationBasic AuthenticationNTLM AuthenticationOneDrive OAuthSharePoint OAuth

Used By

CMIS Connection