Consommer des produits de données dans les applications

Les développeurs d'analytique peuvent charger des produits de données, avec leurs modèles sémantiques, dans des applications d'analytique à l'aide du catalogue de données. Le catalogue de données génère le script nécessaire et crée des éléments maîtres pour les mesures et les dimensions.

Lorsque vous consommez un produit de données, le catalogue de données génère une instruction de script IncludeModel qui charge les tables, relations, mesures et dimensions sélectionnées dans votre application. Les mesures et les dimensions du modèle sémantique apparaissent automatiquement en tant qu'éléments principaux, prêts à être utilisés dans les visualisations.

Conditions préalables requises

Pour consommer un produit de données et son modèle sémantique, vous avez besoin de :

Autorisations

Pour consommer le modèle sémantique des produits de données dans les espaces partagés, gérés et de données, vous devez disposer de l'autorisation Peut consommer des données ou Peut afficher dans l'espace contenant le produit de données.

Pour obtenir des informations détaillées complètes, consultez Rôles et autorisations relatifs aux produits de données.

Jeux de données accessibles

Vous devez avoir accès aux jeux de données, ainsi qu'aux connexions aux données sous-jacentes, qui sont inclus dans le modèle sémantique.

Nom unique du produit de données

Le produit de données doit avoir un nom unique au sein de l'espace. Si une application contient déjà un produit de données portant le même nom, le chargement du modèle sémantique échoue.

Consommer un produit de données et un modèle sémantique via le produit de données

Vous pouvez créer une application analytique directement à partir d'un produit de données. Vous pouvez affiner les éléments à utiliser à partir du produit de données et de son modèle sémantique : jeux de données, champs et éléments maîtres.

1. Ouvrez le produit de données, soit en en sélectionnant un dans la place de marché des données, soit en parcourant le catalogue.

2. Dans l'en-tête du nom du produit de données, cliquez sur Utiliser dans > Application.

   

3. Dans la fenêtre Créer une nouvelle application, examinez le modèle sémantique et les données qui seront chargées.
4. Cliquez sur Continue.

   Le Éditeur de chargement de données de l'application nouvellement créée s'ouvre, et vous êtes redirigé vers le catalogue de données. Le produit de données est sélectionné par défaut, mais vous pouvez naviguer, affiner votre sélection et examiner les données avant de le charger dans l'application. Pour plus d'informations, consultez Consommer un produit de données et un modèle sémantique via le Éditeur de chargement de données.

5. Lorsque vous êtes prêt, cliquez sur Charger les données.

Une fois les données chargées, vous pouvez commencer à ajouter des feuilles et à travailler sur l'application, ou accéder à l'Éditeur de chargement de données pour inspecter et modifier le script si nécessaire. Les tables, relations, mesures et dimensions du modèle sémantique sont désormais disponibles pour utilisation.

Pour en savoir plus sur la visualisation des données dans les feuilles, consultez Création d'analyses et visualisation de données.

Consommer un produit de données et un modèle sémantique via le Éditeur de chargement de données

Le catalogue de données fournit une interface permettant de parcourir et de sélectionner des données et des informations de modèle sémantique provenant de produits de données, au lieu de saisir manuellement un script.

Pour charger un produit de données et son modèle sémantique :

1. Ouvrez une application.
2. Cliquez sur Éditeur de chargement de données dans la barre de navigation supérieure.
3. Dans le volet droit Ajouter des données, cliquez sur Ajouter à partir du catalogue de données.
4. La fenêtre modale du catalogue de données s'ouvre, affichant les données disponibles, y compris les produits de données avec des modèles sémantiques.

   

Parcourir les produits de données

Le catalogue de données affiche les produits de données qui contiennent des modèles sémantiques. Vous pouvez parcourir et rechercher des produits de données par nom, description ou balises.

Cliquez sur un produit de données pour afficher un résumé de ce qui sera chargé dans le script de l'application, notamment les tables, les mesures et les dimensions.

Si un jeu de données dans le modèle sémantique est inaccessible, il est signalé par un indicateur d'avertissement. Vous pouvez toujours consommer les mesures et dimensions associées qui se trouvent dans le modèle sémantique, mais les jeux de données inaccessibles et leurs champs sont exclus.

Sélectionner et affiner un modèle sémantique

Après avoir sélectionné le produit de données à utiliser, vous pouvez affiner votre sélection et choisir précisément les composants du modèle sémantique à inclure dans votre application.

1. Passez la souris sur le produit de données sélectionné et cliquez sur Affiner la sélection.

   

   Trois nouveaux onglets sont disponibles dans lesquels vous pouvez parcourir les éléments du produit de données :

   • Tables/champs
   • Dimensions
   • Mesures
2. Utilisez les cases à cocher pour affiner votre sélection et choisir les jeux de données, champs, mesures et dimensions à inclure.
Note Conseil

Les utilisateurs avancés peuvent activer ou désactiver Inclure automatiquement les éléments ajoutés lors du rechargement pour déterminer si les nouveaux éléments sont automatiquement inclus lorsque le modèle sémantique change.

Lorsque cette option est activée, les nouveaux champs, mesures et dimensions ajoutés au modèle sémantique sont automatiquement ajoutés au modèle de données et aux éléments principaux lors du rechargement. Ceci s'applique uniquement lorsque tous les champs, mesures et dimensions sont cochés, respectivement.

3. Lorsque votre sélection est prête, cliquez sur Insérer le script.

Le script IncludeModel généré est inséré dans le script de chargement et peut être affiché et modifié dans l'Éditeur de chargement de données. Pour charger les données dans l'application, cliquez sur Charger les données.

Une fois les données chargées, vous pouvez commencer à ajouter des feuilles et à travailler sur l'application. Pour plus d'informations, consultez Création d'analyses et visualisation de données.

Comprendre l'inclusion automatique

La fonctionnalité d’inclusion automatique contrôle la façon dont votre application réagit lorsque le modèle sémantique change.

Lorsque l'inclusion automatique est activée pour un type de composant, le script généré utilise un sélecteur à caractère générique (*) :

• Fields * : Inclut tous les champs de la table spécifiée.
• WithMeasures: *: Inclut toutes les mesures en tant qu'éléments principaux.
• WithDimensions: * : Inclut toutes les dimensions en tant qu'éléments principaux.

Lorsque l'inclusion automatique est désactivée, le script liste explicitement les éléments sélectionnés. Par exemple :

• WithMeasures [Total sales], [Total quantity] : inclut uniquement les mesures spécifiées.
• WithDimensions [Region], [Product] : Inclut uniquement les dimensions spécifiées.

L'inclusion automatique est recommandée pour les utilisateurs avancés afin de réduire la maintenance et de garantir que votre application bénéficie des améliorations apportées au modèle sémantique. Désactivez l'inclusion automatique si vous avez besoin d'un contrôle strict sur les éléments inclus.

Comprendre le script IncludeModel généré

Les données génèrent une instruction de script IncludeModel qui fait référence au modèle sémantique et spécifie les composants à charger.

Exemple de script

IncludeModel [My Example Data Product] FromSpace [My Shared Space]
WithTables
  Table [dataset_dim_dateinfo] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_customer] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_fact_transactions] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_category] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_sales_rep] Fields * Connection [My Shared Space:DataFiles]
WithMeasures *
WithDimensions *;

Paramètres du script :

• IncludeModel : Le nom du produit de données contenant le modèle sémantique.
• FromSpace : Spécifie l'espace contenant le produit de données.
• WithTables : Spécifie les tables à inclure.
• Table : Spécifie une table à inclure. Vous pouvez inclure des instructions Table pour chaque table que vous souhaitez utiliser, séparées par des virgules.
• Fields : Spécifie les champs à inclure à partir de la table spécifiée. Utilisez * pour tous les champs ou une liste de champs séparés par des virgules.
• Connection : Spécifie l'emplacement de la table à l'aide du format environment:space:connection, space:connection ou connection.
• WithMeasures : Spécifie les mesures à inclure en tant que mesures principales. Utilisez * pour toutes les mesures ou une liste de noms de mesures spécifiques.
• WithDimensions: Spécifie les dimensions à inclure en tant que dimensions principales. Utilisez * pour toutes les dimensions ou une liste de noms de dimensions spécifiques.

Vous pouvez modifier manuellement l'instruction IncludeModel pour ajuster les éléments inclus ou pour basculer entre les modes de sélection par caractère générique et explicite.

Pour obtenir tous les détails sur l'instruction IncludeModel, reportez-vous à IncludeModel.

Nommage des champs et des tables

Lorsqu'un produit de données est chargé dans une application, les noms de champs et de tables peuvent être automatiquement ajustés afin d'éviter les conflits de nommage et de transformer les relations en associations basées sur les noms conformément aux modèles analytiques de Qlik.

• Champs portant le même nom sans relation : si deux tables contiennent un champ portant le même nom mais que ces champs n'ont pas de relation, les noms de champ sont automatiquement qualifiés par le nom de leur table (par exemple, TableName.FieldName) afin d'éviter toute association automatique involontaire dans l'application.
• Champs ayant une relation : Si les deux champs ont une relation mais des noms différents, ils sont renommés avec le même nom, le nom de la relation, lorsqu'ils sont chargés dans une application pour former une association.

• Clés composites : pour les clés composites, un nouveau champ clé est ajouté aux tables concernées.

• Tables de même nom : si deux tables portent le même nom, elles sont automatiquement renommées par l'ajout d'un suffixe numérique, par exemple TableName_1, TableName_2, et ainsi de suite.

Utilisation des éléments principaux hérités

Lorsque vous rechargez une application qui inclut une instruction IncludeModel, les mesures et dimensions du modèle sémantique apparaissent automatiquement dans le panneau des éléments principaux.

Pour utiliser les éléments principaux d'un modèle sémantique :

1. Rechargez l'application pour charger les données à partir du modèle sémantique.
2. Ouvrez une feuille en mode d'édition.
3. Dans le volet de gauche, cliquez sur Éléments principaux.
4. Les mesures et dimensions du modèle sémantique apparaissent dans la liste avec un indicateur de produit de données.

   

5. Faites glisser une mesure principale ou une dimension sur une visualisation pour l'utiliser.

Les éléments principaux hérités de modèles sémantiques affichent le nom et la description de leur produit de données source. Vous pouvez afficher l'expression utilisée par la mesure ou la dimension en la survolant.

Propriétés des éléments principaux

La plupart des attributs des éléments maîtres hérités de modèles sémantiques sont en lecture seule dans l'application consommatrice. Certains autres attributs d'élément principal, tels que ceux liés aux visualisations, peuvent toujours être modifiés dans l'application.

Le comportement en lecture seule s'applique uniquement à l'interface utilisateur — vous pouvez définir un certain nombre de propriétés d'élément principal via l'API :

• Propriétés configurables dans le modèle sémantique mais en lecture seule dans l'interface utilisateur de l'application consommatrice. Cela comprend le titre, la description et les balises.

• Propriétés qui ne sont pas configurées dans le modèle sémantique et qui ne sont pas exposées dans l'interface utilisateur de l'application consommatrice.

Les modifications apportées aux propriétés définies par le modèle sémantique seront écrasées lors du rechargement de l'application.

Suppression de l'article maître

Dans une application non publiée, vous pouvez supprimer un élément principal hérité, mais il réapparaît lors du rechargement suivant s'il est toujours référencé dans le script IncludeModel. Pour le supprimer définitivement, supprimez-le d'abord du script. Vous pouvez également dupliquer un élément principal hérité. Le dupliquer est un élément principal d'application ordinaire et est entièrement modifiable.

Éléments principaux et publication d'applications

Lorsqu'une application est publiée, ses éléments principaux hérités restent figés sur la version du produit de données utilisée lors de la publication de l'application. Le rechargement d'une application publiée ne crée, ne met à jour ni ne supprime les éléments principaux du produit de données. Pour utiliser des mesures et dimensions nouvelles ou modifiées, mettez à jour l'application et publiez-la à nouveau.

Prise en compte des mises à jour du modèle sémantique dans une application

Si le modèle sémantique change après que vous l'avez consommé, vous pouvez mettre à jour votre application pour refléter les modifications.

Si vous avez utilisé le mode d'inclusion automatique avec des sélecteurs à caractère générique, les nouvelles mesures et dimensions sont automatiquement incluses. Si vous avez utilisé la sélection explicite, seuls les éléments que vous avez initialement sélectionnés sont chargés.

Pour ajouter de nouveaux éléments à partir du modèle sémantique :

1. Ouvrez la console Éditeur de chargement de données.
2. Localisez l'instruction IncludeModel dans votre script.
3. Modifiez l'instruction pour ajouter de nouveaux éléments ou modifier les sélecteurs sur * pour l'inclusion automatique.
4. Actualiser l'application.

Vous pouvez également supprimer l'instruction IncludeModel existante et utiliser le catalogue de données pour en générer une nouvelle avec les sélections mises à jour.

Consommer des produits de données dans d'autres outils

Dans Script, il est possible de consommer des produits de données, mais les mesures et les dimensions sont ignorées.

Lors de la consommation de produits de données dans des ressources autres que des applications et des scripts (tels que des flux de données et des recettes de table), le produit de données fait office d'ensemble de jeux de données de confiance parmi lesquels faire son choix. Ces outils utilisent les jeux de données comme sources et le produit de données n'est pas affiché comme un nœud source dans la traçabilité.