Application Integration でサポートされているコネクタをご覧ください。

テストケースを管理する

プレビュー — Test cases

この機能には、サービス固有の利用規約の「一般的なサービス規約」の「pre-GA サービス規約」が適用されます。 pre-GA の機能は「現状有姿」で利用できますが、サポートが制限される場合があります。 詳しくは、リリース ステージの説明をご覧ください。

このドキュメントでは、統合のテストケースを管理する方法について説明します。テストケースは次の方法で管理できます。

• テストケースを一覧表示する
• テストケースを編集する
• テストケースをコピーする
• テスト ケースを削除する

テストケース、サポートされているテスト構成、制限事項については、テストケースの概要をご覧ください。

始める前に

• テストケースの管理に必要な権限を取得するには、プロジェクトに対する Application Integration 編集者（roles/integrations.integrationEditor）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

  この事前定義ロールには、テストケースの管理に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

  必要な権限

  テストケースを管理するには、次の権限が必要です。

  • テストケースを一覧表示する。 integrations.googleapis.com/testCases.get
  • テストケースをコピーする。
    • integrations.googleapis.com/testCases.get
    • integrations.googleapis.com/testCases.create
  • テストケースを削除する。 integrations.googleapis.com/testCases.delete

  カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

• 統合が DRAFT 状態であることを確認します。統合のステータスが PUBLISHED の場合は、[編集を有効にする] をクリックします。DRAFT 状態の新しいバージョンが統合に作成されます。次の図は、統合エディタの編集ロックを示しています。

  

• 統合にテストケースがあることを確認します。テストケースの作成方法については、テストケースを作成するをご覧ください。

テストケースの編集ロック

Application Integration では、テストケースは設計時のエンティティであり、多くの場合、複数の作成者が共同で開発します。テストケースは、一度に 1 人の作成者のみ編集できますが、チームはテストケースで共同編集できます。

別のユーザーが編集しているテストケースを開くと、統合エディタに次のメッセージが表示されます。これは、任意の時点でテストケースを更新できるのは 1 人のユーザーのみであるためです。

[e-mail] is currently editing the test case. Edit features are temporarily disabled.

注: テストケースは、最後の更新から 15 分間、他のユーザーによる編集がロックされます。ロックは、最後の更新から 15 分後に解除されます。

テストケースを編集するには、[引き継ぐ] をクリックします。次の図は、編集ロックを示しています。

テストケースを一覧表示する

テストケースを一覧表示するには、次のいずれかのオプションを選択します。

Console

1. Google Cloud コンソールで [Application Integration] ページに移動します。

   Application Integration に移動

2. ナビゲーション メニューで [統合] をクリックします。

   [統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。

3. テストケースを含む既存の統合を選択します。

   統合エディタで統合が開きます。

4. [テストケース] をクリックし、[テストケースを開く] をクリックします。[テストケース] ペインに、現在の統合バージョンのテストケースのリストが表示されます。

API

projects.locations.integrations.versions.testCases.list メソッドを呼び出し、関連パラメータを指定します。次に例を示します。

GET https://integrations.googleapis.com/v1/{parent=projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION}/testCases
      

以下を置き換えます。

• PROJECT_ID: Google Cloud プロジェクトの ID
• LOCATION: 統合が配置されているリージョン
• INTEGRATION_NAME: 統合の名前
• INTEGRATION_VERSION: 統合のバージョン

テストケースを編集する

テストケースを編集する手順は次のとおりです。

1. Google Cloud コンソールで [Application Integration] ページに移動します。

   Application Integration に移動

2. ナビゲーション メニューで [統合] をクリックします。

   [統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。

3. テストケースを含む既存の統合を選択します。

   統合エディタで統合が開きます。

4. [テストケース] をクリックし、[テストケースを開く] をクリックします。[テストケース] ペインに、現在の統合バージョンのテストケースのリストが表示されます。
5. 編集するテストケースを選択します。

   統合エディタページで、デザイナー キャンバスに [テストケース モードが有効です] と表示されます。

   統合内のタスクが削除されると、次の図に示すように、テストケースは無効になります。

   

6. 統合内のタスクが削除された場合は、[ 削除 ] をクリックしてテストケースを更新します。
7. テストケースの構成の詳細を更新し、テストケースを実行します。

テストケースをコピーする

同じ統合でテストケースのコピーを作成するには、次のいずれかのオプションを選択します。

Console

1. Google Cloud コンソールで [Application Integration] ページに移動します。

   Application Integration に移動

2. ナビゲーション メニューで [統合] をクリックします。

   [統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。

3. テストケースを含む既存の統合を選択します。

   統合エディタで統合が開きます。

4. [テストケース] をクリックし、[テストケースを開く] をクリックします。[テストケース] ペインに、現在の統合バージョンのテストケースのリストが表示されます。
5. コピーするテストケースを選択します。

   統合エディタページで、デザイナー キャンバスに [テストケース モードが有効です] と表示されます。

6. 複製をクリックします。[テストケースを複製] ページが表示されます。次に、以下の操作を行います。
   1. [テスト名] フィールドにテストケースの名前を入力します。
   2. 必要に応じて、[説明] フィールドにテストケースの説明を入力します。
   3. [作成] をクリックします。テストケースは同じ統合に作成されます。

API

手順は次のとおりです。

• projects.locations.integrations.versions.testCases.get メソッドを呼び出し、関連パラメータを指定します。次に例を示します。

  GET https://integrations.googleapis.com/v1/{parent=projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION}/testCases/TEST_CASE_ID
  

  以下を置き換えます。

  • PROJECT_ID: Google Cloud プロジェクトの ID
  • LOCATION: 統合が配置されているリージョン
  • INTEGRATION_NAME: 統合の名前
  • INTEGRATION_VERSION: 統合のバージョン
  • TEST_CASE_ID: テストケースの ID

出力レスポンスで、テストケースのテキスト プロトコルをコピーします。

• projects.locations.integrations.versions.testCases.create メソッドを呼び出し、前の手順でコピーしたテキスト プロトコルを指定します。

  次に例を示します。

  POST https://integrations.googleapis.com/v1/{parent=projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION}/testCases
  

テスト ケースを削除する

テストケースを削除するには、次のいずれかのオプションを選択します。

Console

1. Google Cloud コンソールで [Application Integration] ページに移動します。

   Application Integration に移動

2. ナビゲーション メニューで [統合] をクリックします。

   [統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。

3. テストを作成する既存の統合を選択します。

   統合エディタで統合が開きます。

4. [テストケース] をクリックし、[テストケースを開く] をクリックします。[テストケース] ペインに、現在の統合バージョンのテストケースのリストが表示されます。
5. 削除するテストケースを選択します。

   統合エディタページで、デザイナー キャンバスに [テストケース モードが有効です] と表示されます。

6. [削除] をクリックします。

API

projects.locations.integrations.versions.testCases.delete メソッドを呼び出します。次に例を示します。

DELETE https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION/testCases/TEST_CASE_ID

以下を置き換えます。

• PROJECT_ID: Google Cloud プロジェクトの ID
• LOCATION: 統合が配置されているリージョン
• INTEGRATION_NAME: 統合の名前
• INTEGRATION_VERSION: 統合のバージョン
• TEST_CASE_ID: 削除するテストケースの ID

次のステップ

• テストケースについて学習する。

• 手順は次のとおりです。

  • テストケースを作成する。
  • テストケースを構成する。
  • テストケースを実行して、テストケースの実行ログを表示する。
  • テストケースをアップロードして、ダウンロードする。