WorkDrive Syncアプリ

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

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

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

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

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

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

1. Catalyst Serverless:

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

2. Catalyst Cloud Scale:

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

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

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

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

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

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