Widget Playbook du portail

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 3 minutes de lecture

    • Explorez le widget Playbook du portail.

    À 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 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 l’ouverture d’un enregistrement ou d’une liste dans une fenêtre modale 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 Playbook prête Générateur d'IU à l’emploi, le Portail de services widget Playbook ou l’élément de contenu Playbook. La modification des composants prêts à l’emploi peut entraîner des problèmes techniques.

    Si, par exemple, vous avez besoin qu’une action cliente UXF fonctionne pour votre instance de la page 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 rubrique Developing custom widgets.

    Clonage d’un widget Playbook Service Portal

    Accédez à la Tous > Portail de services > 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 en fonction du nom du widget par défaut, mais vous pouvez le modifier comme vous le souhaitez.
    Description Ajoutez une description facultative qui fournit des détails sur le 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 de l’application. Pour plus d’informations, consultez Périmètre de l’application.
    Public Sélectionnez cette option si votre widget est public. Si elle 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 le voir.
    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 du 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 CSS du widget. 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 Scriptez 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 fonctionner avec les données d’enregistrement.
    Pour en savoir plus sur le champ de 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 modèle et du contrôleur 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 des connaissances de l’API ServiceNow et d’AngularJS pour créer un contrôleur client.
    controllerAs Le modèle HTML utilise la syntaxe controllerAs pour la liaison de base.
    Lien Utilisez une fonction de lien pour manipuler directement les DOM.
    DANGER :
    La fonction de liaison 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 widget.
    Données de démonstration Fournissez des données lors de l’aperçu du widget dans l’éditeur de widget.
    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, reportez-vous aux sections . et 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 en maintenance.