自動テストフレームワーク (ATF) テスト API - ServiceNow Fluent
自動テストフレームワーク (ATF)テスト API は、変更後にインスタンスが機能することを確認するために実行できる自動テスト [sys_atf_test] を定義します。
自動テストフレームワーク (ATF)テストに関する一般的な情報については、「自動テストフレームワーク (ATF) (ATF)」を参照してください。
Test オブジェクト
実行する一連のステップを含む自動化テスト [sys_atf_test] を作成します。
| 名前 | タイプ | 説明 |
|---|---|---|
| $id | 文字列または数値 | 必須。メタデータオブジェクトの一意の ID。アプリケーションをビルドすると、この ID は一意のsys_idにハッシュされます。詳細については、「ServiceNow Fluent 言語構成」を参照してください。 形式: |
| name | 文字列 | テストの一意の名前。 |
| description | 文字列 | テストの内容の説明。 |
| active | ブーリアン | テストがアクティブかどうかを示すフラグ。 有効な値：
デフォルト：true |
| failOnServerError | ブーリアン | テスト中にサーバーエラーが発生した場合に失敗するかどうかを示すフラグ。 有効な値：
デフォルト：true |
| configurationFunction | 関数 | テストのステップ。テストステップは、atf 関数内のステートメントとして渡されます。たとえば、次のようになります。テストステップの詳細については、「サポートされているテストステップ」を参照してください。 |
| $meta | オブジェクト | アプリケーションメタデータのメタデータ。 installMethod プロパティを使用すると、特定の状況でのみロードされる出力ディレクトリにアプリケーションメタデータをマップできます。 installMethod の有効な値:
|
出力変数を含むテストステップの出力値は、変数として保存され、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 カテゴリ |
|
| サーバーカテゴリ |
|
| サービスカタログ カテゴリ |
|
| サービスポータルのサービスカタログカテゴリ |
|