Introduction 

The following is a comprehensive user guide for End Users who will facilitate the migration of tasks from the Outlook Plugin to the O365 Add-in. This migration process is a coordinated effort between the TeamConnect Admin, the Office Suite Admin (permissions described below), and the End User.  Before diving in, if you have not done so, we suggest acquainting yourself with the O365 Add-In 4.0 released with TeamConnect 7.1 (November 2023). 

• To learn more about the reasons behind the transition from the Office Suite Plugin to the Outlook Add-in, refer to O365 Outlook Plugin Vs Add-in.

Disclaimer: Please avoid concurrent usage of the  Office Suite Plugin and O365 Add-in.  It is vital that users stop using and uninstall the Office Suite Plugin (for Outlook) after the datastore file has been uploaded and before end users start using the Add-in. Concurrent usage will cause data issues such as duplicate appointments, deletion of data within appointments, etc.  

Other noteworthy things include:

1. Task migration from Plugin to Add-in is only supported for TeamConnect versions 7.2 and beyond and is only applicable if users were using tasks in the Outlook Plugin. 
2. The O365 Add-in 4.2 is compatible with desktop environments on Windows and Mac operating systems in all supported browsers. 
3. Supported browsers include Google Chrome, Microsoft Edge, Mozilla Firefox, and Safari (version 17.2.1 or above).
4. If you accidentally use the Plugin again, stop using it and generate/upload another datastore file.
5. File check-In/check-Out is supported in the Outlook Add-In, rather than in Word, PowerPoint, and Excel. Users can efficiently manage files through Outlook Add-In or directly through TeamConnect for seamless file handling.

Important Note: Task migration applies only to users who use tasks within the plugin.

Task Migration from Plugin to Add-in: How to upload DataStore file? 

A TeamConnect Admin will assign you to the new permission group called "Office Suite User," which will grant you the required permissions to initiate the migration of your tasks from the Plugin to the Add-in.  The group's ID is "OfficeSuiteUser". if you do not have this permission group or are unable to see any of the below screens, please contact your IT administrator for assistance. 

The migration process begins by uploading the datastore files. These files contain essential data that needs to be transferred to the new system. 

To ensure a smooth migration, it's crucial to follow the correct procedure for uploading these files:

Instructions	Screenshot for Reference
Login to TeamConnect. From the home page, select "Office Suite Migration" under the “All” section to navigate to the “Office Suite Module”.
Navigate to the Office Suite Migration upload page and click the "Choose File" button to upload the datastore file.

Please note the datastore file location varies depending on which Plugin Version you are on. 

How to identify your Plugin Version?

2.x and 3.x Versions 

To identify the version of the Outlook Plugin you're using, refer to the Outlook interface. Follow the below instructions to determine the Plugin version:

1. Navigate to the TeamConnect task pane or tab on the Home Page → Click on the info icon or the version icon .

2. A dialog box with the Current Plugin Version will be displayed as shown below.

3. Select the desired datastore file in either "MitratechDatastore.ds" or "TeamConnectDatastore.ds" format.
4. Please select the Datastore file from the following location:
   1. For 2.x versions of the Plugin follow this file path to retrieve your datastore file - C:\Users\{yourusername}\AppData\Roaming\Mitratech\TeamConnect\TeamConnectDataStore.ds. 
   2. For 3.x versions of the Plugin follow this file path to retrieve your datastore file - C:\Users\{yourusername}\AppData\Roaming\Mitratech\MitratechDataStore.ds. 
5. Once the file is selected, its name will be displayed. Click the "Upload" button (only one datastore file can be uploaded)
6. If the selected file has an incorrect format other than ".ds," an "Invalid file" error will appear.

8. Upon successful upload, a success message will appear for a few seconds and the upload button will then disappear. 

IMPORTANT WARNING: Once you have uploaded your datastore file please DO NOT use the Plugin again, you should use the Add-in.

1. If new tasks are created in the Plugin after you have uploaded your datastore file, a new file and upload must occur.
2. Upload only one file 

​​​​​​Monitoring Task Migration Status in Office Suite Module

The migration process will be handled by the Office Suite Admin on behalf of you (the end-user). You can easily track the status of the Task Migration progress from the Office Suite module where/how they navigate. Upon uploading the dataStore file, users receive immediate feedback and the upload time and migration status. 

However, when there is a "Failure" or "Partial Failure" during migration, the "Upload" button reappears, and you will need to upload a new DataStore file and your Office Suite Admin will initiate the migration process again.