Événements de composant de tableau de bord

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

    • Sélectionnez des gestionnaires d’événements pour configurer les actions (événements) fournies avec le composant de tableau de bord.

    L’onglet Événements affiche les événements utilisés par le composant de tableau de bord. Pour afficher les événements disponibles, sélectionnez + Ajouter un mappage d’événements. Sélectionnez l’événement dans la liste pour ajouter un ou plusieurs gestionnaires d’événements.

    Gestionnaires d'événements

    Les gestionnaires d’événements utilisent les ressources de données pour lier les actions du tableau de bord aux données que vous souhaitez afficher à vos utilisateurs. Sélectionnez l’événement dans la liste pour ajouter un ou plusieurs gestionnaires d’événements.

    Descriptions des événements

    Événement Description
    Accéder à la page de vue d'ensemble du tableau de bord Réparti lorsque le tableau de bord est fermé et redirige vers la bibliothèque de tableaux de bord. Vous pouvez personnaliser ce comportement en modifiant l’itinéraire et le titre dans le script client Rediriger vers la liste de tableaux de bord. Pour ouvrir des scripts clients, sélectionnez l’icône <> dans la barre latérale de la page.
    * @param {params} params
* @param {api} params.api
* @param {any} params.event
* @param {any} params.imports
* @param {ApiHelpers} params.helpers
*/
function handler({api}) {
    api.emit('SCREEN_STATUS_CHANGED', {status: 'closed'});
    api.emit('NAV_ITEM_SELECTED', {
        route: 'dashboard-library',
        title: 'Dashboard Library',
    });
}
    Widget de tableau de bord sélectionné
    Ajoutez ce gestionnaire d’événements si vous souhaitez remplacer l’exploration vers le bas par défaut avec un comportement personnalisé lorsque vous cliquez sur une visualisation sur le tableau de bord. Il utilise le script client Widget de tableau de bord cliqué. Pour ajouter une exploration vers le bas personnalisée :
    1. Définissez la propriété defaultDrilldowns sur faux.
    2. Ajouter le gestionnaire d’événements Widget du tableau de bord cliqué.
    3. Ouvrez le widget du tableau de bord Script client cliqué. Pour ouvrir des scripts clients, sélectionnez l’icône <> dans la barre latérale de la page.
    4. Localisez le code api.emit('NAV_ITEM_SELECTED', charge utile) ; et mettez à jour la charge utile pour qu’elle s’aligne sur votre logique de redirection personnalisée.
    Mise à jour des paramètres d'URL demandée

    Réparti chaque fois que le composant de tableau de bord devrait normalement mettre à jour les paramètres d’URL et est delegateUrlParamsdéfini sur vrai. Cet événement fournit des données de paramètres structurées que les scripts clients peuvent utiliser pour implémenter une logique de navigation personnalisée.

    Paramètres d’URL :
    • sysId : sys_id du tableau de bord vers lequel vous naviguez. Présent lorsque le tableau de bord change.
    • tabSysId : sys_id de l’onglet sélectionné. Présent lorsque l’onglet change.
    • edit : indique si le tableau de bord est en mode d’édition. Présent lorsque le mode d’édition change.
    Tous les paramètres ont les champs d’objet suivants :
    • value (chaîne | booléen) : valeur du paramètre
    • description (chaîne) : description explicite du paramètre
    Le paramètre sysId comporte également les champs d’objet suivants :
    • dashboardName (chaîne) : titre du tableau de bord
    • isNewTab (booléen) : vrai lorsque l’utilisateur a effectué un clic Cmd/Ctrl+clic ou un clic central dans le sélecteur de tableau de bord, indiquant son intention d’ouvrir dans un nouvel onglet. Envoyé uniquement pour le paramètre sysId .
    Exemple :
    {
  "urlParams": {
    "sysId": {
      "value": "a1b2c3d4e5f6",
      "dashboardName": "Dashboard A",
      "description": "Dashboard sys_id",
      "isNewTab": false
    },
    "tabSysId": {
      "value": "f6e5d4c3b2a1",
      "description": "Tab sys_id"
    },
    "edit": {
      "value": true,
      "description": "Edit mode"
    }
  }
}

    Pour plus d'informations, consultez Délégation des paramètres d’URL du tableau de bord.

    Remarque :
    Cette fonction nécessite la dernière Expérience Platform Analytics application du ServiceNow® Store.