AppSailを使用したLead Managerアプリ

はじめに

このチュートリアルでは、Lead ManagerというNode.js Expressウェブアプリケーションの構築方法を説明します。このウェブアプリを使用すると、Zoho CRMアカウントに接続し、組織内のリードを管理できます。CRMアカウントのLeadsモジュールから、リードのアクセス、追加、編集、削除を直接行うことができます。

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

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

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

クライアントアプリケーションは次のように表示されます：

Lead Managerアプリケーションは、以下のCatalystサービスのコンポーネントを使用します：

• Catalyst Serverless:
  • AppSail: 独立したNode.js Expressアプリケーションをホスティングします。アプリのフロントエンドとバックエンドロジックを構築し、それらをバンドルしてAppSailにデプロイします。
• Catalyst CloudScale:
  • Data Store: ファンクションリソースが取得したRefresh TokenとCatalystユーザーのUserIDを保存します。新しいAccess Tokenを生成する必要があるたびに、ファンクションがこのテーブルからRefresh Tokenを取得します。
  • ZCQL: クエリを使用してData Storeからデータを取得します。
  • Catalyst Authentication: クライアントアプリケーションのログインページに標準のログインオプションに加えてZohoソーシャルログインを実装します。このチュートリアルではEmbedded Authenticationタイプを実装します。

このアプリケーションの構築には、CatalystウェブコンソールとCatalyst Command Line Interface（CLI）を使用します。

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

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

アプリケーションのワークフロー全体については、フロントエンドロジックのコーディング時に詳しく説明します。手順に沿って進める際に確認することをお勧めします。