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ウェブコンソールとCatalystコマンドラインインターフェース（CLI）を使用します。

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

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

Lead Managerアプリケーションのアーキテクチャは以下のとおりです：

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