# IncludeModel

L'istruzione IncludeModel carica un prodotto dati e il relativo modello semantico, incluse tabelle, relazioni, misure e dimensioni. Le misure e le dimensioni del modello semantico appaiono automaticamente come voci principali nell'applicazione.

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]

Argomenti e parole chiave

| Argomento o parola chiave | Descrizione |
| --- | --- |
| data\_product\_name | Il nome del prodotto dati da caricare. |
| [FromSpace](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromSpace.htm), [FromCurrentSpace](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromCurrentSpace.htm), or [FromPersonalSpace](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromPersonalSpace.htm) | Parole chiave che specificano lo spazio da cui caricare il prodotto dati.<br><br>Utilizzare una delle seguenti opzioni in base alle esigenze. Se tutte queste opzioni di parole chiave vengono omesse, l'istruzione IncludeModel cerca il prodotto dati nel tuo spazio personale.<br><br><ul> <li> <p><span>FromSpace</span>: Carica il data product situato nello spazio specificato con <code>data_product_space</code>.</p> </li> <li> <p><span>FromCurrentSpace</span>: Carica il data product situato nello spazio corrente.</p> </li> <li> <p><span>FromPersonalSpace</span>: Carica il prodotto dati situato nel tuo spazio personale.</p> </li> </ul> |
| data\_product\_space | Specifica lo spazio del prodotto dati che si desidera caricare, se si utilizza FromSpace per specificare esplicitamente un particolare spazio da cui caricare. Questo non è applicabile se si utilizza FromPersonalSpace o FromCurrentSpace.<br><br>Seguire le convenzioni per l'uso delle virgolette documentate all'indirizzo [Uso delle virgolette nello script](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Esempi:<br><br>`MyAnalyticsSpace`<br>`"My Analytics Space"`<br>`[My Analytics Space]` |
| [InEnvironment](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/InEnvironment.htm) | Parola chiave che specifica di utilizzare il prodotto dati nell'ambiente specificato con `environment_name`.<br><br>Non richiesto se il data product non si trova in un ambiente. |
| environment\_name | Il nome dell'ambiente, se applicabile, contenente il prodotto dati che desideri caricare.<br><br>Seguire le convenzioni per l'uso delle virgolette documentate all'indirizzo [Uso delle virgolette nello script](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Esempi:<br><br>`Production`<br>`[Production Environment]`<br>`"Production Environment"` |
| [WithTables](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithTables.htm) | Parola chiave che specifica di utilizzare le tabelle definite nelle successive istruzioni `Table`. |
| [Table](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Table.htm) | Parola chiave che specifica l'uso di una tabella. Carica una tabella per ogni istruzione `Table`. |
| table\_name | Specifica il nome della tabella da utilizzare nel modello dati.<br><br>Seguire le convenzioni per l'uso delle virgolette documentate all'indirizzo [Uso delle virgolette nello script](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Esempi:<br><br>`MyDataTable`<br>`[My Data Table]`<br>`"My Data Table"` |
| [Fields](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Field.htm) | Parola chiave che indica di utilizzare i campi specificati (fieldlist) della tabella da integrare nel modello dati. |
| fieldlist | Elenco dei campi della tabella a cui fa riferimento la precedente istruzione `Table`.<br><br>È possibile utilizzare `*` per usare tutti i campi della tabella, oppure fornire un elenco separato da virgole di campi specifici.<br><br>Esempi:<br><br>`Amount, Quantity, Region`<br>`[Amount], [Quantity], [Region]` |
| [Connection](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Connection.htm) | Parola chiave che specifica di utilizzare il dataset specificato in `dataset_connection`. |
| dataset\_connection | Una connessione in grado di caricare il set di dati contenente la tabella a cui viene fatto riferimento.<br><br>A seconda della posizione della connessione, utilizzare uno dei seguenti formati:<br><br><ul> <li> <p><span>environment:space:connection</span> — Utilizzato per i file presenti all'interno di ambienti (contenitori per dati sincronizzati tra <span>Qlik Cloud</span> e <span>Qlik Talend Cloud</span>). Gli ambienti sono associati agli spazi (in particolare, <span>spazi dati</span>).</p> <p>Per ulteriori informazioni sugli ambienti, vedere <a href="https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-environments.htm">Sincronizzazione e gestione di ambienti</a>.</p> </li> <li> <p><span>space:connection</span> — Utilizzato per le connessioni con uno spazio come contenitore di archiviazione di primo livello o nello stesso ambiente dell'applicazione di caricamento. Potrebbe trattarsi di connessioni situate in spazi <span>condivisi</span>, <span>gestiti</span> o spazi dati.</p> <p>Ad esempio, per un dataset memorizzato localmente all'interno di <span>Qlik Cloud</span> (connessione <span>DataFiles</span>), situato in uno spazio denominato <span>Sales Analysis</span>, si utilizzerebbe quanto segue: <span>Sales Analysis:DataFiles</span></p> </li> <li> <p><span>connection</span> — Solo nome della connessione. Si riferisce alle connessioni presenti nel tuo <span>spazio personale</span>. In questo caso, la connessione sarebbe semplicemente: <span>DataFiles</span></p> </li> </ul><br><br>Esempi:<br><br>`[CustomerOrders:DataFiles]`<br>`[SalesData2026:SnowflakeSales]` |
| [WithMeasures](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithMeasures.htm) | Parola chiave che indica di convertire le misure specificate dal prodotto di dati (measurelist) in misure master. |
| measurelist | Elenco delle misure del modello semantico del data product da convertire in misure master.<br><br>È possibile utilizzare `*` per convertire tutte le misure, oppure fornire un elenco separato da virgole di misure specifiche.<br><br>Esempio:<br><br>`[Sales], [Total Quantity], [Cost]` |
| [WithDimensions](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithDimensions.htm) | Parola chiave che indica di convertire le dimensioni specificate dal prodotto dati (dimensionlist) in dimensioni master. |
| dimensionlist | Elenco delle dimensioni del modello semantico del data product da convertire in dimensioni master.<br><br>È possibile utilizzare `*` per convertire tutte le dimensioni, oppure fornire un elenco separato da virgole di dimensioni specifiche.<br><br>Esempio:<br><br>`[Product Name], [Region], [Customer]` |

## osservazioni

L'istruzione IncludeModel viene solitamente generata automaticamente dal catalogo dati quando si sceglie di caricare un prodotto dati con il suo modello semantico. È inoltre possibile scrivere l'istruzione manualmente o modificare l'istruzione generata per personalizzare quali campi, misure e dimensioni includere.

Le relazioni definite nel modello semantico vengono applicate automaticamente alle tabelle caricate, creando associazioni nel tuo modello dati.

Le operazioni per le misure e le dimensioni vengono applicate al termine del caricamento dei dati dopo che le tabelle e i campi sono stati caricati. Se il caricamento non riesce prima di tale fase, non viene applicata alcuna operazione di misura o dimensione.

Nota informaticaÈ necessario disporre dell'autorizzazione Può consumare dati o Può visualizzare nello spazio contenente il data product per utilizzare l'istruzione IncludeModel.

### Proprietà delle voci principali

La maggior parte degli attributi degli elementi master ereditati dai modelli semantici è di sola lettura nell'applicazione consumer. Alcuni altri attributi delle voci principali, come quelli relativi alle visualizzazioni, possono ancora essere modificati all'interno dell'applicazione.

Il comportamento di sola lettura si applica solo all'interfaccia utente—è possibile impostare diverse proprietà della voce principale tramite API:

* Proprietà configurabili nel modello semantico ma di sola lettura nell'interfaccia utente dell'applicazione consumer. Questo include titolo, descrizione e tag.

* Proprietà che non sono configurate nel modello semantico e non sono esposte nell'interfaccia utente dell'applicazione consumer.

Le modifiche alle proprietà definite dal modello semantico verranno sovrascritte quando l'applicazione viene ricaricata.

### Eliminazione elemento master

In un'applicazione non pubblicata, è possibile eliminare una voce principale ereditata, ma ricompare al ricaricamento successivo se vi si fa ancora riferimento nello script IncludeModel. Per rimuoverlo definitivamente, rimuovilo prima dallo script. È anche possibile duplicare una voce principale ereditata. Il duplicare è una normale voce principale dell'applicazione ed è completamente modificabile.

## Esempio 1 – Caricare tabelle specifiche, insieme a tutte le misure e le dimensioni

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

#### Carica script

Questo esempio carica tabelle specifiche, e le relative relazioni, dal data product e dal suo modello semantico. Utilizza inoltre caratteri jolly (\*) per caricare tutti i campi dalle tabelle specifiche e prevede che tutte le misure e le dimensioni nel modello semantico debbano essere definite come voci master nell'applicazione.

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

I componenti di questa istruzione IncludeModel sono:

* Nome del prodotto dati: `Sales Performance Data`

* Spazio del prodotto dati: `Sales Analysis Space`

* Tabelle: `Transactions` e `Products`

* Campi: tutti

* Misure e dimensioni: tutte

Le due tabelle vengono caricate con le relative relazioni. Tutte le misure e le dimensioni nel modello semantico appariranno come voci principali nell'applicazione.

## Esempio 2 – Caricare tabelle, misure e dimensioni specifiche

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

#### Carica script

Questo esempio carica tabelle specifiche, e le relative relazioni, dal data product e dal suo modello semantico. Utilizza i caratteri jolly (\*) per caricare tutti i campi dalle tabelle specifiche. Misure e dimensioni specifiche vengono definite come elementi master, anziché definire automaticamente tutte le misure e le dimensioni come elementi master.

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

I componenti di questa istruzione IncludeModel sono:

* Nome del prodotto dati: `Customer Analytics`

* Spazio del prodotto dati: `sales`

* Tabelle: `Customers` e `Orders`

* Campi: tutti

* Misure: `Total Revenue` e `Customer Count`

* Dimensioni: `Customer Name`

Le due tabelle vengono caricate con le relative relazioni. Ciascuna delle misure e delle dimensioni specifiche del modello semantico apparirà come voce principale nell'applicazione.

## Esempio 3 – Caricare tabelle specifiche, insieme a tutte le misure e dimensioni (dataset situato nell'ambiente)

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

#### Carica script

Questo esempio carica tabelle specifiche e le relative relazioni del modello semantico da un prodotto dati situato in uno spazio dati contenuto all'interno di un ambiente (vedere [Sincronizzazione e gestione di ambienti](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-environments.htm)). Utilizza inoltre caratteri jolly (\*) per caricare tutti i campi dalle tabelle specifiche e prevede che tutte le misure e le dimensioni nel modello semantico debbano essere definite come voci master nell'applicazione.

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

I componenti di questa istruzione IncludeModel sono:

* Nome del prodotto dati: `Sales Performance Data`

* Ambiente del prodotto dati: `Production`

* Spazio del prodotto dati: `Sales Analysis Space`

* Tabelle: `Transactions` e `Products`

* Campi: tutti

* Misure e dimensioni: tutte

Le due tabelle vengono caricate con le relative relazioni. Tutte le misure e le dimensioni nel modello semantico appariranno come voci principali nell'applicazione.

## IncludeModel limitazioni dello script

La sintassi del carattere jolly WithTables: \* non è supportata. È necessario elencare esplicitamente le tabelle.

[Modelli semantici nei prodotti dati](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/semantic-models-in-data-products.htm)

[Consumare prodotti di dati nelle applicazioni](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/consuming-data-products-apps.htm)

[Catalogo dati](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/data-catalog.htm)