# IncludeModel

Instrukcja IncludeModel ładuje produkt danych i jego model semantyczny, w tym tabele, relacje, miary i wymiary. Miary i wymiary z modelu semantycznego automatycznie pojawiają się jako elementy główne w aplikacji.

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]

Argumenty i słowa kluczowe

| Argument lub słowo kluczowe | Opis |
| --- | --- |
| data\_product\_name | Nazwa produktu danych do załadowania. |
| [FromSpace](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromSpace.htm), [FromCurrentSpace](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromCurrentSpace.htm), or [FromPersonalSpace](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromPersonalSpace.htm) | Słowa kluczowe określające przestrzeń, z której ma zostać załadowany produkt danych.<br><br>Użyj jednej z poniższych opcji w zależności od potrzeb. Jeśli wszystkie te opcje słów kluczowych zostaną pominięte, instrukcja IncludeModel wyszukuje produkt danych w Twojej przestrzeni prywatnej.<br><br><ul> <li> <p><span>FromSpace</span>: Załaduj produkt danych znajdujący się w przestrzeni określonej za pomocą <code>data_product_space</code>.</p> </li> <li> <p><span>FromCurrentSpace</span>: Załaduj produkt danych znajdujący się w bieżącej przestrzeni.</p> </li> <li> <p><span>FromPersonalSpace</span>: Załaduj produkt danych znajdujący się w Twojej przestrzeni prywatnej.</p> </li> </ul> |
| data\_product\_space | Określa przestrzeń produktu danych, który chcesz załadować, jeśli używasz FromSpace do jawnego określenia konkretnej przestrzeni, z której ma nastąpić ładowanie. Nie ma to zastosowania, jeśli używasz FromPersonalSpace lub FromCurrentSpace.<br><br>Stosuj się do konwencji cytowania udokumentowanych w [Stosowanie znaków cudzysłowu w skrypcie](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Przykłady:<br><br>`MyAnalyticsSpace`<br>`"My Analytics Space"`<br>`[My Analytics Space]` |
| [InEnvironment](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/InEnvironment.htm) | Słowo kluczowe określające użycie produktu danych w środowisku wskazanym za pomocą `environment_name`.<br><br>Niewymagane, jeśli produkt danych nie znajduje się w środowisku. |
| environment\_name | Nazwa środowiska, jeśli dotyczy, zawierającego produkt danych, który chcesz załadować.<br><br>Stosuj się do konwencji cytowania udokumentowanych w [Stosowanie znaków cudzysłowu w skrypcie](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Przykłady:<br><br>`Production`<br>`[Production Environment]`<br>`"Production Environment"` |
| [WithTables](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithTables.htm) | Słowo kluczowe określające użycie tabel zdefiniowanych w kolejnych instrukcjach `Table`. |
| [Table](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Table.htm) | Słowo kluczowe określające użycie tabeli. Ładuje jedną tabelę na instrukcję `Table`. |
| table\_name | Określa nazwę tabeli do użycia w modelu danych.<br><br>Stosuj się do konwencji cytowania udokumentowanych w [Stosowanie znaków cudzysłowu w skrypcie](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Przykłady:<br><br>`MyDataTable`<br>`[My Data Table]`<br>`"My Data Table"` |
| [Fields](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Field.htm) | Słowo kluczowe nakazujące użycie określonych pól (fieldlist) z tabeli w celu integracji z modelem danych. |
| fieldlist | Lista pól z tabeli, do której odwołuje się poprzedzająca instrukcja `Table`.<br><br>Możesz użyć `*`, aby wykorzystać wszystkie pola z tabeli, lub podać rozdzieloną przecinkami listę określonych pól.<br><br>Przykłady:<br><br>`Amount, Quantity, Region`<br>`[Amount], [Quantity], [Region]` |
| [Connection](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Connection.htm) | Słowo kluczowe wskazujące na użycie zestawu danych określonego w `dataset_connection`. |
| dataset\_connection | Połączenie, które może załadować zestaw danych zawierający tabelę, do której istnieje odwołanie.<br><br>W zależności od lokalizacji połączenia użyj jednego z następujących formatów:<br><br><ul> <li> <p><span>environment:space:connection</span> — Używane w przypadku plików znajdujących się w środowiskach (kontenerach na dane synchronizowane między <span>Qlik Cloud</span> a <span>Qlik Talend Cloud</span>). Środowiska są powiązane z przestrzeniami (w szczególności z <span>przestrzeniami danych</span>).</p> <p>Aby uzyskać więcej informacji na temat środowisk, zobacz <a href="https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-environments.htm">Synchronizowanie i zarządzanie środowiskami</a>.</p> </li> <li> <p><span>space:connection</span> — Używane w przypadku połączeń z przestrzenią jako kontenerem pamięci masowej najwyższego poziomu lub w tym samym środowisku co aplikacja ładująca. Mogą to być połączenia znajdujące się w przestrzeniach <span>współdzielonych</span>, <span>zarządzanych</span> lub danych.</p> <p>Na przykład w przypadku zestawu danych przechowywanego lokalnie w <span>Qlik Cloud</span> (połączenie <span>DataFiles</span>), znajdującego się w przestrzeni o nazwie <span>Sales Analysis</span>, należy użyć następującego zapisu: <span>Sales Analysis:DataFiles</span></p> </li> <li> <p><span>connection</span> — Tylko nazwa połączenia. Dotyczy to połączeń znajdujących się w Twojej <span>przestrzeni prywatnej</span>. W tym przypadku połączenie byłoby po prostu: <span>DataFiles</span></p> </li> </ul><br><br>Przykłady:<br><br>`[CustomerOrders:DataFiles]`<br>`[SalesData2026:SnowflakeSales]` |
| [WithMeasures](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithMeasures.htm) | Słowo kluczowe nakazujące konwersję określonych miar z produktu danych (measurelist) na miary główne. |
| measurelist | Lista miar z modelu semantycznego produktu danych do przekształcenia w miary główne.<br><br>Możesz użyć `*`, aby przekonwertować wszystkie miary, lub podać rozdzieloną przecinkami listę określonych miar.<br><br>Przykład:<br><br>`[Sales], [Total Quantity], [Cost]` |
| [WithDimensions](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithDimensions.htm) | Słowo kluczowe nakazujące konwersję określonych wymiarów z produktu danych (dimensionlist) na wymiary główne. |
| dimensionlist | Lista wymiarów z modelu semantycznego produktu danych do przekształcenia w wymiary główne.<br><br>Możesz użyć `*`, aby przekonwertować wszystkie wymiary, lub podać rozdzieloną przecinkami listę określonych wymiarów.<br><br>Przykład:<br><br>`[Product Name], [Region], [Customer]` |

## komentarze

Instrukcja IncludeModel jest zazwyczaj generowana automatycznie przez katalog danych, gdy wybierzesz załadowanie produktu danych z jego modelem semantycznym. Możesz także napisać instrukcję ręcznie lub edytować wygenerowaną instrukcję, aby dostosować, które pola, miary i wymiary mają zostać uwzględnione.

Relacje zdefiniowane w modelu semantycznym są automatycznie stosowane do załadowanych tabel, tworząc powiązania w Twoim modelu danych.

Operacje na miarach i wymiarach są stosowane na końcu ładowania danych, po załadowaniu tabel i pól. Jeśli ładowanie zakończy się niepowodzeniem przed tą fazą, żadne operacje na miarach ani wymiarach nie zostaną zastosowane.

InformacjaMusisz mieć uprawnienie Może korzystać z danych lub Może wyświetlać w przestrzeni zawierającej produkt danych, aby użyć instrukcji IncludeModel.

### Właściwości elementów głównych

Większość atrybutów elementów głównych odziedziczonych z modeli semantycznych jest tylko do odczytu w aplikacji konsumującej. Niektóre inne atrybuty elementu głównego, takie jak te powiązane z wizualizacjami, nadal można edytować w aplikacji.

Działanie tylko do odczytu dotyczy wyłącznie interfejsu użytkownika — za pomocą API można ustawić szereg właściwości elementu głównego:

* Właściwości, które można konfigurować w modelu semantycznym, ale są tylko do odczytu w interfejsie użytkownika aplikacji konsumującej. Obejmuje to tytuł, opis i tagi.

* Właściwości, które nie są skonfigurowane w modelu semantycznym i nie są wyeksponowane w interfejsie użytkownika aplikacji konsumującej.

Zmiany właściwości zdefiniowanych przez model semantyczny zostaną nadpisane po ponownym załadowaniu aplikacji.

### Usuwanie elementu głównego

W nieopublikowanej aplikacji można usunąć odziedziczony element główny, ale pojawi się on ponownie przy następnym przeładowaniu, jeśli nadal istnieje do niego odwołanie w skrypcie IncludeModel. Aby trwale go usunąć, najpierw usuń go ze skryptu. Można także duplikować odziedziczony element główny. Duplikować to zwykły element główny aplikacji i jest w pełni edytowalny.

## Przykład 1 – Ładowanie określonych tabel wraz ze wszystkimi miarami i wymiarami

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

#### Załaduj skrypt

Ten przykład ładuje określone tabele oraz ich relacje z produktu danych i jego modelu semantycznego. Używa również znaków wieloznacznych (\*) do załadowania wszystkich pól z określonych tabel, a także zakłada, że wszystkie miary i wymiary w modelu semantycznym mają zostać zdefiniowane jako elementy główne w aplikacji.

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

Elementy tej instrukcji IncludeModel to:

* Nazwa produktu danych: `Sales Performance Data`

* Przestrzeń produktu danych: `Sales Analysis Space`

* Tabele: `Transactions` i `Products`

* Pola: wszystkie

* Miary i wymiary: wszystkie

Obie tabele są ładowane wraz ze swoimi relacjami. Wszystkie miary i wymiary w modelu semantycznym pojawią się jako elementy główne w aplikacji.

## Przykład 2 – Ładowanie określonych tabel, miar i wymiarów

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

#### Załaduj skrypt

Ten przykład ładuje określone tabele oraz ich relacje z produktu danych i jego modelu semantycznego. Używa symboli wieloznacznych (\*), aby załadować wszystkie pola z określonych tabel. Określone miary i wymiary są definiowane jako elementy główne, zamiast automatycznego definiowania wszystkich miar i wymiarów jako elementów głównych.

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

Elementy tej instrukcji IncludeModel to:

* Nazwa produktu danych: `Customer Analytics`

* Przestrzeń produktu danych: `sales`

* Tabele: `Customers` i `Orders`

* Pola: wszystkie

* Miary: `Total Revenue` i `Customer Count`

* Wymiary: `Customer Name`

Obie tabele są ładowane wraz ze swoimi relacjami. Każda z określonych miar i każdy z określonych wymiarów z modelu semantycznego pojawią się jako elementy główne w aplikacji.

## Przykład 3 – Ładowanie określonych tabel wraz ze wszystkimi miarami i wymiarami (zestaw danych zlokalizowany w środowisku)

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

#### Załaduj skrypt

Ten przykład ładuje określone tabele oraz ich relacje w modelu semantycznym z produktu danych znajdującego się w przestrzeni danych zawartej w środowisku (zobacz [Synchronizowanie i zarządzanie środowiskami](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-environments.htm)). Używa również znaków wieloznacznych (\*) do załadowania wszystkich pól z określonych tabel, a także zakłada, że wszystkie miary i wymiary w modelu semantycznym mają zostać zdefiniowane jako elementy główne w aplikacji.

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

Elementy tej instrukcji IncludeModel to:

* Nazwa produktu danych: `Sales Performance Data`

* Środowisko produktu danych: `Production`

* Przestrzeń produktu danych: `Sales Analysis Space`

* Tabele: `Transactions` i `Products`

* Pola: wszystkie

* Miary i wymiary: wszystkie

Obie tabele są ładowane wraz ze swoimi relacjami. Wszystkie miary i wymiary w modelu semantycznym pojawią się jako elementy główne w aplikacji.

## IncludeModel ograniczenia skryptu

Składnia symbolu wieloznacznego WithTables: \* nie jest obsługiwana. Należy jawnie wymienić tabele.

[Modele semantyczne w produktach danych](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/semantic-models-in-data-products.htm)

[Korzystanie z produktów danych w aplikacjach](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/consuming-data-products-apps.htm)

[Katalog danych](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/data-catalog.htm)