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

Synchronisez les données entre ServiceNow les tables et les données avec les pages que vous créez avec 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 extrait les données que le générateur d’IU utilise pour afficher des informations dans un composant. Générateur d'IU Les composants utilisent les ressources de données pour synchroniser les données entre différentes expériences. Les ressources de données rendent les données des composants dynamiques, vous n’avez donc pas besoin de recréer des données pour chaque page.

Les ressources de données se trouvent dans le tiroir des ressources de données. Le tiroir des 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. Tiroir de ressources de données

Le tiroir de ressources de données contient trois sections :

• Ressources de données : ressources de données qui font partie de l’expérience
• Configuration/événements : ressources de données et événements configurés pour l’expérience
• Aperçu : JSON pour les informations renvoyées par la ressource de données

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

Définissez des conditions pour un filtre dans votre ressource de données. Pour plus d’informations, voir 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 sur 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 de valeurs d’entrée spécifiées pour s’assurer que les bonnes données 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 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 :

Un seul 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 des ressources de données. Ils sont ensuite classés par type de ressource de données comme les données de serveur ou la transformation. Par exemple, l’application Global dispose de plusieurs ressources de données, mais l’application Espace de travail n’en Gestion du service client (CSM) a que quelques-unes.

Figure 2. Ressources de données

Vous voyez différentes ressources de données en fonction de l’application dans laquelle vous vous trouvez. Si vous sélectionnez l’application Global, les ressources de données sous Données du serveur s’affichent différentes de celles fournies par l’application CSM Espace de travail configurable.

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 des pages et des composants avec des ressources de données. Vous pouvez lier des données à un composant pour récupérer les données à partir du back-end 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 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 en utilisant la syntaxe @context, comme ceci : @context.props.table.

Imaginez que vous ayez une Générateur d'IU page avec un champ obligatoire nommé table. L’URL de votre page peut ressembler à /demo/page/<table-name>. Le <table-name> pourrait être quelque chose comme 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 de ressource 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 de contexte.

Liaison des ressources de données

Utilisez les ressources de données pour extraire les données du back-end 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 à des é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 composants

Utilisez la liaison de composants pour connecter un composant à un autre. Supposons que vous avez un composant de menu de liste sur la Générateur d'IU page. Le menu Liste révèle la liste actuellement choisie aux autres composants de 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 du paramètre de l’état du client

Utilisez la liaison de paramètres d’état du client pour connecter et synchroniser des données entre une application côté client et Générateur d'IU des composants. La liaison de paramètres permet à l’état du 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 affichés dans le tableau.

Tableau 1. Types de ressources de données

Type de ressource de données	Description
Contrôleur	Encapsule la logique des données et des événements 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 sur le client, les états ou la logique spécifiques à un 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 obtenues via des demandes d’API REST.

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

Les ressources de données héritées partagent des informations à partir des parties environnantes d’une Générateur d'IU page, telle qu’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 les pièces d’un puzzle. Si vous obtenez ces informations à partir du cadre, vous n’avez pas besoin de les récupérer vous-même.

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 Générateur d'IU, mettez ces ressources à la disposition de vos composants. Ensuite, liez les données à votre composant pour qu’il puisse fonctionner avec. 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 fasse des choses avec les données, comme enregistrer de nouveaux enregistrements.

Une fois que votre page synchronise des données, vous les connectez à la partie de la page qui en a besoin, telle qu’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 quoi faire avec les données. Par exemple, vous pouvez 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

L’ajout d’une ressource de données dans Générateur d'IU, revient à ajouter un outil qui sait d’où extraire les informations. Les propriétés de ressource de données correspondent aux 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 rechercher, comment trier les données, etc. Ces propriétés permettent à la ressource de données de fonctionner correctement et vous fournissent les données dont vous avez besoin.

Après avoir ajouté une ressource de données, vous pouvez choisir de la charger hâtivement ou explicitement. Utilisez les descriptions ci-dessous pour déterminer l’approche qui convient le mieux à votre page. Cette décision peut avoir un impact sur les performances, l’expérience utilisateur et l’efficacité des ressources. Il est donc important de comprendre les différences.

Immédiatement (évaluation hâtive)

Les données se chargent automatiquement lorsque la page ou le composant se charge.

Utile pour le contenu de base que l’utilisateur s’attend à voir immédiatement.

Peut ralentir le chargement des pages et des composants en récupérant les données inutilisées.

Uniquement lorsqu’il est invoqué (évaluation explicite)

Diffère le chargement des données jusqu’à ce qu’un utilisateur effectue une action spécifique. Par exemple, cliquer sur un bouton ou saisir des données dans un champ.

Économise les ressources en extrayant les données uniquement lorsque cela est nécessaire.

Accélère le chargement initial de la page.

Figure 3. Options d’évaluation des ressources de données

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, si vous traitez une liste de produits, un script pourrait 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 des 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.

• Ajouter et configurer des ressources de données à une page
  Ajoutez des ressources pour exposer dynamiquement les données de tables, d’enregistrements ou d’autres éléments de votre page dans Générateur d'IU.
• Ajouter Now Assist des compétences à votre page
  Ajoutez des compétences pour améliorer votre Générateur d'IU page avec Now Assistles options d’IA générative de .
• Lier les données aux Générateur d'IU pages à l’aide de contrôleurs (fonctionnalité avancée)
  Les contrôleurs simplifient la liaison des données et de la logique d’événement pour activer les préréglages de composant dans Générateur d'IU.
• Créer des contrôleurs personnalisés (fonctionnalité avancée)
  Créez des contrôleurs personnalisés à utiliser dans toutes les expériences. Connectez facilement des données, des scripts et des événements réutilisables à votre page et configurez des entrées, des sorties et des événements.
• Connecter les composants de données
  Utilisez le modal de liaison de données pour associer les données exposées par les ressources de données locales aux composants de votre Générateur d'IU page.
• Paramètres de l'état du client
  Utilisez les paramètres de l’état du client pour lier les valeurs aux configurations de composant. Lorsque la valeur du paramètre d’état client change, le composant se met à jour pour utiliser la nouvelle valeur.
• Définir des scripts clients et les lier aux composants
  Ajoutez et modifiez des scripts clients afin de Générateur d'IU pouvoir mettre à jour l’état du client via des événements. Vous pouvez lier ces scripts à n’importe quel composant à l’aide d’un gestionnaire d’événements.
• Configuration des données multitables
  Présentez les données de plusieurs tables à l’aide de composants et contrôlez la mise en page et le style.
• Utiliser le mappeur d’action de vue d’entité pour Générateur d'IU
  Avec Générateur d'IU, vous pouvez utiliser l’application EVAM (Entity View Action Mapper) pour standardiser l’affichage des sources de données de vos composants dans vos cartes et listes.