Lead Managerアプリ

はじめに

このチュートリアルでは、Zoho CRMアカウントに接続し、組織のリードを管理できるWebアプリケーションの構築方法を説明します。このアプリケーションから直接、CRMアカウントのリードモジュールのリードにアクセス、追加、編集、削除できます。

Zoho CRMへの接続は、OAuth 2.0認証プロトコルを使用して確立されます。Lead Managerアプリケーション用のOAuthアクセストークンを生成し、CRMデータへのアクセス接続を認可するために使用します。

また、CRMアカウントへのアクセスを管理するためにCatalystコネクタを実装します。コネクタはリフレッシュトークンを使用して、アクセストークンの有効期限が切れるたびに自動的に更新し、クライアントとCRMアカウント間の常時接続を維持します。

これらのトークンは、Zoho APIコンソールでクライアントアプリケーションを登録し、必要な認証情報を取得した後に生成できます。

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

Lead Managerアプリケーションには、以下の基本的なCatalystコンポーネントが含まれています：

1. Catalyst Serverless:
   • Advanced I/O Function: Advanced I/O FunctionはJavaプログラミング環境でコーディングされています。このファンクションは、クライアントアプリケーションからCRMリードモジュールのCRUDアクション（リードの追加や削除など）を処理するAPIを定義します。また、CRMへの接続、ユーザーの認証、OAuthトークンの生成を処理するルートも定義します。
2. Catalyst Cloud Scale:
   • Data Store: Advanced I/Oファンクションによって取得されたリフレッシュトークンとCatalystユーザーのUserIDを保存します。新しいアクセストークンを生成する必要があるたびに、ファンクションによってこのテーブルからリフレッシュトークンが取得されます。
   • ZCQL: クエリを通じてData Storeからデータを取得します。
   • Client: Webクライアントホスティングを通じてCatalystでホストされるアプリケーションのフロントエンドです。
   • Authentication: クライアントアプリケーションのログインページに、標準的なログインオプションに加えてZohoサインインオプションを実装するために、このチュートリアルではEmbedded authenticationタイプを実装します。

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

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

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

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

アーキテクチャの詳細については、ファンクションとクライアントコンポーネントを設定した後、クライアントの設定セクションで説明します。