IncludeModel

Senast uppdaterad: 2026-11-03

Instruktionen IncludeModel läser in en dataprodukt och dess semantiska modell, inklusive tabeller, relationer, mått och dimensioner. Mått och dimensioner från den semantiska modellen visas automatiskt som huvudobjekt i applikationen.

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]

Argument och nyckelord
Argument eller nyckelord	Beskrivning
data_product_name	Namnet på dataprodukten som ska läsas in.
FromSpace, FromCurrentSpace, or FromPersonalSpace	Nyckelord som anger det utrymme från vilket dataprodukten ska läsas in. Använd något av följande vid behov. Om alla dessa nyckelordsalternativ utelämnas söker IncludeModel-satsen efter dataprodukten i ditt personliga utrymme. FromSpace: Läs in dataprodukten som finns i utrymmet som anges med data_product_space. FromCurrentSpace: Läs in dataprodukten som finns i det aktuella utrymmet. FromPersonalSpace: Läs in dataprodukten som finns i ditt personliga utrymme.
data_product_space	Anger utrymmet för den dataprodukt du vill läsa in, om du använder FromSpace för att uttryckligen ange ett visst utrymme att läsa in från. Detta är inte tillämpligt om du använder FromPersonalSpace eller FromCurrentSpace. Följ citeringskonventionerna som dokumenteras på Använda citattecken i skriptet. Exempel: MyAnalyticsSpace "My Analytics Space" [My Analytics Space]
InEnvironment	Nyckelord som anger att dataprodukten ska användas i den miljö som anges med environment_name. Krävs inte om dataprodukten inte finns i en miljö.
environment_name	Namnet på miljön, om tillämpligt, som innehåller dataprodukten du vill läsa in. Följ citeringskonventionerna som dokumenteras på Använda citattecken i skriptet. Exempel: Production [Production Environment] "Production Environment"
WithTables	Nyckelord som anger att tabellerna som definieras i efterföljande Table-satser ska användas.
Table	Nyckelord som anger användningen av en tabell. Läser in en tabell per Table-sats.
table_name	Anger tabellens namn som ska användas i datamodellen. Följ citeringskonventionerna som dokumenteras på Använda citattecken i skriptet. Exempel: MyDataTable [My Data Table] "My Data Table"
Fields	Nyckelord som instruerar att använda de angivna fälten (fieldlist) från tabellen för att integrera i datamodellen.
fieldlist	Lista över fält från tabellen som refereras i föregående Table-sats. Du kan använda * för att använda alla fält från tabellen, eller ange en kommaavgränsad lista med specifika fält. Exempel: Amount, Quantity, Region [Amount], [Quantity], [Region]
Connection	Nyckelord som anger att datauppsättningen som specificeras i dataset_connection ska användas.
dataset_connection	En koppling som kan läsa in datamängden som innehåller den refererade tabellen. Beroende på kopplingens plats, använd ett av följande format: environment:space:connection — Används för filer som finns i miljöer (behållare för data som synkroniseras mellan Qlik Cloud och Qlik Talend Cloud). Miljöer är associerade med utrymmen (särskilt datautrymmen). För mer information om miljöer, se Synkronisering och hantering av miljöer. space:connection — Används för anslutningar med ett utrymme som lagringsbehållare på högsta nivån eller i samma miljö som den inläsande applikationen. Detta kan vara anslutningar som finns i delade, hanterade eller datautrymmen. För till exempel ett dataset som lagras lokalt inom Qlik Cloud (DataFiles-koppling), i ett utrymme med namnet Sales Analysis, använder du följande: Sales Analysis:DataFiles connection — Endast anslutningsnamn. Detta avser anslutningar som finns i ditt personliga utrymme. I detta fall skulle kopplingen helt enkelt vara: DataFiles Exempel: [CustomerOrders:DataFiles] [SalesData2026:SnowflakeSales]
WithMeasures	Nyckelord som instruerar att konvertera de angivna måtten från dataprodukten (measurelist) till huvudmått.
measurelist	Lista över mått från dataproduktens semantiska modell som ska konverteras till huvudmått. Du kan använda * för att konvertera alla mått, eller ange en kommaavgränsad lista med specifika mått. Exempel: [Sales], [Total Quantity], [Cost]
WithDimensions	Nyckelord som instruerar om att konvertera de angivna dimensionerna från dataprodukten (dimensionlist) till masterdimensioner.
dimensionlist	Lista över dimensioner från dataproduktens semantiska modell som ska konverteras till huvuddimensioner. Du kan använda * för att konvertera alla dimensioner, eller ange en kommaavgränsad lista med specifika dimensioner. Exempel: [Product Name], [Region], [Customer]

kommentarer

IncludeModel-instruktionen genereras vanligtvis automatiskt av datakatalogen när du väljer att läsa in en dataprodukt med dess semantiska modell. Du kan även skriva satsen manuellt eller redigera den genererade satsen för att anpassa vilka fält, mätvärden och dimensioner som inkluderas.

Relationer som definieras i den semantiska modellen tillämpas automatiskt på de inlästa tabellerna, vilket skapar associationer i din datamodell.

Operationer för mått och dimensioner tillämpas i slutet av dataladdningen efter att tabellerna och fälten har laddats. Om inläsningen misslyckas före den fasen tillämpas inga mått- eller dimensionsoperationer.

Du måste ha behörigheten Kan konsumera data eller Kan visa i det space som innehåller dataprodukten för att använda satsen IncludeModel.

Egenskaper för originalobjekt

De flesta attribut för huvudobjekt som ärvs från semantiska modeller är skrivskyddade i den konsumerande applikationen. Vissa andra attribut för originalobjekt, såsom de som är relaterade till visualiseringar, kan fortfarande redigeras i applikationen.

Skrivskyddet gäller endast användargränssnittet—du kan ange ett antal egenskaper för originalobjekt via API:

Egenskaper som är konfigurerbara i den semantiska modellen men skrivskyddade i den konsumerande applikationens användargränssnitt. Detta inkluderar titel, beskrivning och taggar.
Egenskaper som inte är konfigurerade i den semantiska modellen och inte exponeras i den konsumerande applikationens användargränssnitt.

Ändringar av egenskaper som definieras av den semantiska modellen kommer att skrivas över när applikationen laddas om.

Borttagning av huvudartikel

I en opublicerad applikation kan du ta bort ett ärvt originalobjekt, men det återkommer vid nästa omladdning om det fortfarande refereras i IncludeModel-skriptet. För att ta bort det permanent tar du först bort det från skriptet. Du kan också kopiera ett ärvt originalobjekt. Objektet som skapas genom att kopiera är ett vanligt originalobjekt i programmet och är fullt redigerbart.

Exempel 1 – Läs in specifika tabeller, tillsammans med alla mått och dimensioner

Det här exemplet läser in specifika tabeller och deras relationer från dataprodukten och dess semantiska modell. Det använder också jokertecken (*) för att läsa in alla fält från de specifika tabellerna, och att alla mått och dimensioner i den semantiska modellen ska definieras som huvudelement i applikationen.

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

Komponenterna i denna IncludeModel-sats är:

Dataproduktnamn: Sales Performance Data
Dataproduktutrymme: Sales Analysis Space
Tabeller: Transactions och Products
Fält: alla
Mått och dimensioner: alla

De två tabellerna läses in med sina relationer. Alla mått och dimensioner i den semantiska modellen kommer att visas som huvudobjekt i applikationen.

Exempel 2 – Läs in specifika tabeller, mått och dimensioner

Det här exemplet läser in specifika tabeller och deras relationer från dataprodukten och dess semantiska modell. Det använder jokertecken (*) för att läsa in alla fält från de specifika tabellerna. Specifika mått och dimensioner definieras som huvudobjekt, snarare än att automatiskt definiera alla mått och dimensioner som huvudobjekt.

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

Komponenterna i denna IncludeModel-sats är:

Dataproduktnamn: Customer Analytics
Dataproduktutrymme: sales
Tabeller: Customers och Orders
Fält: alla
Mått: Total Revenue och Customer Count
Dimensioner: Customer Name

De två tabellerna läses in med sina relationer. Vart och ett av de specifika måtten och dimensionerna från den semantiska modellen kommer att visas som huvudobjekt i applikationen.

Exempel 3 – Läs in specifika tabeller, tillsammans med alla mått och dimensioner (datauppsättning finns i miljö)

Det här exemplet läser in specifika tabeller, och deras relationer i den semantiska modellen, från en dataprodukt som finns i ett dataområde som ingår i en miljö (se Synkronisering och hantering av miljöer). Det använder också jokertecken (*) för att läsa in alla fält från de specifika tabellerna, och att alla mått och dimensioner i den semantiska modellen ska definieras som huvudelement i applikationen.

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

Komponenterna i denna IncludeModel-sats är:

Dataproduktnamn: Sales Performance Data
Dataproduktmiljö: Production
Dataproduktutrymme: Sales Analysis Space
Tabeller: Transactions och Products
Fält: alla
Mått och dimensioner: alla

De två tabellerna läses in med sina relationer. Alla mått och dimensioner i den semantiska modellen kommer att visas som huvudobjekt i applikationen.

IncludeModel skriptbegränsningar

Jokerteckensyntaxen WithTables: * stöds inte. Du måste lista tabeller explicit.

Semantiska modeller i dataprodukter

Konsumera dataprodukter i applikationer

Datakatalog

Var den här sidan till hjälp för dig?

Om du stöter på några problem med den här sidan eller innehållet på den, t.ex. ett stavfel, ett saknat steg eller ett tekniskt fel – meddela oss!

Lämna din feedback här