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

機能テスト

このドキュメントでは、Application Integration の機能テストと、統合の機能テストを作成して管理する方法について説明します。統合フローをテストすることで、統合が意図したとおりに機能することを確認できます。

概要

機能テストでは、Google Cloud サービスやその他のビジネスアプリケーションを接続して管理する複雑な統合に対して、複数のテストケースを作成して実行できます。統合フローをテストすることで、統合が意図したとおりに機能することを確認できます。さまざまな入力変数を使用して統合をテストし、統合フロー内の障害を特定できます。

テスト構成

Application Integration では、統合に複数のテストケースを追加できます。トリガーの場合は、テストケースで入力値を構成できます。タスクについては、次のテスト構成を更新できます。

モック戦略タイプ: タスク設定できる 3 つのオプションがあります。
- モックなし: この戦略では、タスクを実行して、タスクのアサーションを追加できます。
- モック実行: この戦略では、タスクを正常に実行されたか、失敗したものとしてモックできます。
- モック出力: この戦略では、統合の次のノードに対するタスクの出力をモックできます。
アサーションタイプ: テスト内の選択したタスクに対して複数のアサーションを追加できます。さまざまなアサーションタイプを使用できます。
- 実行のアサート: このアサーションタイプでは、タスクが正常に実行されたかどうかを確認できます。
- パラメータのアサート: このアサーションタイプでは、アサートするパラメータを選択し、比較する値を指定できます。

始める前に

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

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
統合を作成していることを確認します。

テストケースを作成する

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

Console

Google Cloud コンソールで [Application Integration] ページに移動します。
Application Integration に移動
ナビゲーションメニューで [統合] をクリックします。
[統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。
テストを作成する既存の統合を選択します。
統合エディタで統合が開きます。
[テストケース] をクリックし、[+ 新しいテストケースを作成] をクリックします。表示された [テストケースを作成] ペインで、次の操作を行います。
1. [トリガー] リストからトリガーを選択します。
2. [テスト名] フィールドにテストの名前を入力します。
3. [説明] フィールドにテストの説明を入力します。
4. [作成] をクリックします。
  統合エディタページで、デザイナーキャンバスに [機能テストモード: オン] と表示されます。次の画像は、[機能テストの作成] ペインを示しています。
  
  注: 機能テストモードでは統合を編集できません。
トリガーとタスクのテスト構成を構成します。

API

統合バージョンのテストケースをアップロードするには、CreateTestCase メソッドを使用します。

    curl -v -s -X POST
        -H "Content-Type: application/json" \
        -H "Authorization: Bearer $(gcloud auth print-access-token) \
        -d 'TEST_CASE_JSON' \
        'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/PROJECT_LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION/testCases'

TEST_CASE_JSON は、テストケースの本文に置き換えます。

 
    '{"display_name":"TEST_CASE_NAME", "workflow_id":"INTEGRATION_VERSION", "trigger_id":"TRIGGER_ID"}'

テストケースの本文には、次のフィールドが必要です。

TEST_CASE_NAME: テストケースの名前
INTEGRATION_VERSION: 統合のバージョン
TRIGGER_ID: 統合における API トリガーの ID

トリガーのテスト構成を構成する

トリガーのテスト構成を構成する手順は次のとおりです。

Google Cloud コンソールで [Application Integration] ページに移動します。
Application Integration に移動
ナビゲーションメニューで [統合] をクリックします。
[統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。
テストを作成する既存の統合を選択します。
統合エディタで統合が開きます。
[テストケース] をクリックし、[テストケースを開く] をクリックします。[テストケース] ペインに、現在の統合バージョンのテストケースのリストが表示されます。
リストからテストケースを選択します。
統合エディタページで、デザイナーキャンバスに [機能テストモード: オン] と表示されます。次の画像は、トリガーの [テスト構成] ペインを示しています。
統合エディタページでトリガーをクリックして、トリガー構成ペインを開きます。次に、以下の操作を行います。
- 統合に入力変数がある場合は、[テスト構成] タブに入力変数が表示されます。変数に入力した値は自動的に保存されます。
- トリガーのプロパティを表示するには、[トリガーのプロパティ] タブをクリックします。

タスクのテスト構成を構成する

統合タスクのテストプロパティを構成するには、次の手順に従います。

Google Cloud コンソールで [Application Integration] ページに移動します。
Application Integration に移動
ナビゲーションメニューで [統合] をクリックします。
[統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。
テストを作成する既存の統合を選択します。
統合エディタで統合が開きます。
[テストケース] をクリックし、[テストケースを開く] をクリックします。[テストケース] ペインに、現在の統合バージョンのテストケースのリストが表示されます。
リストからテストケースを選択します。
統合エディタページで、デザイナーキャンバスに [機能テストモード: オン] と表示されます。
統合エディタページでタスクをクリックして、テスト構成ペインを開きます。次の画像は、タスクの [テスト構成] ペインを示しています。

[テスト構成] タブで、次の手順に従います。
1. [モック戦略タイプ] で、次のいずれかのモック戦略を選択します。
  - [モックなし] を選択した場合、タスクはタスクテンプレートと同様にメインワークフローから実行されます。デフォルトでは、タスクに [モックなし] 戦略タイプが選択されています。
  - [モック実行] を選択した場合は、[モック実行ステータス] で次のいずれかを選択する必要があります。
    - スキップ
    - 失敗
  - [モック出力] を選択した場合、[タスク出力リスト] で、統合の次のノードのタスクの出力を指定する必要があります。
2. [アサーション戦略] セクションで、次の操作を行います。
  1. [アサーションタイプ] フィールドで、次のいずれかのオプションを選択します。
    - [実行のアサート] を選択した場合は、[アサートする実行ステータス] で次のいずれかのオプションを選択します。
      - 成功
      - 失敗
      - 実行待ち
    - [パラメータのアサート] を選択した場合は、次の操作を行います。
      1. [アサートするパラメータ] で、入力パラメータと出力パラメータを含むパラメータをアサートするかどうかを選択します。
      2. アサートされたパラメータを入力した値と比較する演算子を選択します。アサートされたパラメータを比較する演算は、次のいずれかです。
        
        等しい
        
        等しくない
        
        含む
      3. [値] フィールドに、パラメータを比較する値を入力します。
  2. オプション: アサーションをさらに追加するには、[+ アサーションを追加] をクリックします。