# IncludeModel Die Anweisung IncludeModel lädt ein Datenprodukt und dessen semantisches Modell, einschließlich Tabellen, Beziehungen, Measures und Dimensionen. Kennzahlen und Dimensionen aus dem semantischen Modell erscheinen automatisch als Master-Elemente in der Anwendung. 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] Argumente und Schlüsselwörter | Argument oder Schlüsselwort | Beschreibung | | --- | --- | | data\_product\_name | Der Name des zu ladenden Datenprodukts. | | [FromSpace](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromSpace.htm), [FromCurrentSpace](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromCurrentSpace.htm), or [FromPersonalSpace](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromPersonalSpace.htm) | Schlüsselwörter, die den Space angeben, aus dem das Datenprodukt geladen werden soll.

Verwenden Sie nach Bedarf eine der folgenden Optionen. Wenn alle diese Schlüsselwortoptionen weggelassen werden, sucht die IncludeModel-Anweisung nach dem Datenprodukt in Ihrem persönlichen Bereich.

| | data\_product\_space | Gibt den Space des Datenprodukts an, das Sie laden möchten, wenn Sie FromSpace verwenden, um explizit einen bestimmten Space anzugeben, aus dem geladen werden soll. Dies gilt nicht, wenn Sie FromPersonalSpace oder FromCurrentSpace verwenden.

Befolgen Sie die unter [Anführungszeichen im Skript verwenden](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm) dokumentierten Konventionen für Anführungszeichen. Beispiele:

`MyAnalyticsSpace`
`"My Analytics Space"`
`[My Analytics Space]` | | [InEnvironment](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/InEnvironment.htm) | Schlüsselwort, das angibt, dass das Datenprodukt in der mit `environment_name` angegebenen Umgebung verwendet werden soll.

Nicht erforderlich, wenn sich das Datenprodukt nicht in einer Umgebung befindet. | | environment\_name | Der Name der Umgebung, sofern zutreffend, die das Datenprodukt enthält, das Sie laden möchten.

Befolgen Sie die unter [Anführungszeichen im Skript verwenden](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm) dokumentierten Konventionen für Anführungszeichen. Beispiele:

`Production`
`[Production Environment]`
`"Production Environment"` | | [WithTables](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithTables.htm) | Schlüsselwort, das angibt, dass die in nachfolgenden `Table`-Anweisungen definierten Tabellen verwendet werden sollen. | | [Table](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Table.htm) | Schlüsselwort, das die Verwendung einer Tabelle angibt. Lädt eine Tabelle pro `Table`-Anweisung. | | table\_name | Gibt den Namen der Tabelle an, die im Datenmodell verwendet werden soll.

Befolgen Sie die unter [Anführungszeichen im Skript verwenden](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm) dokumentierten Konventionen für Anführungszeichen. Beispiele:

`MyDataTable`
`[My Data Table]`
`"My Data Table"` | | [Fields](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Field.htm) | Schlüsselwort, das anweist, die angegebenen Felder (fieldlist) aus der Tabelle zu verwenden, um sie in das Datenmodell zu integrieren. | | fieldlist | Liste der Felder aus der Tabelle, auf die in der vorangehenden `Table`-Anweisung verwiesen wird.

Sie können `*` verwenden, um alle Felder aus der Tabelle zu verwenden, oder eine kommagetrennte Liste bestimmter Felder angeben.

Beispiele:

`Amount, Quantity, Region`
`[Amount], [Quantity], [Region]` | | [Connection](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Connection.htm) | Schlüsselwort, das angibt, den in `dataset_connection` angegebenen Datensatz zu verwenden. | | dataset\_connection | Eine Verbindung, die das Dataset laden kann, das die referenzierte Tabelle enthält.

Je nach Standort der Verbindung verwenden Sie eines der folgenden Formate:



Beispiele:

`[CustomerOrders:DataFiles]`
`[SalesData2026:SnowflakeSales]` | | [WithMeasures](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithMeasures.htm) | Schlüsselwort, das anweist, die angegebenen Kennzahlen aus dem Datenprodukt (measurelist) in Master-Kennzahlen zu konvertieren. | | measurelist | Liste der Kennzahlen aus dem semantischen Modell des Datenprodukts, die in Master-Kennzahlen umgewandelt werden sollen.

Sie können `*` verwenden, um alle Kennzahlen zu konvertieren, oder eine kommagetrennte Liste bestimmter Kennzahlen angeben.

Beispiel:

`[Sales], [Total Quantity], [Cost]` | | [WithDimensions](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithDimensions.htm) | Schlüsselwort, das anweist, die angegebenen Dimensionen aus dem Datenprodukt (dimensionlist) in Master-Dimensionen zu konvertieren. | | dimensionlist | Liste der Dimensionen aus dem semantischen Modell des Datenprodukts, die in Master-Dimensionen umgewandelt werden sollen.

Sie können `*` verwenden, um alle Dimensionen zu konvertieren, oder eine kommagetrennte Liste bestimmter Dimensionen angeben.

Beispiel:

`[Product Name], [Region], [Customer]` | ## Remarks Die Anweisung IncludeModel wird typischerweise automatisch vom Datenkatalog generiert, wenn Sie auswählen, ein Datenprodukt mit seinem semantischen Modell zu laden. Sie können die Anweisung auch manuell schreiben oder die generierte Anweisung bearbeiten, um anzupassen, welche Felder, Kennzahlen und Dimensionen enthalten sind. Im semantischen Modell definierte Beziehungen werden automatisch auf die geladenen Tabellen angewendet, wodurch Assoziationen in Ihrem Datenmodell erstellt werden. Operationen für Kennzahlen und Dimensionen werden am Ende des Datenladevorgangs angewendet, nachdem die Tabellen und Felder geladen wurden. Wenn der Ladevorgang vor dieser Phase fehlschlägt, werden keine Kennzahlen- oder Dimensionsoperationen angewendet. InformationshinweisSie müssen im Space, der das Datenprodukt enthält, über die Berechtigung Kann Daten verbrauchen oder Kann anzeigen verfügen, um die Anweisung IncludeModel zu verwenden. ### Master-Element-Eigenschaften Die meisten Attribute von Master-Elementen, die von semantischen Modellen geerbt wurden, sind in der konsumierenden Anwendung schreibgeschützt. Einige andere Master-Element-Attribute, wie beispielsweise jene, die sich auf Visualisierungen beziehen, können weiterhin innerhalb der Anwendung bearbeitet werden. Das schreibgeschützte Verhalten gilt nur für die Benutzeroberfläche – Sie können eine Reihe von Master-Element-Eigenschaften über die API festlegen: * Eigenschaften, die im semantischen Modell konfigurierbar, aber in der Benutzeroberfläche der konsumierenden Anwendung schreibgeschützt sind. Dies umfasst Titel, Beschreibung und Tags. * Eigenschaften, die nicht im semantischen Modell konfiguriert sind und in der Benutzeroberfläche der nutzenden Anwendung nicht bereitgestellt werden. Änderungen an Eigenschaften, die durch das semantische Modell definiert sind, werden beim Neuladen der Anwendung überschrieben. ### Löschen von Master-Elementen In einer unveröffentlichten Anwendung können Sie ein vererbtes Master-Element löschen, aber es wird beim nächsten Laden wieder angezeigt, wenn im IncludeModel-Skript weiterhin darauf verwiesen wird. Um es dauerhaft zu entfernen, entfernen Sie es zuerst aus dem Skript. Sie können auch ein vererbtes Master-Element duplizieren. Das durch Duplizieren erstellte Element ist ein gewöhnliches Anwendungs-Master-Element und ist vollständig bearbeitbar. ## Beispiel 1 – Bestimmte Tabellen zusammen mit allen Kennzahlen und Dimensionen laden [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/IncludeModel.htm) #### Skript laden Dieses Beispiel lädt bestimmte Tabellen und deren Beziehungen aus dem Datenprodukt und seinem semantischen Modell. Es verwendet außerdem Platzhalter (\*), um alle Felder aus den spezifischen Tabellen zu laden, und sieht vor, dass alle Kennzahlen und Dimensionen im semantischen Modell als Master-Elemente in der Anwendung definiert werden sollen. ``` 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 *; ``` Die Komponenten dieser IncludeModel-Anweisung sind: * Datenproduktname: `Sales Performance Data` * Datenproduktbereich: `Sales Analysis Space` * Tabellen: `Transactions` und `Products` * Felder: alle * Kennzahlen und Dimensionen: alle Die beiden Tabellen werden mit ihren Beziehungen geladen. Alle Kennzahlen und Dimensionen im semantischen Modell erscheinen als Master-Elemente in der Anwendung. ## Beispiel 2 – Bestimmte Tabellen, Measures und Dimensionen laden [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/IncludeModel.htm) #### Skript laden Dieses Beispiel lädt bestimmte Tabellen und deren Beziehungen aus dem Datenprodukt und seinem semantischen Modell. Es verwendet Platzhalter (\*), um alle Felder aus den spezifischen Tabellen zu laden. Bestimmte Kennzahlen und Dimensionen werden als Master-Elemente definiert, anstatt automatisch alle Kennzahlen und Dimensionen als Master-Elemente zu definieren. ``` 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]; ``` Die Komponenten dieser IncludeModel-Anweisung sind: * Datenproduktname: `Customer Analytics` * Datenproduktbereich: `sales` * Tabellen: `Customers` und `Orders` * Felder: alle * Kennzahlen: `Total Revenue` und `Customer Count` * Abmessungen: `Customer Name` Die beiden Tabellen werden mit ihren Beziehungen geladen. Jede der spezifischen Kennzahlen und Dimensionen aus dem semantischen Modell erscheint als Master-Element in der Anwendung. ## Beispiel 3 – Bestimmte Tabellen zusammen mit allen Measures und Dimensionen laden (Dataset befindet sich in der Umgebung) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/IncludeModel.htm) #### Skript laden Dieses Beispiel lädt bestimmte Tabellen und deren Beziehungen des semantischen Modells aus einem Datenprodukt, das sich in einem Datenbereich innerhalb einer Umgebung befindet (siehe [Synchronisieren und Verwalten von Umgebungen](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-environments.htm)). Es verwendet außerdem Platzhalter (\*), um alle Felder aus den spezifischen Tabellen zu laden, und sieht vor, dass alle Kennzahlen und Dimensionen im semantischen Modell als Master-Elemente in der Anwendung definiert werden sollen. ``` 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 *; ``` Die Komponenten dieser IncludeModel-Anweisung sind: * Datenproduktname: `Sales Performance Data` * Datenproduktumgebung: `Production` * Datenproduktbereich: `Sales Analysis Space` * Tabellen: `Transactions` und `Products` * Felder: alle * Kennzahlen und Dimensionen: alle Die beiden Tabellen werden mit ihren Beziehungen geladen. Alle Kennzahlen und Dimensionen im semantischen Modell erscheinen als Master-Elemente in der Anwendung. ## IncludeModel Skript-Einschränkungen Die WithTables: \*-Wildcard-Syntax wird nicht unterstützt. Sie müssen Tabellen explizit auflisten. [Semantische Modelle in Datenprodukten](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/semantic-models-in-data-products.htm) [Verwenden von Datenprodukten in Anwendungen](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/consuming-data-products-apps.htm) [Datenkatalog](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/data-catalog.htm)