IncludeModel

Última actualización: 2026-11-03

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, FromCurrentSpace, or FromPersonalSpace	Palabras clave que especifican el espacio desde el que cargar el producto de datos. 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. FromSpace: carga el producto de datos ubicado en el espacio especificado con data_product_space. FromCurrentSpace: carga el producto de datos ubicado en el espacio actual. FromPersonalSpace: carga el producto de datos ubicado en su espacio personal.
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. Siga las convenciones de entrecomillado detalladas en Uso de las comillas en el script. Ejemplos: MyAnalyticsSpace "My Analytics Space" [My Analytics Space]
InEnvironment	Palabra clave que especifica utilizar el producto de datos en el entorno especificado con environment_name. 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. Siga las convenciones de entrecomillado detalladas en Uso de las comillas en el script. Ejemplos: Production [Production Environment] "Production Environment"
WithTables	Palabra clave que especifica el uso de las tablas definidas en las sentencias Table subsiguientes.
Table	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. Siga las convenciones de entrecomillado detalladas en Uso de las comillas en el script. Ejemplos: MyDataTable [My Data Table] "My Data Table"
Fields	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. Puede utilizar * para usar todos los campos de la tabla o proporcionar una lista separada por comas de campos específicos. Ejemplos: Amount, Quantity, Region [Amount], [Quantity], [Region]
Connection	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. En función de la ubicación de la conexión, utilice uno de los siguientes formatos: environment:space:connection — Se utiliza para archivos ubicados dentro de entornos (contenedores para datos sincronizados entre Qlik Cloud y Qlik Talend Cloud). Los entornos están asociados a espacios (en particular, espacios de datos). Para más información sobre los entornos, vea Sincronización y administración de entornos. space:connection — 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 compartidos, administrados o de datos. Por ejemplo, para un conjunto de datos almacenado localmente en Qlik Cloud (conexión DataFiles), ubicado en un espacio denominado Sales Analysis, utilizaría lo siguiente: Sales Analysis:DataFiles connection — Solo el nombre de la conexión. Esto hace referencia a conexiones ubicadas en su espacio personal. En este caso, la conexión sería simplemente: DataFiles Ejemplos: [CustomerOrders:DataFiles] [SalesData2026:SnowflakeSales]
WithMeasures	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. Puede utilizar * para convertir todas las medidas, o bien aportar una lista de medidas específicas separadas por comas. Ejemplo: [Sales], [Total Quantity], [Cost]
WithDimensions	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. Puede utilizar * para convertir todas las dimensiones o proporcionar una lista de dimensiones específicas separadas por comas. Ejemplo: [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.

Debe 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

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

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)

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). 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

Consumir productos de datos en aplicaciones

Catálogo de datos

¿Esta página le ha sido útil?

Si encuentra algún problema con esta página o su contenido (errores tipográficos, pasos que faltan o errores técnicos), no dude en ponerse en contacto con nosotros.

Deje aquí sus comentarios