# Exchange Connector

# Installation requirements

**Technology used:**

- PHP
- Mysql
- Javascript

**HW/SW requirements**

- vtenext v18.05 or higher
- The connector does not require particular hardware specifications , you must take into account 4Mb of additional RAM to the vtenext server for each user
- Installed in the same machine where the vte resides
- The machine must be able to communicate with the Exchange server
- For the Exchange on premise server, the server certificate must be valid
- Request php soap library

**Request for its installation**

- Access via SSH to the vtenext server
- Access with web admin account to the vtenext application
- Temporary test mailbox on the Exchange server

# Functionality

<table border="1" id="bkmrk-sync-appuntamenti-di" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 62.0988%; vertical-align: middle;">**Calendar appointments sync**</td><td class="align-center" style="width: 12.9012%; vertical-align: middle;">![](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/image-1574250034624.png)

</td><td class="align-center" style="width: 11.5741%; vertical-align: middle;">![](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/image-1574250154722.png)

</td><td class="align-center" style="width: 13.4259%; vertical-align: middle;">![](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/image-1574250139101.png)

</td></tr><tr><td style="width: 62.0988%; vertical-align: middle;">**To do sync tasks**</td><td class="align-center" style="width: 12.9012%; vertical-align: middle;">![](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/image-1574250034624.png)</td><td class="align-center" style="width: 11.5741%; vertical-align: middle;">![](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/image-1574250156701.png)

</td><td class="align-center" style="width: 13.4259%; vertical-align: middle;">![](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/image-1574250139101.png)</td></tr><tr><td style="width: 62.0988%; text-align: justify; vertical-align: middle;">**Contacts sync:**  
Contact synchronization is implemented unidirectionally from vtenext to Exchange. Considering that in CRM the deletion of a contact leads to the loss of links to entities related to it (e.g.: tickets, quotes, report visits, newsletter campaigns ...), it was decided to allow contact synchronization  
only from vtenext to Exchange and not the opposite. Furthermore, this avoids possible problems due to massive import of contacts from your address book, creating incomplete data problems (for example: not connected to any company registry) and potential duplicates.</td><td class="align-center" style="width: 12.9012%; vertical-align: middle;">![](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/image-1574250034624.png)</td><td class="align-center" style="width: 11.5741%; vertical-align: middle;">![](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/image-1574250163151.png)

</td><td class="align-center" style="width: 13.4259%; vertical-align: middle;">![](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/image-1574250139101.png)</td></tr></tbody></table>

# Synchronization flow

**Synchronization flow from Exchange to vtenext**

### **PHASE 1**

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%;"><tbody><tr><td class="align-center" style="width: 33.3333%; vertical-align: middle;">[![image-1574250139101.png](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/image-1574250139101.png)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/image-1574250139101.png)</td><td class="align-center" style="width: 33.3333%; vertical-align: middle;"><span style="font-size: small;"><span style="font-size: medium;">[![streaming1.jpg](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/streaming1.jpg)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/streaming1.jpg)</span></span></td><td class="align-center" style="width: 33.3333%; vertical-align: middle;">[![image-1574250034624.png](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/image-1574250034624.png)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/image-1574250034624.png)</td></tr></tbody></table>

Streaming channel always active between vtenext and Exchange.

---

### **PHASE 2**

<table border="1" id="bkmrk--1" style="width: 100%; border-collapse: collapse;"><tbody><tr><td class="align-center" style="width: 33.3333%; vertical-align: middle;">[![image-1574250139101.png](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/image-1574250139101.png)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/image-1574250139101.png)</td><td class="align-center" style="width: 33.3333%; vertical-align: middle;"><span style="font-size: small;"><span style="font-size: medium;">[![frecciasx.jpg](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/frecciasx.jpg)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/frecciasx.jpg)</span></span></td><td class="align-center" style="width: 33.3333%; vertical-align: middle;">[![image-1574250034624.png](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/image-1574250034624.png)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/image-1574250034624.png)</td></tr></tbody></table>

Arrival of an item from Exchange.

---

### **PHASE 3**

<table border="1" id="bkmrk--3" style="width: 100%; border-collapse: collapse;"><tbody><tr><td class="align-center" style="width: 33.3333%; vertical-align: middle;">[![image-1574250139101.png](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/image-1574250139101.png)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/image-1574250139101.png)</td><td class="align-center" style="width: 33.3333%; vertical-align: middle;"><span style="font-size: small;"><span style="font-size: medium;">[![frecciadx.jpg](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/frecciadx.jpg)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/frecciadx.jpg)</span></span></td><td class="align-center" style="width: 33.3333%; vertical-align: middle;">[![image-1574250034624.png](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/image-1574250034624.png)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/image-1574250034624.png)</td></tr></tbody></table>

Complete data reception and writing or editing of the element on vtenext.

---

**Synchronitazion flow from vtenext to Exchange**

### **PHASE 1**

<table border="1" id="bkmrk--5" style="width: 100%; border-collapse: collapse;"><tbody><tr><td class="align-center" style="width: 33.3333%; vertical-align: middle;">[![image-1574250139101.png](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/image-1574250139101.png)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/image-1574250139101.png)</td><td class="align-center" style="width: 33.3333%; vertical-align: middle;"><span style="font-size: small;"><span style="font-size: medium;">[![cosediritorno.jpg](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/cosediritorno.jpg)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/cosediritorno.jpg)</span></span></td><td class="align-center" style="width: 33.3333%; vertical-align: middle;">[![image-1574250034624.png](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/image-1574250034624.png)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/image-1574250034624.png)</td></tr></tbody></table>

Sending of an item to Exchange in create / edit / delete.

---

### **PHASE 2**

<table border="1" id="bkmrk--7" style="width: 100%; border-collapse: collapse;"><tbody><tr><td class="align-center" style="width: 33.3333%; vertical-align: middle;">[![image-1574250139101.png](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/image-1574250139101.png)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/image-1574250139101.png)</td><td class="align-center" style="width: 33.3333%; vertical-align: middle;"><span style="font-size: small;"><span style="font-size: medium;">[![frecciadx.jpg](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/frecciadx.jpg)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/frecciadx.jpg)</span></span></td><td class="align-center" style="width: 33.3333%; vertical-align: middle;">[![image-1574250034624.png](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/image-1574250034624.png)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/image-1574250034624.png)</td></tr></tbody></table>

Receiving Exchange ID and writing in vtenext to have a reference.

# Assignee management

<table border="1" id="bkmrk-gestione-compiti-a-g" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 50%; vertical-align: middle;">Group tasks management:  
Distribution of group tasks to their members on individual Exchange accounts.</td><td class="align-center" style="width: 50%; vertical-align: middle;">[![assegnatari1.jpg](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/assegnatari1.jpg)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/assegnatari1.jpg)</td></tr><tr><td style="width: 50%; vertical-align: middle;">Group tasks management:  
Management of modifications by the single user and status update to all members of the group.</td><td class="align-center" style="width: 50%; vertical-align: middle;">[![assegnatari2.jpg](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/assegnatari2.jpg)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/assegnatari2.jpg)</td></tr><tr><td style="width: 50%; vertical-align: middle;">Possibility of assigning contacts to a specific user by default.</td><td class="align-center" style="width: 50%; vertical-align: middle;">[![assegnatari3.jpg](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/assegnatari3.jpg)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/assegnatari3.jpg)</td></tr><tr><td style="width: 50%; vertical-align: middle;">Assigning contacts to a group of users.</td><td class="align-center" style="width: 50%; vertical-align: middle;">[![assegnatari4.jpg](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/assegnatari4.jpg)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/assegnatari4.jpg)</td></tr></tbody></table>

# Control Panel

- Control and setup of the error check and user initialization cron
- Server setup and authentication oAuth2 for 0365
- Selector of functionalities to activate and of the sync mode of the contacts

[![cronjob.jpg](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/cronjob.jpg)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/cronjob.jpg)

# User preferences

**User preferences with Office 365 authentication**

**[![preferenze1.jpg](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/preferenze1.jpg)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/preferenze1.jpg)**

**User preferences with Office 365 authentication PopUp orAuth2 MS**

<table border="1" id="bkmrk--0" style="border-collapse: collapse; width: 100%;"><tbody><tr><td class="align-center" style="width: 50%; vertical-align: top;">**[![accessoaccount.jpg](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/accessoaccount.jpg)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/accessoaccount.jpg)**</td><td class="align-center" style="width: 50%; vertical-align: top;">**[![autorizzazioni.jpg](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/autorizzazioni.jpg)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/autorizzazioni.jpg)**</td></tr></tbody></table>

**User preferences with authentication via ntlm or basic protocol for Exchange on premise**

**[![preferenze2.jpg](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/preferenze2.jpg)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/preferenze2.jpg)**

# Availability sharing

**This feature is available from vtenext version 19.10**

Possibility of calendar sharing only available:

  
[![condivisionecalendarioexcha.jpg](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/condivisionecalendarioexcha.jpg)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/condivisionecalendarioexcha.jpg)

Organizer management in an event on invitation:

[![gestioneeventiexchange.jpg](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/gestioneeventiexchange.jpg)](https://usermanual.vtenext.com/uploads/images/gallery/2019-11-Nov/gestioneeventiexchange.jpg)

Introduction of logics to avoid the modification or cancellation of events on invitation.

***N.B.: Endless recurring event management (infinite).***