System Requirements and Technical Considerations

SuiteProjects Pro Exchange Integration Manager is a Windows-based application that enables IT system administrators to set up and run the integration between SuiteProjects Pro and Microsoft Exchange. This help topic includes detail about the following system requirements and technical considerations:

System Requirements to install, configure and run Exchange Integration Manager on your computer.
Infrastructure that Exchange Integration Manager supports.
Communication Interfaces used by the SuiteProjects Pro <> Exchange integration.
Role Permissions required to set up and run the SuiteProjects Pro <> Exchange integration.

Infrastructure

You can use the SuiteProjects Pro <> Exchange integration with an on-premise Windows domain network configuration, a cloud-based environment, or an hybrid configuration.

On-premise	Online	Hybrid
Active Directory (LDAP protocol)	Microsoft Entra ID (formerly Azure Active Directory)	—
All mailboxes stored in Exchange Server organizations. Supported version: 2016. You must run the same version of Microsoft Exchange Server across all instances to use the integration with mailboxes stored in multiple Exchange Server organizations.	All mailboxes stored in Exchange Online organizations.	Some mailboxes are stored in Exchange Online organizations, some in on-premise Exchange organizations.

On-premise

Online

Hybrid

Active Directory (LDAP protocol)

Microsoft Entra ID (formerly Azure Active Directory)

—

All mailboxes stored in Exchange Server organizations.

Supported version: 2016.

You must run the same version of Microsoft Exchange Server across all instances to use the integration with mailboxes stored in multiple Exchange Server organizations.

All mailboxes stored in Exchange Online organizations.

Some mailboxes are stored in Exchange Online organizations, some in on-premise Exchange organizations.

Note:

Review the following guidelines:

If Active Directory is not available, you need to set up mapping between SuiteProjects Pro and Exchange Server users manually.
If some or all mailboxes are stored in an on-premise Exchange organization, you should install Exchange Integration Manager on a separate server or workstation on the same network as the company's Exchange server. This ensures the integration has access to Active Directory to query users, but does not store the integration configuration on the same server.
If Exchange Integration Manager is set up on a remote server outside the company network, the integration typically needs VPN access to the company network to be able to interface with the Exchange server.

System Requirements

The following requirements must be met to install, configure, and run Integration Manager:

Operating System
- Microsoft Windows Server 2016 or 2019
- Microsoft Windows 10 or 11
Microsoft .NET Framework Version 4.7.2.

Note:
The Exchange Integration Manager installer automatically downloads it if it is not installed on your computer.
RAM 1GB or more.

Communication Interfaces

Exchange Integration Manager use the following communication interfaces:

SuiteProjects Pro XML API to transfer information from and to SuiteProjects Pro over a secure layer using the HTTPS protocol (port 443). No incoming ports need to be opened in the firewall.
Active Directory Services Interface (ADSI) and Lightweight Directory Access Protocol (LDAP) to communicate with on-premise Active Directory and retrieve the user information (email address and home mailbox server) required to map Exchange user mailboxes (and associated Active Directory user accounts) with SuiteProjects Pro user records.
Exchange Web Services (EWS) to connect to Microsoft Exchange and create calendar events in user mailboxes.
Important:
Note the following compatibility guidelines:
- Exchange Integration Manager 5.0 or later version does not support WebDAV.
- Microsoft no longer supports Basic authentication for EWS to access Exchange Online. Exchange Integration Manager 5.1 introduced support for using OAuth 2.0 to connect to Exchange Online using EWS. To configure and run the integration between SuiteProjects Pro and Microsoft Exchange Online, you must use Exchange Integration Manager 5.1 or later version and register Exchange Integration Manager with Microsoft Entra ID. See Registering Exchange Integration Manager With Microsoft Identity Platform.

Role Permissions

To set up and run SuiteProjects Pro <> Exchange integration you must have user accounts with the following permissions:

Software	Role permissions	Notes
SuiteProjects Pro	Account administrator	Required to read and update all task assignments, resource bookings, and schedule requests.
Active Directory	Domain administrator	Required to read the user information (email address and home mailbox server) required to map Exchange user mailboxes (and associated Active Directory user accounts) with SuiteProjects Pro user records.
Microsoft Exchange	Administrator	Required to grant access to user mailboxes and modify Exchange settings if necessary.
Read and Write access permissions to all user mailboxes	Should be used to run Exchange Integration Engine, which does not require Exchange or Enterprise administrator privileges.
Windows / Windows Server	Administrator	Required to run SuiteProjects Pro Exchange Integration Setup and Exchange Integration Engine applications.

Software

Role permissions

Notes

SuiteProjects Pro

Account administrator

Required to read and update all task assignments, resource bookings, and schedule requests.

Active Directory

Domain administrator

Required to read the user information (email address and home mailbox server) required to map Exchange user mailboxes (and associated Active Directory user accounts) with SuiteProjects Pro user records.

Microsoft Exchange

Administrator

Required to grant access to user mailboxes and modify Exchange settings if necessary.

Read and Write access permissions to all user mailboxes

Should be used to run Exchange Integration Engine, which does not require Exchange or Enterprise administrator privileges.

Windows / Windows Server

Administrator

Required to run SuiteProjects Pro Exchange Integration Setup and Exchange Integration Engine applications.

Known Limitations

The integration has the following limitations:

Exchange Web Services (EWS) limits the calendar item duration to five years maximum. If any task assignments, resource bookings or time off requests exceed five years in SuiteProjects Pro, the integration automatically sets the duration of calendar events to five years (maximum duration supported by EWS).

Backup

You should backup the file containing your SuiteProjects Pro <> Exchange integration configuration settings (oaexchdb.mdb) periodically. The file is located in the Exchange Integration Manager installation folder – typically, C:\Program Files (x86)\SuiteProjectsPro\ExchangeManager.