--- title: "実装" url: https://docs.catalyst.zoho.com/ja/serverless/help/circuits/implementation/ description: "Catalyst Circuitsは、ワークフローとロジックのオーケストレーションと自動化を支援し、簡単なドラッグ＆ドロップでスキーマティクスを設計できます。" last_updated: 2026-08-17T12:16:04Z service: Serverless type: general --- # 実装 実装セクションでは、CatalystコンソールからCatalyst Circuitの設定とテストについて説明します。CatalystアプリケーションにCircuitsを実装するには、[Java SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/serverless/circuits/execute-circuit/)、[Node.js SDK](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/serverless/circuits/execute-circuit/)、[Python SDK](https://docs.catalyst.zoho.com/ja/sdk/python/v1/serverless/circuits/execute-circuit/)、および[APIドキュメント](https://docs.catalyst.zoho.com/ja/api/code-reference/serverless/circuits/execute-circuit/#ExecuteCircuit)を参照してください。 ### Circuitの作成 > **Note:** Catalystでは、[開発環境](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/introduction)でプロジェクトに最大50のCircuitを作成できます。本番環境ではルール作成の上限はありません。 Catalystコンソールからプロジェクト内に最初のCircuitを作成するには： 1. Catalyst Serverlessコンソールの*Orchestration*配下にある**Circuits**に移動し、**Create your first circuit**をクリックします。 ![Circuits- Create a Circuit](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_create_circuit_1.webp) 2. Circuitの名前を入力し、**Create**をクリックします。 ![Circuits- Create a Circuit](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_create_circuit_2.webp) Circuitが作成され、_Builder View_が開きます。 ![Circuits- Circuit Created](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_builder_view.webp) Circuitの名前の横にある矢印マークをクリックして、_Circuits_ページに移動できます。一意の**Circuit ID**と一意の**Circuit Reference Name**がCircuitに作成されます。これは、[Circuitステート](https://docs.catalyst.zoho.com/ja/serverless/help/circuits/key-concepts/#circuit)を使用してCircuitをネストする場合や、[バッチステート](https://docs.catalyst.zoho.com/ja/serverless/help/circuits/key-concepts/#batch)をCircuitに関連付ける場合に使用される参照名です。Circuit IDは、SDKおよびAPIで作業する際にCircuitを参照するために使用されます。 ![Circuits- Circuit Created](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_index_page.webp) ### Circuitの設定 作成したCircuitを設定しましょう。CircuitsページからCircuitの名前をクリックして_Builder View_を開きます。左パネルからステートをドラッグ＆ドロップしてCircuitに追加できます。 ![Circuits- Configure a Circuit](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_left_panel.webp) ステートをドラッグ＆ドロップすると、ポップアップウィンドウが開きます。ステート名、前のステート、次のステートなどの詳細を入力できます。**Create**をクリックしてステートを作成します。 ![Circuits- Configure a Circuit](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_create_state.webp) ステートがフロー図に表示されます。ステートの設定、入出力パスの指定、パラメータの削除、ステートの削除などを行えます。 ![Circuits- Configure a Circuit](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_configure_state.webp) 各ステートで利用可能な設定とプロパティの詳細については、[ステートに関するKey Conceptsセクション](https://docs.catalyst.zoho.com/ja/serverless/help/circuits/key-concepts/#circuit-states-1)を参照してください。 右側のアイコンを使用して、ビューを水平に変更したり、フロー図内のステートを自動配置したり、ズームインまたはズームアウトしたりできます。 ![Circuits- Configure a Circuit](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_builder_view_2.webp) **Code View**をクリックして、自動生成されたCircuitのJSONコードを表示することもできます。コードまたは図で行った変更は、もう一方に自動的に反映されます。ライブ反映が遅延する場合は、**更新アイコン**をクリックできます。 ![Circuits- Configure a Circuit](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_code_view.webp) 左下隅の**Get Invocation URL**をクリックして、Circuit URLにアクセスできます。 ![Circuits- Configure a Circuit](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_url.webp) Circuitの設定が完了したら、**Save**をクリックします。 ### Circuitのコンパイルエラー Circuitを実行する前に、CatalystはCircuitの設定または構造のコンパイルエラーチェックを実行します。Circuitの設定後に**Save**または**Save and Execute**をクリックすると、Catalystは即座にCircuitのコンパイルチェックを実行し、ステート設定、設計、ロジックフロー内のエラーを一覧表示します。 これらは、提供する入力でCircuitを実行する前にCatalystが特定する、非依存の潜在的なエラーです。Circuit実行前でも、Circuitの設計と設定の検証と修正を行うことができます。 例えば、以下に示すCircuitでは、2つの分岐ステートのパラメータが定義されていません。さらに、ステートはループを終了する条件を定義せずにサイクリックループとして設定されています。ここで**Save**または**Save and Execute**をクリックすると、Catalystは以下に示すようにこれらのエラーを即座に表示します。 ![Circuits- Compilation Errors](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_execute_error.webp) Circuitの実行を開始した後、Catalystはテスト条件、データフロー、およびその他のランタイムの問題に関連する動的エラーを検出し、各イベントの詳細なログを提供できます。これについては次のセクションで説明します。 ### Circuitの実行 異なるテスト条件と入力でCircuitを実行し、生成された結果を確認できます。 Circuitを実行するには： 1. Circuitページの右下隅にある**Save and Execute**をクリックします。 2. JSON形式のキーバリューペアとして[Circuitの入力](https://docs.catalyst.zoho.com/ja/serverless/help/circuits/key-concepts/#input-output-and-result)を指定し、**Next**をクリックします。 ![Circuits- Execute a Circuit](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_execute.webp) 3. テストケースの名前を入力し、**Run**をクリックします。 ![Circuits- Execute a Circuit](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_execute_2.webp) **View Graph**セクションからCircuitのライブ実行を確認できます。 ![Circuits- Execute a Circuit](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_graph_1.webp) Circuitが実行された後、右パネルから入力、出力、実行時間などの実行詳細を確認できます。いつでも**Stop Execution**をクリックして実行を停止できます。 ![Circuits- Execute a Circuit](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_graph_2.webp) Circuit内でたどったパス、上部に記載されたカラーコードで表される各ステートのステータス、およびCircuit実行全体のステータスを確認できます。 _View Graph_はCircuitの実行履歴の一部です。次のセクションでその詳細を説明します。 ### Circuitの実行履歴 Circuitページの右上隅にある**View Execution History**をクリックすることで、いつでもCircuitの実行履歴にアクセスできます。 一意のExecution IDおよびその他の詳細とともに、Circuitのすべての実行リストが表示されます。 ![Circuits- Execute a Circuit](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_exec_history.webp) 特定の実行を開いて、実行グラフ、Circuitのコード、実行のログを確認できます。**View Logs**をクリックして、実行のログを表示します。 ![Circuits- Execute a Circuit](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_logs.webp) ログは各ステートのタスク実行の詳細を提供します。以下の詳細が表示されます。 * **Timeline:** ステート内の特定のイベントの日時と、イベントタイプを示すアイコンを表示します * **State:** 特定のイベントが実行される[ステート](https://docs.catalyst.zoho.com/ja/serverless/help/circuits/key-concepts/#circuit-states-1)を指します * **Event:** ステート内で発生した特定のイベントを指します。すべてのステートの共通イベントには、_State Entered_、_Input Processing_、_Result Processing_、_State Exited_が含まれます。一部のステートには追加のカスタムイベントがあります。例えば、待機ステートには待機時間が終了するまで続く_State Time Waiting_イベントがあります。ファンクションステートには、_Input Processing_イベントの後に_Function Triggered_と_Function Executed_イベントがあります。 SuccessステートとFailureステートは終了ステートであるため、_Success State Reached_と_Failure State Reached_イベントのみがあります。Circuit実行の開始と終了は、_State Machine Triggered_と_State Machine Executed_イベントで示されます。 * **Payload:** Circuit内のあるステートから次のステートに伝送される入力JSONを指します。ステートのペイロードは、そのステートが処理する入力です。 * **Parameter:** ユーザーが提供する追加パラメータを指します。パラメータはファンクションステートとバッチステートで提供できます。 * **Response:** ステートの処理後に生成される出力を指します。ステートの出力パスや結果パスに値が指定されている場合、出力はそれに応じて変更されます。 * **Exception:** ステートによって生成される可能性のある例外を指します。ステートの処理が失敗した場合、ここから例外の詳細を確認できます。 詳細ログにより、Circuit内の各ステートの実行における障害の評価とバグの検出を効果的に行えます。前述の通り、ファンクション、Circuit、バッチステートのログには、ファンクションのページ、[Catalyst Logs](https://docs.catalyst.zoho.com/ja/devops/help/logs/introduction/)、またはネストされたCircuitのログへのリンクが含まれており、簡単にアクセスできます。 **View Code**セクションでは、実行詳細とともにCircuitのコードが表示されます。 ![Circuits- Execute a Circuit](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_view_code.webp) ### Circuitの名前変更 CatalystコンソールからCircuitの名前を変更するには： 1. _Circuits_ページのCircuitの**省略記号アイコン**をクリックし、**Rename**をクリックします。 ![Circuits- Rename a Circuit](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_rename.webp) 2. Circuitの新しい名前を入力し、**Enter**キーを押します。 ![Circuits- Rename a Circuit](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_rename_2.webp) > **Note:** Circuitの[参照名](https://docs.catalyst.zoho.com/ja/serverless/help/circuits/implementation/#create-a-circuit)は変更できません。Circuitの名前のみ変更可能です。 ### Circuitの削除 CatalystコンソールからCircuitを削除するには： 1. _Circuits_ページのCircuitの**省略記号アイコン**をクリックし、**Delete**をクリックします。 ![Circuits- Delete a Circuit](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_delete.webp) 2. 確認ウィンドウで**Yes, Proceed**をクリックします。 ![Functions- Delete a Circuit](https://catalyst-docs-development.zohostratus.in/images/help/circuits/catalyst_circuits_delete_confirmation.webp)