# IncludeModel

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](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromSpace.htm), [FromCurrentSpace](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromCurrentSpace.htm), or [FromPersonalSpace](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromPersonalSpace.htm) | Nyckelord som anger det utrymme från vilket dataprodukten ska läsas in.<br><br>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.<br><br><ul> <li> <p><span>FromSpace</span>: Läs in dataprodukten som finns i utrymmet som anges med <code>data_product_space</code>.</p> </li> <li> <p><span>FromCurrentSpace</span>: Läs in dataprodukten som finns i det aktuella utrymmet.</p> </li> <li> <p><span>FromPersonalSpace</span>: Läs in dataprodukten som finns i ditt personliga utrymme.</p> </li> </ul> |
| 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.<br><br>Följ citeringskonventionerna som dokumenteras på [Använda citattecken i skriptet](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Exempel:<br><br>`MyAnalyticsSpace`<br>`"My Analytics Space"`<br>`[My Analytics Space]` |
| [InEnvironment](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/InEnvironment.htm) | Nyckelord som anger att dataprodukten ska användas i den miljö som anges med `environment_name`.<br><br>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.<br><br>Följ citeringskonventionerna som dokumenteras på [Använda citattecken i skriptet](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Exempel:<br><br>`Production`<br>`[Production Environment]`<br>`"Production Environment"` |
| [WithTables](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithTables.htm) | Nyckelord som anger att tabellerna som definieras i efterföljande `Table`-satser ska användas. |
| [Table](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Table.htm) | 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.<br><br>Följ citeringskonventionerna som dokumenteras på [Använda citattecken i skriptet](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Exempel:<br><br>`MyDataTable`<br>`[My Data Table]`<br>`"My Data Table"` |
| [Fields](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Field.htm) | 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.<br><br>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.<br><br>Exempel:<br><br>`Amount, Quantity, Region`<br>`[Amount], [Quantity], [Region]` |
| [Connection](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Connection.htm) | 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.<br><br>Beroende på kopplingens plats, använd ett av följande format:<br><br><ul> <li> <p><span>environment:space:connection</span> — Används för filer som finns i miljöer (behållare för data som synkroniseras mellan <span>Qlik Cloud</span> och <span>Qlik Talend Cloud</span>). Miljöer är associerade med utrymmen (särskilt <span>datautrymmen</span>).</p> <p>För mer information om miljöer, se <a href="https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-environments.htm">Synkronisering och hantering av miljöer</a>.</p> </li> <li> <p><span>space:connection</span> — 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 <span>delade</span>, <span>hanterade</span> eller datautrymmen.</p> <p>För till exempel ett dataset som lagras lokalt inom <span>Qlik Cloud</span> (<span>DataFiles</span>-koppling), i ett utrymme med namnet <span>Sales Analysis</span>, använder du följande: <span>Sales Analysis:DataFiles</span></p> </li> <li> <p><span>connection</span> — Endast anslutningsnamn. Detta avser anslutningar som finns i ditt <span>personliga utrymme</span>. I detta fall skulle kopplingen helt enkelt vara: <span>DataFiles</span></p> </li> </ul><br><br>Exempel:<br><br>`[CustomerOrders:DataFiles]`<br>`[SalesData2026:SnowflakeSales]` |
| [WithMeasures](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithMeasures.htm) | 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.<br><br>Du kan använda `*` för att konvertera alla mått, eller ange en kommaavgränsad lista med specifika mått.<br><br>Exempel:<br><br>`[Sales], [Total Quantity], [Cost]` |
| [WithDimensions](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithDimensions.htm) | 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.<br><br>Du kan använda `*` för att konvertera alla dimensioner, eller ange en kommaavgränsad lista med specifika dimensioner.<br><br>Exempel:<br><br>`[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.

Anteckning om informationDu 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

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

#### Ladda skript

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

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

#### Ladda skript

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

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

#### Ladda skript

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](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-environments.htm)). 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](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/semantic-models-in-data-products.htm)

[Konsumera dataprodukter i applikationer](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/consuming-data-products-apps.htm)

[Datakatalog](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/data-catalog.htm)