--- title: "コンポーネントイベントリスナー" url: https://docs.catalyst.zoho.com/ja/cloud-scale/help/event-listeners/component-event-listeners/ description: "Catalystは、Catalystコンポーネント、カスタムソース、または関連するZohoサービスで発生する特定のイベントをリッスンし、イベント発生時に独自のロジックを実行できるコンポーネント、カスタム、およびZohoイベントリスナーを提供します。" last_updated: 2026-08-17T12:16:04Z service: Cloud Scale type: general --- # Catalystコンポーネントイベントリスナー ### はじめに > **注意:** Catalystは、**Signals**と呼ばれる新しいイベントバスサービスを提供しています。このサービスは、現在の*Cloud Scale Event Listeners*コンポーネントの大幅なアップグレードです。Catalyst Signalsサービスの詳細については、[こちら](https://docs.catalyst.zoho.com/ja/signals/)を参照してください。 すべてのCatalystプロジェクトには、プロジェクト作成時に作成される1つのコンポーネントイベントリスナーが含まれています。前のセクションで説明したように、コンポーネントイベントリスナーとカスタムイベントリスナーの動作と機能は異なります。 Catalystコンポーネントイベントリスナーは、Catalystコンポーネントをターゲット関数またはCircuitにリンクし、呼び出し時にコンポーネントデータを関数またはCircuitに渡すために使用されます。 以下の表は、Catalystコンポーネントのリストと、コンポーネントイベントリスナーに関連付けることができるイベント発生を説明しています:
コンポーネント イベント 説明
Data Store Insert Update Delete 関連するテーブルにデータが挿入された 関連するテーブルのデータが更新された 関連するテーブルからデータが削除された
Cache Put 関連するCacheセグメントにデータが書き込まれた
Authentication Sign Up Delete ユーザーがアプリケーションにサインアップした アプリケーションからユーザーが削除された
GitHub Success Failure GitHubデプロイメントが成功した GitHubデプロイメントが失敗した
Web Client Hosted プロジェクトでWebクライアントがホストされた
> **注意:** * 特定のルールには1つのコンポーネントのアクションのみを関連付けることができます。 * 1つのルールにコンポーネント内の複数のイベントを関連付けることができます。 * 1つのルールに対して複数のターゲット関数を実行することもできます。 * コンポーネントイベントリスナーの名前変更や削除はできません。ただし、作成したルールは[削除](https://docs.catalyst.zoho.com/ja/cloud-scale/help/event-listeners/working-with-rules/#delete-a-rule)できます。 たとえば、コンポーネントイベントリスナーのルールがStratus内の3つのフォルダー（_Folder1_、_Folder2_、_Folder3_）のファイルアップロードイベントに関連付けられているとします。ターゲット関数は_Function1_と_Function2_です。これは、これらの3つのフォルダーのいずれかにファイルがアップロードされるたびに、_Function1_と_Function2_の両方が実行されることを意味します。 フォルダーID、ファイル名、3つのフォルダーすべてのイベント時刻などのイベントデータは、事前定義されたパターンで_Function1_と_Function2_の両方に渡されます。データはイベントリスナーからターゲット関数またはCircuitに常に**JSON形式**で渡され、このデータはCircuitまたは関数内で処理して必要なアクションを実行できます。 ルールを作成すると、コンソールに**サンプルデータパターン**が表示されます。これは、イベント発生時に関数に渡されるデータのサンプル構造を示しています。データパターンは、ルールが関連付けられているコンポーネントとアクションに基づいて異なります。これは、異なるイベントには異なるデータが含まれるためです。 たとえば、ルールがAuthenticationのサインアップイベントに関連付けられている場合、イベントデータは以下のパターンになります: ```json { "project_details": { "id": 57*************, "project_name": "Eventbus" }, "event_bus_details": { "name": "Default", "id": 57************* }, "data": { "platform_type": null, "user_details": { "email_id": "emma@zylker.com", "role_details": { "role_name": "App User", "role_id": 57************* }, "zaaid": 1002347509, "created_time": "Sep 10, 2019 11:47 PM", "invited_time": "Sep 10, 2019 11:47 PM", "modified_time": "Sep 10, 2019 11:47 PM", "user_id": 57*************, "is_confirmed": true, "last_name": "", "first_name": "Amelia Burrows", "zuid": 1002342431, "status": "ACTIVE" }, "org_id": 1002347509, "zaid": 1002345135, "redirect_url": null }, "current_project": { "id": 57*************, "project_name": "Eventbus" }, "action": "SignUp", "source": "UserManagement", "event_time": 1568139437092 } ``` ルールは、プロジェクトの詳細やイベントに関するその他のメタデータとともに、ユーザーとサインアップデータを渡します。ターゲット関数をコーディングしたり、Circuitを設定して、必要に応じてイベントデータを処理できます。 それでは、Catalystコンソールでイベントリスナーを操作しましょう。 ### コンポーネントイベントリスナーでルールを作成する コンソールの*Cloud Scale*セクションにある_Triggers_セクションから_Event Listeners_コンポーネントにアクセスできます。Catalystコンポーネントイベントリスナーはデフォルトで既に存在しています。 > **注意:** [開発環境](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/development-environment/)では、コンポーネントイベントリスナーに最大50のルールを作成できます。この上限の引き上げをご希望の場合は、[**support@zohocatalyst.com**](mailto:support@zohocatalyst.com)までサポートにお問い合わせください。各リクエストはケースバイケースで対応いたします。本番環境ではルール作成に上限はありません。 コンポーネントイベントリスナーでルールを作成するには: 1. Catalystコンソールの*Cloud Scale*セクションにある_Triggers_の下の**Event Listeners**に移動します。 ![catalyst_event_listener_default](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_event_listener_default.webp) Event Listenersページには、Catalystコンポーネントイベントのタイルが表示され、その日の[処理済み、失敗、キューイベント](https://docs.catalyst.zoho.com/ja/cloud-scale/help/event-listeners/terminology/)の統計が表示されます。 2. イベントリスナーのタイルの**View**をクリックして開きます。 ![catalyst_event_listener_component_empty](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_event_listener_component_empty.webp) 3. **Create Rule**をクリックします。 ![catalyst_event_listener_component_create_rule_highlight](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_event_listener_component_create_rule_highlight.webp) 4. ルールの名前と説明を入力します。 ![catalyst_event_listener_create_new_rule](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_event_listener_create_new_rule.webp) 5. ドロップダウンリストからルールに関連付けるコンポーネントを選択します。コンポーネントを選択すると、ポップアップにターゲット関数またはCircuitに渡されるデータのサンプル構造が表示されます。前述のように、このデータパターンは選択するコンポーネントごとに異なります。 ![catalyst_event_listener_creatin_rule](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_event_listener_creatin_rule.webp) 選択したコンポーネントに基づいて、追加情報の入力が必要になる場合があります。たとえば、「Data Store」を選択した場合、ルールに関連付ける1つ以上のテーブルを選択できます。 6. ルールに関連付けるコンポーネントで発生するアクションを選択します。前述のように、これらのアクションもコンポーネントに基づいて異なります。 ![catalyst_event_listeners_creating_rule_2](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_event_listeners_creating_rule_2.webp) > **注意:** コンポーネントとして「Web Client」を選択した場合、Actionフィールドは表示されません。Web Clientを選択すると、プロジェクトでWebクライアントがホストされたときにルールがトリガーされることを示します。 7. *Target Point*として**Function**または**Circuit**を選択します: - **Functions**をトリガーする場合: イベント発生時に呼び出すターゲット関数を選択します。1つ以上の関数を選択できます。 ![catalyst_event_listeners_creating_rule_3](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_event_listeners_creating_rule_3.webp) - **Circuits**をトリガーする場合: ドロップダウンリストからターゲットCircuitを選択します。1つ以上のCircuitを選択できます。 ![catalyst_event_listener_component_circuit_select](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_event_listener_component_circuit_select.webp) > **注意:** * ターゲットとしてFunctionsを選択した場合、ドロップダウンには[イベント関数](https://docs.catalyst.zoho.com/ja/serverless/help/functions/event-functions/)のみが一覧表示されます。 * ターゲットとしてCircuitsを選択した場合、ドロップダウンには以前に作成したすべてのCircuitが一覧表示されます。 * イベントリスナーの設定前にイベント関数またはCircuitを作成していない場合は、ドロップダウンの**Create New**をクリックすると、[イベント関数](https://docs.catalyst.zoho.com/ja/serverless/help/functions/event-functions/#introduction)または[Circuit](https://docs.catalyst.zoho.com/ja/serverless/help/circuits/implementation/#create-a-circuit)を作成するための各コンポーネントセクションに移動します。 8. **Create**をクリックします。 ルールが作成されました。コンポーネントイベントリスナーのセクションから、すべてのルールとその詳細の一覧を確認できます。 ![catalyst_event_listener_component_rule_created](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_event_listener_component_rule_created.webp) 一覧からルール名をクリックすると、ルールの詳細とサンプルデータパターンが表示されます。 ![catalyst_event_listeners_rule_dets](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_event_listeners_rule_dets.webp) これらのセクションの詳細については、[処理済みイベント](https://docs.catalyst.zoho.com/ja/cloud-scale/help/event-listeners/processed-events/)および[キューイベント](https://docs.catalyst.zoho.com/ja/cloud-scale/help/event-listeners/queued-events/)のページを参照してください。 ### Catalystコンポーネントリスナーのアラート設定 [前述](https://docs.catalyst.zoho.com/ja/cloud-scale/help/event-listeners/introduction/)のように、イベントリスナーで障害、コード例外、またはプロセスタイムアウトが発生した場合に、自動メールアラートを送信するよう設定できます。これらのアラートは、[*Application Alerts*](https://docs.catalyst.zoho.com/ja/devops/help/application-alerts/introduction/)コンポーネントに移動することなく、Event Listenersセクションで直接設定できます。 1. アラートを設定するには、イベントリスナーの詳細セクションで**+ Configure**ボタンをクリックします。 ![catalyst_custom_event_alert_configure](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_custom_event_alert_configure.webp) 2. アラートを設定した後、**Confirm**をクリックして有効にします。 ![catalyst_alert_configuration](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_alert_configuration.webp) 3. アラートステータスの横にある省略記号アイコンをクリックし、**Remove**をクリックしてアラートを削除することもできます。 ![catalyst_event_listener_remove_alert](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_event_listener_remove_alert.webp)