テスト実行

テスト実行では、エンドユーザーがアクションタイプを適用できるようになる前に、Ontology Manager でそのアクションタイプをシミュレーションできます。テスト実行を確定すると、Foundry は指定されたパラメーター値に基づいてアクションを評価し、アクションが行うはずの編集内容と、詳細な実行の内訳を返します。

テスト実行は、アクションタイプエディターのアクションフォームプレビューにあるテスト実行タブから利用できます。

テストを実行する

1. Ontology Manager でアクションタイプを開き、アクションフォームプレビューを開きます。
2. プレビューがフォームレイアウトに設定されていることを確認します。テスト実行はフォームレイアウトで利用でき、テーブルレイアウトでは利用できません。
3. アクションフォームプレビューでテスト実行タブを選択します。
4. テストするパラメーター値をフォームに入力します。
5. 確定を選択して、テストを実行します。

テスト実行が完了すると、結果がアクションフォームプレビューに表示されます。

テスト実行は、現在のオントロジーブランチ上でアクションタイプを評価し、ご自身の権限で実行されます。その際、通常のアクション実行と同じオブジェクトセキュリティと実行条件が適用されます。Ontology Manager でアクションタイプの設定を閲覧できる場合は、テストを実行できます。

結果を解釈する

完了したテスト実行の結果は、2つのタブに表示されます。

提案された変更

提案された変更タブには、作成、変更、削除されるオブジェクトとリンクを含め、アクションがオントロジーに対して行うはずの編集内容が一覧表示されます。プロパティの変更は、現在の値と提案された値の比較として表示されます。アクションによって編集が行われない場合、タブには提案された変更はありませんと表示されます。

詳細

詳細タブでは、アクションがどのように評価されたかと、直接的な編集以外に何が起こるかが説明されます。

• 実行ログ： メタデータの読み込み、依存関係の検証、実行条件、パラメーターの検証、編集内容の計算を含む、実行のステップごとの内訳です。このログを使用して、アクションに成功した理由や、どの段階で失敗したかを把握できます。
• 副次的効果：通知など、アクションがトリガーするはずの副次的効果のプレビューです。通知プレビューを開くと、生成されるはずの内容と受信者を確認できます。
• 参照されたエンティティ： 実行中にアクションが参照したオブジェクトタイプ、リンクタイプ、インターフェースタイプ、および関数です。

アクションに失敗した場合、詳細タブではエラーが2つのカテゴリーに分けられます。

• 管理者向けエラー： デバッグ用の技術的な詳細です。
• エンドユーザー向けエラー： アクションをトリガーしたユーザーに表示されるメッセージです。

テスト実行中にスキップされる処理

テスト実行では、アクションの結果を判断するために必要な処理のみが行われます。アクションの適用後に発生する副次的効果はスキップされます。アクションタイプに次のいずれかが含まれている場合、アクションフォームプレビューに、それらがスキップされることが通知されます。

• 副次的効果の Webhookは呼び出されません。
• 通知は送信されません。トリガーされるはずの通知の内訳が、テスト実行の結果に表示されます。
• スケジュールビルドはトリガーされません。

外部呼び出し

正確な結果を生成するために、テスト実行では、アクションが結果に到達するために必要な関数と呼び出しが実行されます。これには、アクションのルールで使用される関数、通知の本文または受信者を生成する関数、Webhook のペイロードを生成する関数、ライトバック Webhook、および外部リソースにアクセスする関数が含まれます。アクションの結果を判断するために必要な呼び出しのみが行われます。

制限事項

• テスト実行はフォームレイアウトでのみ利用でき、テーブルレイアウトでは利用できません。
• アクションタイプに未保存の編集内容がある間は、テスト実行は利用できません。テストを実行する前に変更を保存してください。
• テスト実行中にスキップされる処理で説明されているように、アクションの適用後に発生する副次的効果はスキップされます。一部の関数ベースの呼び出しは引き続き実行されます。外部呼び出しを参照してください。