---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# AgentNowHandler - Dans le champ d'application

# AgentNowHandler - Dans le champ d'application {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes de lecture

L'include de script AgentNowHandler fournit des méthodes qui permettent d'exécuter des définitions de vérification sur demande, de vérifier l'état des exécutions sur demande et des exécutions de vérification de test, et d'arrêter les vérifications d'arrière-plan qui ont été exécutées sur demande.

Cet include de script nécessite l'application Agent Client Collector de stockage Framework (sn_agent) et est fourni dans l'espace de noms `sn_agent` . Pour plus d'informations, consultez [Agent Client Collector](https://www.servicenow.com/docs/access?context=acc-landing-page&version=xanadu&pubname=xanadu-it-operations-management&ft:locale=en-US).

Pour la solution d'API REST, consultez [l'API Agent Client Collector](https://servicenow-prod.fluidtopics.net/QEP8zRm1ZTNaxaPmVG9qAg#agnt_clnt_cll-api "L’API Agent Client Collector fournit des points de terminaison pour gérer les actions sur les agents disponibles et les politiques de gestion.").

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

Crée une instance AgentNowHandler.
{#AgentNowHnl-AgentNowHandler__table_ohr_4qd_bpb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 1. Paramètres]

{#AgentNowHnl-AgentNowHandler__table_ohr_4qd_bpb}  
L'exemple suivant montre comment initialiser AgentNowHandler.

    var handler = new sn_agent.AgentNowHandler();

## AgentNowHandler : getRequestStatus(String requestId) {#ariaid-title3}

Obtient l'état de la demande avec l'ID donné.
{#AgentNowHnl-getRequestStatus_S__table_zk2_2g2_z4b__entry__3}

| Nom | Type | Description |
|-|-|-|
| requestId | Chaîne | ID de demande de vérification généré par l'appel de la méthode runCheckForCis(). |
[Tableau 2. Paramètres]

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

| Propriétés | Description |
|-|-|
| Objet | État de la demande et tout message d'erreur applicable. |
| statut | État de la demande. Valeurs possibles : * Terminé : la vérification a réussi. * échec : la vérification a échoué. Voir le message d'erreur pour plus de détails. * mid_flow : la sortie de la demande est gérée par le MID Server. * Traitement : la vérification est en cours. * timeout : vérifiez que le traitement a dépassé la limite de temps définie dans la méthode runCheckForCis(). {#AgentNowHnl-getRequestStatus_S__ul_edm_1rr_5qb} Type de données : chaîne |
| err_msg | Message d'erreur le cas échéant. Valeurs possibles : * Aucun agent trouvé pour les CI appropriés. * Aucune demande de vérification des antécédents avec l'ID fourni. * Aucune demande avec l'ID fourni. * Aucun résultat de test avec l'ID fourni. * Délai d'expiration de la demande. {#AgentNowHnl-getRequestStatus_S__ul_qcf_zcq_5qb} Type de données : chaîne |
[Tableau 3. Renvoie]

{#AgentNowHnl-getRequestStatus_S__table_al2_2g2_z4b}  
L'exemple suivant montre comment obtenir l'état d'une demande.

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

Obtient l'état de vérification du test du résultat du test donné.
{#AgentNowHnl-getTestResultStatus_S__table_zk2_2g2_z4b__entry__3}

| Nom | Type | Description |
|-|-|-|
| testResultId (en anglais seulement) | Chaîne | ID de résultat de test généré par la création d'une demande de contrôle de test. |
[Tableau 4. Paramètres]

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

| Propriétés | Description |
|-|-|
| statut | État des résultats des tests. Valeurs possibles : * 0 : en attente * 1 : En cours * 2 : Terminé * 3 : Aucun résultat de test avec l'ID fourni {#AgentNowHnl-getTestResultStatus_S__ul_yyq_4bq_5qb} Type de données : chaîne |
| sortie | Sortie décrivant l'état. Type de données : chaîne |
[Tableau 5. Renvoie]

{#AgentNowHnl-getTestResultStatus_S__table_al2_2g2_z4b}  
L'exemple suivant montre comment obtenir l'état du résultat d'une demande de vérification de test terminée.

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

## AgentNowHandler : runCheckForCis(CI d'objet, vérification de l'objet, priorité du numéro, délai d'expiration du numéro) {#ariaid-title5}

Exécute une vérification par rapport à l'élément de configuration donné.
{#AgentNowHnl-runCheckForCis_O_O_N_N__table_zk2_2g2_z4b__entry__3}{#AgentNowHnl-runCheckForCis_O_O_N_N__agntNowHlr-parm-ph-chkparms}

| Nom | Type | Description |
|-|-|-|
| CI | [GlideRecord](https://servicenow-prod.fluidtopics.net/2WySz5FCvQHHbdfx6_dFUg#c_GlideRecordScopedAPI "L’API GlideRecord incluse dans le périmètre d’application est utilisée pour les opérations de base de données.") | GlideRecord de n'importe quelle table CMDB (n'importe quelle application, hôte ou agent) sur laquelle la vérification travaille. |
| vérifier | Objet | ID de vérification et paramètres de vérification facultatifs. { "checkDefId": "String", "params": {Object} } |
| check.checkDefId | Chaîne | Sys_id d'une définition de vérification dans la table Définitions de vérification \[sn_agent_check_def\]. |
| paramètres.vérification | Objet | Facultatif. Carte des noms et des valeurs des paramètres. Ces paramètres peuvent être utilisés pour remplacer les enregistrements de paramètres de la définition de contrôle et ses valeurs spécifiées. "params": { "<parameter name>": "String" } {#AgentNowHnl-runCheckForCis_O_O_N_N__agntNowHlr-parm-cd-chkparms} |
| Priorité | Numéro | Priorité de la demande à définir sur la file d'attente ECC. Valeurs possibles : * 0 : interactif * 1 : Accéléré * 2 : standard {#AgentNowHnl-runCheckForCis_O_O_N_N__ul_bkf_hnq_wqb} |
| timeout | Numéro | Valeur du délai d'expiration de la demande, en secondes. |
[Tableau 6. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Sys_id de la demande de vérification des antécédents générée. |
[Tableau 7. Renvoie]

{#AgentNowHnl-runCheckForCis_O_O_N_N__table_al2_2g2_z4b}  
L'exemple suivant montre comment exécuter une vérification des antécédents et obtenir son ID de demande.

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

Sortie :

    b9cf14aedb5e30106f4810284b961990

## AgentNowHandler : stopBackgroundCheck(String requestId) {#ariaid-title6}

Arrête une vérification des antécédents.
Pour lancer une vérification des antécédents, utilisez la méthode runCheckForCis().
{#AgentNowHnl-stopBackgroundCheck_S__table_zk2_2g2_z4b__entry__3}

| Nom | Type | Description |
|-|-|-|
| requestId | Chaîne | ID d'une demande de vérification des antécédents générée par l'appel de la méthode runCheckForCis(). |
[Tableau 8. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 9. Renvoie]

{#AgentNowHnl-stopBackgroundCheck_S__table_al2_2g2_z4b}  
L'exemple suivant montre comment arrêter l'exécution d'une vérification des antécédents.

    handler.stopBackgroundCheck(backRequestId);