IncludeModel

Dernière mise à jour : 2026-11-03

L'instruction IncludeModel charge un produit de données et son modèle sémantique, y compris les tables, les relations, les mesures et les dimensions. Les mesures et les dimensions du modèle sémantique apparaissent automatiquement en tant qu'éléments principaux dans l'application.

IncludeModel data_product_name [InEnvironment environment_name] [FromSpace data_product_space | FromCurrentSpace | FromPersonalSpace] [WithTables Table table_name1 Fields fieldlist Connection dataset_connection {, Table table_nameN Fields fieldlist Connection dataset_connection,... }] [WithMeasures measurelist] [WithDimensions dimensionlist]

Arguments et mots-clés
Argument ou mot-clé	Description
data_product_name	Le nom du produit de données à charger.
FromSpace, FromCurrentSpace, or FromPersonalSpace	Mots-clés spécifiant l'espace à partir duquel charger le produit de données. Utilisez l'un des éléments suivants selon vos besoins. Si toutes ces options de mots-clés sont omises, l'instruction IncludeModel recherche le produit de données dans votre espace personnel. FromSpace : Charger le produit de données situé dans l'espace spécifié avec data_product_space. FromCurrentSpace : Charger le produit de données situé dans l'espace actuel. FromPersonalSpace : Chargez le produit de données situé dans votre espace personnel.
data_product_space	Spécifie l'espace du produit de données que vous souhaitez charger, si vous utilisez FromSpace pour spécifier explicitement un espace particulier à partir duquel charger. Cela ne s'applique pas si vous utilisez FromPersonalSpace ou FromCurrentSpace. Respectez les conventions de mise entre guillemets documentées sur Utilisation de guillemets dans le script. Exemples : MyAnalyticsSpace "My Analytics Space" [My Analytics Space]
InEnvironment	Mot-clé spécifiant d'utiliser le produit de données dans l'environnement spécifié avec environment_name. Non requis si le produit de données n'est pas situé dans un environnement.
environment_name	Le nom de l'environnement, le cas échéant, contenant le produit de données que vous souhaitez charger. Respectez les conventions de mise entre guillemets documentées sur Utilisation de guillemets dans le script. Exemples : Production [Production Environment] "Production Environment"
WithTables	Mot-clé spécifiant d'utiliser les tables définies dans les instructions Table suivantes.
Table	Mot-clé spécifiant l'utilisation d'une table. Charge une table par instruction Table.
table_name	Spécifie le nom de la table à utiliser dans le modèle de données. Respectez les conventions de mise entre guillemets documentées sur Utilisation de guillemets dans le script. Exemples : MyDataTable [My Data Table] "My Data Table"
Fields	Mot-clé indiquant d'utiliser les champs spécifiés (fieldlist) de la table à intégrer dans le modèle de données.
fieldlist	Liste des champs de la table référencée dans l'instruction Table précédente. Vous pouvez utiliser * pour utiliser tous les champs de la table, ou fournir une liste de champs spécifiques séparés par des virgules. Exemples : Amount, Quantity, Region [Amount], [Quantity], [Region]
Connection	Mot-clé indiquant d'utiliser le jeu de données spécifié dans dataset_connection.
dataset_connection	Une connexion qui peut charger le jeu de données contenant la table référencée. En fonction de l'emplacement de la connexion, utilisez l'un des formats suivants : environment:space:connection — Utilisé pour les fichiers situés dans des environnements (conteneurs de données synchronisées entre Qlik Cloud et Qlik Talend Cloud). Les environnements sont associés à des espaces (en particulier, des espaces de données). Pour plus d'informations sur les environnements, consultez Synchronisation et gestion des environnements. space:connection — Utilisé pour les connexions avec un espace comme conteneur de stockage de niveau supérieur ou dans le même environnement que l'application de chargement. Il peut s'agir de connexions situées dans des espaces partagés, gérés ou de données. Par exemple, pour un jeu de données stocké localement dans Qlik Cloud (connexion DataFiles), situé dans un espace nommé Sales Analysis, vous utiliseriez ce qui suit : Sales Analysis:DataFiles connection — Nom de la connexion uniquement. Cela fait référence aux connexions situées dans votre espace personnel. Dans ce cas, la connexion serait simplement : DataFiles Exemples : [CustomerOrders:DataFiles] [SalesData2026:SnowflakeSales]
WithMeasures	Mot-clé indiquant de convertir les mesures spécifiées du produit de données (measurelist) en mesures principales.
measurelist	Liste des mesures du modèle sémantique du produit de données à convertir en mesures principales. Vous pouvez utiliser * pour convertir toutes les mesures, ou fournir une liste de mesures spécifiques séparées par des virgules. Exemple : [Sales], [Total Quantity], [Cost]
WithDimensions	Mot-clé donnant l'instruction de convertir les dimensions spécifiées du produit de données (dimensionlist) en dimensions principales.
dimensionlist	Liste des dimensions du modèle sémantique du produit de données à convertir en dimensions principales. Vous pouvez utiliser * pour convertir toutes les dimensions, ou fournir une liste de dimensions spécifiques séparées par des virgules. Exemple : [Product Name], [Region], [Customer]

Remarques

L'instruction IncludeModel est généralement générée automatiquement par le catalogue de données lorsque vous choisissez de charger un produit de données avec son modèle sémantique. Vous pouvez également rédiger l'instruction manuellement ou modifier l'instruction générée pour personnaliser les champs, mesures et dimensions inclus.

Les relations définies dans le modèle sémantique sont automatiquement appliquées aux tables chargées, créant des associations dans votre modèle de données.

Les opérations relatives aux mesures et aux dimensions sont appliquées à la fin du chargement des données, après le chargement des tables et des champs. Si le chargement échoue avant cette phase, aucune opération de mesure ou de dimension n'est appliquée.

Vous devez disposer de l'autorisation Peut consommer des données ou Peut afficher dans l'espace contenant le produit de données pour utiliser l'instruction IncludeModel.

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.

Exemple 1 – Charger des tables spécifiques, ainsi que toutes les mesures et dimensions

Cet exemple charge des tables spécifiques, et leurs relations, à partir du produit de données et de son modèle sémantique. Il utilise également des caractères génériques (*) pour charger tous les champs des tables spécifiques, et précise que toutes les mesures et dimensions du modèle sémantique doivent être définies en tant qu'éléments principaux dans l'application.

IncludeModel [Sales Performance Data] FromSpace [Sales Analysis Space]
WithTables
    Table [Transactions] Fields * Connection [Sales Analysis Space:DataFiles],
    Table [Products] Fields * Connection [Sales Analysis Space:DataFiles]
WithMeasures *
WithDimensions *;

Les composants de cette instruction IncludeModel sont :

Nom du produit de données : Sales Performance Data
Espace de produits de données : Sales Analysis Space
Tables : Transactions et Products
Champs : tous
Mesures et dimensions : toutes

Les deux tables sont chargées avec leurs relations. Toutes les mesures et les dimensions du modèle sémantique apparaîtront en tant qu'éléments principaux dans l'application.

Exemple 2 – Charger des tables, des mesures et des dimensions spécifiques

Cet exemple charge des tables spécifiques, et leurs relations, à partir du produit de données et de son modèle sémantique. Il utilise des caractères génériques (*) pour charger tous les champs des tables spécifiques. Des mesures et dimensions spécifiques sont définies en tant qu'éléments principaux, plutôt que de définir automatiquement toutes les mesures et dimensions en tant qu'éléments principaux.

IncludeModel [Customer Analytics] FromSpace [sales]
WithTables 
    Table [Customers] Fields * Connection [sales:DataFiles],
    Table [Orders] Fields * Connection [sales:DataFiles]
WithMeasures [Total Revenue], [Customer Count]
WithDimensions [Customer Name];

Les composants de cette instruction IncludeModel sont :

Nom du produit de données : Customer Analytics
Espace de produits de données : sales
Tables : Customers et Orders
Champs : tous
Mesures : Total Revenue et Customer Count
Dimensions : Customer Name

Les deux tables sont chargées avec leurs relations. Chacune des mesures et des dimensions spécifiques du modèle sémantique apparaîtra en tant qu'élément principal dans l'application.

Exemple 3 – Charger des tables spécifiques, ainsi que toutes les mesures et dimensions (jeu de données situé dans l'environnement)

Cet exemple charge des tables spécifiques, ainsi que leurs relations de modèle sémantique, à partir d'un produit de données situé dans un espace de données contenu dans un environnement (voir Synchronisation et gestion des environnements). Il utilise également des caractères génériques (*) pour charger tous les champs des tables spécifiques, et précise que toutes les mesures et dimensions du modèle sémantique doivent être définies en tant qu'éléments principaux dans l'application.

IncludeModel [Sales Performance Data]
    InEnvironment 'Production'
    FromSpace [Sales Analysis Space]
WithTables
    Table [Transactions] Fields * Connection [Sales Analysis Space:DataFiles],
    Table [Products] Fields * Connection [Sales Analysis Space:DataFiles]
WithMeasures *
WithDimensions *;

Les composants de cette instruction IncludeModel sont :

Nom du produit de données : Sales Performance Data
Environnement du produit de données : Production
Espace de produits de données : Sales Analysis Space
Tables : Transactions et Products
Champs : tous
Mesures et dimensions : toutes

Les deux tables sont chargées avec leurs relations. Toutes les mesures et les dimensions du modèle sémantique apparaîtront en tant qu'éléments principaux dans l'application.

IncludeModel limitations des scripts

La syntaxe de caractère générique WithTables: * n'est pas prise en charge. Vous devez lister explicitement les tables.

Modèles sémantiques dans les produits de données

Consommer des produits de données dans les applications

Catalogue de données

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.

Laissez vos commentaires ici