IncludeModel

Laatst bijgewerkt: 2026-11-10

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, FromCurrentSpace, or FromPersonalSpace	Trefwoorden die de ruimte specificeren waaruit het dataproduct moet worden geladen. Gebruik indien nodig een van de volgende. Als al deze trefwoordopties worden weggelaten, zoekt de IncludeModel-instructie naar het dataproduct in uw persoonlijke ruimte. FromSpace: Laad het dataproduct dat zich bevindt in de ruimte die is opgegeven met data_product_space. FromCurrentSpace: Laad het dataproduct dat zich in de huidige ruimte bevindt. FromPersonalSpace: Laad het dataproduct dat zich in uw persoonlijke ruimte bevindt.
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. Volg de aanhalingsconventies zoals beschreven op Gebruik van aanhalingstekens in het script. Voorbeelden: MyAnalyticsSpace "My Analytics Space" [My Analytics Space]
InEnvironment	Sleutelwoord dat aangeeft dat het dataproduct moet worden gebruikt in de omgeving die is opgegeven met environment_name. 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. Volg de aanhalingsconventies zoals beschreven op Gebruik van aanhalingstekens in het script. Voorbeelden: Production [Production Environment] "Production Environment"
WithTables	Trefwoord waarmee wordt aangegeven dat de tabellen moeten worden gebruikt die zijn gedefinieerd in daaropvolgende Table-instructies.
Table	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. Volg de aanhalingsconventies zoals beschreven op Gebruik van aanhalingstekens in het script. Voorbeelden: MyDataTable [My Data Table] "My Data Table"
Fields	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. U kunt * gebruiken om alle velden uit de tabel te gebruiken, of een door komma's gescheiden lijst met specifieke velden opgeven. Voorbeelden: Amount, Quantity, Region [Amount], [Quantity], [Region]
Connection	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. Afhankelijk van de locatie van de verbinding gebruikt u een van de volgende indelingen: environment:space:connection — Wordt gebruikt voor bestanden die zich binnen omgevingen bevinden (containers voor gegevens die tussen Qlik Cloud en Qlik Talend Cloud worden gesynchroniseerd). Omgevingen zijn gekoppeld aan ruimten (in het bijzonder dataruimten). Voor meer informatie over omgevingen, zie Omgevingen synchroniseren en beheren. space:connection — 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 gedeelde, beheerde of dataruimten. Bijvoorbeeld: voor een dataset die lokaal is opgeslagen binnen Qlik Cloud (DataFiles verbinding), gelegen in een ruimte met de naam Sales Analysis, gebruikt u het volgende: Sales Analysis:DataFiles connection — Alleen verbindingsnaam. Dit verwijst naar verbindingen die zich in uw persoonlijke ruimte bevinden. In dit geval zou de verbinding simpelweg zijn: DataFiles Voorbeelden: [CustomerOrders:DataFiles] [SalesData2026:SnowflakeSales]
WithMeasures	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. U kunt * gebruiken om alle meetwaarden te converteren, of een door komma's gescheiden lijst met specifieke meetwaarden opgeven. Voorbeeld: [Sales], [Total Quantity], [Cost]
WithDimensions	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. U kunt * gebruiken om alle dimensies te converteren, of een door komma's gescheiden lijst met specifieke dimensies opgeven. Voorbeeld: [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.

U 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

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

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)

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). 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

Dataproducten consumeren in applicaties

Gegevenscatalogus

Was deze pagina nuttig?

Als u problemen ervaart op deze pagina of de inhoud onjuist is – een tikfout, een ontbrekende stap of een technische fout – laat het ons weten!

Geef hier uw feedback