自動テストフレームワーク (ATF) テスト API - ServiceNow Fluent
テスト API には、変更後にインスタンスが動作することを確認するための自動化テスト [sys_atf_test] を作成して実行するオブジェクトが含まれます。
注:
自動テストフレームワーク (ATF) のテスト API は一方向の同期のみをサポートします。ソースコードで ATF テストを定義した後、メタデータがソースコードの外部で変更された場合、それらの変更は同期されず、ソースコードに反映されません。
Test オブジェクト
実行する一連のステップを含む自動化テスト [sys_atf_test] を作成します。
| 名前 | タイプ | 説明 |
|---|---|---|
| $id | 文字列または数値 | 必須。次の形式で提供されるメタデータオブジェクトの一意の ID。ここで、<value> は文字列または数値です。アプリケーションをビルドすると、この ID は一意の sys_ID にハッシュされます。 |
| name | 文字列 | テストの一意の名前。 |
| description | 文字列 | テストの内容の説明。 |
| active | ブーリアン | テストがアクティブかどうかを示すフラグ。 有効な値：
デフォルト：true |
| failOnServerError | ブーリアン | テスト中にサーバーエラーが発生した場合に失敗するかどうかを示すフラグ。 有効な値：
デフォルト：true |
| configurationFunction | 関数 | テストのステップ。テストステップは、atf 関数内のステートメントとして渡されます。テストステップの詳細については、「サポートされているテストステップ」を参照してください。 |
出力変数を含むテストステップの出力値は、変数として保存され、output.<output-variable> 構文を使用して他のステップへの入力として使用できます。出力変数は、適切なフィールドの入力として直接使用、または次の例の atf.server.log のようにテンプレート文字列内で使用できます。
import { Test } from '@servicenow/sdk/core'
import '@servicenow/sdk-core/global'
Test(
{
active: true,
failOnServerError: true,
name: 'Simple example',
description: 'An illustrative test written in fluent',
$id: Now.ID[1],
},
(atf) => {
atf.form.openNewForm({
table: 'sn_table_app_reptile_table',
formUI: 'standard_ui',
view: '',
})
atf.form.setFieldValue({
table: 'sn_table_app_reptile_table',
formUI: 'standard_ui',
fieldValues: {
reptiles: 'lizard' as any,
},
})
const output = atf.form.submitForm({ assertType: 'form_submitted_to_server', formUI: 'standard_ui' })
atf.server.recordValidation({
recordId: output.record_id,
table: 'sn_table_app_reptile_table',
assertType: 'record_validated',
enforceSecurity: true,
fieldValues: 'reptiles=lizard',
})
atf.server.log({
log: `Submitted record with sys_id: ${output.record_id} to table ${output.table}`
})
}
)サポートされているテストステップ
次のテストステップがサポートされています。ステップのプロパティについては、自動テストフレームワーク (ATF) (ATF) テストステップカテゴリ ドキュメントを参照してください。
注:
フォームのテストステップに使用できる一部のフィールドは、ServiceNow Fluent のプロパティとして使用できません。
| カテゴリ | ステップ |
|---|---|
| アプリケーションナビゲーターカテゴリ |
|
| メールのカテゴリ |
|
| サービスポータル のフォームカテゴリ |
|
| サービスポータルのサービスカタログカテゴリ |
|
| Quick start tests for Dashboards |
|
| REST カテゴリ |
|
| サーバーカテゴリ |
|
| サービスカタログ カテゴリ |
|
| フォームカテゴリ |
|