# IncludeModel 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](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromSpace.htm), [FromCurrentSpace](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromCurrentSpace.htm), or [FromPersonalSpace](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromPersonalSpace.htm) | 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.

| | 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](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Exemples :

`MyAnalyticsSpace`
`"My Analytics Space"`
`[My Analytics Space]` | | [InEnvironment](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/InEnvironment.htm) | 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](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Exemples :

`Production`
`[Production Environment]`
`"Production Environment"` | | [WithTables](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithTables.htm) | Mot-clé spécifiant d'utiliser les tables définies dans les instructions `Table` suivantes. | | [Table](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Table.htm) | 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](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Exemples :

`MyDataTable`
`[My Data Table]`
`"My Data Table"` | | [Fields](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Field.htm) | 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](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Connection.htm) | 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 :



Exemples :

`[CustomerOrders:DataFiles]`
`[SalesData2026:SnowflakeSales]` | | [WithMeasures](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithMeasures.htm) | 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](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithDimensions.htm) | 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. Note InformationsVous 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 [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/IncludeModel.htm) #### Script de chargement 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 [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/IncludeModel.htm) #### Script de chargement 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) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/IncludeModel.htm) #### Script de chargement 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](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-environments.htm)). 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](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/semantic-models-in-data-products.htm) [Consommer des produits de données dans les applications](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/consuming-data-products-apps.htm) [Catalogue de données](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/data-catalog.htm)