Crear tablas de anotaciones
Puede crear una tabla de anotaciones en su hoja, añadiendo dimensiones, medidas y columnas editables, según sea necesario. Tras crear una tabla de anotaciones en una aplicación, los usuarios con acceso a dicha aplicación, así como permisos de escritura en la tabla de anotaciones, podrán realizar cambios en las columnas editables. Los cambios se pueden exportar posteriormente a sistemas externos.
Crear una tabla de anotaciones
Puede añadir una tabla de anotaciones a su hoja en cualquier momento.
Haga lo siguiente:
-
En el panel de activos, abra Gráficos.
-
Bajo Visualizaciones, arrastre una Tabla de anotaciones a la hoja.
Haga clic en Añadir dimensión y seleccione una dimensión o un campo.
Añada las columnas de dimensión y medida adicionales haciendo clic en
en Datos en el panel de propiedades. Se abre un menú desplegable. Seleccione una de las siguientes opciones:- Campos y elementos maestros: abre un cuadro de diálogo de búsqueda que muestra todos los campos y elementos maestros. Puede optar por agregar cualquier elemento como dimensión o medida.
- Expresión personalizada: abre un cuadro de diálogo donde puede escribir una expresión o abrir el editor de expresiones
.
Añada columnas editables haciendo clic en
en Datos en el panel de propiedades y seleccionando Columna editable.Defina una o varias claves principales para la tabla. En la tabla de anotaciones, dentro de la columna editable, haga clic en Definir y seleccione una o varias columnas de dimensión para usar como claves principales.
Para obtener más información sobre las claves principales, consulte Clave principal.
Haga clic en Guardar.
Después de crear la tabla de anotaciones, permita que los usuarios interactúen con ella y añadan cambios a las columnas editables. También puede personalizar el aspecto de la tabla de anotaciones configurando sus propiedades e incorporándola en plantillas personalizadas. Vea:
Extraer y usar los cambios
Cuando los usuarios añaden datos en columnas editables, sus cambios no se aplican al modelo de datos de la aplicación. También son temporales: los cambios se almacenan en un almacén de cambios administrado por Qlik durante 90 días, tras los cuales se eliminan.
Puede recuperar estos cambios a través de la API change-stores. Los cambios se pueden utilizar de varias maneras, entre ellas:
-
Cargar los cambios en los QVD o aplicaciones para almacenamiento permanente y uso dentro de Qlik Cloud.
-
Extraer los cambios, añadiéndolos a sistemas externos como hojas de cálculo de Excel o bases de datos SQL.
-
Integrar dinámicamente los datos en procesos automatizados, como el envío de correos electrónicos y la compra de inventario.
-
Crear sus propias aplicaciones e integrar llamadas a API change-stores en sus flujos de trabajo operativos.
Requisitos previos
Antes de poder acceder a los datos guardados en el almacén de cambios, debe poder acceder a API change-stores. Para ello, necesita:
-
Clave de API para el espacio empresarial inquilino de Qlik Cloud. Vea Administrar las claves de API.
-
Los permisos necesarios para trabajar con tablas de anotaciones, asignados por los administradores del espacio empresarial inquilino. Vea:
-
Suscripciones a Configuración de permisos para tablas de anotaciones basadas en consumo de capacidad
-
Suscripciones a Configuración de permisos para tablas de anotaciones basadas en número de usuarios
-
-
El ID del almacén de cambios. Esto se puede recuperar después de crear la tabla de anotaciones en una hoja. Vea Almacén de cambios.
Herramientas disponibles para extraer los cambios
Puede utilizar las siguientes herramientas para extraer y usar los cambios de API change-stores:
-
Qlik Automate
-
El conector REST disponible con la creación de scripts y la preparación de datos de Qlik.
Para ejemplos y casos de uso, vea:
Conceptos
Esta sección proporciona una descripción general de los conceptos fundamentales para la tabla de anotaciones.
Columna editable
En una tabla de anotaciones, las columnas editables permiten a los usuarios introducir datos sobre la marcha durante el análisis. Al guardar los cambios en una columna editable, un usuario escribe los cambios en un almacén de cambios, desde el cual pueden ser recuperados por los desarrolladores de aplicaciones e integradores.
Para obtener más información sobre dónde se crean las columnas editables, consulte Crear una tabla de anotaciones.
Después de haber añadido una columna editable, puede personalizarla aún más para adaptarla a sus necesidades.
Haga lo siguiente:
-
En el panel de propiedades, en Datos, haga clic en la columna editable.
Las propiedades de la columna se abren.
-
Puede cambiar cualquiera de las siguientes propiedades:
-
Título: cambie el título predeterminado de la columna.
-
Mostrar contenido: cambie cómo pueden editar los usuarios datos en la tabla. Puede elegir entre:
-
Selección única: especifique un conjunto de valores que los usuarios pueden seleccionar para cada celda al editar. Por ejemplo, podría añadir dos valores para los estados de los pedidos: En curso y Retrasado. Los usuarios pueden seleccionar entre estos valores cuando comenten registros de datos.
-
Entrada manual del usuario: los usuarios editan los datos escribiendo texto manualmente en las celdas.
-
-
Mostrar columna: permite alternar si la columna estará visible u oculta.
-
Ancho de columna: permite establecer el ancho de la columna.
-
Almacén de cambios
Un almacén de cambios es una ubicación de almacenamiento administrada por Qlik que contiene los cambios añadidos por el usuario desde columnas editables en una tabla de anotaciones. El almacén de cambios es una ubicación de almacenamiento temporal: los cambios se almacenan durante un máximo de 90 días, tras los cuales se eliminan.
El almacén de cambios de su tabla de anotaciones está preconfigurado para su espacio empresarial inquilino y es accesible a través de API change-stores. Con su ID de almacén de cambios, puede formular solicitudes de API y automatizaciones que sincronicen los cambios del usuario con una ubicación permanente, como una hoja de cálculo o una base de datos. Para más información, vea Extraer y usar los cambios.
Puede copiar el ID del almacén de cambios de dos maneras:
-
En el modo de edición de hoja, después de crear la tabla de anotaciones. En el panel de propiedades, en Cambiar almacén> ID de almacén de cambios, haga clic en
.Copie el ID de almacén de cambios desde el panel de propiedades.
-
En el modo de análisis, al ver la tabla de anotaciones. Haga clic en el icono
en la esquina inferior derecha. Haga clic en para copiar el ID del almacén de cambios.Copiado del ID del almacén de cambios al ver una tabla de anotaciones.
Clave principal
Para añadir columnas editables a una tabla de anotaciones, es necesario definir al menos una clave principal.
Una clave principal es un campo utilizado para vincular los cambios en las columnas editables con los datos originales del modelo de datos. Las claves principales proporcionan la asignación entre los registros de la tabla de anotaciones —que representan datos del modelo de datos— y las ediciones que los usuarios introducen en las columnas editables.
La clave principal puede ser un campo único, o podría ser una clave compuesta que abarque varios campos.
Una vez que haya definido las claves principales en una tabla de anotaciones, puede cambiarlas en cualquier momento. En el panel de propiedades, en Almacén de cambios > Claves principales, haga clic en Modificar.
La clave principal también es importante cuando extrae cambios de la API change-stores.
Uso de herramientas Qlik Cloud para extraer cambios de tablas de anotaciones
Extracción de cambios de tablas de anotaciones con Qlik Automate
Los cambios guardados en el almacén de cambios se pueden extraer utilizando los bloques Change Store en el conector Qlik Cloud Services en Qlik Automate. Este conector se conecta automáticamente a la cuenta de Qlik del propietario de la automatización, por lo que no se requieren pasos adicionales para autenticarse.
Más información acerca de Qlik Automate está disponible en Qlik Automate.
Bloques de Qlik Automate disponibles para extraer cambios de tablas de anotaciones
Listado de cambios actuales del almacén de cambios
El bloque List Current Changes From Change Store utiliza el punto de conexión de la API /changes/tabular-views y solo devolverá el valor más reciente para cada celda (es decir, devuelve los valores actuales). Devuelve estos valores como una lista de objetos en la que cada objeto contiene las claves principales y los valores de cambio. Cada registro también se amplía con una marca de tiempo updatedAt para la fecha y hora en que se realizó la última actualización del registro y un ID de usuario updatedBy para el usuario que realizó este cambio.
El bloque List Current Changes From Change Store en Qlik Automate
Mostrar el historial de cambios del almacén
El bloque List Change Store History utiliza el punto de conexión de la API /changes y devuelve el historial completo de cada celda. Si una celda se ha actualizado varias veces, este bloque devolverá cada valor, userId y la marca de tiempo updatedAt de cada actualización.
El bloque List Change Store History en Qlik Automate
Permisos
Para crear tablas de anotaciones e interactuar con la API change-stores, necesita permisos específicos. Para más información, vea Permisos en la tabla de anotaciones.