Lead Manager App Using AppSail

はじめに

このチュートリアルでは、Lead Managerと呼ばれるJava Spring BootアプリケーションWebアプリケーションの構築方法を説明します。このWebアプリを使用すると、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：独立したJava Spring Bootアプリケーションをホストするために使用します。アプリのフロントエンドとバックエンドロジックを構築し、それらをバンドルしてAppSailにデプロイします。
• Catalyst CloudScale：
  • Data Store：ファンクションリソースによって取得されたRefresh TokenとCatalystユーザーのUserIDを保存するために使用します。新しいAccess Tokenを生成する必要がある場合、ファンクションはこのテーブルからRefresh Tokenを取得します。
  • ZCQL：クエリを通じてData Storeからデータを取得するために使用します。
  • Catalyst Authentication：クライアントアプリケーションのログインページに、標準のログインオプションに加えてZohoソーシャルログインを実装するために使用します。このチュートリアルではEmbedded Authentication タイプを実装します。

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

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

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

アプリケーションのワークフロー全体は、フロントエンドロジックのコーディング時により詳しく説明します。手順に沿って進める際にぜひご確認ください。