# IncludeModel

La sentencia IncludeModel carga un producto de datos y su modelo semántico, incluidas tablas, relaciones, medidas y dimensiones. Las medidas y dimensiones del modelo semántico aparecen automáticamente como elementos maestros en la aplicación.

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]

Argumentos y palabras clave

| Argumento o palabra clave | Descripción |
| --- | --- |
| data\_product\_name | El nombre del producto de datos que se ha de cargar. |
| [FromSpace](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromSpace.htm), [FromCurrentSpace](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromCurrentSpace.htm), or [FromPersonalSpace](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromPersonalSpace.htm) | Palabras clave que especifican el espacio desde el que cargar el producto de datos.<br><br>Utilice uno de los siguientes según sea necesario. Si se omiten todas estas opciones de palabra clave, la sentencia IncludeModel busca el producto de datos en su espacio personal.<br><br><ul> <li> <p><span>FromSpace</span>: carga el producto de datos ubicado en el espacio especificado con <code>data_product_space</code>.</p> </li> <li> <p><span>FromCurrentSpace</span>: carga el producto de datos ubicado en el espacio actual.</p> </li> <li> <p><span>FromPersonalSpace</span>: carga el producto de datos ubicado en su espacio personal.</p> </li> </ul> |
| data\_product\_space | Especifique el espacio del producto de datos que desea cargar, si está utilizando FromSpace para especificar explícitamente un espacio concreto desde el que cargar. Esto no es aplicable si está utilizando FromPersonalSpace o FromCurrentSpace.<br><br>Siga las convenciones de entrecomillado detalladas en [Uso de las comillas en el script](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Ejemplos:<br><br>`MyAnalyticsSpace` `"My Analytics Space"` `[My Analytics Space]` |
| [InEnvironment](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/InEnvironment.htm) | Palabra clave que especifica utilizar el producto de datos en el entorno especificado con `environment_name`.<br><br>No es necesario si el producto de datos no se encuentra en un entorno. |
| environment\_name | El nombre del entorno, si procede, que contiene el producto de datos que desea cargar.<br><br>Siga las convenciones de entrecomillado detalladas en [Uso de las comillas en el script](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Ejemplos:<br><br>`Production` `[Production Environment]` `"Production Environment"` |
| [WithTables](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithTables.htm) | Palabra clave que especifica el uso de las tablas definidas en las sentencias `Table` subsiguientes. |
| [Table](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Table.htm) | Palabra clave que especifica el uso de una tabla. Carga una tabla por sentencia `Table`. |
| table\_name | Especifica el nombre de la tabla que se utilizará en el modelo de datos.<br><br>Siga las convenciones de entrecomillado detalladas en [Uso de las comillas en el script](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Ejemplos:<br><br>`MyDataTable` `[My Data Table]` `"My Data Table"` |
| [Fields](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Field.htm) | Palabra clave que indica utilizar los campos especificados (fieldlist) de la tabla para integrarlos en el modelo de datos. |
| fieldlist | Lista de campos de la tabla referenciada en la sentencia `Table` anterior.<br><br>Puede utilizar `*` para usar todos los campos de la tabla o proporcionar una lista separada por comas de campos específicos.<br><br>Ejemplos:<br><br>`Amount, Quantity, Region` `[Amount], [Quantity], [Region]` |
| [Connection](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Connection.htm) | Palabra clave que especifica el uso del conjunto de datos especificado en `dataset_connection`. |
| dataset\_connection | Una conexión que pueda cargar el conjunto de datos que contiene la tabla referenciada.<br><br>En función de la ubicación de la conexión, utilice uno de los siguientes formatos:<br><br><ul> <li> <p><span>environment:space:connection</span> — Se utiliza para archivos ubicados dentro de entornos (contenedores para datos sincronizados entre <span>Qlik Cloud</span> y <span>Qlik Talend Cloud</span>). Los entornos están asociados a espacios (en particular, <span>espacios de datos</span>).</p> <p>Para más información sobre los entornos, vea <a href="https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-environments.htm">Sincronización y administración de entornos</a>.</p> </li> <li> <p><span>space:connection</span> — Se utiliza para conexiones con un espacio como contenedor de almacenamiento de nivel superior o en el mismo entorno que la aplicación de carga. Podrían ser conexiones ubicadas en espacios <span>compartidos</span>, <span>administrados</span> o de datos.</p> <p>Por ejemplo, para un conjunto de datos almacenado localmente en <span>Qlik Cloud</span> (conexión <span>DataFiles</span>), ubicado en un espacio denominado <span>Sales Analysis</span>, utilizaría lo siguiente: <span>Sales Analysis:DataFiles</span></p> </li> <li> <p><span>connection</span> — Solo el nombre de la conexión. Esto hace referencia a conexiones ubicadas en su <span>espacio personal</span>. En este caso, la conexión sería simplemente: <span>DataFiles</span></p> </li> </ul><br><br>Ejemplos:<br><br>`[CustomerOrders:DataFiles]` `[SalesData2026:SnowflakeSales]` |
| [WithMeasures](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithMeasures.htm) | Palabra clave que indica que se conviertan las medidas especificadas del producto de datos (measurelist) en medidas maestras. |
| measurelist | Lista de las medidas del modelo semántico del producto de datos que se van a convertir en medidas maestras.<br><br>Puede utilizar `*` para convertir todas las medidas, o bien aportar una lista de medidas específicas separadas por comas.<br><br>Ejemplo:<br><br>`[Sales], [Total Quantity], [Cost]` |
| [WithDimensions](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithDimensions.htm) | Palabra clave que indica que se conviertan las dimensiones especificadas del producto de datos (dimensionlist) en dimensiones maestras. |
| dimensionlist | Lista de las dimensiones del modelo semántico del producto de datos que se van a convertir en dimensiones maestras.<br><br>Puede utilizar `*` para convertir todas las dimensiones o proporcionar una lista de dimensiones específicas separadas por comas.<br><br>Ejemplo:<br><br>`[Product Name], [Region], [Customer]` |

## Comentarios

La sentencia IncludeModel suele generarse automáticamente por el catálogo de datos cuando elige cargar un producto de datos con su modelo semántico. También puede escribir la sentencia manualmente o editar la sentencia generada para personalizar qué campos, medidas y dimensiones se incluyen.

Las relaciones definidas en el modelo semántico se aplican automáticamente a las tablas cargadas, creando asociaciones en su modelo de datos.

Las operaciones para medidas y dimensiones se aplican al final de la carga de datos después de que se carguen las tablas y los campos. Si la carga falla antes de esa fase, no se aplica ninguna operación de medidas o dimensiones.

Nota informativaDebe tener el permiso Puede consumir datos o Puede ver en el espacio que contiene el producto de datos para utilizar la sentencia IncludeModel.

### Propiedades de los elementos maestros

La mayoría de atributos de los elementos maestros heredados de modelos semánticos son de solo lectura en la aplicación de consumo. Algunos otros atributos de los elementos maestros, como los relacionados con las visualizaciones, se pueden seguir editando dentro de la aplicación.

El comportamiento de solo lectura se aplica únicamente a la interfaz de usuario: puede configurar varias propiedades de los elementos maestros a través de la API:

* Propiedades que son configurables en el modelo semántico pero de solo lectura en la interfaz de usuario de la aplicación de consumo. Esto incluye el título, la descripción y las etiquetas.

* Propiedades que no están configuradas en el modelo semántico y no están expuestas en la interfaz de usuario de la aplicación de consumo.

Los cambios en las propiedades definidas por el modelo semántico se ignorarán al recargar la aplicación.

### Eliminar elementos maestros

En una aplicación no publicada, puede eliminar un elemento maestro heredado, pero reaparecerá en la siguiente recarga si todavía se hace referencia a él en el script IncludeModel. Para eliminarlo de forma permanente, elimínelo primero del script. También puede duplicar un elemento maestro heredado. El elemento duplicado es un elemento maestro normal de una aplicación y es totalmente editable.

## Ejemplo 1 – Cargar tablas específicas, junto con todas las medidas y dimensiones

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

#### Script de carga

Este ejemplo carga tablas específicas, y sus relaciones, a partir del producto de datos y su modelo semántico. También utiliza caracteres comodín (\*) para cargar todos los campos de las tablas específicas y que todas las medidas y dimensiones del modelo semántico se definan como elementos maestros en la aplicación.

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

Los componentes de esta sentencia IncludeModel son:

* Nombre del producto de datos: `Sales Performance Data`

* Espacio de producto de datos: `Sales Analysis Space`

* Tablas: `Transactions` y `Products`

* Campos: todos

* Medidas y dimensiones: todas

Las dos tablas se cargan con sus relaciones. Todas las medidas y dimensiones del modelo semántico aparecerán como elementos maestros en la aplicación.

## Ejemplo 2 – Cargar tablas, medidas y dimensiones específicas

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

#### Script de carga

Este ejemplo carga tablas específicas, y sus relaciones, a partir del producto de datos y su modelo semántico. Utiliza caracteres comodín (\*) para cargar todos los campos de las tablas específicas. Se definen medidas y dimensiones específicas como elementos maestros, en lugar de definir automáticamente todas las medidas y dimensiones como elementos maestros.

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

Los componentes de esta sentencia IncludeModel son:

* Nombre del producto de datos: `Customer Analytics`

* Espacio del producto de datos: `sales`

* Tablas: `Customers` y `Orders`

* Campos: todos

* Medidas: `Total Revenue` y `Customer Count`

* Dimensiones: `Customer Name`

Las dos tablas se cargan con sus relaciones. Cada una de las medidas y dimensiones específicas del modelo semántico aparecerá como elemento maestro en la aplicación.

## Ejemplo 3 – Cargar tablas específicas, junto con todas las medidas y dimensiones (conjunto de datos ubicado en el entorno)

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

#### Script de carga

Este ejemplo carga tablas específicas y sus relaciones de modelo semántico desde un producto de datos ubicado en un espacio de datos contenido dentro de un entorno (vea [Sincronización y administración de entornos](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-environments.htm)). También utiliza caracteres comodín (\*) para cargar todos los campos de las tablas específicas y que todas las medidas y dimensiones del modelo semántico se definan como elementos maestros en la aplicación.

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

Los componentes de esta sentencia IncludeModel son:

* Nombre del producto de datos: `Sales Performance Data`

* Entorno del producto de datos: `Production`

* Espacio de producto de datos: `Sales Analysis Space`

* Tablas: `Transactions` y `Products`

* Campos: todos

* Medidas y dimensiones: todas

Las dos tablas se cargan con sus relaciones. Todas las medidas y dimensiones del modelo semántico aparecerán como elementos maestros en la aplicación.

## Limitaciones del script de IncludeModel

No se admite la sintaxis de comodines WithTables: \*. Debe enumerar las tablas de forma explícita.

[Modelos semánticos en productos de datos](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/semantic-models-in-data-products.htm)

[Consumir productos de datos en aplicaciones](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/consuming-data-products-apps.htm)

[Catálogo de datos](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/data-catalog.htm)