---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# AgentNowHandler: Bereichsbezogen

# AgentNowHandler: Bereichsbezogen {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Die AgentNowHandler-Skripteinbindung stellt Methoden bereit, die das Ausführen von Prüfungsdefinitionen bei Bedarf, das Überprüfen des Status von Ausführungen bei Bedarf und von Testprüfungen sowie das Stoppen von Hintergrundprüfungen ermöglichen, die bei Bedarf ausgeführt wurden.

Diese Skripteinbindung erfordert die Store-Anwendung Framework Agent Client Collector (sn_agent) und wird im Namespace `sn_agent` bereitgestellt. Weitere Informationen finden Sie unter [Agent Client Collector](https://www.servicenow.com/docs/access?context=acc-landing-page&version=xanadu&pubname=xanadu-it-operations-management&ft:locale=en-US).

Informationen zur REST-API-Lösung finden Sie unter [Agent Client Collector API](https://servicenow-prod.fluidtopics.net/cJjDnd2cBThck5ShtcSWYw#agnt_clnt_cll-api "Die Agent Client Collector API bietet Endpunkte zum Verwalten von Aktionen für verfügbare Agents und zum Verwalten von Richtlinien.").

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

Erstellt eine AgentNowHandler-Instanz.
{#AgentNowHnl-AgentNowHandler__table_ohr_4qd_bpb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#AgentNowHnl-AgentNowHandler__table_ohr_4qd_bpb}  
Das folgende Beispiel zeigt, wie AgentNowHandlerinitialisiert wird.

    var handler = new sn_agent.AgentNowHandler();

## AgentNowHandler -- getRequestStatus(Zeichenfolge requestId) {#ariaid-title3}

Ruft den Status der Anforderung mit der angegebenen ID ab.
{#AgentNowHnl-getRequestStatus_S__table_zk2_2g2_z4b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| requestId | Zeichenfolge | Eine Scheckanforderungs-ID, die durch Aufrufen der runCheckForCis()- Methode generiert wird. |
[Tabelle : 2. Parameter]

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

| Eigenschaften | Beschreibung |
|-|-|
| Objekt | Status der Anforderung und zugehörige Fehlermeldung. |
| status | Anforderungsstatus. Mögliche Werte: * done -- Prüfung war erfolgreich. * Fehler: Die Prüfung ist fehlgeschlagen. Details finden Sie in der Fehlermeldung. * mid_flow: Die Anforderungsausgabe wird vom MID-Server verarbeitet. * Verarbeitung -- Prüfung wird ausgeführt. * Zeitüberschreitung: Die Scheckverarbeitung hat das in der runCheckForCis()- Methode festgelegte Zeitlimit überschritten. {#AgentNowHnl-getRequestStatus_S__ul_edm_1rr_5qb} Datentyp: Zeichenfolge |
| err_msg | Fehlermeldung, falls vorhanden. Mögliche Werte: * Keine Agents für relevante CIs gefunden. * Keine Anforderung zur Hintergrundprüfung mit angegebener ID. * Keine Anforderung mit angegebener ID. * Kein Testergebnis mit angegebener ID. * Zeitüberschreitung für Anforderung. {#AgentNowHnl-getRequestStatus_S__ul_qcf_zcq_5qb} Datentyp: Zeichenfolge |
[Tabelle : 3. Ergebnisse]

{#AgentNowHnl-getRequestStatus_S__table_al2_2g2_z4b}  
Das folgende Beispiel zeigt, wie Sie den Status einer Anforderung abrufen.

    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(Zeichenfolge testResultId) {#ariaid-title4}

Ruft den Testprüfungsstatus des angegebenen Testergebnisses ab.
{#AgentNowHnl-getTestResultStatus_S__table_zk2_2g2_z4b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| testResultId | Zeichenfolge | Eine Testergebnis-ID, die durch Erstellen einer Testüberprüfungsanforderung generiert wird. |
[Tabelle : 4. Parameter]

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

| Eigenschaften | Beschreibung |
|-|-|
| status | Status der Testergebnisse. Mögliche Werte: * 0: Ausstehend * 1: In Bearbeitung * 2: Abgeschlossen * 3: Kein Testergebnis mit angegebener ID {#AgentNowHnl-getTestResultStatus_S__ul_yyq_4bq_5qb} Datentyp: Zeichenfolge |
| Ausgabe | Ausgabe, die den Status beschreibt. Datentyp: Zeichenfolge |
[Tabelle : 5. Ergebnisse]

{#AgentNowHnl-getTestResultStatus_S__table_al2_2g2_z4b}  
Das folgende Beispiel zeigt, wie Sie den Ergebnisstatus einer abgeschlossenen Testüberprüfungsanforderung abrufen.

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

## AgentNowHandler -- runCheckForCis(Objekt-CIs, Objektprüfung, Nummernpriorität, Nummern-Timeout) {#ariaid-title5}

Führt eine Prüfung für das angegebene Configuration Item durch.
{#AgentNowHnl-runCheckForCis_O_O_N_N__table_zk2_2g2_z4b__entry__3}{#AgentNowHnl-runCheckForCis_O_O_N_N__agntNowHlr-parm-ph-chkparms}

| Name | Typ | Beschreibung |
|-|-|-|
| cis | [GlideRecord](https://servicenow-prod.fluidtopics.net/g1N~QBZ9WXF6q3o57iuLTw#c_GlideRecordScopedAPI "Die bereichsbezogene GlideRecord- API wird für Datenbankvorgänge verwendet.") | GlideRecord einer beliebigen CMDB-Tabelle (beliebige Anwendung, Host oder Agent), für die die Prüfung ausgeführt wird. |
| Scheck | Objekt | Scheck-ID und optionale Prüfparameter. { "checkDefId": "String", "params": {Object} } |
| check.checkDefId | Zeichenfolge | Sys_id einer Prüfungsdefinition in der Tabelle „Prüfungsdefinitionen" \[sn_agent_check_def\]. |
| check.params | Objekt | Optional. Zuordnung von Parameternamen und -werten. Diese Einstellungen können verwendet werden, um die Parameterdatensätze der Prüfungsdefinition und die angegebenen Werte zu überschreiben. "params": { "<parameter name>": "String" } {#AgentNowHnl-runCheckForCis_O_O_N_N__agntNowHlr-parm-cd-chkparms} |
| Priorität | Nummer | Priorität der Anforderung, die in der ECC-Warteschlange festgelegt werden soll. Mögliche Werte: * 0: interaktiv * 1: beschleunigt * 2: Standard {#AgentNowHnl-runCheckForCis_O_O_N_N__ul_bkf_hnq_wqb} |
| Zeitüberschreitung | Nummer | Wert der Zeitüberschreitung für die Anforderung in Sekunden. |
[Tabelle : 6. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Sys_id der generierten Hintergrundprüfungsanforderung. |
[Tabelle : 7. Ergebnisse]

{#AgentNowHnl-runCheckForCis_O_O_N_N__table_al2_2g2_z4b}  
Das folgende Beispiel zeigt, wie Sie eine Hintergrundprüfung ausführen und ihre Anforderungs-ID abrufen.

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

Ausgabe:

    b9cf14aedb5e30106f4810284b961990

## AgentNowHandler -- stopBackgroundCheck (Zeichenfolge -- requestId) {#ariaid-title6}

Stoppt eine Hintergrundprüfung.
Um eine Hintergrundprüfung zu starten, verwenden Sie die runCheckForCis()- Methode.
{#AgentNowHnl-stopBackgroundCheck_S__table_zk2_2g2_z4b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| requestId | Zeichenfolge | Die ID einer Hintergrundprüfungsanforderung, die durch Aufrufen der runCheckForCis()- Methode generiert wurde. |
[Tabelle : 8. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 9. Ergebnisse]

{#AgentNowHnl-stopBackgroundCheck_S__table_al2_2g2_z4b}  
Das folgende Beispiel zeigt, wie Sie die Ausführung einer Hintergrundprüfung anhalten.

    handler.stopBackgroundCheck(backRequestId);