# IncludeModel

IncludeModel ifadesi, tablolar, ilişkiler, ölçüler ve boyutlar dahil olmak üzere bir veri ürününü ve semantik modelini yükler. Semantik modeldeki hesaplamalar ve boyutlar uygulamada otomatik olarak ana öğeler olarak görünür.

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]

Argümanlar ve anahtar kelimeler

| Argüman veya anahtar kelime | Açıklama |
| --- | --- |
| data\_product\_name | Yüklenecek veri ürününün adı. |
| [FromSpace](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromSpace.htm), [FromCurrentSpace](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromCurrentSpace.htm), or [FromPersonalSpace](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromPersonalSpace.htm) | Veri ürününün yükleneceği alanı belirten anahtar kelimeler.<br><br>Gerektiğinde aşağıdakilerden birini kullanın. Bu anahtar sözcük seçeneklerinin tümü atlanırsa, IncludeModel deyimi veri ürününü kişisel alanınızda arar.<br><br><ul> <li> <p><span>FromSpace</span>: <code>data_product_space</code> ile belirtilen alanda bulunan veri ürününü yükleyin.</p> </li> <li> <p><span>FromCurrentSpace</span>: Geçerli alanda bulunan veri ürününü yükleyin.</p> </li> <li> <p><span>FromPersonalSpace</span>: Kişisel alanınızda bulunan veri ürününü yükleyin.</p> </li> </ul> |
| data\_product\_space | Yükleme yapılacak belirli bir alanı açıkça belirtmek için FromSpace kullanıyorsanız, yüklemek istediğiniz veri ürününün alanını belirtir. FromPersonalSpace veya FromCurrentSpace kullanıyorsanız bu geçerli değildir.<br><br>[Komut dosyasında tırnak işaretlerinin kullanımı](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm) adresinde belgelenen tırnak içine alma kurallarına uyun. Örnekler:<br><br>`MyAnalyticsSpace`<br>`"My Analytics Space"`<br>`[My Analytics Space]` |
| [InEnvironment](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/InEnvironment.htm) | Veri ürününün `environment_name` ile belirtilen ortamda kullanılmasını belirten anahtar kelime.<br><br>Veri ürünü bir ortamda bulunmuyorsa gerekli değildir. |
| environment\_name | Varsa, yüklemek istediğiniz veri ürününü içeren ortamın adı.<br><br>[Komut dosyasında tırnak işaretlerinin kullanımı](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm) adresinde belgelenen tırnak içine alma kurallarına uyun. Örnekler:<br><br>`Production`<br>`[Production Environment]`<br>`"Production Environment"` |
| [WithTables](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithTables.htm) | Sonraki `Table` deyimlerinde tanımlanan tabloların kullanılmasını belirten anahtar sözcük. |
| [Table](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Table.htm) | Bir tablonun kullanımını belirten anahtar sözcük. `Table` ifadesi başına bir tablo yükler. |
| table\_name | Veri modelinde kullanılacak tablonun adını belirtir.<br><br>[Komut dosyasında tırnak işaretlerinin kullanımı](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm) adresinde belgelenen tırnak içine alma kurallarına uyun. Örnekler:<br><br>`MyDataTable`<br>`[My Data Table]`<br>`"My Data Table"` |
| [Fields](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Field.htm) | Tablodaki belirtilen alanların (fieldlist) veri modeline entegre edilmesi amacıyla kullanılmasını belirten anahtar kelime. |
| fieldlist | Önceki `Table` ifadesinde başvurulan tablodaki alanların listesi.<br><br>Tablodaki tüm alanları kullanmak için `*` kullanabilir veya belirli alanların virgülle ayrılmış bir listesini sağlayabilirsiniz.<br><br>Örnekler:<br><br>`Amount, Quantity, Region`<br>`[Amount], [Quantity], [Region]` |
| [Connection](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Connection.htm) | `dataset_connection` içinde belirtilen veri kümesinin kullanılacağını belirten anahtar sözcük. |
| dataset\_connection | Başvurulan tabloyu içeren veri kümesini yükleyebilen bir Bağlantı.<br><br>Bağlantının konumuna bağlı olarak aşağıdaki biçimlerden birini kullanın:<br><br><ul> <li> <p><span>environment:space:connection</span> — Ortamlar (<span>Qlik Cloud</span> ve <span>Qlik Talend Cloud</span> arasında senkronize edilen veriler için kapsayıcılar) içinde bulunan dosyalar için kullanılır. Ortamlar, alanlarla (özellikle <span>veri alanları</span> ile) ilişkilendirilir.</p> <p>Ortamlar hakkında daha fazla bilgi için bkz. <a href="https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-environments.htm">Ortamları senkronize etme ve yönetme</a>.</p> </li> <li> <p><span>space:connection</span> — En üst düzey depolama kapsayıcısı bir alan olan veya yükleme uygulamasıyla aynı ortamda bulunan bağlantılar için kullanılır. Bu, <span>paylaşılan</span>, <span>yönetilen</span> veya veri alanlarında bulunan bağlantılar olabilir.</p> <p>Örneğin, <span>Sales Analysis</span> adlı bir alanda bulunan ve <span>Qlik Cloud</span> (<span>DataFiles</span> Bağlantı) içinde yerel olarak depolanan bir veri kümesi için aşağıdakini kullanırsınız: <span>Sales Analysis:DataFiles</span></p> </li> <li> <p><span>connection</span> — Yalnızca bağlantı adı. Bu, <span>kişisel alanınızda</span> bulunan bağlantıları ifade eder. Bu durumda Bağlantı basitçe şu şekilde olur: <span>DataFiles</span></p> </li> </ul><br><br>Örnekler:<br><br>`[CustomerOrders:DataFiles]`<br>`[SalesData2026:SnowflakeSales]` |
| [WithMeasures](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithMeasures.htm) | Veri ürününden (measurelist) belirtilen ölçülerin ana ölçülere dönüştürülmesini belirten anahtar sözcük. |
| measurelist | Veri ürününün semantik modelinden ana hesaplamalara dönüştürülecek hesaplamaların listesi.<br><br>Tüm ölçüleri dönüştürmek için `*` kullanabilir veya belirli ölçülerin virgülle ayrılmış bir listesini sağlayabilirsiniz.<br><br>Örnek:<br><br>`[Sales], [Total Quantity], [Cost]` |
| [WithDimensions](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithDimensions.htm) | Belirtilen boyutları veri ürününden (dimensionlist) ana boyutlara dönüştürme talimatı veren anahtar kelime. |
| dimensionlist | Veri ürününün semantik modelinden ana boyutlara dönüştürülecek boyutların listesi.<br><br>Tüm boyutları dönüştürmek için `*` kullanabilir veya belirli boyutların virgülle ayrılmış bir listesini sağlayabilirsiniz.<br><br>Örnek:<br><br>`[Product Name], [Region], [Customer]` |

## açıklamalar

IncludeModel ifadesi, bir veri ürününü semantik modeliyle birlikte yüklemeyi seçtiğinizde genellikle veri kataloğu tarafından otomatik olarak oluşturulur. Ayrıca hangi alanların, ölçülerin ve boyutların dahil edileceğini özelleştirmek için ifadeyi manuel olarak yazabilir veya oluşturulan ifadeyi düzenleyebilirsiniz.

Semantik modelde tanımlanan ilişkiler, yüklenen tablolara otomatik olarak uygulanarak veri modelinizde ilişkilendirmeler oluşturur.

Hesaplamalar ve boyutlara yönelik işlemler, tablolar ve alanlar yüklendikten sonra veri yüklemesinin sonunda uygulanır. Yükleme o aşamadan önce başarısız olursa hiçbir ölçü veya boyut işlemi uygulanmaz.

Bilgi notuIncludeModel ifadesini kullanmak için veri ürününü içeren alanda Veri tüketebilir veya Görüntüleyebilir iznine sahip olmanız gerekir.

### Ana öğe özellikleri

Semantik modellerden devralınan ana öğelerin çoğu özniteliği, tüketen uygulamada salt okunurdur. Görselleştirmelerle ilgili olanlar gibi diğer bazı ana öğe öznitelikleri, uygulama içinde hâlâ düzenlenebilir.

Salt okunur davranış yalnızca kullanıcı arayüzü için geçerlidir—API aracılığıyla bir dizi ana öğe özelliğini ayarlayabilirsiniz:

* Semantik modelde yapılandırılabilen ancak tüketen uygulamanın kullanıcı arabiriminde salt okunur olan özellikler. Buna başlık, açıklama ve etiketler dahildir.

* Semantik modelde yapılandırılmamış ve tüketen uygulamanın kullanıcı arabiriminde gösterilmeyen özellikler.

Semantik model tarafından tanımlanan özelliklerde yapılan değişikliklerin üzerine, uygulama yeniden yüklendiğinde yazılacaktır.

### Ana öğe silme

Yayımlanmamış bir uygulamada, devralınan bir ana öğeyi silebilirsiniz; ancak IncludeModel komut dosyasında hâlâ referans veriliyorsa bir sonraki yeniden yüklemede tekrar görünür. Kalıcı olarak kaldırmak için önce komut dosyasından kaldırın. Ayrıca devralınan bir ana öğeyi çoğaltabilirsiniz. Çoğalt, sıradan bir uygulama ana öğesidir ve tamamen düzenlenebilir.

## Örnek 1 – Belirli tabloları, tüm ölçü ve boyutlarıyla birlikte yükleyin

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

#### Komut dosyasını yükle

Bu örnek; veri ürününden ve semantik modelinden belirli tabloları ve bunların ilişkilerini yükler. Ayrıca belirli tablolardan tüm alanları yüklemek için joker karakterler (\*) kullanır ve semantik modeldeki tüm ölçümlerin ve boyutların uygulamada ana öğeler olarak tanımlanması gerekir.

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

Bu IncludeModel ifadesinin bileşenleri şunlardır:

* Veri ürünü adı: `Sales Performance Data`

* Veri ürünü alanı: `Sales Analysis Space`

* Tablolar: `Transactions` ve `Products`

* Alanlar: tümü

* Hesaplamalar ve boyutlar: tümü

İki tablo ilişkileriyle birlikte yüklenir. Semantik modeldeki tüm hesaplamalar ve boyutlar uygulamada ana öğeler olarak görünecektir.

## Örnek 2 – Belirli tabloları, ölçümleri ve boyutları yükleme

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

#### Komut dosyasını yükle

Bu örnek; veri ürününden ve semantik modelinden belirli tabloları ve bunların ilişkilerini yükler. Belirli tablolardan tüm alanları yüklemek için joker karakterler (\*) kullanır. Tüm hesaplamaları ve boyutları otomatik olarak ana öğe olarak tanımlamak yerine, belirli hesaplamalar ve boyutlar ana öğe olarak tanımlanır.

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

Bu IncludeModel ifadesinin bileşenleri şunlardır:

* Veri ürünü adı: `Customer Analytics`

* Veri ürünü alanı: `sales`

* Tablolar: `Customers` ve `Orders`

* Alanlar: tümü

* Ölçüler: `Total Revenue` ve `Customer Count`

* Boyutlar: `Customer Name`

İki tablo ilişkileriyle birlikte yüklenir. Semantik modeldeki belirli hesaplamaların ve boyutların her biri uygulamada ana öğeler olarak görünür.

## Örnek 3 – Belirli tabloları tüm ölçüler ve boyutlarla birlikte yükleme (veri kümesi ortamda bulunur)

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

#### Komut dosyasını yükle

Bu örnek, bir ortam içinde yer alan bir veri alanında bulunan bir veri ürününden belirli tabloları ve bunların semantik model ilişkilerini yükler (bkz. [Ortamları senkronize etme ve yönetme](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-environments.htm)). Ayrıca belirli tablolardan tüm alanları yüklemek için joker karakterler (\*) kullanır ve semantik modeldeki tüm ölçümlerin ve boyutların uygulamada ana öğeler olarak tanımlanması gerekir.

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

Bu IncludeModel ifadesinin bileşenleri şunlardır:

* Veri ürünü adı: `Sales Performance Data`

* Veri ürünü ortamı: `Production`

* Veri ürünü alanı: `Sales Analysis Space`

* Tablolar: `Transactions` ve `Products`

* Alanlar: tümü

* Hesaplamalar ve boyutlar: tümü

İki tablo ilişkileriyle birlikte yüklenir. Semantik modeldeki tüm hesaplamalar ve boyutlar uygulamada ana öğeler olarak görünecektir.

## IncludeModel komut dosyası sınırlamaları

WithTables: \* joker karakter söz dizimi desteklenmiyor. Tabloları açıkça listelemelisiniz.

[Veri ürünlerindeki anlamsal modeller](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/semantic-models-in-data-products.htm)

[Uygulamalarda veri ürünlerini kullanma](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/consuming-data-products-apps.htm)

[Veri kataloğu](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/data-catalog.htm)