ActivitySubscriptions API

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 19 minutes de lecture

    • L’API ActivitySubscriptions fournit des points de terminaison pour récupérer des entités d’activité à partir du cadre de travail Abonnements et flux d’activités.

    Cette API nécessite l’activation du module d’extension Abonnements et flux d’activités (com.snc.activity_subscriptions). Activez le module d’extension Centre client (com.sn_csm_customer_central) pour amorcer la configuration dans toutes les tables requises. Pour plus d’informations sur les paramètres de configuration du centre client, consultez Configurer le centre client.

    ActivitySubscriptions : GET /now/actsub/activities

    Récupère les enregistrements d’activité à partir du cadre de travail Abonnements et flux d’activités.

    Aucun rôle n’est requis pour accéder à ce point de terminaison, mais les données renvoyées sont limitées par les paramètres d’accès utilisateur.

    Format d'URL

    URL avec version : /api/now/{api_version}/actsub/activities

    URL par défaut : /api/now/actsub/activities

    Remarque :
    Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST scriptées, des informations supplémentaires sur la version se trouvent dans le formulaire Service REST scripté.

    Paramètres de demande pris en charge

    Tableau 1. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison autre que la plus récente.

    Type de données : chaîne
    Tableau 2. Paramètres de requête
    Nom Description
    avant Valeur date/heure. La demande renvoie uniquement les enregistrements créés avant cette date et cette heure.

    Type de données : chaîne

    Format : AAAA-MM-JJ hh :mm :ss ou AAAA-MM-JJ
    contexte Requis. Sys_id d’un contexte d’activité.

    Les contextes d’activité prédéfinis incluent Consommateur et Contact.

    Type de données : chaîne

    Table : contexte de l’activité [sn_actsub_activity_context]
    context_instance Requis. Sys_id d’une instance du contexte d’activité spécifié, représentant l’initiateur des activités que vous souhaitez récupérer. Situé dans la table appropriée pour le contexte de l’activité.

    Par exemple, si vous définissez context l’sys_id du contexte d’activité Consommateur, définissez ce paramètre sur l’sys_id de l’enregistrement de table Consommateur [csm_consumer] pour le consommateur dont vous souhaitez récupérer les activités.

    Type de données : chaîne
    end_date Valeur date/heure. La demande renvoie uniquement les enregistrements créés pendant la période définie par start_date et ce paramètre. Doit être défini en même temps que start_date.

    Type de données : chaîne

    Format : AAAA-MM-JJ hh :mm :ss ou AAAA-MM-JJ
    Facettes de Liste séparée par des virgules des sys_ids de types de facettes d’activité à récupérer pour le contexte d’activité spécifié.

    Pour plus de détails sur les facettes d’activité, voir Créer des facettes pour les contextes d’activité.

    Type de données : chaîne

    Par défaut : renvoie tous les types de facettes d’activité configurés pour le contexte de l’activité.

    Table : Facette de l’activité [sn_actsub_facet]
    dernier Valeur d’index de la première ligne de résultat omise du corps de la réponse. L’index de la ligne de résultat commence à 0, de sorte que la dernière ligne incluse dans le corps de la réponse est celle avec l’index last-1.

    Par exemple, la définition de last=5 omet les lignes avec l’index 5 et supérieur et renvoie au maximum uniquement les cinq premières lignes de résultat (avec les valeurs d’index de 0 à 4). La définition de stFrom=1 et last=5 ignore la première ligne de résultat et renvoie les deuxième à cinquième lignes de résultat (avec les valeurs d’index 1 à 4).

    Type de données : nombre (entier)

    Par défaut : valeur de la propriété système com.snc.actsub.activities.api.fetch.limit (10 par défaut).
    record_id Sys_id d’un enregistrement à utiliser lors du rendu des facettes dynamiques. Situé dans la table appropriée pour le type d’activité que vous souhaitez récupérer.

    Par exemple, si vous souhaitez extraire des activités pour un enregistrement de ticket, définissez ce paramètre sur la sys_id de l’enregistrement de ticket en question.

    Pour plus de détails sur les facettes dynamiques, voir Créer des facettes pour les contextes d’activité.

    Type de données : chaîne
    start_date Valeur date/heure. La demande renvoie uniquement les enregistrements créés pendant la période définie par ce paramètre et end_date. Doit être défini en même temps que end_date.

    Type de données : chaîne

    Format : AAAA-MM-JJ hh :mm :ss ou AAAA-MM-JJ
    stFrom Valeur d’index de la première ligne de résultat à inclure dans le corps de la réponse. L’index de ligne de résultat commence à 0.

    Par exemple, stFrom=2 ignore les deux premières lignes de résultat et renvoie les résultats à partir de la troisième ligne.

    Type de données : nombre (entier)

    Par défaut : 0
    Tableau 3. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    Néant

    En-têtes

    Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP ou s’appliquent à cette action d’une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 4. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json
    Tableau 5. En-têtes de réponses
    En-tête Description
    Néant

    Codes d'état

    Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 6. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été traitée avec succès.
    400 Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. Le paramètre du corps result.message de la réponse décrit la nature de l’erreur.
    Exemples de messages d’erreur :
    • Assurez-vous que le contexte et les context_instance valides sont transmis ou S’assurer qu’un flux et un utilisateur valides sont transmis indique que la demande ne dispose pas d’un ou des deux paramètres de context requête et context_instance . Ces paramètres sont requis.
    • stFrom ne peut pas être supérieur à la dernière indique que la valeur du paramètre de requête stFrom dépasse la valeur du paramètre de last requête.
    • Veuillez fournir start_date et end_date indique que la demande inclut uniquement un des paramètres de requête et end_date , start_date qui ne peuvent pas être utilisés séparément.
    • start_date ne peut pas être en avance sur end_date indique que la valeur du paramètre de requête spécifiée start_date se produit après la valeur du paramètre de requête spécifiée end_date .
    • Le contexte fourni n’est pas configuré dans le système et indique que la valeur du paramètre de requête ne représente pas un contexte d’activité context valide.
    • Assurez-vous qu’une context_instance valide est transmise indique que la context_instance valeur du paramètre de requête ne représente pas une instance valide du contexte d’activité spécifié.
    401 Non autorisé. Les informations d’identification de l’utilisateur sont incorrectes ou n’ont pas été transmises.
    500 Erreur interne du serveur. Une erreur inattendue s’est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l’erreur.

    Paramètres du corps de la réponse (JSON ou XML)

    Nom Description
    résultat Objet de résultat.

    Type de données : objet

    
"result": {
  "activities": [Array],
  "message": "String",
  "status": Number,
  "stream": "String",
  "user": "String"
}
    Résultat.Activités Tableau d’objets dans lequel chaque objet représente un enregistrement d’activité à partir du contexte d’activité et de l’instance de contexte spécifiés.

    Type de données : tableau d’objets

    "activities": [
  {
    "activity_type_id": "String",
    "content_fields": [Array],
    "created": "String",
    "icon": "String",
    "source_table_name": "String",
    "subheader_fields": [Array],
    "subobject_sys_id": "String",
    "subobject_table_name": "String",
    "sys_id": "String",
    "title": "String"
  }
]
    result.activities.activity_type_id Sys_id de l’enregistrement de la table Types d’activité [sn_actsub_activity_type] qui correspond au type de cet enregistrement d’activité.

    Type de données : chaîne
    result.activities.content_fields Tableau d’objets dans lequel chaque objet représente un champ à afficher en tant que contenu dans la vignette de l’enregistrement d’activité.

    Type de données : tableau d’objets

    "content_fields": [
  {
    "deeplink_to_subobject": "String",
    "display_as_timeago": "String",
    "label": "String",
    "show_label": "String",
    "type": "String",
    "value": "String"
  }
]
    result.activities.content_fields.deeplink_to_subobject Marqueur indiquant si le champ de contenu s’affiche ou non sous forme de lien hypertexte vers l’enregistrement de l’objet sur lequel cette activité a été effectuée.
    Valeurs valides :
    • vrai : le champ de contenu s’affiche sous la forme d’un lien hypertexte vers l’enregistrement de l’objet sur lequel cette activité a été effectuée.
    • faux : le champ de contenu s’affiche sous la forme d’un lien hypertexte vers l’enregistrement de l’objet sur lequel cette activité a été effectuée.

    Type de données : chaîne
    result.activities.content_fields.display_as_timeago Marqueur indiquant si le champ de contenu s’affiche ou non au format Auparavant.
    Valeurs valides :
    • vrai : le champ Contenu s’affiche au format Auparavant.
    • faux : le champ Contenu ne s’affiche pas au format Auparavant.

    Type de données : chaîne
    result.activities.content_fields.étiquette Étiquette du champ de contenu.

    Type de données : chaîne
    result.activities.content_fields.show_label Marqueur indiquant si l’étiquette du champ de contenu s’affiche ou non pour les valeurs de champ de contenu dans la vignette de cet enregistrement d’activité.
    Valeurs valides :
    • vrai : l’étiquette du champ de contenu s’affiche pour les valeurs de champ de contenu dans la vignette de cet enregistrement d’activité.
    • faux : l’étiquette du champ de contenu ne s’affiche pas pour les valeurs de champ de contenu dans la vignette de cet enregistrement d’activité.

    Type de données : chaîne
    result.activities.content_fields.type Type du champ de contenu.

    Type de données : chaîne
    result.activities.content_fields.valeur Valeur du champ de contenu.

    Type de données : chaîne
    Résultat.Activités.Créées Date/heure de création de cet enregistrement d’activité.

    Type de données : chaîne

    Format : JJ-AAAA hh :mm :ss
    résultat.activités.icône Nom de l’icône affichée sur la vignette pour cet enregistrement d’activité.

    Type de données : chaîne
    result.activities.source_table_name Nom de la table dans laquelle se trouve cet enregistrement d’activité.

    Déterminé par la source d’activité définie dans la table Types d’activité [sn_actsub_activity_type] pour le type associé à cet enregistrement d’activité.

    Type de données : chaîne
    result.activities.subheader_fields Tableau d’objets dans lequel chaque objet représente un champ affiché dans le sous-en-tête de la vignette de cet enregistrement d’activité.

    Type de données : tableau d’objets

    "subheader_fields": [
  {
    "deeplink_to_subobject": "String",
    "display_as_timeago": "String",
    "label": "String",
    "show_label": "String",
    "type": "String",
    "value": "String"
  }
]
    result.activities.subheader_fields.deeplink_to_subobject Marqueur indiquant si le champ de sous-titre s’affiche ou non sous forme de lien hypertexte vers l’enregistrement de l’objet sur lequel cette activité a été effectuée.
    Valeurs valides :
    • vrai : le champ de sous-titre s’affiche sous la forme d’un lien hypertexte vers l’enregistrement de l’objet sur lequel cette activité a été effectuée.
    • faux : le champ de sous-titre ne s’affiche pas en tant que lien hypertexte vers l’enregistrement pour l’objet sur lequel cette activité a été effectuée.

    Type de données : chaîne
    result.activities.subheader_fields.display_as_timeago Marqueur indiquant si le champ de sous-titre s’affiche au format Auparavant.
    Valeurs valides :
    • vrai : le champ de sous-titre s’affiche au format Auparavant.
    • faux : le champ de sous-titre ne s’affiche pas au format Auparavant.

    Type de données : chaîne
    result.activities.subheader_fields.étiquette Étiquette du champ de sous-titre.

    Type de données : chaîne
    result.activities.subheader_fields.afficher_étiquette Marqueur indiquant si l’étiquette de champ de sous-titre s’affiche ou non pour les valeurs de champ de sous-titre dans la vignette de cet enregistrement d’activité.
    Valeurs valides :
    • vrai : l’étiquette du champ de sous-titre s’affiche pour les valeurs de champ de sous-titre dans la vignette de cet enregistrement d’activité.
    • faux : l’étiquette de champ de sous-titre ne s’affiche pas pour les valeurs de champ de sous-titre dans la vignette de cet enregistrement d’activité.

    Type de données : chaîne
    result.activities.subheader_fields.type Type du champ de sous-titre.

    Type de données : chaîne
    result.activities.subheader_fields.valeur Valeur du champ de sous-titre.

    Type de données : chaîne
    result.activities.subobject_sys_id Sys_id de l’enregistrement de l’objet sur lequel cette activité a été effectuée. Situé dans la table spécifiée dans la valeur du subobject_table_name paramètre.

    Type de données : chaîne
    result.activities.subobject_table_name Nom de la table contenant l’enregistrement de l’objet sur lequel cette activité a été effectuée.

    Déterminé par le nom de table défini dans la table Groupe d’activité [sn_actsub_subscribable_object] pour le groupe contenant le type d’activité associé à cet enregistrement d’activité.

    Type de données : chaîne
    result.activities.sys_id Sys_id de cet enregistrement d’activité. Situé dans la table spécifiée comme valeur de paramètre de corps de réponse source_table_name .

    Type de données : chaîne
    résultat.activités.titre Titre qui s’affiche sur la vignette de cet enregistrement d’activité.

    Type de données : chaîne
    résultat.aplusd’enregistrements Marqueur indiquant si la liste des activités dans le corps de la réponse est tronquée ou non par la last valeur du paramètre de requête.
    Valeurs valides :
    • vrai : la liste des activités dans le corps de la réponse est tronquée par la valeur du last paramètre de requête. La répétition de la demande avec une valeur de paramètre de requête plus élevée last renvoie des activités supplémentaires pour ce contexte et cette instance de contexte.
    • faux : la liste des activités dans le corps de la réponse n’est pas tronquée par la valeur du last paramètre de requête. Aucune autre activité n’est disponible pour ce contexte et cette instance de contexte.

    Type de données : chaîne
    résultat.message Message d’erreur décrivant le problème rencontré lors du traitement de la demande.

    Type de données : chaîne
    résultat.état Code d’état HTTP retourné pour la demande.

    Valeurs valides : consultez les codes d’état.

    Type de données : nombre
    résultat.flux Sys_id spécifié dans le paramètre de requête de demande context .

    Type de données : chaîne

    Table : contexte de l’activité [sn_actsub_activity_context]
    résultat.utilisateur Sys_id spécifié dans le paramètre de requête de demande context_instance . Situé dans la table appropriée pour le contexte de l’activité.

    Type de données : chaîne

    Demande cURL

    Demander les deuxième et troisième enregistrements d’activité pour un contact spécifique, en limitant aux données de 2020 :

    curl "https://instance.servicenow.com/api/now/actsub/activities\
?context=4a6a035a73d30010e37d71ef64f6a714\
&context_instance=ddce70866f9331003b3c498f5d3ee417\
&stFrom=1&last=3\
&start_date=2020-01-01%2000:00:00&end_date=2020-12-31%2023:59:59" \
--request GET \
--header "Accept: application/json" \
--user "username:password"

    Le corps de la réponse comprend les deux enregistrements d’activité demandés pour le contact spécifié :

    {
  "result": {
    "hasMoreRecords": true,
    "activities": [
      {
        "subobject_table_name": "sn_customerservice_case",
        "source_table_name": "sn_customerservice_case",
        "content_fields": [
          {
            "value": "Test",
            "show_label": "false",
            "type": "string",
            "label": "Short description",
            "display_as_timeago": "false",
            "deeplink_to_subobject": "false"
          }
        ],
        "created": "2020-05-29 18:42:16",
        "activity_type_id": "baf0aace73530010e37d71ef64f6a748",
        "title": "Lamar Wilson created case",
        "subobject_sys_id": "1687360e8d819010f87705a074e52ac9",
        "icon": "clipboard_outline",
        "sys_id": "1687360e8d819010f87705a074e52ac9",
        "subheader_fields": [
          {
            "value": "CS0001007",
            "show_label": "false",
            "type": "string",
            "label": "Number",
            "display_as_timeago": "false",
            "deeplink_to_subobject": "true"
          },
          {
            "value": "2020-05-29 18:42:16",
            "show_label": "false",
            "type": "glide_date_time",
            "label": "Created",
            "display_as_timeago": "true",
            "deeplink_to_subobject": "false"
          },
          {
            "value": "",
            "show_label": "false",
            "type": "reference",
            "label": "Assigned to",
            "display_as_timeago": "false",
            "deeplink_to_subobject": "false"
          },
          {
            "value": "Lamar Wilson",
            "show_label": "false",
            "type": "reference",
            "label": "Contact",
            "display_as_timeago": "false",
            "deeplink_to_subobject": "false"
          }
        ]
      },
      {
        "subobject_table_name": "kb_knowledge",
        "source_table_name": "kb_use",
        "content_fields": [
          {
            "value": "How to Set Up a Broadband Router",
            "show_label": "false",
            "type": "string",
            "label": "Short description",
            "display_as_timeago": "false",
            "deeplink_to_subobject": "false"
          }
        ],
        "created": "2020-05-26 10:00:00",
        "activity_type_id": "4a8c329273d30010e37d71ef64f6a7c1",
        "title": "Lamar Wilson viewed knowledge article",
        "subobject_sys_id": "f855a0a89f011200550bf7b6077fcf4f",
        "icon": "document_outline",
        "sys_id": "b929dd5873941010e37d71ef64f6a719",
        "subheader_fields": [
          {
            "value": "KB0000110",
            "show_label": "false",
            "type": "string",
            "label": "Number",
            "display_as_timeago": "false",
            "deeplink_to_subobject": "true"
          },
          {
            "value": "2020-05-26 10:00:00",
            "show_label": "false",
            "type": "glide_date_time",
            "label": "Created",
            "display_as_timeago": "true",
            "deeplink_to_subobject": "false"
          }
        ]
      }
    ]
  }
}

    ActivitySubscriptions : GET /now/actsub/facets/{activity_context}/{context_instance}

    Récupère les facettes configurées pour un contexte d’activité à partir du cadre de travail Abonnements et flux d’activités. Affiche le nombre d’activités et les données de chaque facette, telles que déterminées par le type d’activité, le groupe et les paramètres de contexte.

    Les utilisateurs doivent avoir le rôle de actsub_user ou d’administrateur pour accéder à ce point de terminaison. Les données renvoyées sont limitées par les paramètres d’accès utilisateur.

    Pour plus de détails sur les facettes contextuelles des activités, voir Créer des facettes pour les contextes d’activités.

    Format d'URL

    URL versionnée : /api/now/{api_version}/actsub/facets/{activity_context}/{context_instance}

    URL par défaut : /api/now/actsub/facets/{activity_context}/{context_instance}

    Remarque :
    Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST scriptées, des informations supplémentaires sur la version se trouvent dans le formulaire Service REST scripté.

    Paramètres de demande pris en charge

    Tableau 7. Paramètres de chemin d'accès
    Nom Description
    activity_context Sys_id d’un contexte d’activité.

    Les contextes d’activité prédéfinis incluent Consommateur et Contact. Accédez à la Centre clientèle > Activité du client > Contextes des activités pour afficher la liste complète des contextes d’activité définis pour votre instance.

    Type de données : chaîne

    Table : Contextes des activités [sn_actsub_activity_context]
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison autre que la plus récente.

    Type de données : chaîne
    context_instance Sys_id d’une instance du contexte d’activité spécifié, représentant l’initiateur des activités pour lesquelles vous souhaitez récupérer les facettes.

    Par exemple, si vous définissez activity_context la sys_id du contexte d’activité Contact, vous devez définir ce paramètre sur la sys_id de l’enregistrement Contact [customer_contact] pour le contact dont vous souhaitez récupérer les facettes de l’activité.

    Type de données : chaîne

    Table : dans la table de contexte spécifiée pour l’enregistrement de contexte de l’activité dans la table Contextes de l’activité [sn_actsub_activity_context].
    Tableau 8. Paramètres de requête
    Nom Description
    end_date Valeur date/heure. La demande renvoie uniquement les enregistrements créés pendant la période définie par start_date et ce paramètre. Doit être défini en même temps que start_date.

    Type de données : chaîne

    Format : AAAA-MM-JJ hh :mm :ss ou AAAA-MM-JJ
    Facettes de Liste séparée par des virgules des sys_ids des facettes d’activité à récupérer pour le contexte d’activité spécifié.

    Pour afficher les types de facettes d’activité définis pour un contexte d’activité, accédez à Centre clientèle > Activité du client > Contextes des activités et examinez la liste connexe Facettes .

    Type de données : chaîne

    Par défaut : renvoie toutes les facettes d’activité configurées pour le contexte de l’activité.
    get_activity_count Marqueur indiquant s’il faut inclure ou non les nombres d’activités pour chaque facette dans le corps de la réponse.
    Valeurs valides :
    • vrai : inclure le nombre d’activités de la facette.
    • faux : omettre les nombres d’activités de la facette.

    Type de données : booléennes

    Valeur par défaut : false
    lazy_load Marqueur indiquant s’il faut ou non améliorer les performances en omettant les données d’activité des facettes et les nombres d’activités du corps de la réponse. Ce paramètre a priorité sur get_activity_count.
    Valeurs valides :
    • vrai : omettre les données d’activité des facettes et les nombres d’activités.
    • faux : récupérer les données d’activité des facettes et les nombres d’activités.

    Type de données : booléennes

    Valeur par défaut : false
    start_date Valeur date/heure. La demande renvoie uniquement les enregistrements créés pendant la période définie par ce paramètre et end_date. Doit être défini en même temps que end_date.

    Type de données : chaîne

    Format : AAAA-MM-JJ hh :mm :ss ou AAAA-MM-JJ
    Tableau 9. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    Néant

    En-têtes

    Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP ou s’appliquent à cette action d’une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 10. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json
    Tableau 11. En-têtes de réponses
    En-tête Description
    Néant

    Codes d'état

    Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 12. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été traitée avec succès.
    400 Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. Le paramètre du corps result.message de la réponse décrit la nature de l’erreur.
    Exemples de messages d’erreur :
    • Assurez-vous que les détails d’un contexte d’activité valide sont transmis Indique que la valeur du paramètre de chemin activity_context d’accès ne représente pas un contexte d’activité valide, la context_instance valeur du paramètre de chemin d’accès ne représente pas une instance valide du contexte d’activité spécifié, ou les deux.
    • Veuillez fournir start_date et end_date indique que la demande inclut uniquement un des paramètres de requête et end_date , start_date qui ne peuvent pas être utilisés séparément.
    • start_date ne peut pas être en avance sur end_date indique que la valeur du paramètre de requête spécifiée start_date se produit après la valeur du paramètre de requête spécifiée end_date .
    401 Non autorisé. Les informations d’identification de l’utilisateur sont incorrectes ou n’ont pas été transmises.
    500 Erreur interne du serveur. Une erreur inattendue s’est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l’erreur.

    Paramètres du corps de la réponse (JSON ou XML)

    Nom Description
    résultat Liste des facettes d’activité.

    Type de données : tableau d’objets

    "result": [
  {
    "activity_count": Number,
    "children": [Array],
    "facets": [Array],
    "icon": "String",
    "is_dynamic": "String",
    "message": "String",
    "name": "String",
    "status": Number
  }
]
    result.activity_count Nombre d’enregistrements d’activité inclus dans cette facette (et ses enfants, le cas échéant). S’affiche uniquement lorsque le paramètre de requête est faux et get_activity_count que lazy_load le paramètre de requête est vrai.

    Type de données : nombre
    résultat.enfants Tableau d’objets dans lequel chaque objet représente un enregistrement d’activité (s’il s’agit d’une facette dynamique) ou une facette enfant (s’il s’agit d’une facette statique).

    Type de données : tableau d’objets

    
"children": [
  {
    "activity_count": Number
    "facet": "String",
    "icon": "String",
    "title": "String"
  }
]
    result.children.activity_count Nombre d’enregistrements d’activité inclus dans cette facette enfant (et ses enfants, le cas échéant). S’affiche uniquement lorsque le paramètre de lazy_load requête a la valeur faux et que le paramètre de get_activity_count requête est vrai.

    Type de données : nombre
    résultat.enfants.créés Date/heure de création de cet enregistrement d’activité.

    Type de données : chaîne

    Format : JJ-MM-AAAA hh :mm :ss
    résultat.facettes.enfants Sys_id de cet enregistrement de facette enfant.

    Type de données : chaîne

    Table : Facette de l’activité [sn_actsub_facet]
    résultat.enfants.icône Nom de l’icône associée à cette facette enfant.

    Type de données : chaîne
    result.children.sys_id Sys_id de cet enregistrement d’activité. Situé dans la table appropriée pour le type de facette parent.

    Par exemple, un enregistrement d’activité inclus dans la facette Tickets a un sys_id situé dans la table Ticket [sn_customerservice_case].

    Type de données : chaîne
    résultat.métadonnées.enfants Tableau d’objets dans lequel chaque objet inclut des données d’enregistrement d’activité pour un champ de facette configuré dans l’enregistrement de la table Facette d’activité [sn_actsub_facet] pour ce type de facette.

    Type de données : tableau d’objets

    
"metadata": [
  {
    "key": "String",
    "label": "String",
    "type": "String",
    "value": "String"
  }
]
    result.children.metadata.key Nom de ce champ de facette.

    Type de données : chaîne
    résultat.enfants.métadonnées.étiquette Étiquette de ce champ de facette.

    Type de données : chaîne
    résultat.enfants.métadonnées.type Type de ce champ de facette.

    Type de données : chaîne
    résultat.enfants.métadonnées.valeur Valeur de ce champ de facette.

    Type de données : chaîne
    résultat.enfants.titre Nom de cet enregistrement d’activité ou facette enfant.

    Type de données : chaîne
    résultat.facettes Liste des sys_ids associés à cet enregistrement de facette. Pour une facette dynamique, ce tableau contient les sys_id de la facette elle-même. Pour une facette statique, elle contient plutôt le sys_ids de toutes les facettes qui sont des enfants de la facette.

    Type de données : tableau

    
"facets": [
  "510d7e2e73570010e37d71ef64f6a70d",
  "bc9bfaaa73570010e37d71ef64f6a771"
]

    Table : Facette de l’activité [sn_actsub_facet]
    résultat.icône Nom de l’icône associée à cette facette.

    Type de données : chaîne
    result.is_dynamic Marqueur indiquant si cette facette est une facette dynamique ou non. Cette valeur détermine le type d’informations incluses dans le paramètre Corps de la children réponse.
    Valeurs possibles :
    • true : il s’agit d’une facette dynamique. La children valeur du paramètre Corps de la réponse contient les détails de l’enregistrement d’activité et le facets paramètre contient la sys_id de facette dynamique.
    • false : il s’agit d’une facette statique (un groupe de facettes). La valeur du children paramètre Corps de la réponse contient des facettes enfants, et le facets paramètre contient la sys_ids de ces facettes enfants.

    Type de données : booléennes
    résultat.message Message d’erreur décrivant le problème rencontré lors du traitement de la demande.

    Type de données : chaîne
    result.name Nom de la facette ou du groupe de facettes.

    Type de données : chaîne
    résultat.état Code d’état HTTP retourné pour la demande.

    Valeurs possibles : voir le tableau Code d’état.

    Type de données : nombre

    Demande cURL

    Récupérer les facettes et les activités des articles de la messagerie instantanée, du téléphone et de la base de connaissances pour un contact :

    curl "https://instance.servicenow.com/api/now/actsub/facets/4a6a035a73d30010e37d71ef64f6a714/ddce70866f9331003b3c498f5d3ee417\
?get_activity_count=true\
&facets=510d7e2e73570010e37d71ef64f6a70d,bc9bfaaa73570010e37d71ef64f6a771,c72d7e2e73570010e37d71ef64f6a7b8" \
--request GET \
--header "Accept: application/json" \
--user "username:password"

    Le corps de la réponse inclut les trois facettes demandées en tant qu’enfants de leurs groupes de facettes, avec les nombres d’activités affichés :

    {
  "result": [
    {
      "is_dynamic": false,
      "name": "Interactions",
      "activity_count": 4.0,
      "facets": [
        "510d7e2e73570010e37d71ef64f6a70d",
        "bc9bfaaa73570010e37d71ef64f6a771"
      ],
      "children": [
        {
          "facet": "510d7e2e73570010e37d71ef64f6a70d",
          "icon": "chat_outline",
          "activity_count": 2.0,
          "title": "Chat"
        },
        {
          "facet": "bc9bfaaa73570010e37d71ef64f6a771",
          "icon": "phone_outline",
          "activity_count": 2.0,
          "title": "Phone"
        }
      ]
    },
    {
      "is_dynamic": false,
      "name": "Portal Activity",
      "activity_count": 5.0,
      "facets": [
        "c72d7e2e73570010e37d71ef64f6a7b8"
      ],
      "children": [
        {
          "facet": "c72d7e2e73570010e37d71ef64f6a7b8",
          "icon": "document_outline",
          "activity_count": 5.0,
          "title": "Knowledge articles"
        }
      ]
    }
  ]
}