Extraction des modifications des tables d'annotations

Lorsque les utilisateurs ajoutent des données dans des colonnes modifiables au sein de tables d'annotations, leurs modifications ne sont pas appliquées au modèle de données de l'application. Elles sont également temporaires — les modifications sont stockées dans des stores de modifications gérés par Qlik pendant 90 jours, après quoi elles sont supprimées.

Vous pouvez récupérer ces modifications via API change-stores. Vous pouvez utiliser les modifications de diverses manières, notamment :

• Chargez les modifications dans des QVD ou des applications pour leur stockage permanent et leur utilisation au sein de Qlik Cloud.

• Extrayez les modifications et ajoutez-les à des systèmes externes tels que des feuilles de calcul Excel ou des bases de données SQL.

• Intégrez dynamiquement les données à des processus automatisés tels que l'envoi d'e-mails et l'achat de stocks.

• Créez vos propres applications et intégrez des appels à API change-stores dans vos flux de travail opérationnels.

Conditions préalables requises

Avant de pouvoir accéder aux données enregistrées dans le store de modifications, vous devez pouvoir accéder à API change-stores. Pour ce faire, vous avez besoin des éléments suivants :

• La clé API du Qlik Cloud client. Consultez Gestion des clés API.

• Les autorisations requises pour pouvoir utiliser des tables d'annotations, attribuées par les administrateurs de clients. Consultez :

  • Définition des autorisations relatives aux tables d'annotations (abonnements basés sur la capacité)

  • Définition des autorisations relatives aux tables d'annotations (abonnements basés sur les utilisateurs)

• L'ID du store de modifications. Celui-ci peut être récupéré après la création de la table d'annotations sur une feuille. Consultez Utilisation de stores de modifications.

Outils disponibles pour l'extraction des modifications

Vous pouvez utiliser les outils suivants pour extraire et utiliser les modifications de API change-stores :

• Qlik Automate

• Le connecteur REST disponible avec la rédaction de scripts et la préparation de données Qlik.

Pour des exemples et des cas d'utilisation, consultez :

• Extraction des modifications de la table d'annotations via Qlik Automate

• Extraction des modifications de la table d'annotations via le connecteur REST

• Cas d'utilisation des tables d'annotations

Extraction des modifications de la table d'annotations via Qlik Automate

Les modifications enregistrées dans le store de modifications peuvent être extraites via les blocs Change Store du connecteur Qlik Cloud Services dans Qlik Automate. Ce connecteur se connecte automatiquement au compte Qlik du propriétaire de l'automatisation ; il n'y a donc aucune étape supplémentaire requise pour l'authentification.

Vous trouverez plus d'informations à propos de Qlik Automate dans Qlik Automate.

Liste des modifications actuelles du store de modifications

Le bloc List Current Changes From Change Store utilise le point de terminaison d'API /changes/tabular-views et ne renverra que la valeur la plus récente de chaque cellule (en d'autres termes, il renvoie les valeurs actuelles). Il renvoie ces valeurs sous forme de liste d'objets dans laquelle chaque objet contient les clés primaires et les valeurs de modification. À chaque enregistrement est également ajouté un horodatage updatedAt indiquant la date et l'heure de la dernière mise à jour de l'enregistrement et un ID utilisateur updatedBy indiquant l'utilisateur qui a effectué cette modification.

Liste de l'historique des stores de modifications

Le bloc List Change Store History utilise le point de terminaison d'API /changes et renvoie l'historique complet de chaque cellule. Si une cellule a été mise à jour plusieurs fois, ce bloc renverra chaque valeur, userId et l'horodatage updatedAt de chaque mise à jour.

Utilisation de modèles

Vous pouvez également commencer par un modèle d'automatisation si vous extrayez les données dans une base de données MySQL. Les modèles suivants sont disponibles sous Insights to Action :

• Extract Change Store Data to a MySQL Database

• Extract Change Store Data to a MySQL Database in Bulk

Ces modèles organisent les blocs Change Store (décrits ci-dessus) avec d'autres blocs pour vous aider à extraire les données plus rapidement. Il suffit d'ajuster les paramètres des blocs pour vous connecter à vos ressources. Pour une présentation détaillée, consultez cet article de la Communauté.

Extraction des modifications de la table d'annotations via le connecteur REST

Cet exemple montre comment configurer une connexion REST à API change-stores. Cette connexion peut être utilisée pour effectuer une extraction de l'API, puis charger de nouveau les modifications dans une application ou les stocker dans des QVD au sein de Qlik Cloud.

Procédez comme suit :

1. Dans Qlik Cloud Analytics, créez une nouvelle connexion au connecteur REST. Consultez Ajout de connexions de données.

2. Définissez les paramètres suivants pour la connexion :

   • 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