Microsoft TeamsからZoho Cliqへの移行方法

Microsoft TeamsからZoho Cliqへの移行方法

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

前提条件 - 移行要件

1. ディスク容量
ユーザーは、エクスポート処理が正常に完了するよう、ディスクに十分な空き容量があることを確認する必要があります。
2. ネットワークおよびシステムの安定性
ユーザーは、移行中にネットワークが中断されないようにする必要があります。また、スクリプトはシステムがスリープモードに入ると終了してしまうため、マシンがスリープ状態にならないようにも注意してください。
3. Python のインストールと設定
エラーを回避するため、Python バージョン 3 以上の使用を強く推奨します。ユーザーは次のリンクから Python をインストールできます: MacOS および Windows。Python のインストール手順については、次のリンクを参照してください。
インストールを確認するには、次を実行します:
  •  python3 --version
4. pip は通常、Python と一緒にインストールされます。pip がない場合は、別途インストールする必要があります。インストールガイド:
https://pip.pypa.io/en/stable/installation/
pip のインストールを確認するには、次を実行します:
  • pip3 --version または python3 -m pip --version
5. 必要なモジュールがすべてインストールされているか事前に確認するには、ターミナルで .py ファイル内に次のコードを実行します。インストール済みのすべてのモジュールが表示されます。特定のモジュールが不足している場合は、インストールしてください。
  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. # チェックするモジュールの一覧  
  10. modules_to_check = ['os', 'urllib', 'ssl', 'certifi', 'requests', 'json', 'logging', 'queue', 'threading']
  11. # 各モジュールをチェック  
  12. for module_name in modules_to_check:
  13. check_module(module_name)
6. 「No module $module_name」エラーが発生した場合は、Python 3 用の正しいコマンドを特定し、そのコマンドをスクリプト内に入力してください。例えば、Python 3 ではコマンドは「sudo pip3 install requests」です。

7. pip3 install が動作しない場合、ユーザーは次を使用してください: python3 -m pip install <module_name>
8. requestscertifi などの必須 Python 依存関係もインストールしておく必要があります。

Microsoft Teams から Cliq にチャット、チャンネル、チーム、ユーザーを移行する場合は、次の操作を行ってください。

Microsoft Teams からのデータエクスポート   

手順 1: Azure ポータルでアプリケーションを登録する 

以下の手順に従って Azure にアプリを登録し、Microsoft Teams のデータをエクスポートできるようにします。

  1. 次のリンクから Azure ポータル にアクセスします。

  2. [Azure サービス]の下にある[App registrations]をクリックします。

  3. 左上の[New registration]を選択します。

  4. 表示されるフォームで、アプリ名などの詳細を入力し、このアプリケーションまたは API を使用またはアクセスできるユーザーを選択してから、Register をクリックします。

  5. アプリが登録されます。Application (client) ID と Tenant ID をメモしておいてください。

Notesメモ: アプリの登録方法については、Microsoft のガイドを参照できます。

クライアント シークレット値
  

クライアントのシークレット値を取得するには、次の操作を行います。

  • アプリの詳細ページで、Certificates & Secretsに移動します。

  • Certificates と Client secrets の 2 つのタブが表示されます。

  • Client secrets タブを選択し、新しいクライアント シークレットをクリックします。

  • フォームが表示されるので、説明と有効期限を入力し、追加を選択します。

  • アプリケーションの認証情報が正常に更新されます。

  • クライアント シークレットの値をコピーします。

アプリに API 権限を追加する  

  • アプリの概要ページで、API 権限に移動します。

  • 権限の追加をクリックし、Microsoft Graph を選択します。

  • アプリケーションの権限を選択すると、要求したい権限を選択できるカテゴリの一覧が表示されます。

  • 以下に記載されている 18 個の権限を選択し、権限の追加を選択します。

  • 指定した API への組織のアクセスを承認するには、Grant admin consent for $orgname ボタンをクリックします。

    Notesメモ: この操作を実行できるのはスーパー管理者のみです。

Cliq へのデータインポート 

 手順 2: コードを実行する

  1. Cliq の管理パネルに移動し、[データ管理]の下にあるMicrosoft Teams をインポートを選択します。
  2. Python スクリプトをコピーし、コードを実行します。


Notes

メモ:

  • スクリプトを実行する前に、管理者のメール ID、クライアント シークレット値、クライアント ID、テナント ID を編集する必要があります。

  • スクリプトの実行が正常に完了すると、Microsoft Teams データを含む ZIP フォルダーがシステムにダウンロードされます。

 スクリプトにデータを追加して保存する 

  1. お使いのシステムでテキストエディタを開き、Python スクリプトを貼り付け、Azure アプリから取得した必須データを入力します。
  1. スクリプトを「teamsexport.py」という名前のファイルとして、任意のディレクトリ(例: Desktop)に保存します。

ターミナルを開いてスクリプトを実行する 

MacOS でターミナルを開く方法:
  1. 「Launchpad」を開き、「Terminal」と入力します。
  1. ターミナルで Python ファイルを保存したディレクトリに移動します(例: cd ~/Desktop/)。
  1. 次の行で「python3 teamsexport.py」と入力します。
  1. Enter キーを押すと、スクリプトが実行されます。
 
Windows でターミナルを開く方法:
  1. Windows の[スタート]メニューをクリックし、「Command Prompt」を検索します。これでターミナルが開きます。
  1. ターミナルでデスクトップ上の Python スクリプトがある場所に移動し、「python3 $pythonscriptfilename.py」と入力します。
  1. Enter キーを押すと、スクリプトが実行されます。

手順 3: ZIP フォルダーをアップロードして Cliq にデータをインポートする 

  1. ZIP フォルダーをドラッグ&ドロップするか、システムからアップロードし、アップロードをクリックします。
  2. データのインポートが正常に完了すると、インポートされたユーザー、チーム、チャネルの件数を確認できます。組織ユーザーのダイレクトメッセージやグループチャットもインポートできます。
  3. Cliq への参加を案内する招待メールがユーザーに送信されます。
Notes
メモ:
  1. データを複数回インポートすると重複が発生し、整理が困難になる場合があります。問題を避けるため、データのインポートは 1 回のみ行うようにしてください。

 移行後の要件 

  1. 移行の開始後に発生した Python 関連の問題については、デバッグのために demo.log ファイルを共有する必要があります。これにより、やり取りの回数を減らすことができます。
  2. ユーザーは有効な入力値とスクリプトを提供する必要があります。Python を使用して移行を行い、2 回目の移行を実行する場合は、管理パネルから新しいスクリプトを生成し、既存のスクリプトを再利用しないでください