Prerequisites-Migration Requirements

1. Disk Space

Users must ensure that the disk has sufficient free space for the export process to complete successfully.
2. Network and System Stability
Users must ensure there are no network interruptions during the migration. They should also ensure their machine does not go to sleep, as the script will terminate if the system enters sleep mode.
3. Python Installation and Setup
Python version 3 or above is strongly recommended to avoid errors. Users can install Python using the following links: MacOS and Windows. For step-by-step instructions on how to install Python, you can refer to this link.
To verify the installation, run:

•  python3 --version

4. pip is usually installed along with Python. If pip is missing, it must be installed separately. Installation guide:
https://pip.pypa.io/en/stable/installation/
To verify pip installation, run:

•    pip3 --version (or) python3 -m pip --version

5. As a prerequisite to checking if all the necessary modules are installed, you can run the following code in a .py file in your terminal. This will display all the installed modules. If a specific module is missing, you can install it.

1. import importlib
2. def check_module(module_name):
3.     try:
4.         module = importlib.import_module(module_name)
5.         print(f"{module_name} module is installed")
6.     except ModuleNotFoundError:
7.         print(f"{module_name} module is not installed")
8.     print()
9. #List of modules to check  
10. modules_to_check = ['os', 'urllib', 'ssl', 'certifi', 'requests', 'json', 'logging', 'queue', 'threading']
11. #Check each module  
12. for module_name in modules_to_check:
13.     check_module(module_name)

6. If you encounter the 'No module $module_name' error, identify the exact command for the Python 3 version and enter it in the script. For example, in Python 3, the command is "sudo pip3 install requests".

7. If pip3 install does not work, users should use: python3 -m pip install <module_name>

8. Required Python dependencies such as requests and certification must also be installed.

Exporting data from Microsoft Teams   

Step 1: Register an application in the Azure portal 

Follow the below steps to register an app in Azure so that you can export your Microsoft Teams data.

1. Go to the Azure portal.

2. Click App Registrations under Azure services.
   

3. In the top-left corner, select New registration.
   

4. In the form that appears, fill in details such as App name and select who can use this application or access this API and click on Register.
   

5. The app will be registered. You can make a note of the Application (client) ID & Tenant ID.
   

Note: You can refer to Microsoft's guide on how to register an app.

Client secret value
  

To get the client's secret value, do the following:

• In the app details page, go to Certificates & Secrets.

• You will find two tabs: Certificates and Client secrets.

• Select the Client secrets tab and click on New client secret.

• A form will appear where you will have to fill in the description and when it expires and select Add.

• Your application credentials will be updated successfully.

• Copy the client secret value.

Add API permissions in the app  

• In the app overview page, go to API permissions.

• Click on Add a permission and select Microsoft Graph.

• Select Application permissions, and a list of categories will appear where you can select the permission you want to request.

• Check the 18 permissions mentioned below and select Add permission.
  

• Click the Grant admin consent for $orgname button to authorize your organization’s access to the specified APIs.
  

  Note: Only a super admin can perform this action.

Importing data to Cliq 

 Step 2: Run the code

Note:

• You will have to edit the admin's email ID, client secret value, client ID and tenant ID before running the script.

• A zip folder with your Microsoft Teams data will get downloaded in your system once the script execution is successful.

 Add data to the script and save it 

1. Open a text editor on your system, paste the Python script, and enter the required data from the Azure app.

2. Save the script in a directory (e.g., Desktop) as a file named "teamsexport.py".
   

Open terminal and run the script 

1. Open "Launchpad" and type "Terminal."

2. In the terminal, navigate to the directory where the Python file is saved, e.g., cd ~/Desktop/

3. In the next line, type "python3 teamsexport.py".

4. Click "Enter," and the script should run.

1. Click on the Start menu in Windows, then search for 'Command Prompt.' This will open the terminal.

2. Now navigate to the Python script located on the desktop within the terminal and type "python3 $pythonscriptfilename.py".

3. Click "Enter," and the script should run.
   

Step 3: Upload zip folder to import data to Cliq