Consumir productos de datos en aplicaciones

Los desarrolladores de aplicaciones de analítica pueden cargar productos de datos, con sus modelos semánticos, en apps de analítica mediante el catálogo de datos. El catálogo de datos genera el script necesario y crea elementos maestros para medidas y dimensiones.

Cuando consume un producto de datos, el catálogo de datos genera una sentencia de script IncludeModel que carga las tablas, relaciones, medidas y dimensiones seleccionadas en su aplicación. Las medidas y dimensiones del modelo semántico aparecen automáticamente como elementos maestros, listos para usarse en visualizaciones.

Requisitos previos

Para consumir un producto de datos y su modelo semántico, necesita:

Permisos

Para consumir el modelo semántico de los productos de datos en espacios compartidos, administrados y de datos, necesita el permiso Puede consumir datos o Puede ver en el espacio que contiene el producto de datos.

Para ver todos los detalles, consulte Roles y permisos en los productos de datos.

Acceso a conjuntos de datos

Debe tener acceso a los conjuntos de datos, así como a las conexiones a los datos subyacentes, las cuales se incluyen en el modelo semántico.

Nombre de producto de datos único

El producto de datos debe tener un nombre único dentro del espacio. Si una aplicación ya contiene un producto de datos con el mismo nombre, la carga del modelo semántico fallará.

Consumir un producto de datos y un modelo semántico a través del producto de datos

Puede crear una aplicación analítica directamente desde un producto de datos. Puede precisar qué utilizar del producto de datos y su modelo semántico: conjuntos de datos, campos y elementos maestros.

1. Abra el producto de datos, ya sea seleccionando uno del mercado de datos o explorando el catálogo.

2. En el encabezado del nombre del producto de datos, haga clic en Usar en > Aplicación.

   

3. En la ventana Crear una nueva aplicación, revise el modelo semántico y los datos que se cargarán.
4. Haga clic en Continuar.

   Se abre la Editor de carga de datos de la aplicación recién creada y se le dirige al catálogo de datos. El producto de datos está seleccionado de forma predeterminada, pero puede examinar, afinar su selección y revisar los datos antes de cargarlos en la aplicación. Para más información, vea Consumir un producto de datos y un modelo semántico mediante el Editor de carga de datos.

5. Cuando esté listo, haga clic en Cargar datos.

Una vez cargados los datos, puede empezar a añadir hojas y trabajar en su aplicación, o navegar hasta el Editor de carga de datos para inspeccionar y modificar el script si es necesario. Las tablas, relaciones, medidas y dimensiones del modelo semántico ya están disponibles para su uso.

Para más información sobre cómo visualizar datos en las hojas, vea Crear análisis y visualizar datos.

Consumir un producto de datos y un modelo semántico mediante el Editor de carga de datos

El catálogo de datos ofrece una interfaz donde examinar y seleccionar datos e información del modelo semántico a partir de productos de datos, en lugar de tener que insertar el script manualmente.

Para cargar un producto de datos y su modelo semántico:

1. Abra una aplicación.
2. Haga clic en el Editor de carga de datos en la barra de navegación superior.
3. En el panel derecho Añadir datos, haga clic en Añadir desde el catálogo de datos.
4. Se abre la ventana modal del catálogo de datos, que muestra los datos disponibles, incluidos los productos de datos con modelos semánticos.

   

Explorar productos de datos

El catálogo de datos muestra productos de datos que contienen modelos semánticos. Puede explorar y buscar productos de datos por nombre, descripción o etiquetas.

Haga clic en un producto de datos para ver un resumen de lo que se cargará en el script de la aplicación, incluidas tablas, medidas y dimensiones.

Si un conjunto de datos en el modelo semántico está inaccesible, esto se marca mediante un indicador de advertencia. Aún podrá consumir las medidas y dimensiones relacionadas con él que se encuentren en el modelo semántico, pero los conjuntos de datos inaccesibles y sus campos quedarán excluidos.

Seleccionar y refinar un modelo semántico

Después de seleccionar qué producto de datos utilizar, puede refinar su selección y elegir con precisión qué componentes del modelo semántico incluir en su aplicación.

1. Pase el ratón sobre el producto de datos seleccionado y haga clic en Refinar la selección.

   

   Hay tres nuevas pestañas disponibles en las que puede navegar por los elementos del producto de datos:

   • Tablas/campos
   • Dimensiones
   • Medidas
2. Utilice las casillas de verificación para refinar la selección y elegir qué conjuntos de datos, campos, medidas y dimensiones incluir.
Nota de sugerencia

Los usuarios avanzados pueden activar o desactivar Incluir automáticamente elementos agregados al recargar para controlar si los nuevos elementos se incluyen automáticamente cuando cambia el modelo semántico.

Cuando está habilitado, los nuevos campos, medidas y dimensiones que se añadan al modelo semántico se agregan automáticamente al modelo de datos y a los elementos maestros tras la recarga. Esto solo se aplica cuando se seleccionan todos los campos, medidas y dimensiones, respectivamente.

3. Cuando la selección esté lista, haga clic en Insertar script.

El script IncludeModel generado se inserta en el script de carga y se puede ver y editar en Editor de carga de datos. Para cargar los datos en la aplicación, haga clic en Cargar datos.

Una vez cargados los datos, puede empezar a añadir hojas y trabajar en la aplicación. Para más información, vea Crear análisis y visualizar datos.

Comprender la inclusión automática

La función de inclusión automática controla cómo responde su aplicación cuando cambia el modelo semántico.

Cuando la inclusión automática está habilitada para un tipo de componente, el script generado utiliza un selector comodín (*):

• Fields *: incluye todos los campos de la tabla especificada.
• WithMeasures: *: incluye todas las medidas como elementos maestros.
• WithDimensions: *: incluye todas las dimensiones como elementos maestros.

Cuando la inclusión automática está deshabilitada, el script enumera explícitamente los elementos seleccionados. Por ejemplo:

• WithMeasures [Total sales], [Total quantity]: incluye solo las medidas especificadas.
• WithDimensions [Region], [Product]: incluye solo las dimensiones especificadas.

Se recomienda la inclusión automática para usuarios avanzados a fin de reducir el mantenimiento y garantizar que su aplicación se beneficie de las mejoras del modelo semántico. Desactive la inclusión automática si necesita un control estricto sobre qué elementos se incluyen.

Comprender el script IncludeModel generado

Los datos generan una sentencia de script IncludeModel que hace referencia al modelo semántico y especifica qué componentes cargar.

Script a modo de ejemplo:

IncludeModel [My Example Data Product] FromSpace [My Shared Space]
WithTables
  Table [dataset_dim_dateinfo] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_customer] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_fact_transactions] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_category] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_sales_rep] Fields * Connection [My Shared Space:DataFiles]
WithMeasures *
WithDimensions *;

Parámetros del script:

• IncludeModel: el nombre del producto de datos que contiene el modelo semántico.
• FromSpace: especifica el espacio que contiene el producto de datos.
• WithTables: especifica qué tablas incluir.
• Table: especifica una tabla que se ha de incluir. Puede agregar sentencias Table para cada tabla que desee utilizar, separadas por comas.
• Fields: especifica qué campos incluir de la tabla especificada. Utilice * para todos los campos o una lista de campos separados por comas.
• Connection: especifica la ubicación de la tabla mediante el formato environment:space:connection, space:connection o connection.
• WithMeasures: especifica qué medidas incluir como medidas maestras. Utilice * para todas las medidas o una lista de nombres de medidas específicos.
• WithDimensions: especifica qué dimensiones incluir como dimensiones maestras. Utilice * para todas las dimensiones o una lista de nombres de dimensiones específicos.

Puede editar manualmente la sentencia IncludeModel para ajustar qué elementos se incluyen o para cambiar entre los modos de selección comodín y explícito.

Para obtener todos los detalles sobre la sentencia IncludeModel, consulte IncludeModel.

Asignar nombres a campos y tablas

Cuando un producto de datos se carga en una aplicación, los nombres de campo y de tabla se pueden ajustar automáticamente para evitar conflictos de asignación de nombres y transformar las relaciones en asociaciones basadas en nombres siguiendo los patrones analíticos de Qlik.

• Campos con el mismo nombre sin una relación: si dos tablas contienen un campo con el mismo nombre pero los campos no tienen una relación, los nombres de los campos se calificarán automáticamente con el nombre de su tabla (por ejemplo, TableName.FieldName) para evitar una asociación automática no intencionada en la aplicación.
• Campos que tienen una relación: si los dos campos tienen una relación pero nombres diferentes, se renombrarán con el mismo nombre, el nombre de la relación, al cargarse en una aplicación para formar una asociación.

• Claves compuestas: para las claves compuestas, se añadirá un nuevo campo clave a las tablas implicadas.

• Tablas con el mismo nombre: si dos tablas tienen el mismo nombre, se renombrarán automáticamente añadiéndose un sufijo numérico, por ejemplo TableName_1, TableName_2, y así sucesivamente.

Trabajar con elementos maestros heredados

Cuando recarga una aplicación que incluye una sentencia IncludeModel, las medidas y dimensiones del modelo semántico aparecen automáticamente en el panel de elementos maestros.

Para utilizar elementos maestros de un modelo semántico:

1. Recargue la aplicación para cargar datos del modelo semántico.
2. Abra una hoja en modo de edición.
3. En el panel izquierdo, haga clic en Elementos maestros.
4. Las medidas y dimensiones del modelo semántico aparecen en la lista con un indicador de producto de datos.

   

5. Arrastre una medida o dimensión maestra a una visualización para utilizarla.

Los elementos maestros heredados de los modelos semánticos muestran el nombre y la descripción de su producto de datos de origen. Puede ver la expresión utilizada por la medida o dimensión al pasar el cursor sobre ella.

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.

Elementos maestros y publicación de aplicaciones

Cuando se publica una aplicación, sus elementos maestros heredados permanecen fijos en la versión del producto de datos utilizada cuando se publicó la aplicación. Recargar una aplicación publicada no crea, actualiza ni elimina elementos maestros del producto de datos. Para utilizar medidas y dimensiones nuevas o modificadas, actualice la aplicación y publíquela de nuevo.

Abordar las actualizaciones del modelo semántico en una aplicación

Si el modelo semántico cambia después de haberlo consumido, puede actualizar su aplicación para reflejar los cambios.

Si utilizó el modo de inclusión automática con selectores comodín, las nuevas medidas y dimensiones se incluirán automáticamente. Si utilizó la selección explícita, solo se cargarán los elementos que seleccionó originalmente.

Para añadir nuevos elementos del modelo semántico:

1. Abra el Editor de carga de datos.
2. Localice la sentencia IncludeModel en su script.
3. Edite la sentencia para añadir nuevos elementos o cambiar los selectores a * para la inclusión automática.
4. Recargue la aplicación.

Como alternativa, puede eliminar la sentencia IncludeModel existente y usar el catálogo de datos para generar una nueva con las selecciones actualizadas.

Consumir productos de datos en otras herramientas

En Script, es posible consumir productos de datos, pero las medidas y dimensiones se ignoran.

Al consumir productos de datos en activos distintos de aplicaciones y scripts (como flujos de datos y recetas de tabla), el producto de datos actúa como un conjunto de conjuntos de datos de confianza entre los que elegir. Estas herramientas utilizan los conjuntos de datos como orígenes y el producto de datos no se muestra como un nodo de origen en el linaje.