--- sourceDocument: オーストラリア API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference Release : - australia ft:locale : - ja-JP ft:publication_title : - オーストラリア API リファレンス ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # クラウドランナー TestRunnerApi:スコープ指定、グローバル # クラウドランナー TestRunnerApi:スコープ指定、グローバル {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：5分 自動テストフレームワーク (ATF) のクラウドランナーで実行されるテストを管理します。 この API は CloudRunnerApi スクリプトインクルードの一部です。 この API は、次のタスクに使用できます。 * クラウドランナーブラウザーで ATF テストまたはテストスイートを開始します。 * テストジョブの進行状況を確認します。 * テストジョブをキャンセルします。 {#cloudrnr-TestRunnerAPI-scoped__cloudrnr-TestRunnerAPI-scoped_ul_vwb_wvn_31c} グローバルスコープでは、この API は sn_atf_tg 名前空間内で実行されます。この API を使用するには、 [ATF Test Generator and Cloud Runner](https://www.servicenow.com/docs/access?context=atf-tg-cr-intro&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) (sn_atf_tg) プラグインを有効にする必要があります。 関連項目： * [クラウドランナー TestGenerationApi:スコープ指定、グローバル](https://servicenow-prod.fluidtopics.net/ywyFgvZ2WtUwgj_ydXc3jg#cloudrnr-TestGenerationAPI-scoped "自動テストフレームワーク (ATF) のクラウドランナーで実行されるテストジョブの生成を管理します。 この API は CloudRunnerApi スクリプトインクルードの一部です。") * [クラウドランナー TestUserApi:スコープ指定、グローバル](https://servicenow-prod.fluidtopics.net/JCnJriE~SPfzOflvwp6XiA#cloudrnr-TestUserAPI-scoped "自動テストフレームワーク (ATF) のクラウドランナーで実行されるテストユーザージョブを管理します。 この API は CloudRunnerApi スクリプトインクルードの一部です。") * [クラウドランナーテストユーザー REST API](https://servicenow-prod.fluidtopics.net/_6KGrBFJxTb8ImJjmt2X9Q#cloudrunner-testuser-api "自動テストフレームワーク (ATF) のクラウドランナーで実行されるテストユーザージョブを管理します。") {#cloudrnr-TestRunnerAPI-scoped__ul_gd4_zsn_31c} ## TestRunnerApi -- cancelJob(文字列 snboqId) {#ariaid-title2} テストランナージョブを完了ステータスに設定し、実行中の生成済みテストのルートトラッカーをキャンセルします。 {#cr-TestRunnerAPI-cancelJob_S__table_epx_lv4_g1c__entry__3}{#cr-TestRunnerAPI-cancelJob_S__cr-snboqId-ph-desc} | 名前 | タイプ | 説明 | |-|-|-| | snboqId | 文字列 | 必須です。ブラウザオーケストレーションキュー \[sn_atf_tg_sn_boq\] テーブル内の BOQ レコードのsys_id。 | [表 : 1. パラメーター] {#cr-TestRunnerAPI-cancelJob_S__table_epx_lv4_g1c} {#cr-TestRunnerAPI-cancelJob_S__table_fpx_lv4_g1c__entry__2} | タイプ | 説明 | |-|-| | null | 成功した場合は null、それ以外の場合はエラーメッセージ。 | [表 : 2. 返される内容] {#cr-TestRunnerAPI-cancelJob_S__table_fpx_lv4_g1c} 次の例は、テストの開始、ATF テストの実行、進捗状況の表示、およびテスト実行の停止の方法を示しています。グローバルスコープでは、sn_atf_tg 名前空間を使用します。 var snboqId = CloudRunnerAPI.TestRunnerAPI.startJob({ "testId": "" }); gs.info(JSON.stringify(CloudRunnerAPI.TestRunnerAPI.progress({"snboqId": snboqId}))); CloudRunnerAPI.TestRunnerAPI.cancelJob({"snboqId": snboqId}); 出力： {progress: 64, state: running} ## TestRunnerApi -- progress(文字列 snboqId) {#ariaid-title3} 指定されたブラウザオーケストレーションキュー (BOQ) レコードに対して実行された各テストのステータスを提供します。 {#cr-TestRunnerAPI-progress_S__table_epx_lv4_g1c__entry__3}{#cr-TestRunnerAPI-progress_S__cr-snboqId-ph-desc} | 名前 | タイプ | 説明 | |-|-|-| | snboqId | 文字列 | 必須です。ブラウザオーケストレーションキュー \[sn_atf_tg_sn_boq\] テーブル内の BOQ レコードのsys_id。 | [表 : 3. パラメーター] {#cr-TestRunnerAPI-progress_S__table_epx_lv4_g1c} {#cr-TestRunnerAPI-progress_S__table_fpx_lv4_g1c__entry__2}{#cr-TestRunnerAPI-progress_S__cr-prog-state-ph-desc} | タイプ | 説明 | |-|-| | オブジェクト | テストの進行状況を示す JSON オブジェクト。 { "progress": Number, "state": "String" } | | Object.progress | テストの進捗状況の完了率を示します。 タイプ：数値 | | Object.state | BOQ レコードのステータス。 可能な値： * 保留中:要求されたテストアクティビティが作成され、実行を待機しています。{#cr-TestRunnerAPI-progress_S__cr-prog-state-li-pending} {#cr-TestRunnerAPI-progress_S__cr-prog-state-li-pending} * 処理中:インスタンスはレコードをスキャンして、要求がクラウドインフラストラクチャに送信される前に、実行トラッカーがクラウドランナー用にマークされていることを確認します。 * ブラウザーが要求されました (Browsers requested):テスト生成またはテスト実行のためにブラウザーを起動するための要求がクラウドインフラストラクチャに送信されました。{#cr-TestRunnerAPI-progress_S__cr-prog-state-li-brsreq} {#cr-TestRunnerAPI-progress_S__cr-prog-state-li-brsreq} * 実行中:クラウドインフラストラクチャブラウザーは、保留中のテストを検索して実行します。 * 完了:テストタスクが完了しました。{#cr-TestRunnerAPI-progress_S__cr-prog-state-li-complete} {#cr-TestRunnerAPI-progress_S__cr-prog-state-li-complete} * \[失敗\] ステータス - テストタスクが失敗しました。{#cr-TestRunnerAPI-progress_S__cr-prog-state-li-failed} {#cr-TestRunnerAPI-progress_S__cr-prog-state-li-failed} {#cr-TestRunnerAPI-progress_S__ul_rvl_vsg_l1c} タイプ：文字列 | | エラー | 失敗した場合、次のエラーメッセージが表示される可能性があります。 * BOQ ID が渡されていません -- 指定された JSON オブジェクトに BOQ ID エントリがありません。JSON オブジェクトが `{snboqId: ""}` として構造化されていることを確認します。 * 無効な BOQ sys_id が渡されました:指定された ID は、ブラウザオーケストレーションキュー \[sn_atf_tg_sn_boq\] テーブルの BOQ レコードの ID である必要があります。 {#cr-TestRunnerAPI-progress_S__ul_wqr_slb_j1c} | [表 : 4. 返される内容] {#cr-TestRunnerAPI-progress_S__table_fpx_lv4_g1c} 次の例は、テストの開始、ATF テストの実行、進捗状況の表示、およびテスト実行の停止の方法を示しています。グローバルスコープでは、sn_atf_tg 名前空間を使用します。 var snboqId = CloudRunnerAPI.TestRunnerAPI.startJob({ "testId": "" }); gs.info(JSON.stringify(CloudRunnerAPI.TestRunnerAPI.progress({"snboqId": snboqId}))); CloudRunnerAPI.TestRunnerAPI.cancelJob({"snboqId": snboqId}); 出力： {progress: 64, state: running} ## TestRunnerApi -- startJob(文字列 testId) {#ariaid-title4} クラウドランナーブラウザーで ATF テストまたはテストスイートを開始します。 {#cr-TestRunnerAPI-startJob_S__table_epx_lv4_g1c__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | testid | 文字列 | 必須。クラウドランナーブラウザーで実行する ATF テストまたはテストスイートのsys_id。次のいずれかのテーブルにあります。 * テスト \[sys_atf_test\] * テストスイート \[sys_atf_test_suite\] {#cr-TestRunnerAPI-startJob_S__ul_gqc_yj4_l1c} | [表 : 5. パラメーター] {#cr-TestRunnerAPI-startJob_S__table_epx_lv4_g1c} {#cr-TestRunnerAPI-startJob_S__table_fpx_lv4_g1c__entry__2} | タイプ | 説明 | |-|-| | 文字列 | ブラウザオーケストレーションキュー \[sn_atf_tg_sn_boq\] テーブル内の BOQ レコードのsys_id。 | [表 : 6. 返される内容] {#cr-TestRunnerAPI-startJob_S__table_fpx_lv4_g1c} 次の例は、テストの開始、ATF テストの実行、進捗状況の表示、およびテスト実行の停止の方法を示しています。グローバルスコープでは、sn_atf_tg 名前空間を使用します。 var snboqId = CloudRunnerAPI.TestRunnerAPI.startJob({ "testId": "" }); gs.info(JSON.stringify(CloudRunnerAPI.TestRunnerAPI.progress({"snboqId": snboqId}))); CloudRunnerAPI.TestRunnerAPI.cancelJob({"snboqId": snboqId}); 出力： {progress: 64, state: running}