Extraer los cambios de las tablas de anotaciones

Cuando los usuarios añaden datos en columnas editables dentro de las tablas de anotaciones, sus cambios no se aplican al modelo de datos de la aplicación. También son temporales: los cambios se almacenan en almacenes de cambios gestionados por Qlik durante 90 días, tras lo cual se eliminan.

Puede recuperar estos cambios mediante 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 Trabajar con almacenes 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:

• Extracción de cambios de tablas de anotaciones con Qlik Automate

• Extraer cambios en tablas de anotaciones con el conector REST

• Casos de uso para 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.

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.

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.

Trabajar con plantillas

También puede empezar con una plantilla de automatización si está extrayendo los datos a una base de datos MySQL. Las siguientes plantillas están disponibles en Insights to Action:

• Extract Change Store Data to a MySQL Database

• Extract Change Store Data to a MySQL Database in Bulk

Estas plantillas organizan los bloques Change Store (descritos anteriormente) con otros bloques para ayudarle a extraer los datos más rápidamente. Simplemente ajuste los parámetros del bloque para conectarse a sus recursos. Para un tutorial detallado, consulte este artículo de Qlik Community.

Extraer cambios en tablas de anotaciones con el conector REST

Este ejemplo muestra cómo puede configurar una conexión REST a API change-stores.Esta conexión se puede usar para extraer datos de la API, y luego cargar los cambios de nuevo en una aplicación o almacenarlos en QVD dentro de Qlik Cloud.

Haga lo siguiente:

1. En Qlik Cloud Analytics, cree una nueva conexión al conector REST. Vea Agregar conexiones de datos.

2. Configure los siguientes parámetros para la conexión:

   • URL: <your_tenant_base_URL>/api/analytics/change-stores/<your change store id>/changes/tabular-views

   • Additional request parameters

     • Query parameters

       • Limit (Key): 100 (Value)

     • Query headers

       • Authorization (Key): Bearer <your_API_token> (Value)

   • Pagination type: Next URL

     • 'Next url' path: links/next/href