# Office 365 Integration

## Introduction 

This document describes how to install, configure and use the QLM / Office 365 module (QLM-O365).

QLM-O365 is designed to perform the following tasks:

* Export customers from QLM to O365 contacts
* Export contacts from O365 to QLM customers

## Requirements

* The QLM-O365 module is designed to work with Office 365 2018.
* .NET 4.5 must be installed on the target system.
* QLM Enterprise Edition

## Installation

QLM-O365 is automatically installed with QLM. It is typically located in:

C:\Program Files\Soraco\QuickLicenseMgr\Integrations\QlmOffice365

## Azure Application

In order to enable QLM to communicate with Office 365, you need to register an App in the Azure Active Directory service as shown below.

* Login to O365
* Go to the Admin centers
* Click "Azure Active Directory"
* Click All services
* In the "Security + Identity" section, select "App registrations"
* Click "New application registration"
* Enter a name for the application such as: QLM O365 Integration
* Set the Application Type to: Native
* Set the Sign-on URL to: [http://localhost](http://localhost/)
* Click Create
* Once the App registration is created, make a note of the Application ID. You will need it later on when running the QlmOffice365 tool.
* Then, click Settings and select Required Permissions
* Click Add then "Select an API"
* Click "Microsoft Graph" then click Select
* In the Select Permissions section, check the following entries: 
  * Read and write user and shared contacts
  * Read user and shared contacts
* Click Select then click Done 

## Configuration

The first time you launch QLM-O365, you must configure it to connect to your QLM License Server:

* Go to the Settings tab
* Enter your O365 Application ID
* Enter your O365 Authority URL
* Enter the URL to your QLM License Server
* Enter the communicationEncryptionKey of your QLM License Server
* Enter the adminEncryptionKey of your QLM License Server

## Export to Office 365

To export QLM customers to Office 365 Contacts

* Go to the “Export Customers to Office 365”
* Click “Load Customers from QLM”
* Select each customer that you would like to Export
* Click “Export to Office 365”
* Login to O365 when prompted
* A dialog will display the result of the operation.

## Export to QLM

To export Office 365 Contacts to QLM customers

* Go to the “Export Contacts to QLM”
* Click “Load Contacts from Office 365”
* Select each customer that you would like to Export
* Click “Export to QLM”
* A dialog will display the result of the operation.

## Command Line

You can automate the export process by creating a scheduled task that runs a command line version of the export tool. 

Syntax for running QlmOffice365 from the command line:

*QlmOffice365.exe /from \[o365|qlm] /to \[o365|qlm] \[/overwrite]*

Example 1: Import from Office 365 to QLM, do not overwrite existing entries

*QlmOffice365.exe /from o365 /to qlm*

Example 2: Import from Office 365 to QLM, overwrite existing entries

*QlmOffice365.exe /from o365 /to qlm /overwrite*

Example 3: Import from QLM to Office 365, do not overwrite existing entries

*QlmOffice365.exe /from qlm /to o365*

Example 4: Import from QLM to Office 365, overwrite existing entries

*QlmOffice365.exe /from qlm /to o365 /overwrite*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.soraco.co/docs/3rd-party-integration/office-365-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.