---
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


---

# クラウドランナー TestUserApi:スコープ指定、グローバル

# クラウドランナー TestUserApi:スコープ指定、グローバル {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：12分

自動テストフレームワーク (ATF) のクラウドランナーで実行されるテストユーザージョブを管理します。
この API は CloudRunnerApi スクリプトインクルードの一部です。  
この API は、次のタスクに使用できます。

* ユーザーテストジョブを開始します。
* クラウドユーザーを設定します。
* 指定されたユーザーが有効かどうかを確認します。
* ユーザーテストジョブの進行状況を確認します。
* テストジョブをキャンセルします。
{#cloudrnr-TestUserAPI-scoped__cloudrnr-TestUserAPI-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 スクリプトインクルードの一部です。")
* [クラウドランナー TestRunnerApi:スコープ指定、グローバル](https://servicenow-prod.fluidtopics.net/6p5zqJDphRgmZqrtnMw88A#cloudrnr-TestRunnerAPI-scoped "自動テストフレームワーク (ATF) のクラウドランナーで実行されるテストを管理します。 この API は CloudRunnerApi スクリプトインクルードの一部です。")
* [クラウドランナーテストランナー REST API](https://servicenow-prod.fluidtopics.net/ZpHa4BHXA6sWmYC08O4E8Q#cloudrunner-testrunner-api "自動テストフレームワーク (ATF) のクラウドランナーで実行されるテストを管理します。")
{#cloudrnr-TestUserAPI-scoped__ul_gd4_zsn_31c}

## TestUserApi -- cancelJob(文字列 snboqId) {#ariaid-title2}

ブラウザオーケストレーションキュー \[sn_atf_tg_sn_boq\] テーブルのテストユーザージョブステータスを完了に設定します。
{#cr-TestUserAPI-cancelJob_S__table_epx_lv4_g1c__entry__3}{#cr-TestUserAPI-cancelJob_S__cr-snboqId-ph-desc}

| 名前 | タイプ | 説明 |
|-|-|-|
| snboqId | 文字列 | 必須です。ブラウザオーケストレーションキュー \[sn_atf_tg_sn_boq\] テーブル内の BOQ レコードのsys_id。 |
[表 : 1. パラメーター]

{#cr-TestUserAPI-cancelJob_S__table_epx_lv4_g1c} {#cr-TestUserAPI-cancelJob_S__table_fpx_lv4_g1c__entry__2}

| タイプ | 説明 |
|-|-|
| null | 成功した場合は null、それ以外の場合はエラーメッセージ。 |
| エラー | 失敗した場合、次のエラーメッセージが表示される可能性があります。 * BOQ ID が渡されていません -- 指定された JSON オブジェクトに BOQ ID エントリがありません。JSON オブジェクトが `{snboqId: "<sys_id>"}` として構造化されていることを確認します。 * 無効な BOQ sys_id が渡されました:指定された ID は、ブラウザオーケストレーションキュー \[sn_atf_tg_sn_boq\] テーブルの BOQ レコードの ID である必要があります。 {#cr-TestUserAPI-cancelJob_S__ul_wqr_slb_j1c} |
[表 : 2. 返される内容]

{#cr-TestUserAPI-cancelJob_S__table_fpx_lv4_g1c}  
次の例は、admin ユーザーのテストユーザーを開始し、進捗状況を取得して、テストユーザーをキャンセルする方法を示しています。ロックアウトされたユーザーが有効なクラウドユーザーであることを確認した後、コードはクラウドユーザーを ITIL アドミニストレーターとして設定します。グローバルスコープでは、sn_atf_tg 名前空間を使用します。

    var snboqId = CloudRunnerAPI.TestUserAPI.startJob({username: "abel.tuter"});

    gs.info(JSON.stringify(CloudRunnerAPI.TestUserAPI.progress({snboqId: snboqId})));

    CloudRunnerAPI.TestUserAPI.cancelJob({snboqId: snboqId});

    gs.info(CloudRunnerAPI.TestUserAPI.isValidCloudUser({username: <name of the user who has been locked out>}));

    CloudRunnerAPI.TestUserAPI.selectCloudUser({username: "itil_admin"});

出力：

    {progress: 64, state: running}
    User is missing the following criteria: 
    	User is locked out
    False

## TestUserApi -- isValidCloudUser(文字列 username) {#ariaid-title3}

指定されたユーザーが有効なクラウドユーザーであるかどうかを確認します。
{#cr-TestUserAPI-isValidCloudUser_S__table_epx_lv4_g1c__entry__3}{#cr-TestUserAPI-isValidCloudUser_S__cr-userNm-ph-desc}

| 名前 | タイプ | 説明 |
|-|-|-|
| ユーザー名 | オブジェクト | 必須です。ユーザー \[sys_user\] テーブルにリストされている有効なユーザーのユーザー ID。この値は、JSON オブジェクトで文字列として提供されます。例: `{username: "abel.tuter"}`。 |
[表 : 3. パラメーター]

{#cr-TestUserAPI-isValidCloudUser_S__table_epx_lv4_g1c} {#cr-TestUserAPI-isValidCloudUser_S__table_fpx_lv4_g1c__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | 指定されたユーザーが有効なクラウドユーザーであるかどうかを示すフラグ。 有効な値： * true:指定されたユーザーは有効なクラウドユーザーです。 * false:指定されたユーザーは、次の 1 つ以上の理由で無効です。 * ユーザーが見つかりませんでした。 * ユーザーは非アクティブです。 * ユーザーはロックアウトされています。 * ユーザーはパスワードリセットが必要です。 * ユーザーに admin ロールがありません。 * ユーザーには読み取り専用アクセス権があります。 * ユーザーは Web サービスのみにアクセスできます。 {#cr-TestUserAPI-isValidCloudUser_S__ul_gzz_dcg_m1c} {#cr-TestUserAPI-isValidCloudUser_S__ul_ofc_wzf_m1c} |
[表 : 4. 返される内容]

{#cr-TestUserAPI-isValidCloudUser_S__table_fpx_lv4_g1c}  
次の例は、admin ユーザーのテストユーザーを開始し、進捗状況を取得して、テストユーザーをキャンセルする方法を示しています。ロックアウトされたユーザーが有効なクラウドユーザーであることを確認した後、コードはクラウドユーザーを ITIL アドミニストレーターとして設定します。グローバルスコープでは、sn_atf_tg 名前空間を使用します。

    var snboqId = CloudRunnerAPI.TestUserAPI.startJob({username: "abel.tuter"});

    gs.info(JSON.stringify(CloudRunnerAPI.TestUserAPI.progress({snboqId: snboqId})));

    CloudRunnerAPI.TestUserAPI.cancelJob({snboqId: snboqId});

    gs.info(CloudRunnerAPI.TestUserAPI.isValidCloudUser({username: <name of the user who has been locked out>}));

    CloudRunnerAPI.TestUserAPI.selectCloudUser({username: "itil_admin"});

出力：

    {progress: 64, state: running}
    User is missing the following criteria: 
    	User is locked out
    False

## TestUserApi -- progress(文字列 snboqId) {#ariaid-title4}

指定されたブラウザオーケストレーションキュー (BOQ) レコードの各ユーザーテストのステータスを提供します。
{#cr-TestUserAPI-progress_S__table_epx_lv4_g1c__entry__3}{#cr-TestUserAPI-progress_S__cr-snboqId-ph-desc}

| 名前 | タイプ | 説明 |
|-|-|-|
| snboqId | 文字列 | 必須です。ブラウザオーケストレーションキュー \[sn_atf_tg_sn_boq\] テーブル内の BOQ レコードのsys_id。 |
[表 : 5. パラメーター]

{#cr-TestUserAPI-progress_S__table_epx_lv4_g1c} {#cr-TestUserAPI-progress_S__table_fpx_lv4_g1c__entry__2}{#cr-TestUserAPI-progress_S__cr-prog-state-ph-desc}

| タイプ | 説明 |
|-|-|
| オブジェクト | テストの進行状況を示す JSON オブジェクト。 { "progress": Number, "state": "String" } |
| Object.progress | テストの進捗状況の完了率を示します。 タイプ：数値 |
| Object.state | BOQ レコードのステータス。 可能な値： * 保留中:要求されたテストアクティビティが作成され、実行を待機しています。{#cr-TestUserAPI-progress_S__cr-prog-state-li-pending} {#cr-TestUserAPI-progress_S__cr-prog-state-li-pending} * 処理中:インスタンスはレコードをスキャンして、要求がクラウドインフラストラクチャに送信される前に、実行トラッカーがクラウドランナー用にマークされていることを確認します。 * ブラウザーが要求されました (Browsers requested):テスト生成またはテスト実行のためにブラウザーを起動するための要求がクラウドインフラストラクチャに送信されました。{#cr-TestUserAPI-progress_S__cr-prog-state-li-brsreq} {#cr-TestUserAPI-progress_S__cr-prog-state-li-brsreq} * 実行中:クラウドインフラストラクチャブラウザーは、保留中のテストを検索して実行します。 * 完了:テストタスクが完了しました。{#cr-TestUserAPI-progress_S__cr-prog-state-li-complete} {#cr-TestUserAPI-progress_S__cr-prog-state-li-complete} * \[失敗\] ステータス - テストタスクが失敗しました。{#cr-TestUserAPI-progress_S__cr-prog-state-li-failed} {#cr-TestUserAPI-progress_S__cr-prog-state-li-failed} {#cr-TestUserAPI-progress_S__ul_rvl_vsg_l1c} タイプ：文字列 |
| エラー | 失敗した場合、次のエラーメッセージが表示される可能性があります。 * BOQ ID が渡されていません -- 指定された JSON オブジェクトに BOQ ID エントリがありません。JSON オブジェクトが `{snboqId: "<sys_id>"}` として構造化されていることを確認します。 * 無効な BOQ sys_id が渡されました:指定された ID は、ブラウザオーケストレーションキュー \[sn_atf_tg_sn_boq\] テーブルの BOQ レコードの ID である必要があります。 {#cr-TestUserAPI-progress_S__ul_wqr_slb_j1c} |
[表 : 6. 返される内容]

{#cr-TestUserAPI-progress_S__table_fpx_lv4_g1c}  
次の例は、admin ユーザーのテストユーザーを開始し、進捗状況を取得して、テストユーザーをキャンセルする方法を示しています。ロックアウトされたユーザーが有効なクラウドユーザーであることを確認した後、コードはクラウドユーザーを ITIL アドミニストレーターとして設定します。グローバルスコープでは、sn_atf_tg 名前空間を使用します。

    var snboqId = CloudRunnerAPI.TestUserAPI.startJob({username: "abel.tuter"});

    gs.info(JSON.stringify(CloudRunnerAPI.TestUserAPI.progress({snboqId: snboqId})));

    CloudRunnerAPI.TestUserAPI.cancelJob({snboqId: snboqId});

    gs.info(CloudRunnerAPI.TestUserAPI.isValidCloudUser({username: <name of the user who has been locked out>}));

    CloudRunnerAPI.TestUserAPI.selectCloudUser({username: "itil_admin"});

出力：

    {progress: 64, state: running}
    User is missing the following criteria: 
    	User is locked out
    False

## TestUserApi -- selectCloudUser(文字列username) {#ariaid-title5}

クラウドランナーでエンドツーエンドのテストユーザージョブを開始します。ユーザーが admin ロールで正しくログインできる場合、クラウドランナーインフラストラクチャでの今後のテスト実行およびテスト生成に対して、クラウドユーザープロパティがこのユーザーとして設定されます。
{#cr-TestUserAPI-selectCloudUser_S__table_epx_lv4_g1c__entry__3}{#cr-TestUserAPI-selectCloudUser_S__cr-userNm-ph-desc}

| 名前 | タイプ | 説明 |
|-|-|-|
| ユーザー名 | オブジェクト | 必須です。ユーザー \[sys_user\] テーブルにリストされている有効なユーザーのユーザー ID。この値は、JSON オブジェクトで文字列として提供されます。例: `{username: "abel.tuter"}`。 |
[表 : 7. パラメーター]

{#cr-TestUserAPI-selectCloudUser_S__table_epx_lv4_g1c} {#cr-TestUserAPI-selectCloudUser_S__table_fpx_lv4_g1c__entry__2}

| タイプ | 説明 |
|-|-|
| Null | 成功した場合は null。それ以外の場合はエラーメッセージ。 クラウドユーザーをクラウドユーザーとして設定できません (Unable to set cloud user as cloud user not valid ) -- このエラーは、指定されたユーザーが次の 1 つ以上の理由で無効であることを示します。 * ユーザーが見つかりませんでした。 * ユーザーは非アクティブです。 * ユーザーはロックアウトされています。 * ユーザーはパスワードリセットが必要です。 * ユーザーに admin ロールがありません。 * ユーザーには読み取り専用アクセス権があります。 * ユーザーは Web サービスのみにアクセスできます。 {#cr-TestUserAPI-selectCloudUser_S__ul_gzz_dcg_m1c} |
[表 : 8. 返される内容]

{#cr-TestUserAPI-selectCloudUser_S__table_fpx_lv4_g1c}  
次の例は、admin ユーザーのテストユーザーを開始し、進捗状況を取得して、テストユーザーをキャンセルする方法を示しています。ロックアウトされたユーザーが有効なクラウドユーザーであることを確認した後、コードはクラウドユーザーを ITIL アドミニストレーターとして設定します。グローバルスコープでは、sn_atf_tg 名前空間を使用します。

    var snboqId = CloudRunnerAPI.TestUserAPI.startJob({username: "abel.tuter"});

    gs.info(JSON.stringify(CloudRunnerAPI.TestUserAPI.progress({snboqId: snboqId})));

    CloudRunnerAPI.TestUserAPI.cancelJob({snboqId: snboqId});

    gs.info(CloudRunnerAPI.TestUserAPI.isValidCloudUser({username: <name of the user who has been locked out>}));

    CloudRunnerAPI.TestUserAPI.selectCloudUser({username: "itil_admin"});

出力：

    {progress: 64, state: running}
    User is missing the following criteria: 
    	User is locked out
    False

## TestUserApi -- startJob(文字列 username) {#ariaid-title6}

クラウドランナーでエンドツーエンドのテストユーザージョブを開始します。
{#cr-TestUserAPI-startJob_S__table_epx_lv4_g1c__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| ユーザー名 | 文字列 | 必須。クラウドランナーのエンドツーエンドインフラストラクチャをテストするsys_userのユーザー名。 |
[表 : 9. パラメーター]

{#cr-TestUserAPI-startJob_S__table_epx_lv4_g1c} {#cr-TestUserAPI-startJob_S__table_fpx_lv4_g1c__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | ブラウザオーケストレーションキュー \[sn_atf_tg_sn_boq\] テーブル内の BOQ レコードのsys_id。 |
[表 : 10. 返される内容]

{#cr-TestUserAPI-startJob_S__table_fpx_lv4_g1c}  
次の例は、admin ユーザーのテストユーザーを開始し、進捗状況を取得して、テストユーザーをキャンセルする方法を示しています。ロックアウトされたユーザーが有効なクラウドユーザーであることを確認した後、コードはクラウドユーザーを ITIL アドミニストレーターとして設定します。グローバルスコープでは、sn_atf_tg 名前空間を使用します。

    var snboqId = CloudRunnerAPI.TestUserAPI.startJob({username: "abel.tuter"});

    gs.info(JSON.stringify(CloudRunnerAPI.TestUserAPI.progress({snboqId: snboqId})));

    CloudRunnerAPI.TestUserAPI.cancelJob({snboqId: snboqId});

    gs.info(CloudRunnerAPI.TestUserAPI.isValidCloudUser({username: <name of the user who has been locked out>}));

    CloudRunnerAPI.TestUserAPI.selectCloudUser({username: "itil_admin"});

出力：

    {progress: 64, state: running}
    User is missing the following criteria: 
    	User is locked out
    False