WorkDrive Syncアプリ

このチュートリアルでは、StratusとZoho WorkDrive間のアクションを同期できるWebアプリケーションの構築方法を説明します。WorkDriveは、クラウドベースのファイル管理ツールで、組織内でファイルを保存、整理、管理するための共有スペースを作成できます。

このチュートリアルでは、プロジェクトのStratus内のバケットとWorkDrive内のそれぞれ2つのフォルダ間の同期を実現します。このチュートリアルで構築するクライアントアプリケーションを通じてファイルをアップロードできます。ファイルは必要なバケットにアップロードされ、その後自動的にWorkDriveで利用可能になります。この同期は、Catalyst Signalsを使用したイベント駆動型アーキテクチャによって自動化されています。

クライアントアプリケーションでは、アップロードされたファイルのダウンロードや削除も行えます。削除アクションは、StratusとWorkDriveの両方からファイルを削除します。

CatalystとWorkDrive間のこの接続は、OAuth 2.0認証プロトコルを使用して確立されます。Zoho APIコンソールでクライアントを設定し、WorkDriveへのアクセスを認証するために必要なOAuthトークンを生成します。

クライアントアプリケーションは以下のようになります：

WorkDrive Syncアプリケーションは、以下のCatalystコンポーネントを使用します：

1. Catalyst Serverless:

   • Event Function: Event関数はJavaまたはNode.jsプラットフォームでコーディングできます。この関数は、Stratusでファイルのアップロードが行われるたびにイベントリスナーによってトリガーされます。イベントデータとアップロードされたファイルを取得し、APIを通じてファイルをWorkDriveに投稿します。

2. Catalyst Cloud Scale:

   • Data Store: クライアントを通じてアップロードされたファイルのメタデータ（ファイル名、サイズ、WorkDrive同期ステータスなど）を保存します。これらの詳細はクライアントアプリで取得・表示されます。
   • ZCQL: クエリを通じてData Storeテーブルからデータを取得、更新、削除します。
   • Stratus: Stratusにバケットを作成し、クライアントアプリケーションを通じてファイルをアップロードします。
   • Authentication: クライアントアプリに認証を実装します。標準のログインオプションに加えて、ログインページにZohoサインインオプションを追加します。
   • Web Client: Webクライアントホスティングを通じてCatalystでホストされるアプリケーションのフロントエンドです。

3. Signals: Stratusでのファイルアップロードイベントをリッスンし、そのイベントが発生すると関連するEvent関数をトリガーします。その後、イベントデータを関数に渡し、WorkDriveとのデータ同期を可能にします。

このアプリケーションの構築には、CatalystウェブコンソールとCatalystコマンドラインインターフェース（CLI）を使用します。

このチュートリアルでは、関数およびクライアントコンポーネントに含めるファイルのコードが提供されます。ここで提供されるコードをコピーして、指示に従って適切なファイルに貼り付けるだけです。

アプリケーションアーキテクチャ

WorkDrive Syncアプリケーションのアーキテクチャを以下に示します：