Widget Playbook du portail

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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 Session Storage afin qu’il sache quand effectuer une action dans le portail, comme l’ouverture d’un enregistrement ou d’une liste dans un modal dans Portail de services.

    Les composants prêts à l’emploi sont conçus pour tous ceux Expérience de playbook dont vous pourriez avoir besoin pour vos Portail de services utilisateurs. Nous vous déconseillons de modifier directement la page du portail Playbook prête à l’emploi Générateur d'IU , le Portail de services widget Playbook ou l’élément de contenu Playbook. Le changement 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 Playbook, nous vous recommandons de cloner le widget Playbook à la place.

    Remarque :
    Pour en savoir plus sur le clonage ou la création de votre propre widget à la place, reportez-vous à la section Developing custom widgets.

    Clonage d’un widget Playbook Service Portal

    Accédez à la Tout > Portail de services > Widgets et recherchez le widget Playbook .
    Remarque :
    Si vous clonez le widget Playbook , assurez-vous que toutes les actions et propriétés de configuration prêtes à l’emploi sont copiées dans votre widget cloné.
    Tableau 1. Champs de formulaire
    Champ Description
    Nom Saisissez un nom pour le widget cloné.
    ID L’ID du 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 les actions 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 permet de playbook vous 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 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 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 vos variables de 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 aux sections . et .
    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 CSS dans un widget réel affecte toutes les instances de ce widget. Pour en savoir plus sur le champ CSS, reportez-vous aux sections . et .
    Script serveur Scriptez la logique côté serveur. Cela est principalement utile pour interagir avec la plateforme Glide via des API côté serveur.
    DANGER :
    Un script serveur nécessite des connaissances de l’API ServiceNow pour fonctionner avec les données d’un enregistrement.
    Pour en savoir plus sur le champ Script serveur, reportez-vous aux sections . et .
    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 que l’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 lien nécessite la connaissance d’AngularJS.
    Pour en savoir plus sur le champ Lien, reportez-vous aux sections . et .
    A l'aperçu Cochez cette case pour 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 des options, 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 d’expérience de playbook et 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.