# IncludeModel

De IncludeModel-instructie laadt een dataproduct en het bijbehorende semantisch model, inclusief tabellen, relaties, meetwaarden en dimensies. Metingen en dimensies uit het semantisch model verschijnen automatisch als masteritems in de applicatie.

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]

Argumenten en sleutelwoorden

| Argument of sleutelwoord | Beschrijving |
| --- | --- |
| data\_product\_name | De naam van het te laden dataproduct. |
| [FromSpace](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromSpace.htm), [FromCurrentSpace](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromCurrentSpace.htm), or [FromPersonalSpace](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromPersonalSpace.htm) | Trefwoorden die de ruimte specificeren waaruit het dataproduct moet worden geladen.<br><br>Gebruik indien nodig een van de volgende. Als al deze trefwoordopties worden weggelaten, zoekt de IncludeModel-instructie naar het dataproduct in uw persoonlijke ruimte.<br><br><ul> <li> <p><span>FromSpace</span>: Laad het dataproduct dat zich bevindt in de ruimte die is opgegeven met <code>data_product_space</code>.</p> </li> <li> <p><span>FromCurrentSpace</span>: Laad het dataproduct dat zich in de huidige ruimte bevindt.</p> </li> <li> <p><span>FromPersonalSpace</span>: Laad het dataproduct dat zich in uw persoonlijke ruimte bevindt.</p> </li> </ul> |
| data\_product\_space | Geeft de space aan van het dataproduct dat u wilt laden, als u FromSpace gebruikt om expliciet een specifieke space op te geven waaruit moet worden geladen. Dit is niet van toepassing als u FromPersonalSpace of FromCurrentSpace gebruikt.<br><br>Volg de aanhalingsconventies zoals beschreven op [Gebruik van aanhalingstekens in het script](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Voorbeelden:<br><br>`MyAnalyticsSpace`<br>`"My Analytics Space"`<br>`[My Analytics Space]` |
| [InEnvironment](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/InEnvironment.htm) | Sleutelwoord dat aangeeft dat het dataproduct moet worden gebruikt in de omgeving die is opgegeven met `environment_name`.<br><br>Niet vereist als het dataproduct zich niet in een omgeving bevindt. |
| environment\_name | De naam van de omgeving, indien van toepassing, die het dataproduct bevat dat u wilt laden.<br><br>Volg de aanhalingsconventies zoals beschreven op [Gebruik van aanhalingstekens in het script](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Voorbeelden:<br><br>`Production`<br>`[Production Environment]`<br>`"Production Environment"` |
| [WithTables](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithTables.htm) | Trefwoord waarmee wordt aangegeven dat de tabellen moeten worden gebruikt die zijn gedefinieerd in daaropvolgende `Table`-instructies. |
| [Table](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Table.htm) | Sleutelwoord dat het gebruik van een tabel specificeert. Laadt één tabel per `Table`-instructie. |
| table\_name | Specificeert de naam van de tabel die in het gegevensmodel moet worden gebruikt.<br><br>Volg de aanhalingsconventies zoals beschreven op [Gebruik van aanhalingstekens in het script](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Voorbeelden:<br><br>`MyDataTable`<br>`[My Data Table]`<br>`"My Data Table"` |
| [Fields](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Field.htm) | Trefwoord met de instructie om de opgegeven velden (fieldlist) uit de tabel te gebruiken om te integreren in het gegevensmodel. |
| fieldlist | Lijst met velden uit de tabel waarnaar wordt verwezen in de voorafgaande `Table`-instructie.<br><br>U kunt `*` gebruiken om alle velden uit de tabel te gebruiken, of een door komma's gescheiden lijst met specifieke velden opgeven.<br><br>Voorbeelden:<br><br>`Amount, Quantity, Region`<br>`[Amount], [Quantity], [Region]` |
| [Connection](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Connection.htm) | Sleutelwoord dat aangeeft dat de gegevensset moet worden gebruikt die is opgegeven in `dataset_connection`. |
| dataset\_connection | Een verbinding die de dataset kan laden die de gerefereerde tabel bevat.<br><br>Afhankelijk van de locatie van de verbinding gebruikt u een van de volgende indelingen:<br><br><ul> <li> <p><span>environment:space:connection</span> — Wordt gebruikt voor bestanden die zich binnen omgevingen bevinden (containers voor gegevens die tussen <span>Qlik Cloud</span> en <span>Qlik Talend Cloud</span> worden gesynchroniseerd). Omgevingen zijn gekoppeld aan ruimten (in het bijzonder <span>dataruimten</span>).</p> <p>Voor meer informatie over omgevingen, zie <a href="https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-environments.htm">Omgevingen synchroniseren en beheren</a>.</p> </li> <li> <p><span>space:connection</span> — Wordt gebruikt voor verbindingen met een space als de opslagcontainer op het hoogste niveau of in dezelfde omgeving als de ladende applicatie. Dit kunnen verbindingen zijn die zich bevinden in <span>gedeelde</span>, <span>beheerde</span> of dataruimten.</p> <p>Bijvoorbeeld: voor een dataset die lokaal is opgeslagen binnen <span>Qlik Cloud</span> (<span>DataFiles</span> verbinding), gelegen in een ruimte met de naam <span>Sales Analysis</span>, gebruikt u het volgende: <span>Sales Analysis:DataFiles</span></p> </li> <li> <p><span>connection</span> — Alleen verbindingsnaam. Dit verwijst naar verbindingen die zich in uw <span>persoonlijke ruimte</span> bevinden. In dit geval zou de verbinding simpelweg zijn: <span>DataFiles</span></p> </li> </ul><br><br>Voorbeelden:<br><br>`[CustomerOrders:DataFiles]`<br>`[SalesData2026:SnowflakeSales]` |
| [WithMeasures](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithMeasures.htm) | Trefwoord dat instrueert om de opgegeven metingen uit het dataproduct (measurelist) om te zetten in mastermetingen. |
| measurelist | Lijst met metingen uit het semantisch model van het dataproduct die moeten worden geconverteerd naar mastermetingen.<br><br>U kunt `*` gebruiken om alle meetwaarden te converteren, of een door komma's gescheiden lijst met specifieke meetwaarden opgeven.<br><br>Voorbeeld:<br><br>`[Sales], [Total Quantity], [Cost]` |
| [WithDimensions](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithDimensions.htm) | Trefwoord dat instrueert om de opgegeven dimensies van het dataproduct (dimensionlist) te converteren naar masterdimensies. |
| dimensionlist | Lijst met dimensies uit het semantisch model van het dataproduct die moeten worden geconverteerd naar masterdimensies.<br><br>U kunt `*` gebruiken om alle dimensies te converteren, of een door komma's gescheiden lijst met specifieke dimensies opgeven.<br><br>Voorbeeld:<br><br>`[Product Name], [Region], [Customer]` |

## opmerkingen

De instructie IncludeModel wordt doorgaans automatisch gegenereerd door de datacatalogus wanneer u ervoor kiest om een dataproduct met zijn semantisch model te laden. U kunt de instructie ook handmatig schrijven of de gegenereerde instructie bewerken om aan te passen welke velden, meetwaarden en dimensies worden opgenomen.

Relaties die in het semantisch model zijn gedefinieerd, worden automatisch toegepast op de geladen tabellen, waardoor associaties in uw gegevensmodel ontstaan.

Bewerkingen voor metingen en dimensies worden toegepast aan het einde van het laden van de gegevens, nadat de tabellen en velden zijn geladen. Als het laden voor die fase mislukt, worden er geen meetwaarde- of dimensiebewerkingen toegepast.

InformatieU moet beschikken over de machtiging Kan gegevens consumeren of Kan weergeven in de space die het dataproduct bevat om de instructie IncludeModel te gebruiken.

### Eigenschappen van masteritems

De meeste attributen van masteritems die zijn overgenomen van semantische modellen, zijn alleen-lezen in de consumerende applicatie. Sommige andere masteritem-attributen, zoals die met betrekking tot visualisaties, kunnen nog steeds binnen de applicatie worden bewerkt.

Het alleen-lezen-gedrag is alleen van toepassing op de gebruikersinterface—u kunt via de API een aantal masteritem-eigenschappen instellen:

* Eigenschappen die configureerbaar zijn in het semantisch model, maar alleen-lezen zijn in de gebruikersinterface van de consumerende toepassing. Dit omvat de titel, beschrijving en tags.

* Eigenschappen die niet zijn geconfigureerd in het semantisch model en niet worden weergegeven in de gebruikersinterface van de consumerende toepassing.

Wijzigingen in eigenschappen die zijn gedefinieerd door het semantisch model worden overschreven wanneer de applicatie opnieuw wordt geladen.

### Masteritem verwijderen

In een niet-gepubliceerde applicatie kunt u een overgeërfd masteritem verwijderen, maar het verschijnt opnieuw bij de volgende herlaadbeurt als er nog steeds naar wordt verwezen in het IncludeModel-script. Om het permanent te verwijderen, verwijdert u het eerst uit het script. U kunt ook een overgeërfd masteritem dupliceren. Het dupliceren is een gewoon applicatiemasteritem en is volledig bewerkbaar.

## Voorbeeld 1 – Specifieke tabellen laden, samen met alle meetwaarden en dimensies

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/IncludeModel.htm)

#### Laad script

Dit voorbeeld laadt specifieke tabellen, en hun relaties, uit het dataproduct en het bijbehorende semantisch model. Het maakt ook gebruik van jokertekens (\*) om alle velden uit de specifieke tabellen te laden, en dat alle metingen en dimensies in het semantisch model moeten worden gedefinieerd als masteritems in de toepassing.

```
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 *;
```

De onderdelen van deze IncludeModel-instructie zijn:

* Dataproductnaam: `Sales Performance Data`

* Dataproductruimte: `Sales Analysis Space`

* Tabellen: `Transactions` en `Products`

* Velden: alle

* Metingen en dimensies: alle

De twee tabellen worden geladen met hun relaties. Alle metingen en dimensies in het semantisch model verschijnen als masteritems in de applicatie.

## Voorbeeld 2 – Specifieke tabellen, meetwaarden en dimensies laden

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/IncludeModel.htm)

#### Laad script

Dit voorbeeld laadt specifieke tabellen, en hun relaties, uit het dataproduct en het bijbehorende semantisch model. Het gebruikt jokertekens (\*) om alle velden uit de specifieke tabellen te laden. Specifieke metingen en dimensies worden gedefinieerd als masteritems, in plaats van alle metingen en dimensies automatisch als masteritems te definiëren.

```
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];
```

De onderdelen van deze IncludeModel-instructie zijn:

* Dataproductnaam: `Customer Analytics`

* Dataproductruimte: `sales`

* Tabellen: `Customers` en `Orders`

* Velden: alle

* Metingen: `Total Revenue` en `Customer Count`

* Afmetingen: `Customer Name`

De twee tabellen worden geladen met hun relaties. Elk van de specifieke metingen en dimensies uit het semantisch model zal als masteritem in de applicatie verschijnen.

## Voorbeeld 3 – Specifieke tabellen laden, samen met alle meetwaarden en dimensies (dataset bevindt zich in omgeving)

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/IncludeModel.htm)

#### Laad script

Dit voorbeeld laadt specifieke tabellen, en hun relaties in het semantisch model, uit een dataproduct dat zich bevindt in een dataruimte binnen een omgeving (zie [Omgevingen synchroniseren en beheren](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-environments.htm)). Het maakt ook gebruik van jokertekens (\*) om alle velden uit de specifieke tabellen te laden, en dat alle metingen en dimensies in het semantisch model moeten worden gedefinieerd als masteritems in de toepassing.

```
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 *;
```

De onderdelen van deze IncludeModel-instructie zijn:

* Dataproductnaam: `Sales Performance Data`

* Dataproductomgeving: `Production`

* Dataproductruimte: `Sales Analysis Space`

* Tabellen: `Transactions` en `Products`

* Velden: alle

* Metingen en dimensies: alle

De twee tabellen worden geladen met hun relaties. Alle metingen en dimensies in het semantisch model verschijnen als masteritems in de applicatie.

## IncludeModel scriptbeperkingen

De WithTables: \* jokertekensyntaxis wordt niet ondersteund. U moet tabellen expliciet vermelden.

[Semantische modellen in dataproducten](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/semantic-models-in-data-products.htm)

[Dataproducten consumeren in applicaties](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/consuming-data-products-apps.htm)

[Gegevenscatalogus](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/data-catalog.htm)