Exposer dynamiquement les données dans les pages du générateur d’IU (fonctionnalité avancée)

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 8 minutes de lecture
  • Synchronisez les données entre ServiceNow les tables et les données avec les pages avec lesquelles vous créez .Générateur d'IU Les pages affichent les données synchronisées en temps réel et mettent à jour les données/tables lorsqu’un utilisateur saisit des informations.

    En savoir plus sur les ressources de données dans Générateur d'IU

    Générateur d'IUSynchronise les tables/données à l’aide des ServiceNowressources de données. Une ressource de données récupère les données que Générateur d’IU utilise pour afficher les informations dans un composant. Générateur d'IU Les composants utilisent des ressources de données pour synchroniser les données entre différentes expériences. Les ressources de données dynamisent les données des composants, ce qui signifie que vous n’avez pas besoin de recréer des données pour chaque page.

    Pile de ressources de données distribuant les données sur plusieurs pages.

    Les ressources de données se trouvent dans le tiroir des ressources de données. Le tiroir de ressources de données est l’endroit où vous pouvez ajouter et configurer une ressource de données pour votre page. Après avoir configuré la ressource de données, vous pouvez synchroniser les données entre les composants de votre page et ServiceNow les tables/données.

    Figure 1. Commutateur de ressources de données
    Flèche pointant vers le tiroir de ressources de données dans le générateur d’IU.
    Le tiroir de ressources de données contient trois sections :
    • Ressources de données : les ressources de données qui font partie de l’expérience
    • Configuration/Événements : les ressources de données et les événements configurés pour l’expérience
    • Aperçu : JSON pour les informations retournées par la ressource de données

    Vous pouvez lier les propriétés de configuration pour les composants, d’autres ressources de données, les scripts clients, l’état du client et les événements à ces ressources de données.

    Définissez des conditions pour un filtre dans votre ressource de données. Pour plus d’informations, consultez Connecter les données à vos composants .

    Comment fonctionnent les ressources de données dans Générateur d'IU

    Les ressources de données extraient les données des API Glide, GraphQL et REST, puis les transforment pour les utiliser dans un composant d’une Générateur d'IU page.

    Les composants utilisent à la fois des instances de ressources de données héritées et locales. Les ressources de données héritées sont automatiquement chargées dans une Générateur d'IU page et des instances de ressources de données locales peuvent être ajoutées et configurées. Les ressources de données sont évaluées en fonction des valeurs d’entrée spécifiées pour s’assurer que les données correctes sont récupérées. Pour plus d’informations sur les ressources de données héritées et locales, reportez-vous à la section Ressources de données héritées par rapport aux ressources de données locales dans Générateur d'IU.

    Ressources de données locales dans Générateur d'IU

    Vous pouvez sélectionner des ressources de données locales, telles que des données de serveur, des opérations, des transformations ou des données client, telles que l’API gForm, pour apporter des données à la Générateur d'IU page.
    Remarque :
    Seul un formulaire GlideForm est pris en charge par page dans Générateur d'IU. Pour plus d’informations sur GlideForm, consultez le site ServiceNow Developer.
    Les ressources de données sont organisées par application dans le tiroir de ressources de données. Elles sont ensuite classées par type de ressource de données comme Données du serveur ou Transformation. Par exemple, l’application Global dispose de plusieurs ressources de données, tandis que l’application Workspace n’a Gestion du service client (CSM) que quelques ressources de données.
    Figure 2. Ressources de données
    Modal de sélection des ressources de données.

    Les différentes ressources de données s’affichent en fonction de l’application dans laquelle vous vous trouvez. Si vous sélectionnez l’application Global, les ressources de données sous les données du serveur s’affichent sous les données du serveur que si vous sélectionnez l’application CSM Configurable Workspace.

    Utilisation de la liaison de données dans Générateur d'IU

    La liaison de données vous permet de créer des pages dynamiques en synchronisant les pages et les composants avec les ressources de données. Vous pouvez lier des données à un composant pour récupérer des données à partir du serveur principal et utiliser des paramètres de champ pour obtenir des propriétés à partir de l’URL. La modification des paramètres d’URL vous permet de créer des pages dynamiques qui affichent des données différentes en fonction des paramètres.

    Vous pouvez lier des données à un composant de l’une des manières suivantes :

    Liaison de contexte

    Utilisez les paramètres d’URL pour connecter des parties de l’URL aux propriétés de votre page. Par exemple, vous pouvez lier le nom de la table à partir de l’URL à votre composant à l’aide de la syntaxe @context, comme ceci : @context.props.table.

    Imaginez que vous avez une Générateur d'IU page avec un champ obligatoire nommé table. L’URL de votre page peut ressembler à /demo/page/<nom-table>. Le <nom-table> pourrait ressembler à incident. Les données peuvent également provenir de ressources de données parentes ou être des propriétés locales spécifiques à la page.

    Pour lier les propriétés de votre composant, d’autres propriétés des ressources de données ou les détails de l’événement à la propriété de page, vous utilisez une liaison @context.props.table . Assurez-vous de fournir une valeur de test dans l’URL ou de définir une valeur fixe pour cette propriété dans la configuration de votre page si vous utilisez la liaison contextuelle.

    Liaison des ressources de données

    Utilisez des ressources de données pour extraire des données à partir du serveur principal de votre instance, telles que l’état du client, GraphQL ou une API REST. Ces sources de données ont des propriétés qui peuvent être liées aux éléments d’une Générateur d'IU page.

    Par exemple, si vous utilisez la ressource de données Rechercher un enregistrement, vous pouvez l’utiliser dans un composant de bouton. Vous pouvez utiliser une expression de données dans la propriété « label » comme ceci : @data.lookup_record_1.result.number.displayValue.

    Liaison de composant
    Utilisez la liaison de composant pour connecter un composant à un autre. Supposons que vous disposiez d’un composant de menu de liste sur la Générateur d'IU page. Le menu Liste révèle la liste actuellement choisie à d’autres composants sur la même page. Ces autres composants peuvent accéder aux données en les liant à l’aide d’une expression telle que @elements.list_menu_1.selectedListId.
    Liaison des paramètres de l’état du client

    Utilisez la liaison des paramètres de l’état du client pour connecter et synchroniser les données entre une application côté client et Générateur d'IU des composants. La liaison des paramètres permet à l’état client de mettre à jour automatiquement les données dans les composants, et vice versa. Utilisez @state syntaxe pour lier une propriété d’état à un paramètre d’état client.

    Types de sources de données disponibles dans Générateur d'IU

    Vous pouvez utiliser les types de ressources de données suivants qui sont indiqués dans la table.

    Tableau 1. Types de ressources de données
    Type de ressource de données Description
    Contrôleur Encapsule les données et la logique d’événement et active les paramètres prédéfinis pour les composants.
    GraphQL Requêtes GraphQL et mutations exécutées.
    Transformer Script qui transforme les données d’entrée dans un autre format.
    État du client Ressources de données côté client qui incluent les informations client, la logique ou la logique spécifique au domaine, les préférences utilisateur, etc.
    Composite Ressource de données réutilisable unique qui contient plusieurs ressources de données.
    REST Ressources de données effectuées via des demandes REST API.

    Ressources de données héritées par rapport aux ressources de données locales dans Générateur d'IU

    Les ressources de données héritées partagent des informations provenant des parties environnantes d’une Générateur d'IU page, comme une application. Imaginez que votre page est dans un grand cadre et qu’elle reçoit des informations du cadre ou d’autres parties qui l’entourent. Vous pouvez utiliser ces informations en les connectant aux propriétés de votre page, un peu comme si vous reliiez des pièces de puzzle entre elles. Si vous obtenez ces informations à partir du cadre, vous n’avez pas besoin de les récupérer vous-même.

    Diagramme montrant la différence entre les ressources de données héritées et locales.

    Les ressources de données locales sont des éléments que vous ajoutez vous-même à une Générateur d'IU page. Imaginez que vous créez une page pour les demandes de voyage. Vous pouvez synchroniser les données des employés avec un composant de liste afin que les employés puissent demander des déplacements liés à leurs propres informations.

    Pour utiliser ces ressources de données, importez-les à partir d’une application ou créez-les dans la ServiceNow plateforme. Ensuite, dans , mettez ces ressources à Générateur d'IUla disposition de vos composants. Ensuite, liez les données à votre composant, afin qu’il puisse fonctionner avec lui. Par exemple, vous pouvez avoir un ensemble d’enregistrements, l’exposer dans le générateur d’IU et le lier à un composant. À partir de là, configurez le composant pour qu’il effectue certaines opérations avec les données, comme enregistrer de nouveaux enregistrements.

    Une fois que votre page synchronise les données, vous les connectez à la partie de la page qui en a besoin, comme un composant. C’est comme s’assurer que la bonne pièce de puzzle s’insère au bon endroit. Ensuite, vous pouvez dire à cette partie de la page ce qu’il faut faire avec les données. Vous pouvez par exemple l’utiliser pour ajouter de nouveaux plans de déplacement pour les employés.

    Générateur d'IU Propriétés des ressources de données

    Lorsque vous ajoutez une ressource de données dans Générateur d'IU, c’est comme si vous ajoutiez un outil qui sait d’où extraire des informations. Les propriétés des ressources de données sont les instructions qui indiquent à une ressource de données comment importer des données dans Générateur d'IU des pages. Ces propriétés indiquent à une ressource de données quelles données obtenir, comment les organiser et quelles conditions respecter. Par exemple, vous pouvez utiliser ces propriétés pour spécifier les tables dans lesquelles effectuer une recherche, comment trier les données, etc. Ce sont ces propriétés qui permettent à la ressource de données de fonctionner correctement et vous fournissent les données dont vous avez besoin.

    Générateur d'IU Scripts des ressources de données

    Les scripts de ressources de données sont des instructions spéciales que vous donnez Générateur d'IU pour renvoyer des éléments de données spécifiques. Par exemple, s’il s’agit d’une liste de produits, un script peut indiquer à une ressource de données de n’afficher que les produits disponibles en stock ou de les organiser dans un ordre particulier. Les scripts de ressources de données vous permettent de personnaliser le traitement Générateur d'IU des informations, par exemple en ajoutant des règles ou des actions supplémentaires.