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


---

# AgentNowHandler - スコープ指定

# AgentNowHandler - スコープ指定 {#ariaid-title1}

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

AgentNowHandler スクリプトインクルードは、チェック定義をオンデマンドで実行し、オンデマンド実行とテストチェック実行のステータスをチェックし、オンデマンドで実行されたバックグラウンドチェックを停止するためのメソッドを提供します。

このスクリプトインクルードには エージェントクライアントコレクター Framework (sn_agent) ストアアプリケーションが必要であり、 `sn_agent` 名前空間内で提供されます。詳細については、「 [エージェントクライアントコレクター](https://www.servicenow.com/docs/access?context=acc-landing-page&version=australia&pubname=australia-it-operations-management&ft:locale=en-US)」を参照してください。

REST API ソリューションについては、「 [エージェントクライアントコレクター API](https://servicenow-prod.fluidtopics.net/AkJTonHNQh2a_KwsYT8Uqg#agnt_clnt_cll-api "エージェントクライアントコレクター API は、利用可能なエージェントに対するアクションを管理し、ポリシーを管理するためのエンドポイントを提供します。")」を参照してください。

## AgentNowHandler:AgentNowHandler() {#ariaid-title2}

AgentNowHandler インスタンスを作成します。
{#AgentNowHnl-AgentNowHandler__table_ohr_4qd_bpb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 1. パラメーター]

{#AgentNowHnl-AgentNowHandler__table_ohr_4qd_bpb}  
次の例は、 AgentNowHandler を初期化する方法を示しています。

    var handler = new sn_agent.AgentNowHandler();

## AgentNowHandler:getRequestStatus(文字列 requestId) {#ariaid-title3}

指定された ID で要求のステータスを取得します。
{#AgentNowHnl-getRequestStatus_S__table_zk2_2g2_z4b__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| requestId | 文字列 | runCheckForCis() メソッドを呼び出して生成されたチェック要求 ID。 |
[表 : 2. パラメーター]

{#AgentNowHnl-getRequestStatus_S__table_zk2_2g2_z4b} {#AgentNowHnl-getRequestStatus_S__table_al2_2g2_z4b__entry__2}

| プロパティ | 説明 |
|-|-|
| オブジェクト | 要求のステータスと該当するエラーメッセージ。 |
| status | 要求ステータス。 可能な値： * done:チェックに成功しました。 * failure:チェックに失敗しました。詳細については、エラーメッセージを参照してください。 * mid_flow:要求の出力は MID サーバーによって処理されています。 * 処理中:チェックが進行中です。 * timeout -- チェック処理が runCheckForCis() メソッドで設定された時間制限を超えました。 {#AgentNowHnl-getRequestStatus_S__ul_edm_1rr_5qb} データタイプ：文字列 |
| err_msg | エラーメッセージ (存在する場合)。 可能な値： * 関連する CI のエージェントが見つかりません。 * 指定された ID の経歴チェック要求はありません。 * 指定された ID の要求はありません。 * 指定された ID のテスト結果はありません。 * 要求タイムアウト。 {#AgentNowHnl-getRequestStatus_S__ul_qcf_zcq_5qb} データタイプ：文字列 |
[表 : 3. 返される内容]

{#AgentNowHnl-getRequestStatus_S__table_al2_2g2_z4b}  
次の例は、要求のステータスを取得する方法を示しています。

    var handler = new sn_agent.AgentNowHandler();
    var check = {checkDefId: "158279505372b30034b8ddeeff7b1270"};
    var computerGr = new GlideRecord("cmdb_ci_computer");
    computerGr.query();
    var requestId = handler.runCheckForCis(computerGr, check, 0, 60);

    var reqStatusJson = handler.getRequestStatus(requestId);
    gs.info(JSON.stringify(reqStatusJson));

## AgentNowHandler - getTestResultStatus(文字列 testResultId) {#ariaid-title4}

指定されたテスト結果のテストチェックステータスを取得します。
{#AgentNowHnl-getTestResultStatus_S__table_zk2_2g2_z4b__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| testResultId | 文字列 | テストチェック要求を作成することで生成されたテスト結果 ID。 |
[表 : 4. パラメーター]

{#AgentNowHnl-getTestResultStatus_S__table_zk2_2g2_z4b} {#AgentNowHnl-getTestResultStatus_S__table_al2_2g2_z4b__entry__2}

| プロパティ | 説明 |
|-|-|
| status | テスト結果のステータス。 可能な値： * 0：処理待ち * 1:進行中 * 2:完了 * 3:指定された ID のテスト結果はありません {#AgentNowHnl-getTestResultStatus_S__ul_yyq_4bq_5qb} データタイプ：文字列 |
| 出力 | ステータスを説明する出力。 データタイプ：文字列 |
[表 : 5. 返される内容]

{#AgentNowHnl-getTestResultStatus_S__table_al2_2g2_z4b}  
次の例は、完了したテストチェック要求の結果ステータスを取得する方法を示しています。

    var testCheckStatusJson = handler.getTestResultStatus("testResultId");
    gs.info(JSON.stringify(testCheckStatusJson));

## AgentNowHandler - runCheckForCis(Object cis, Object check, Number priority, Number timeout) {#ariaid-title5}

指定された構成アイテムに対してチェックを実行します。
{#AgentNowHnl-runCheckForCis_O_O_N_N__table_zk2_2g2_z4b__entry__3}{#AgentNowHnl-runCheckForCis_O_O_N_N__agntNowHlr-parm-ph-chkparms}

| 名前 | タイプ | 説明 |
|-|-|-|
| cis | [GlideRecord](https://servicenow-prod.fluidtopics.net/sq3Fh7Z2Yb_KuRvql0AZmg#c_GlideRecordScopedAPI "スコープ対象の GlideRecord API は、データベース操作に使用されます。") | チェックが機能している任意の CMDB テーブル (任意のアプリケーション、ホスト、またはエージェント) の GlideRecord。 |
| チェック | オブジェクト | チェック ID とオプションのチェックパラメーター。 "check": { "checkDefId": "String", "params": {Object} } |
| check.checkDefId | 文字列 | チェック定義 \[sn_agent_check_def\] テーブルのチェック定義のSys_id。 |
| check.params | オブジェクト | オプション。パラメーターの名前と値のマップ。これらの設定を使用して、チェック定義のパラメーターレコードとその指定された値を上書きできます。 "params": { "<parameter name>": "String" } {#AgentNowHnl-runCheckForCis_O_O_N_N__agntNowHlr-parm-cd-chkparms} |
| priority | 数値 | ECC キューに設定する要求の優先度。 可能な値： * 0:インタラクティブ * 1:迅速化済み * 2:標準 {#AgentNowHnl-runCheckForCis_O_O_N_N__ul_bkf_hnq_wqb} |
| timeout | 数値 | 要求のタイムアウト値 (秒単位)。 |
[表 : 6. パラメーター]

{#AgentNowHnl-runCheckForCis_O_O_N_N__table_zk2_2g2_z4b} {#AgentNowHnl-runCheckForCis_O_O_N_N__table_al2_2g2_z4b__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 生成された経歴チェック要求のSys_id。 |
[表 : 7. 返される内容]

{#AgentNowHnl-runCheckForCis_O_O_N_N__table_al2_2g2_z4b}  
次の例は、バックグラウンドチェックを実行してその要求 ID を取得する方法を示しています。

    var handler = new sn_agent.AgentNowHandler();
    var check = {checkDefId: "028fcd5067c80010b7b72dbd2685ef4f"};
    var computerGr = new GlideRecord("cmdb_ci_computer");
    computerGr.query();
    var requestId = handler.runCheckForCis(computerGr, check, 0, 60);

    gs.info(requestId);

出力：

    b9cf14aedb5e30106f4810284b961990

## AgentNowHandler - stopBackgroundCheck(文字列 requestId) {#ariaid-title6}

経歴チェックを停止します。
バックグラウンドチェックを開始するには、 runCheckForCis() メソッドを使用します。
{#AgentNowHnl-stopBackgroundCheck_S__table_zk2_2g2_z4b__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| requestId | 文字列 | runCheckForCis() メソッドを呼び出して生成された経歴チェック要求の ID。 |
[表 : 8. パラメーター]

{#AgentNowHnl-stopBackgroundCheck_S__table_zk2_2g2_z4b} {#AgentNowHnl-stopBackgroundCheck_S__table_al2_2g2_z4b__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 9. 返される内容]

{#AgentNowHnl-stopBackgroundCheck_S__table_al2_2g2_z4b}  
次の例は、経歴チェックの実行を停止する方法を示しています。

    handler.stopBackgroundCheck(backRequestId);