コネクタービルダーの送信テスト

Okta Integration Networkに公開されたOkta Workflowsコネクターはいずれも、Oktaのお客様が期待する厳格な要件を満たすよう正しく評価される必要があります。

送信プロセスの一環として、サードパーティーがコネクターのテストケースドキュメントを作成し、対応するテストフローとともに送信する必要があります。

テストケース

テストケースドキュメントの内容：

すべてのテストシナリオ
意図する目的
すべての必須の入力
期待する結果

テストケースは、ポジティブなシナリオとネガティブなシナリオの両方を含める必要があります。ネガティブなシナリオとは、必須の入力が不足している、またはカードが無効の入力を受信している場合に、カードが失敗あるいはエラーを返すテストケースを指します。

テストケースはコネクターカードのあり得る組み合わせについて説明し、異なるオプションの連携を証明する必要があります。

テストケースの例

テストケースID	アクションカード	タイトル	前提条件	期待する結果
TC001	カスタムAPIアクション（Custom API Action）	パスワードと、falseと等しいアクティベーションパラメーターを持つユーザーを作成する 200を返し、ユーザーの「ステータス」を「STAGED」に設定する必要がある	リクエストタイプ（Request Type） = `POST` 相対URL（Relative URL）= `/api/v1/users` クエリ（query） = `False`	作成されたユーザーのステータス = `Staged`
TC002	カスタムAPIアクション（Custom API Action）	有効なユーザーIDとfalseと等しいsendEmailパラメーターを持つユーザーをアクティブ化する 200を返し、ユーザーの「ステータス」を「ACTIVE」に設定する必要がある	リクエストタイプ（Request Type） = `POST` 相対URL（Relative URL）= `/api/v1/users/lifecycle/activate`	ユーザーのステータスが`Active`に変更される
TC003	カスタムAPIアクション（Custom API Action）	ユーザーのメールアドレスでユーザーを検索する 200とユーザー配列を返す必要がある	リクエストタイプ（Request Type） = `GET` 相対URL（Relative URL）= `/api/v1/users`	ユーザーリストが表示される
TC004	カスタムAPIアクション（Custom API Action）	有効なユーザーIDを持ち、ユーザーステータスが「ACTIVE」のユーザーを一時停止する 200を返す必要がある	リクエストタイプ（Request Type） = `POST` 相対URL（Relative URL）= `/api/v1/users/lifecycle/activate`	ユーザーステータスが`Suspended`に変更される
TC005	カスタムAPIアクション（Custom API Action）	有効なユーザーIDを持つユーザーを読み取る 200とユーザー情報を返す必要がある	リクエストタイプ（Request Type） = `GET`	ユーザー情報が返される
TC006	カスタムAPIアクション（Custom API Action）	有効なユーザーIDを持つユーザーを更新する 200とユーザー情報を返す必要がある	リクエストタイプ（Request Type） = `GET`	ユーザーレコードが更新される
TC007	カスタムAPIアクション（Custom API Action）	グループデータの更新をプッシュする 200のコードを返す必要がある	リクエストタイプ（Request Type） = `PUT`	グループデータが更新される
TC008	カスタムAPIアクション（Custom API Action）	相対URL（Relative URL）の最初が「/」ではないグループ情報を取得するエラーが返される必要がある	リクエストタイプ（Request Type） = `PUT`	カードがエラーを返す

テストフロー

OINチームは提供されたテストフローを利用してコネクターの機能をテストし、期待通りに動作するかどうかを検証します。チームは提供されたテストケースドキュメントにテスト結果を照らし合わせます。

要件

各テストケースにテストフローを提供してください。
テストケースIDとテストされるアクションカード名を含め、各フローを命名してください。例：TC001 Custom API Action
カードのすべての入力に関する有効な値（必須の値と必須ではない値の両方を含む）をテストフローで提示してください。
各入力の組み合わせにテストフローが必要です。たとえば、検索カードは一般的に First Matching Record、 First 200 Matching Records、 Stream all Matching Recordsのパターンに従います。
期待される値に対するカードの出力すべてを検証してください。
空やnullなどの無効な入力に対するテストフローを含めてください。If Error関数のエラー処理を利用してエラーを検知し、予期されるエラーと比較してください。

例

このフロー例では、パスワードと、falseに設定されたアクティベーションパラメーターを持つユーザーを作成します。200のステータスコードを返し、ユーザーステータスをSTAGEDに設定する必要があります。このテストケースではIf Error関数カードのTryセクションとIf Errorセクションを利用しています。