Widget du playbook du portail

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

    • Explorez le widget Portal Playbook.

    À propos du widget

    Le widget Playbook est un iFrame qui permet aux administrateurs de spécifier où un événement Playbook doit être dirigé. L’URL iFrame correspond à la page du Générateur d'IU portail des playbooks. Le widget gère les événements que le playbook écoute via l’API de stockage de session afin de savoir quand effectuer une action dans le portail, comme ouvrir un enregistrement ou une liste dans un modal dans Portail de services.

    Les composants prêts à l’emploi sont conçus pour répondre à tous les Expérience de playbook besoins de vos Portail de services utilisateurs. Nous vous déconseillons de modifier directement la page du portail du playbook, le Portail de services widget Playbook ou l’élément de contenu du playbook prêt à Générateur d'IU l’emploi. La modification des composants prêts à l’emploi peut entraîner des problèmes techniques.

    Si, par exemple, vous avez besoin qu’une action du client UXF fonctionne pour votre instance de la page du playbook, nous vous recommandons de cloner le widget du playbook à la place.

    Remarque :
    Pour en savoir plus sur la façon de cloner ou de créer votre propre widget, reportez-vous à la section Developing custom widgets.

    Clonage d’un widget du portail de services Playbook

    Accédez à la Tous > Portail de services > Configuration de widgets et recherchez le widget Playbook .
    Remarque :
    Si vous clonez le widget Playbook , assurez-vous que toutes les actions prêtes à l’emploi et les propriétés de configuration sont copiées sur votre widget cloné.
    Tableau 1. Champs de formulaire
    Champ Description
    Nom Saisissez un nom pour le widget cloné.
    ID L’ID de widget est créé automatiquement par défaut en fonction du nom du widget, mais vous pouvez le modifier comme vous voulez.
    Description Ajoutez une description facultative qui fournit des détails sur les effets du widget.
    Application Choisissez le périmètre de l’application dans lequel vous souhaitez que votre widget s’exécute. La sélection de Global vous playbook permet de l’exécuter dans n’importe quel périmètre d’application. Pour plus d’informations, consultez Périmètre de l’application.
    Public Sélectionnez si votre widget est public. Si cette option n’est pas cochée, votre widget est privé et seuls les utilisateurs authentifiés disposant du rôle snc_internal ou snc_external peuvent voir le widget.
    Rôles Limitez l’accès au widget à certains rôles.
    Modèle du corps HTML Tirez parti de la liaison bidirectionnelle Angular JS pour lier les variables de votre contrôleur à votre balisage.
    DANGER :
    N’apportez des modifications aux modèles HTML que si vous avez des connaissances avancées en codage et une bonne compréhension d’AngularJS et de l’API de la plateforme.
    L’URL iFrame est l’URL de la Générateur d'IU page. Pour en savoir plus sur le champ de modèle HTML, reportez-vous à la section Developing custom widgets.
    Avertissement :
    Assurez-vous que l’URL iFrame de votre widget cloné est différente de l’URL iFrame du widget prêt à l’emploi.
    CSS Configurez le widget CSS. La configuration de CSS dans un widget réel affecte toutes les instances de ce widget. Pour en savoir plus sur le champ CSS, reportez-vous à la section Developing custom widgets.
    Script serveur Script de la logique côté serveur. Ceci est principalement utile pour interagir avec la plateforme Glide via des API côté serveur.
    DANGER :
    Un script serveur nécessite une connaissance de l’API ServiceNow pour pouvoir utiliser les données d’enregistrement.
    Pour en savoir plus sur le champ Script serveur, reportez-vous à la section Developing custom widgets.
    Contrôleur client Dans Angular, les modèles HTML contiennent des éléments et des attributs spécifiques à Angular. Angular combine le modèle avec les informations du contrôleur de modèle et du client pour afficher la vue dynamique qu’un utilisateur voit dans le navigateur. Nom de l’identificateur pour une référence au contrôleur dans le périmètre de la directive
    DANGER :
    Un script client nécessite une connaissance de l’API ServiceNow et d’AngularJS pour créer un contrôleur client.
    Contrôleurs A Le modèle HTML utilise la syntaxe controllerAs pour la liaison de base.
    un lien Utilisez une fonction de lien pour manipuler directement les DOM.
    DANGER :
    La fonction de lien nécessite une connaissance d’AngularJS.
    Pour en savoir plus sur le champ Lien, reportez-vous à la section Developing custom widgets.
    A l’aperçu Sélectionnez l’option permettant d’activer un aperçu du widget dans l’éditeur de widgets.
    Données de démonstration Fournissez des données lors de l’aperçu du widget dans l’éditeur de widgets.
    Table de données Sélectionnez une table à utiliser comme source de données.
    Champs Sélectionnez les champs à afficher en tant qu’options d’instance.
    Schéma de l’option Permet à un Portail de services administrateur de configurer un widget. Pour en savoir plus sur le champ Schéma d’option, Widget option schema.
    Documents Sélectionnez un lien vers la Portail de services documentation.

    Vérifiez les erreurs dans la configuration de la page du portail de l’expérience de playbook et dans les Générateur d'IU propriétés des événements, par exemple, désactivez l’événement Ouvrir l’enregistrement en tant qu’utilisateur de maintenance.