Meta WorkplaceからZoho Cliqへの移行方法

Meta Workplaceから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 named $module_name」というエラーが発生した場合は、使用している Python 3 のバージョンに対応した正しいコマンドを特定し、そのコマンドをスクリプト内に入力してください。例えば、Python 3 ではコマンドは「sudo pip3 install requests」となります。

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

Meta Workplace から Zoho Cliq に会話を移行するには、次の操作を行います。

Meta Workplace から データをエクスポートする

権限を付与し、アクセストークンをコピーする

  1. Meta Workplace アカウントにログインします。
  2. ナビゲーションサイドバーで、Admin Panel をクリックします。
  1. 次に Integrations に移動し、 Create custom integration ボタンをクリックします。
  1. インテグレーションの名前と説明を入力し、Create をクリックします。
 API 権限を追加する 
  1. カスタムインテグレーションを作成したら、Permissions をクリックします。カテゴリの一覧が表示されるので、リクエストしたい権限を選択できます。
  2. 以下に挙げる 13 個の権限にチェックを入れ、Save をクリックします。
選択する API 権限:
  • すべてのメッセージを読み取る (Read all messages)
  • 任意のメンバーにメッセージを送信 (Message any member)
  • 従業員データを参照 (Explore employee data)
  • グループメンバーシップを読み取る (Read group membership)
  • グループコンテンツを読み取る (Read group content)
  • グループを管理 (Manage groups)
  • ユーザーのメールアドレスを読み取る (Read user email)
  • 勤務権限を読み取る (Read work permissions)
  • 組織図を読み取る (Read org chart)
  • 取引先を管理 (Manage accounts)
  • ユーザーのタイムラインを読み取る (Read user timeline)
  • Workplace 会社データのエクスポートを読み取る (Read Workplace company data exports)
  1. ［確定］を、権限テンプレートが更新されましたというポップアップでクリックします。
 アクセストークンをコピーする 
  1. ［詳細］を選択し、［アクセストークンを作成］を［Integration 詳細］の下でクリックします。
  1. 新しいトークンが作成されます。トークンをコピーして、［完了］をクリックします。

InfoInfo: アクセストークンは、システム上の任意の場所（例：メモ帳など）に必ずコピー＆ペーストして保存してください。トークンは一度しか表示されず、後で必要になります。

Zoho Cliq にデータをインポートする

コードを実行する  

  1. Zoho Cliq の管理パネルに移動します。［Data Administration］の下で［外部データをインポート］を選択し、［Meta workplace］をクリックします。
  1. 表示される要件と手順を確認します。
スクリプトにデータを追加して保存する   
  1. 管理パネルの前の手順に表示されているスクリプトをコピーし、.py ファイルとして保存します。
  1. コピーしたアクセストークンを .py ファイル内に必ず追加してください。
  2. スクリプトを、（例：Desktop などの）任意のディレクトリに「metaworkplaceexport.py」という名前で保存します。

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

MacOS でターミナルを開く方法：

  1. ［Launchpad］を開き、「Terminal」と入力します。
  1. ターミナルで、Python ファイルを保存したディレクトリに移動します。例：cd ~/Desktop/
  1. 次の行で「python3 metaworkplaceexport.py」と入力します。
  1. スクリプトを実行するには、Enterキーを押します。 

Windows でターミナルを開く方法：

  1. Windows の［スタートメニュー］をクリックし、「Command Prompt」と検索します。これでターミナル（コマンドプロンプト）が開きます。
  1. ターミナルでデスクトップ上の Python スクリプトがある場所に移動し、「python3 $pythonscriptfilename.py」と入力します。
  1. スクリプトを実行するには、Enterキーを押します。

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

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

移行後の要件 

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