# 自動テスト



--------------------------------------------------------------------------------
title: "はじめに"
description: "Automation Testingは、Functionのエンドポイントまたは任意のサードパーティURLに対して、効率的で自動化されたAPIテストを実行し、問題箇所を解決することを可能にします。"
last_updated: "2026-09-02T11:25:12.649Z"
source: "https://docs.catalyst.zoho.com/ja/devops/help/automation-testing/introduction/"
service: "DevOps"
--------------------------------------------------------------------------------



# Automation Testing

### はじめに

Catalyst Automation Testingは、CatalystアプリケーションのAPIテストプロセスを自動化するAPIテストツールとして機能するCatalyst DevOpsコンポーネントです。この機能を使用すると、要件に基づいてテストケースを記述し、テストの自動実行をスケジュールし、最小限の手動介入でAPIテストのプロセス全体を管理できます。Automation Testingは、リアルタイムの詳細なレポートとデバッグ結果を提供し、APIの障害の根本原因を分析して問題をより迅速に解決できるようにします。

DevOpsサービスの他のコンポーネントについては、こちらのページをご覧ください。

Automation Testingは、コーディングや複雑なバックエンドセットアップの設定を必要とせずに、すべてのテストニーズを管理するための便利なプラットフォームです。この機能により、テスト全体の効率が向上し、反復的な手動テストに貴重な時間と労力を費やすことがなくなります。Catalystサーバーは高いスケーラビリティを備えており、テストプロセスに影響を与えることなく高い需要に対応できます。

Automation Testingは、アプリケーションのアクセス可能なすべてのエンドポイント、つまりBasic I/OおよびAdvanced I/O Functionをテストできます。また、必要な任意のサードパーティURLもテストしてレスポンスを取得できます。この機能は一部有料のコンポーネントとして提供されており、各プロジェクトの無料制限を使い切った後に支払いが必要になります。

注意:

* Automation Testingは、テストは理想的にはDevelopment環境で実行されるため、Production環境ではアクセスできません。ただし、Development環境からProduction環境のテストを実行し、そこからProductionのレスポンスを確認できます。環境について詳しくは、環境のヘルプページを参照してください。

* Automation Testingは現在、EU、AU、IN、またはCAデータセンターからアクセスするCatalystユーザーには利用できません。


Automation Testingの作業手順は以下のようにまとめることができます:

1. 関連するアクションを実行するテストケースを含むモジュールを作成します。
2. テストケースを作成し、個々のリクエストを設定します。
3. 様々なテストケースとモジュールを並列または順次で実行するためのTest Suiteを作成します。
4. 1つ以上のTest Suitesの自動実行をスケジュールするためのTest Planを作成します。

<br>


### メリット

1. 完全な自動化による効率的なアプリケーション開発プロセス<br /> マイクロサービスがさまざまなテスト条件に対して繰り返し頻繁なテストを必要とする場合、テストの自動化は非常に有用です。自動化は、手動テストの高労力、時間がかかる、単調な性質を最小限に抑えるために不可欠であり、手動テストは人的ミスが起こりやすいものです。Automation Testingは完全な自動化を可能にしますが、必要な場合にはいつでも手動で介入する柔軟性も提供します。

2. 豊富な機能を備えたスケーラブルで信頼性の高いプラットフォーム<br /> Automation Testingは、基本的なテストニーズをすべて満たし、高度なテスト体験を促進する豊富な機能を備えています。個別のアクションに対して個々のテストケースを記述し、関連するテストケースをまとめて整理し、必要に応じて再利用できます。また、チェーンされたAPI実行と順次テスト実行を調整してそれらの間で動的な値を渡すことも、テストを高速化する並列テスト実行も行えます。

3. テスト設定における使いやすさ<br /> Automation Testingは、テスト環境を数分で簡単にセットアップできる統合プラットフォームを提供します。数回のボタンクリックですべてを設定できます。テストケースを簡単に設定し、レスポンスで返されることが予想される値を確認し、自動テスト実行を素早くスケジュールできます。Automation Testingが残りを処理し、詳細なインサイトを含む結果を提供します。追加の設定を行うことなく、DevelopmentとProduction両方の環境で異なるデータセットを使用するテストも実行できます。

4. デバッグと問題解決の容易化<br /> Automation Testingは、正確な問題箇所を特定するだけでなく、修正時に非常に役立つ問題の解読も行います。結果には、各テストケースの各リクエストに対する正確なレスポンスと、セットアップ全体の重要なメトリクスおよびパフォーマンス統計が含まれます。これらのインサイトに富んだメトリクスを使用してサービスのパフォーマンスを測定し、統合の機能性と信頼性を判断し、エンドユーザーへの高い基準を満たすことを確保できます。

<br>

### Automation Testingの有効化

Automation Testingの機能について説明する前に、プロジェクトのCatalystコンソールで有効化しましょう。

1. Catalystコンソールの左ペインでDevOpsに移動し、Automation Testingをクリックします。



2. Automation Testing機能ページでEnable Nowをクリックし、表示される確認ウィンドウでProceedをクリックします。



これでプロジェクトのAutomation Testingが有効になりました。

<br>

### Automation Testingの無効化

以下の方法でAutomation Testingを無効にできます:

1. Automation Testingページの右上にある省略記号アイコンをクリックし、Disableをクリックします。



2. 確認ポップアップに「DISABLE」と入力して確認し、Yes, Proceedをクリックします。



これでプロジェクトのAutomation Testingが無効になりました。必要に応じて無効化と再有効化ができます。


--------------------------------------------------------------------------------
title: "テストスイート"
description: "Automation Testingは、Functionのエンドポイントまたは任意のサードパーティURLに対して、効率的で自動化されたAPIテストを実行し、問題箇所を解決することを可能にします。"
last_updated: "2026-09-02T11:25:12.649Z"
source: "https://docs.catalyst.zoho.com/ja/devops/help/automation-testing/test-suites/"
service: "DevOps"
--------------------------------------------------------------------------------


# Test Suites

### はじめに

Test Suitesは、Automation Testingで作成したテストケースの次のレベルの組織単位です。Suiteはテストケースのグループを管理し、複数のTest SuitesをTest Planを使用してまとめて自動化できます。

Suite内に複数のテストケースをグループ化し、必要に応じて並列または順次実行できます。例えば、テストケースのグループがプロセスからデータを取得して別のプロセスに渡すなどの順次的なアクションを含む場合、実行順序を指定できます。テストケースのグループが互いに関連していない場合は、並列で実行できます。

Automation Testingでは、テストケースを任意の組み合わせでSuiteに追加できます。つまり、同じモジュールやサブモジュールに属するテストケースや、異なるモジュールのテストケースをまとめて追加できます。

注意:

* Test Suiteは、少なくとも1つのテストケースを作成した後にのみ作成できます。
* テストケースは、まずSuiteに追加してTest Planを設定しないと自動化できません。


### Test Suiteの作成

以下の手順でTest Suiteを作成できます:

1. _Automation Testing_のTest Suitesタブに移動し、Create Suiteをクリックします。



2. Test Suiteの名前を入力し、ドロップダウンリストから実行方法としてSequenceまたはParallelを選択します。

スキーマからSuiteに追加するすべてのテストケースを選択します。任意のモジュールから任意のテストケースを選択できます。



右パネルからドラッグ＆ドロップして、実行順序に基づいてテストケースを並べ替えることができます。
3. Createをクリックします。

Suiteが作成され、詳細ページが開きます。

### Test Suiteの管理

Test Suiteの詳細ページには、そのSuiteの設定と情報が表示されます。

<br />

Test Planを作成してこのSuiteを自動実行に含めた後、このSuiteの統計情報を表示できるようになります。このページの上部セクションには、Suiteの詳細、成功率、および直近5回のテスト実行の成功統計が表示されます。

#### Suiteの編集

1. 詳細ページの上部にあるSuite名の横にある編集アイコンをクリックして、Suiteの名前や実行タイプを編集できます。
2. ポップアップで必要な変更を行い、Updateをクリックします。




#### Suiteへのテストケースまたはモジュールの追加

1. Suiteの詳細ページの左側にある検索バーからテストケースまたはモジュールを検索して追加できます。リストから追加するものを選択します。<br /> 

含めたモジュールは青色で、テストケースは緑色で表示されます。
2. オプションとして、Add cases afterチェックボックスをオンにし、前の実行アイテムのOrder IDを入力することで、特定の実行アイテムの後にこれらのアイテムを追加できます。

すべての実行アイテムのOrder IDは、このページの右側で確認できます。入力しない場合、テストケースやモジュールはデフォルトで順序の最後のアイテムの後に追加されます。

3. Addをクリックします。

#### Suite内のテストケースの管理

このセクションの右側で、Suite内のすべてのテストケースのリストとその詳細を表示できます。



ここでは、Suiteの実行に関する以下のレポートも表示されます:

* Frequently Failed: 失敗回数に基づいて降順に表示される、頻繁に失敗したテストケース
* Failed in Last Run: Suiteの最後の実行で失敗したテストケース

テストケースの実行順序の設定: テストケースは、設定された実行順序でリスト表示されます。順次実行のSuiteでは、その順序に従って1つずつ実行されます。テストケースのmoveアイコンをクリックして順序を変更できます。



移動先のOrder IDを入力し、Moveをクリックします。Order IDはこのテーブルの最初の列に記載されています。または、テストケースの左側にあるドラッグアイコンをクリックして、新しい位置にドラッグ＆ドロップすることもできます。

SuiteからのテストケースのRemove: このテーブルのテストケースのRemoveアイコンをクリックして、Suiteからテストケースを削除できます。確認ポップアップでConfirmをクリックします。



#### Test Suiteの削除

詳細ページのSuite名の横にある戻る矢印をクリックすると、作成したすべてのTest Suitesのリストが表示されます。このページには各Suiteの重要な詳細が表示されます。

<br />
1. このリストでSuiteにカーソルを合わせると表示される削除アイコンをクリックして、Test Suiteを削除できます。
2. 確認ポップアップウィンドウでYesをクリックします。<br /> 

チェックボックスを使用してリストから複数のSuiteを選択し、一括削除することもできます。


--------------------------------------------------------------------------------
title: "モジュールとテストケース"
description: "Automation Testingにより、FunctionエンドポイントまたはサードパーティURLで効率的な自動APIテストを実行し、問題領域を解決できます。"
last_updated: "2026-09-02T11:25:12.650Z"
source: "https://docs.catalyst.zoho.com/ja/devops/help/automation-testing/modules-test-cases/"
service: "DevOps"
--------------------------------------------------------------------------------



# モジュールとテストケース

### モジュール

モジュールを使用すると、作成したテストケースを実行するアクションやロジックに基づいて分類できます。モジュールは同じプロセスやFunctionを表すこともできます。ただし、モジュールを使用してプロセスを個々のアクティビティに焦点を当てたさまざまな部分に分割できます。たとえば、アプリケーション内の特定のフォーム送信に関連するすべてのテストケースを1つのモジュールにグループ化できます。

Automation Testingのモジュールについて、以下のポイントを覚えておいてください：

* テストケースはモジュールに関連付ける必要があるため、モジュール内にテストケースを作成する必要があります。そのため、テストケースを作成する前に、モジュールを作成するか、既存のモジュールに追加する必要があります。
* モジュール内に1レベルまでのサブモジュールを作成できます。
* モジュールは同じレベルにテストケースとサブモジュールを含めることはできません。たとえば、_Module A_は_Test Case 1_と_Submodule B_を同じレベルに別個のエンティティとして含めることはできません。_Test Case 1_を_Submodule B_内、別のサブモジュール内、またはまったく別のモジュールに作成できます。

<br>

### テストケース

テストケースには、実行するアクションの定義と詳細が含まれます。APIテストケースでは、1つ以上のリクエストURLを呼び出し、パラメータ、ヘッダー、またはリクエストボディにデータを渡します。

注意:

* リクエストでは、アプリケーションの開発環境と本番環境の両方のFunction URLおよびサードパーティURLをテストできます。

* Functionエンドポイント用にAPI Gatewayで設定したAPIもテストできます。


APIテストでは、通常、Functionのエンドポイントまたはサードパーティリソースにリクエストを送信してレスポンスを受信します。テストは、リクエストに設定したさまざまなテスト条件、リクエストメソッド、環境、値に対して受信されるレスポンスを観察するために行われます。

テストケースで行うすべてのリクエストで渡した値と条件に対して期待されるレスポンスが得られた場合、テストは成功と見なすことができます。

Automation Testingのテストケースについて、以下のポイントを覚えておいてください：

* テストケースには、個別に設定できる1つ以上のリクエストを含めることができます。
* テストケースは、テストスイートに追加され、テストプランで実行がスケジュールされた後にのみ自動化できます。
* 単一のテストケースで一連のリクエストを自動的に実行するようにオーケストレーションし、1つのリクエストのレスポンスから取得した動的な値を次のリクエストに渡すことができます。これは、リクエストに変数を定義し、その変数を次のリクエストのパラメータとして渡すことで実現できます。
* アサーションを使用してリクエストの期待されるレスポンスを定義する必要があります。リクエストの実行時に、Catalystは受信したレスポンスと期待値を自動的に比較し、それに応じてテストケースの結果を判定し、Resultsセクションに表示します。テストケースの実行が成功するには、各個別のリクエストが成功する必要があります。
* Automation Testingで行うリクエストは、_Custom Authentication_メソッドを通じて認証できます。Deluge Connectionsを使用して接続を設定し、それを通じてリクエストを認証できます。

<br>

### テストケースの作成

テストケースを作成してAutomation Testingの使用を開始できます。テストケースの設定に関わる各アクションについて、このセクションで詳しく説明します。

1. _Add-on Services_からAutomation Testingを有効にした後、_Test Cases_セクションからCreate Test Caseをクリックします。<br /> 

2. テストケースの名前と説明を入力します。
<br /> <br /> テストケースはモジュールに関連付ける必要があり、まだモジュールを作成していないため、ドロップダウンをクリックして新しいモジュールの名前を入力し、検索バーでCreateをクリックします。
<br /> <br /> モジュールまたはサブモジュールがすでに存在する場合は、リストから選択するだけです。

3. Createをクリックします。

指定したモジュールにテストケースが作成されます。テストケースのタブが開き、リクエストを設定できます。

UI要素については、このドキュメントの後のセクションで説明します。

<br>

### リクエストの設定

テストケース内で以下の方法でリクエストを設定できます：

1. テストケースのセクションでAdd Requestをクリックします。<br /> <br />

2. テストが必要なAPIエンドポイントのURLを入力します。
<br /> <br /> いずれかの環境のBasic I/OまたはAdvanced I/O Function URL、API Gatewayで設定したAPI、またはサードパーティURLを入力できます。<br /><br /> 設定した環境変数またはグローバル変数をリクエストURLの値として渡すこともできます。これらについては変数セクションで学ぶことができます。

3. ドロップダウンリストからリクエストのHTTPリクエストメソッドを選択します。GET、PUT、POST、PATCH、DELETE、HEAD、OPTIONSから選択できます。

4. Params: _Params_セクションで、リクエストURLに追加されるクエリ文字列をキーバリュー形式で設定できます。パラメータ名を入力すると、別のパラメータを追加するための新しい列が表示されます。閉じるアイコンをクリックしてパラメータを削除できます。<br /> <br /> {{$\<variable\>}}形式で環境変数またはグローバル変数を渡したり、前のリクエストのレスポンスから値を割り当てた変数を{{\<variable\>}}形式でリクエストのパラメータとして渡したりすることもできます。

5. Authentication: この特定のリクエストの認証方法を設定するには、リクエストURLの下にあるAuthenticationタブをクリックします。リクエストで認証を使用しない場合は、Noneを選択します。<br /><br /> Custom Authを選択して、Deluge connectionを設定できます。Deluge connectionsを使用すると、Zohoまたはサードパーティサービスとの認証を確立できます。この接続により、CatalystがサードパーティサービスのAPIを呼び出し、認証されたデータへのアクセスを取得できます。この場合、設定しているリクエストがサードパーティサービスになります。
<br /><br /> Custom Authを選択すると、ドロップダウンボックスに設定済みの既存の接続が一覧表示されます。新しい接続を作成するには、Create Newをクリックします。
<br /><br /> <br /> リクエストセクションにConnections設定ページが開きます。ここで接続を設定し、利用可能な認証タイプのいずれかを選択できます。
<br /><br /> <br /> これらの手順の詳細については、Zoho CRM Connectionsヘルプページから確認できます。CRMは同じDeluge connectionsサービスを実装しています。たとえば、Zoho CRMとの接続により、リクエストでリードの挿入やCRMアカウントからの連絡先の取得などのアクションを実行できます。

6. Headers: _Headers_セクションからリクエストURLのヘッダーを設定できます。Headersタブをクリックします。渡すヘッダーの名前と対応する値を入力します。入力中にCatalystがヘッダーキーを提案します。<br /> <br /> ヘッダー名を入力すると、別のヘッダーを追加するための新しい列が表示されます。閉じるアイコンをクリックしてヘッダーを削除できます。

7. Body: Bodyセクションからリクエストのボディにデータを渡す設定ができます。リクエストボディは通常、POSTまたはPUTリクエストで渡されます。Bodyタブをクリックします。

Automation Testingは3種類のリクエストボディをサポートしています：_form-data_、_x-www-form-urlencoded_、_raw_。ドロップダウンリストからタイプを選択します。<br /><br /> _form-data_または_x-www-form-urlencoded_を選択した場合、ペイロードをキーバリュー形式で入力できます。これらの形式でキーの値として変数を渡すこともできます。_raw_を選択した場合、JSONとして渡すことができます。<br /><br /> 

リクエストの必要なすべての部分を設定した後、リクエストにアサーションを追加できます。

<br>

### アサーションの追加

アサーションは、リクエストに対して受信したレスポンスを検証するために使用されます。ここでレスポンスのさまざまな部分で期待する値を定義できます。Automation Testingは期待値と受信値を自動的に比較します。値が一致し、すべてのアサーションが満たされた場合、リクエストの実行は成功と見なされます。そうでない場合は失敗と見なされます。

注意: テストケースのリクエストにアサーションは必須ではありません。リクエストにアサーションを追加しない場合、テスト実行は自動的に成功と見なされます。自動テスト実行の詳細なレポートは、_Results_セクションから確認できます。

リクエスト設定ウィンドウのAssertionsタブをクリックし、Add Assertionをクリックしてテストケースのアサーションを設定します。



アサーションは、以下の設定可能な要素で構成されます：

* Source: アサーションを適用する場所。ドロップダウンリストからアサーションのソースのいずれかを選択できます：

   * Header: レスポンスで期待されるヘッダーとその対応する値を定義できます。
   * Status Code: レスポンスでリクエストに対して期待されるHTTPステータスコードを定義できます。たとえば、リクエストが正常に処理されることを期待する場合、ステータスコードが200に等しいことを示すアサーションを定義できます。
   * XML Body: レスポンスのXMLボディで受信した特定のデータ項目を、そのパスを指定して期待値を定義することで抽出できます。
   * JSON Body: レスポンスのJSONボディで受信した特定のデータ項目を、そのパスを指定して期待値を定義することで抽出できます。

* Property: アサーションを適用するソースの特定の属性<br /><br /> たとえば、ソースとしてHeaderを選択した場合、Propertyテキストボックスに値を比較する必要がある特定のヘッダーのキーを入力できます。<br /><br /> 同様に、ソースとしてXML BodyまたはJSON Bodyを選択した場合、Propertyテキストボックスに抽出するデータ項目のパスを指定できます。パスの定義にはJSONまたはXML構文に従う必要があります。

注意: Status Codeソースタイプには属性がないため、Property属性は使用できません。

* Comparison: 期待値と定義された値を比較する演算子<br /><br /> ドロップダウンリストから以下のいずれかの演算子を選択できます：_Equals_、_Not Equals_、_Contains_、_Not Contains_、_Is Empty_、_Is Not Empty_、_Lesser Than_、_Greater Than_、_Lesser Than Or Equal To_、_Greater Than Or Equal To_、_Has Key_、_Array Count_。<br /><br /> _Has Key_演算子は、ヘッダー、XMLまたはJSONパスに特定のキーが存在するかどうかを確認できます。_Array Count_演算子は、ヘッダー、XMLまたはJSONキーで期待する配列項目の数を指定するために使用できます。

注意: Status Codeソースタイプには以下の演算子は適用されません：Contains、Not Contains、Is Empty、Is Not Empty、Has Key、Array Count。

* Value: 比較演算子に基づいて、選択したプロパティに期待される値

注意: Is EmptyおよびIs Not Empty演算子には値を追加できません。
 たとえば、レスポンスステータスコードがエラーコードのいずれでもないことを期待する場合、Is Lesser Thanを使用して値を「400」と入力してアサーションを定義できます。HTTPステータスコード400以上はエラーを示すためです。

対応する閉じるアイコンをクリックしてアサーションを削除できます。

例:

あるリクエストのレスポンスに、以下の条件を満たすJSONボディのデータが含まれることを期待するとします：

* キー_id_が「10000」以上であること
* キー_location.country_が必ず存在すること
* キー_location.country_に空の値が含まれないこと
* キー_location.city_に「New York」の値が含まれないこと

したがって、毎回JSON Bodyをソースとして選択した後、以下のアサーションを追加する必要があります：

* アサーション1: _Property_\= "id"、_Comparison_\= "Greater Than Or Equal To"、_Value_\= "10000"
* アサーション2: _Property_\= "location"、_Comparison_\= "Has Key"、_Value_\= "country"
* アサーション3: _Property_\= "location.country"、_Comparison_\= "Is Not Empty"
* アサーション4: _Property_\= "location.city"、_Comparison_\= "Not Equals"、_Value_\= "New York"

実行時に以下のJSONレスポンスを受信したとします：

{
"id" : "10993",
"location": {
"country":"US",
"city":"Austin"
}
}


レスポンスが定義したすべてのアサーションを満たすため、テストは成功と見なされます。

<br>

### リクエスト内の変数の設定

リクエストに対して受信するレスポンスからデータを抽出し、チェーンリクエストで次のリクエストにパラメータ値として渡すために変数に割り当てることができます。

テストケース内で設定する変数は、Catalystプロジェクトの必要な詳細を保存するために使用する環境変数やグローバル変数とは異なります。パラメータやリクエストURLフィールドでこれらの変数を使用する構文も異なります。詳細については変数セクションで確認できます。このセクションでは、チェーンリクエスト用の変数の追加についてのみ説明します。

リクエスト設定ウィンドウのVariablesタブをクリックし、テストケースに設定する各変数に対してAdd Variableをクリックします。

<br />

これはアサーションと同じ要素を含んでいます。

1. Sourceを選択して、データを抽出する場所を指定します。
2. 変数を割り当てるソースの特定の属性を_Property_として定義します。
3. Variable列に、データを割り当てる変数名を入力します。構文の詳細については変数セクションを参照してください。

注意: APIテスト中に作成された変数のスコープは、その特定のテストケースに限定されます。環境変数とグローバル変数のスコープは、すべてのテストケースでグローバルです。

閉じるアイコンをクリックして変数を削除できます。

リクエストのチェーンセクションでは、作成した変数を使用してチェーンリクエストでデータを渡す例を示します。

<br>

### テストケースとリクエストの管理

チェーンリクエストの設定について説明する前に、コンソールからリクエストに対して実行できるいくつかのアクションを紹介します：

<br />
* リクエスト名の変更: リクエストの設定ウィンドウで名前の横にある編集アイコンをクリックし、新しい名前を入力します。Enterを押して変更を保存します。

* リクエストの削除: 削除アイコンをクリックし、確認ポップアップウィンドウでYesをクリックします。<br /> <br />

ツールバーおよび以下のオプションからテストケースに対して以下のアクションも実行できます：



* テストの実行: テストを即時実行し、レスポンスのライブプレビューを表示できます。すべての変更を横のSaveボタンで保存した後、ページ下部のRunをクリックします。

注意: このオプションは、テストケースの設定が正しく動作しているかを素早く確認するために使用します。テストケースをスイートに追加し、テストプランを使用して実行をスケジュールすることで、テスト実行を自動化できます。

開くポップアップウィンドウから、テストを実行するデフォルトの環境をオプションで選択することもできます。実行アイコンの横にある矢印をクリックし、Customizeをクリックして、以前に設定した構成を選択または変更することもできます。

<br /> ドロップダウンウィンドウから環境変数を選択する必要があります。環境変数の設定の詳細については、変数セクションを参照してください。チェックボックスをクリックして、これを優先設定として保存できます。Runをクリックします。<br /> <br /> 進行状況を表示するライブプレビューウィンドウが開きます。実行完了後にサマリーが表示されます。Restartをクリックして実行を再開できます。<br /> <br /> 画面下部のShow LessまたはShow Moreをクリックして、ライブプレビューをいつでも折りたたんだり展開したりできます。実行に複数のリクエストが含まれる場合、すべてのレスポンスがライブプレビューセクションに表示されます。


注意:

   * 即時実行のサマリーには詳細なレポートは含まれません。
   * これらのサマリーはResultsセクションにも表示されません。Resultsセクションには、テストプランを通じて実行された自動テスト実行の詳細なレポートのみが表示されます。
   * このライブプレビューセクションに表示されるサマリーは、このセクションから移動すると消えます。


* テストケースの保存: ページ下部のSaveをクリックして、テストケースの変更を定期的に保存してください。

* テストケースのスイートへの即時追加または削除: テストケースのツールバーのスイートアイコンをクリックして、テストスイートに即座に追加します。ポップアップウィンドウでAdd to Test Suiteをクリックし、リストから既存のスイートを選択します。<br /> <br /> このウィンドウでスイート名にカーソルを合わせると表示される削除アイコンをクリックして、すでに追加されているスイートからテストケースを削除することもできます。Yes, Proceedをクリックします。<br /> 

* テストケースの編集: 編集アイコンをクリックして、テスト名と説明を編集するか、テストケースを別のモジュールに移動します。変更を行い、Updateをクリックします。



左パネルの詳細については、このセクションを参照してください。

<br>

### リクエストのチェーン

テストケースで必要なすべてのリクエストを作成・設定した後、これらのリクエストを実行する順序を選択できます。

テストケースが実行されるたびに、リクエストは設定された順序でのみ実行されます。デフォルトでは、リクエストはテストケース内での作成順に一覧表示され、最初に作成したリクエストが先頭に、次に作成したリクエストが続きます。

リクエストウィンドウの右上にあるドラッグアイコンをクリックし、新しい場所にドラッグすることで、必要な順序にリクエストを並べ替えることができます。



チェーンリクエストを使用すると、変数を使用してリクエスト間で動的な値を渡すことができます。

例を使って説明します。

_Request 1_を、GETメソッドを使用してFunctionを呼び出しデータを取得するように設定するとします。レスポンスはJSONボディを返します。

このレスポンスからキー_id_、_email_、_city_の値を抽出し、_Request 2_のパラメータとして渡す必要があります。以下に示すように、_Request 1_でこれらの値を抽出する変数を設定することでこれを実現できます。



最初のリクエストの実行後、次のリクエストの実行前に一定時間一時停止したい場合は、最初のリクエストの下にあるPauseをクリックして一時停止時間を設定できます。これは2番目のリクエストを作成する前に設定する必要があります。



注意: レスポンスの受信に待ち時間が予想される場合、リクエスト後に一時停止時間を設定できます。これにより、Automation Testingは次のリクエストの実行を開始する前にその時間だけ待機します。

次に、別のリクエストを作成し、抽出した値を動的に渡します。これらの変数をパラメータ値として渡すために、_Request 2_に対応するパラメータを追加する必要があります。以下に示すように実現できます。

<br />

注意: リクエスト内のローカル変数は名前を直接宣言して定義でき、 {{\<variable\>}} 形式でパラメータ値として渡す必要があります。グローバル変数と環境変数の構文については、変数セクションを参照してください。

設定を保存した後に即時実行を開始すると、最初に_Request 1_が実行されます。期待されるJSONレスポンスが返されたとします。定義されたキー_id_、_email_、_city_で送信された値がそこから抽出され、_Request 1_の変数_customer\_id_、_customer\_email_、_city\_name_に割り当てられます。

これらは、リクエストの呼び出し時に、_Request 2_で定義されたパラメータ_customerID_、_customerEmail_、_city_にそれぞれ値として渡されます。

この方法でチェーンリクエストを設定・オーケストレーションできます。

<br>

### すべてのテストケースとモジュールの管理

_Test Cases_セクションの左パネルでは、いくつかのアクションを実行できます。作成したすべてのモジュールと、それらのモジュール内のすべてのテストケースが一覧表示されます。



検索バーを使用してテストケースを検索し、ここからモジュールに移動して任意のテストケースを開くことができます。

#### モジュールの作成

テストケースを追加するために、任意の数のモジュールを作成できます。

1. 左パネルの下部にあるAdd Moduleをクリックします。
2. モジュールの名前と説明を入力します。<br /> <br />
3. サブモジュールを作成する場合は、ドロップダウンリストをクリックして既存の親モジュールを選択します。新しいモジュールを作成する場合は、これを無視してCreateをクリックします。<br />
注意: 前述のとおり、サブモジュールは1レベルまで作成できます。モジュールは同じレベルにテストケースとサブモジュールを含めることはできません。そのため、ルートに直接テストケースがない場合にのみ、親モジュールを選択できます。

モジュールが作成され、ディレクトリに一覧表示されます。

#### テストケーススキーマ

左パネルの上部にあるManageをクリックして、設定したすべてのモジュール、サブモジュール、テストケースの詳細なスキーマにアクセスできます。



詳細ページが開きます。ディレクトリを展開または折りたたんで、テストケースのスキーマを表示できます。



検索バーを使用してテストケースを検索したり、リストアイコンをクリックしてテストケースのリストのみを表示したり、このセクションの右上から新しいテストケースやモジュールをすばやく作成したりできます。

モジュールの省略記号アイコンをクリックして、以下のアクションを実行できます：



* メニューから+Moduleまたは+Test Caseをそれぞれ選択して、モジュール内に新しいサブモジュールまたは新しいテストケースを作成できます。

* モジュールの編集: Editをクリックして、モジュールの名前、説明を更新するか、別のモジュールの下に移動するか、親モジュールから外します。<br /> <br /> 必要な変更を行い、Updateをクリックします。

* モジュールの削除: Deleteをクリックしてモジュールを完全に削除します。
<br /> <br /> 確認ポップアップウィンドウでYesをクリックします。

注意: テストケースを含むモジュールは削除できません。モジュールを削除する前に、モジュール内のすべてのテストケースを先に削除する必要があります。

* モジュールの移動: Move toをクリックして、モジュールを別のモジュールの下に移動するか、親モジュールから外すこともできます。右側にパネルが開きます。モジュールまたはルートを選択し、Moveをクリックします。<br /> 

* モジュールのスイートへの追加: Add to Suiteをクリックして、モジュールを1つ以上のスイートにすばやく追加します。右側にパネルが開き、スイートを選択できます。Applyをクリックして変更を保存します。<br /> <br /> 同様に、このページからテストケースの省略記号アイコンをクリックすると、以下のオプションにアクセスできます。
<br /> 

* テストケースの削除: メニューからDeleteをクリックし、確認ポップアップウィンドウでYesをクリックします。<br /> 

注意: テストスイートまたはテストプランで参照されているテストケースは削除できません。まずテストプランからテストスイートを削除し、次にテストスイートからテストケースを削除してから、テストケースを削除する必要があります。

_Edit_、_Move To_、_Add to Suite_オプションは、このセクションで説明したものと同じです。Manageセクションのチェックボックスを使用して複数のテストケースを選択し、一括で削除、移動、またはスイートに追加することもできます。


--------------------------------------------------------------------------------
title: "テストプラン"
description: "Automation Testingは、Functionのエンドポイントまたは任意のサードパーティURLに対して、効率的で自動化されたAPIテストを実行し、問題箇所を解決することを可能にします。"
last_updated: "2026-09-02T11:25:12.654Z"
source: "https://docs.catalyst.zoho.com/ja/devops/help/automation-testing/test-plans/"
service: "DevOps"
--------------------------------------------------------------------------------



# Test Plans

Test Planは、1つ以上のTest Suitesの自動実行を可能にします。Test Planでは、Suiteの実行順序、実行に適用する環境変数、実行スケジュール、通知アラートなど、実行に関する様々な詳細を設定できます。Test Planの実行に関する詳細なレポートは、Resultsセクションから確認できます。

### Test Planの作成

以下の手順でTest Planを設定できます:

1. Automation TestingのTest Planタブをクリックし、Create Test Planをクリックします。<br /> 

2. Test Planの名前と説明を入力します。<br /> 

3. Environment Variables: このテスト実行に適用する環境変数を選択できます。



注意: グローバル変数と環境変数の両方で同じキーの変数を定義した場合、CatalystはTest Plan実行時にグローバル変数の値よりも環境変数の値を使用します。詳しくは変数セクションを参照してください。

4. Test Suites: Add Test Suitesをクリックして、このTest Planで実行する少なくとも1つのTest Suiteを含めます。ポップアップウィンドウからTest Suitesを選択し、Saveをクリックします。<br /> 

 追加後、左側のドラッグアイコンを使用してドラッグ＆ドロップし、Test Suitesを並べ替えて実行順序を定義できます。また、削除アイコンをクリックして、含めたTest Suiteを削除することもできます。<br /> 

5. Schedule: 以下の実行タイプのいずれかを選択して、テスト実行のスケジュールを設定します:

   * Nightly: このタイプでは、午後6時から午前6時までの間で実行時間を設定できます。毎晩実行されます。実行する曜日とTest Planの開始日をカレンダーから選択できます。
   * Day: このタイプでは、午前6時から午後6時までの間で実行時間を設定できます。毎日実行されます。実行する曜日とTest Planの開始日をカレンダーから選択できます。
   * Custom: 特定の開始日と24時間中の任意の実行時間で実行するように設定できます。このタイプでは曜日の選択はできません。
   * Starts Now: Test Planが作成された直後に実行を開始します。このタイプではスケジュールの設定はできません。<br /> 

6. Notifications: Add Notificationsをクリックして、Test Planの実行における様々なイベントに対する通知アラートを設定します。ポップアップウィンドウが開きます。<br /> 

Whenドロップダウンリストから実行イベントの1つを選択できます:

   * Started: Test Planの実行が開始されたとき
   * Completed: Test Planの実行が完了したとき
   * Success: Test Planの実行が成功した場合
   * Fail: Test Planの実行が失敗した場合
   * Not executed (delay): Test Planが予定時刻に開始されなかった場合
   * Terminated: Test Planが完了せずに進行中に終了した場合

 _Success_と_Fail_オプションには、通知をトリガーする成功または失敗のパーセンテージを指定する追加フィールドがあります。<br /><br /> _Recipients email address_テキストフィールドをクリックすると表示されるコラボレーターのリストから、アラートを送信する受信者のメールアドレスを選択します。他の受信者のメールアドレスも入力できます。<br /><br /> 送信する通知メッセージを入力し、Saveをクリックします。異なるイベントに対して複数の通知を追加でき、作成後に編集や削除もできます。

7. Test Planの設定が完了したら、Createをクリックします。

Test Planが作成され、_Test Plans_セクションにリスト表示されます。一意のTest Plan IDが作成されます。

### Test Planの管理

_Test Plans_セクションで、すべてのTest Planとその詳細を確認できます。ここからTest Planに対して様々なアクションを実行できます。



* Test Planの無効化または有効化: _Status_列のトグルをクリックして、スケジュールされたTest Planを有効または無効にします。

注意: これにより、Test Planのスケジュールのみが無効または有効になります。以下に指定するように、Test Planの即時実行は引き続き実行できます。

* Test Planの実行: 実行アイコンをクリックして、Test Planの即時実行を行い、結果を確認できます。この実行の結果はResultsセクションから確認できます。自動実行と即時実行の各Test Plan実行に一意のRun IDが生成され、Resultsセクションに表示されます。

* Test Planの削除: 削除アイコンをクリックし、確認ポップアップでYesをクリックしてTest Planを削除します。



チェックボックスを使用して複数のTest Planを選択し、一括削除できます。


--------------------------------------------------------------------------------
title: "結果"
description: "Automation Testingにより、FunctionエンドポイントまたはサードパーティURLで効率的な自動APIテストを実行し、問題領域を解決できます。"
last_updated: "2026-09-02T11:25:12.655Z"
source: "https://docs.catalyst.zoho.com/ja/devops/help/automation-testing/results/"
service: "DevOps"
--------------------------------------------------------------------------------


# 結果

Resultsセクションには、実行されたすべてのテストプランの詳細かつ包括的なレポートが表示されます。

ここには、スケジュールされた自動テストプラン実行と、_Test Plans_セクションから実行された即時実行の結果が表示されます。_Test Cases_セクションで実行されたライブプレビューの結果は表示されません。それらの結果はそれぞれのセクションから確認できます。

Automation TestingのResultsタブをクリックして結果にアクセスします。

Resultsセクションは3つのレベルで結果を表示します：

### すべてのテスト実行

すべてのテストプランのすべてのテスト実行が、Resultsの初期ページに表示されます。



完了した実行数と現在実行中の実行数、すべてのテストプラン実行の全体的な成功率、すべての実行に関与した環境数などの統計を確認できます。最後のものは、テストプランの作成時に選択した環境変数に基づいています。

一意のRun ID、実行に含まれるテストケース数、実行の成功率、開始時間、実行期間などの詳細とともに、すべてのテスト実行のリストを確認できます。

以下に示す基準に基づいて結果を並べ替え、それに応じて実行を表示できます。



フィルターボタンをクリックしてさまざまなフィルターを選択することで、結果をフィルタリングすることもできます。


* Date: 日付フィルターとして次のオプションから選択して、その期間の結果のみを表示できます：_Last 24 hours_、_Last 7 days_、_Last 1 month_、_Custom_。_Custom_オプションでは、必要に応じて日付範囲を選択できます。
* Status: 次の実行ステータスのいずれかを選択して、関連する結果を表示できます：_Completed_、_Running_、_Queued_、_Terminated_。
* Test Plan: 特定のテストプランに基づいて結果をフィルタリングすることもできます。そのテストプランのすべての実行のみが表示されます。

フィルターを選択した後、Applyをクリックします。

結果の反映に時間がかかる場合は、このページの上部にあるRefreshをクリックしてください。

<br>

### 特定のテスト実行の詳細

テスト実行リストから特定のテスト実行を開き、テストプランに含まれるテストケースの詳細を確認できます。合計テストケース数、完了・残り・非アクティブなテストケースの数、そのテスト実行の全体的な成功率などの統計を確認できます。



テストプランに含まれるすべてのテストケースが、各テストケースの全体的な結果やその他の詳細とともに一覧表示されます。

テストケースの実行期間に基づいて結果を並べ替えることもできます。



フィルターアイコンをクリックしてさまざまな詳細を選択することで、結果をフィルタリングできます。特定のスイートのテストケースのみ、または次のいずれかのステータスで実行されたテストケースを表示できます：_Completed_、_Passed_、_Failed_、_Inactive_、_Remaining_。フィルターを選択した後、Applyをクリックします。



<br>

### 特定のテストケースの詳細

テストケースリストから特定のテストケースを開き、その中の個々のリクエストの実行詳細を確認できます。このセクションでは、特定のテストケースのサマリーとともに、テストケース実行の全体的な結果と期間、テストケースでパスしたアサーションの合計数などの有用な統計が提供されます。



テストケース内の個々のリクエストの詳細と、各リクエストに対して受信した詳細なレスポンスが一覧表示されます。リクエストのセクションを展開して、そのリクエストでパスしたアサーションとレスポンスステータスコードを確認できます。



レポートにはレスポンスボディ、レスポンスヘッダー、リクエストの詳細も表示されます。右側のドロップダウンから選択して、Response Bodyをraw形式またはpretty形式で表示できます。

Response HeadersまたはRequest Detailsタブをクリックして、それらの情報を表示します。



このドリルダウンにより、テストケースが失敗した正確なリクエストとその具体的な理由を簡単に特定できます。

右上の矢印を使用して、次のテストケースの詳細に移動できます。

<br>

### 失敗したテスト実行の詳細

前述のとおり、テスト実行が失敗した場合、自動再実行を設定できます。再実行のステータスと詳細は*Results*セクションで確認できます。

<br />

*Results*セクションでは、失敗したテストプランを展開して、実行されたテスト実行数、テストされたテストケース数、そのステータス、期間、全体的な結果の概要を確認できます。すべてのテスト実行と再実行の概要をここで確認できます。

<br />

この画像の**Re-Run 1**は、失敗時に自動再実行が行われたことを示しており、そのテスト実行の概要も併せて表示されます。

特定の失敗したテスト実行をクリックして、その詳細なレポートを表示できます。

<br>

### 特定の失敗したテスト実行の詳細

失敗したテスト実行をクリックすると、*Results*セクションに表示されるすべての概要統計を確認でき、**Pre-Condition**と**Post-Condition**のテストケースのステータスと結果もその詳細とともに確認できます。

<br />

画面の上部、テストプラン名の横にあるドロップダウンをクリックし、**Re-Run 1**を選択して、失敗時に自動的に実行された再実行のステータスと結果を確認できます。

<br />

### 失敗した再実行のテストプランを手動で実行

1. 再実行も失敗した場合、右上の**Run**ボタンをクリックして、失敗したテストプランを手動で実行できます。

<br />

2. **Proceed**をクリックして手動再実行を開始します。

<br />

手動再実行を実行したテストプランをクリックして、そのステータスを確認します。

<br />

このドリルダウンにより、テストケースが失敗した正確なリクエストとその詳細を簡単に特定できます。

実行が成功するまで、同じ方法で失敗したテストプランを何度でも再実行できます。実行が成功すると、このセクションに実行ボタンは表示されなくなります。ドロップダウン選択をクリックして必要なテスト実行を選択することで、すべての以前のテストケースの詳細なログを確認できます。

<br />

注意: 失敗したテストプランの自動再実行を設定しているかどうかに関係なく、Test Planセクションから任意のテストプランを手動で実行できます。


--------------------------------------------------------------------------------
title: "変数"
description: "Automation Testingにより、FunctionエンドポイントまたはサードパーティURLで効率的な自動APIテストを実行し、問題領域を解決できます。"
last_updated: "2026-09-02T11:25:12.656Z"
source: "https://docs.catalyst.zoho.com/ja/devops/help/automation-testing/variables/"
service: "DevOps"
--------------------------------------------------------------------------------


# 変数

### はじめに

変数は、リクエストで渡す可能性のある動的な値のプレースホルダーです。頻繁に使用する値を変数として保存し、テストケースで参照することで、値を変更する必要がある場合に、使用している各テストケースで変更する必要がないため、作業が容易になります。設定した変数を編集するだけで済みます。

Automation Testingでは、さまざまな目的で使用されるさまざまなタイプの変数を設定できます。

変数を使用する1つの方法は、_Variables_セクションで固定パラメータの値を定義・保存し、リクエストで簡単に参照することです。これには以下の2種類の変数があります：

* グローバル変数: グローバル変数は、任意のテストケースで使用するために定義・保存できる単一の変数セットです。これらの変数はグローバルスコープを持ち、すべてのテストケースに適用できます。
* 環境変数: 環境変数は、異なる環境に対して同じキーの値を分類・設定するのに役立ちます。テストプランを設定するか、テストケースの即時実行を実行する際に、実行に使用する環境を選択できます。その環境で定義された変数が適用されます。これらの変数は、すべてのテストケースでグローバルに使用することもできます。

Automation Testingで変数を使用するもう1つの方法は、テストケース内の個々のリクエストのレスポンスから受信した値を抽出し、チェーン設定で次のリクエストのパラメータとして渡すために変数に割り当てることです。リクエスト内で定義されたこのような変数のスコープはそのテストケースに限定され、そのテストケースの外では参照できません。この方法については、リクエストのチェーンセクションで例を用いて詳しく説明します。


#### グローバル変数と環境変数の例：

各環境で1つの変数に異なる値を保存できます。たとえば、CatalystのZAIDの値は開発環境と本番環境で異なります。その場合、まず「Development」と「Production」という名前の2つの環境を作成します。次に、これらの両方の環境で「zaid」という名前の変数を作成し、それぞれの値を個別に定義します。

テストプランの設定時に_Development_を選択すると、リクエストで変数zaidを使用している箇所に、開発環境でzaidに定義された値が適用されます。



同じ変数をグローバル変数として定義し、各環境で個別に定義することもできます。

たとえば、_baseURL_というグローバル変数を作成し、値を「https://globaltest.com」と定義できます。次に、DevelopmentおよびProduction環境で同じ_baseURL_変数を、それぞれ「https://developmenttest.com」と「https://productiontest.com」の値で作成できます。

ここで、テストケースのリクエストを設定する際に、_baseURL_をリクエストURLとして参照するとします。即時実行の実行時に使用する環境変数として_Development_を選択すると、https://developmenttest.comの値がリクエストURLとして使用されます。_Production_を選択すると、「https://productiontest.com」の値が使用されます。即時実行で環境を選択しない場合、デフォルトでグローバル値「https://globaltest.com」が使用されます。

#### 覚えておくべき重要なポイント：

* 同じ変数をグローバル変数および異なる環境変数として作成することは、同じキーに複数の値を割り当てることになります。
* グローバル変数を作成し、対応する環境変数を持つことができます。特定の環境でのみ新しい変数を作成した場合でも、同じ値でグローバル変数セクションに一覧表示されます。
* 環境が選択されていない場合、テストプランまたは即時実行ではデフォルトでグローバル変数が使用されます。環境を選択した場合にのみ、その環境の値がグローバル値をオーバーライドします。
* 特定のリクエスト内で作成するローカル変数は、名前で直接宣言でき、他のリクエストで\{\{\<variable \>\}\}
形式のパラメータ値として渡す必要があります。
* グローバル変数と環境変数は、リクエスト内で\{\{$\<variable \>\}\}形式で渡す必要があります。

### グローバル変数の作成

以下の方法でグローバル変数を作成できます：

1. _Automation Testing_のVariablesタブをクリックし、Create Variableをクリックします。<br /> <br />
2. 変数の名前と値を入力し、Saveをクリックします。<br /> <br />
注意: 変数名にスペースを含めたり、数字で始めたりすることはできません。変数名は大文字と小文字が区別されます。
 右上のBulk Addをクリックして、複数の変数を一括で追加することもできます。ポップアップウィンドウでkey:value形式で変数を定義し、Saveをクリックします。<br /> すべての変数が追加され一覧表示されます。<br /> 

### 環境変数の作成

環境変数を作成する前に、環境を作成する必要があります。

1. _Variables_セクションからEnvironment Variablesをクリックします。
2. ポップアップウィンドウで環境名を入力し、Createをクリックします。<br /> 

3. グローバル変数の作成と同じ方法で、その環境内に変数を作成できます。変数の名前と値を入力し、Saveをクリックします。<br /> 環境のセクションでは、Nameテキストボックスをクリックすると、すべてのグローバル変数が一覧表示されます。いずれかを選択して、この環境でその変数に異なる値を割り当てるか、テキストボックスに入力して完全に新しい変数を作成できます。この変数はグローバルセクションにも一覧表示されます。

右上のBulk Addをクリックして、グローバル変数の一括追加と同じ方法で、複数の環境変数を一括で追加することもできます。

### グローバル変数と環境変数の管理

上部のドロップダウンをクリックして、グローバル変数または特定の環境の変数を開くことを選択できます。必要なオプションを選択します。



* 環境名の編集: 環境名の横にある編集アイコンをクリックします。ポップアップウィンドウで変更を行い、Updateをクリックします。<br /> <br />
* 環境の削除: 環境名の横にある削除アイコンをクリックします。ポップアップウィンドウでYesをクリックします。<br /> 

注意: 環境またはグローバル変数・環境変数を削除すると、設定済みのテストケースに影響を与え、データ損失が発生する可能性があります。慎重に操作してください。

* 変数の削除: 変数名にカーソルを合わせると表示される編集アイコンをクリックして、グローバル変数または環境変数を削除できます。<br /> <br /> 

確認ポップアップウィンドウでYesをクリックします。<br /> <br />


--------------------------------------------------------------------------------
title: "料金"
description: "Automation Testingは、Functionのエンドポイントまたは任意のサードパーティURLに対して、効率的で自動化されたAPIテストを実行し、問題箇所を解決することを可能にします。"
last_updated: "2026-09-02T11:25:12.656Z"
source: "https://docs.catalyst.zoho.com/ja/devops/help/automation-testing/pricing/"
service: "DevOps"
--------------------------------------------------------------------------------



# 料金

他のすべてのCatalystコンポーネントは、Development環境で設定および作業するために無料で提供されています。通常、アプリケーションをProductionにデプロイする際にCatalystの支払いの設定を求められます。

ただし、はじめにで述べたように、Automation TestingはDevelopment環境でのみアクセス可能でProductionではアクセスできないため、CatalystはこのコンポーネントをDevelopment環境で一部有料として提供しています。

Automation Testingの料金基準は、このコンポーネントで実行されるテスト実行の回数です。1回のテスト実行は、1つのテストケースの実行です。つまり、Resultsセクションの_特定のテスト実行の詳細レベル_にリスト表示される各テストケースの実行が1回のテスト実行としてカウントされます。

例えば、_Test Plan A_に合計20個のテストケースを含むいくつかのSuiteが含まれており、_Test Plan A_が全体で3回実行された場合、テスト実行の総数は60になります。このように、各Test Plan内の各実行で実行されたテストケースの数がカウントされ、テスト実行の総数が決定されます。

Catalystは最初の500回のテスト実行を無料で提供しています。Automation Testingページの下部にあるすべてのセクションの_Free trial runs left_カウントには、500回のうち残りの無料テスト実行数が常に表示されます。



これは各テスト実行の後に更新されたカウントを表示します。この制限を使い切ると、Catalystはそれ以降の各テスト実行に対して課金を開始します。正確な費用やその他の詳細については、ウェブサイトの料金セクションをご確認ください。

以前にCatalystの支払いを設定していない場合は、Catalystの支払いを有効にするためにカードを追加する必要があります。_Free trial runs left_カウントをクリックすると、ポップアップウィンドウが開きます。



その後、Add Cardボタンをクリックして支払い方法を設定できます。Catalystの支払い設定と請求管理の詳細については、請求ヘルプドキュメントを参照してください。

500回の無料トライアル実行の制限を使い切ると、CatalystはAutomation Testingページの上部にAdd Cardボタン付きのバナーも表示します。

支払い方法を設定した後、無料トライアル実行数は下部に表示されなくなります。


---

## API Reference — 自動テスト

--------------------------------------------------------------------------------
title: "テスト計画を実行する"
description: "このAPIを使用すると、リモートコンソールで既に設定されているAutomation Testingのテストプランの実行をトリガーできます。"
last_updated: "2026-09-02T11:25:12.662Z"
source: "https://docs.catalyst.zoho.com/ja/api/code-reference/devops/automation-testing/execute-test-plan/"
service: "DevOps"
--------------------------------------------------------------------------------






# Automation Testing

Automation Testingは、アプリケーションのAPIテストプロセスを自動化するAPIテストツールです。アプリケーション内のBasic I/OおよびAdvanced I/O関数、または任意のサードパーティURLをテストし、レスポンスを取得できます。要件に基づいてテストケースを記述し、テストの自動実行をスケジュールし、最小限の手動介入でAPIテストのプロセス全体を管理できます。

注意: Automation Testingは現在、EU、AU、IN、またはCAデータセンターからアクセスするCatalystユーザーには利用できません。

# テストプランの実行


### 説明

テストプランは、Automation Testingにおける1つ以上のテストスイートの自動実行を可能にします。このAPIを使用すると、プロジェクト内のリモートコンソールで既に設定されているテストプランの実行をトリガーできます。これは、コンソールでテストプランに対して利用可能な即時実行オプションと同等です。

### リクエスト詳細

#### リクエストURL
<p>{api-domain}/baas/v1/project/{project_id}/automation-testing/{test_plan_id}/execute</p>

Catalyst APIにアクセスするためのDC固有ドメイン

プロジェクトの一意のID

テストプランに対して作成された一意のID



#### リクエストヘッダー
 **Authorization:** Zoho-oauthtoken {oauth_token} <br>
**Environment:** Development


**任意のヘッダー** <br>
 **CATALYST-ORG:** {org_id}

 **Environment:** Development


#### スコープ

ZohoCatalyst.automationtesting.execute




### レスポンス詳細

レスポンスには、テストプラン実行のステータスが含まれ、自動実行または即時実行ごとに生成される一意のRun ID、渡されたTest Plan ID、および実行開始のステータスをtrueまたはfalseとして含むis_schedule_startedパラメータなどの詳細が含まれます。






curl -X POST \
https://api.catalyst.zoho.com/baas/v1/project/3359000000016812/automation-testing/537000000022025/execute \
-H "Authorization: Zoho-oauthtoken 1000.25*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*e.3e*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*3" \



    {
    "status": "success",
    "data": {
        "id": 537000000034053,
        "test_plan_id": 537000000022025,
        "is_schedule_started": true
    }
    }