Création de tables d'annotations
Vous pouvez créer une table d'annotations sur votre feuille en ajoutant des dimensions, des mesures et des colonnes modifiables selon les besoins. Une fois la table d'annotations créée dans une application, les utilisateurs ayant accès à cette application et disposant également d'autorisations de table d'annotations pourront apporter des modifications aux colonnes modifiables. Les modifications peuvent ensuite être exportées vers des systèmes externes.
Création d'une table d'annotations
Vous pouvez ajouter une table d'annotations à votre feuille à tout moment.
Procédez comme suit :
-
Dans le panneau des ressources, ouvrez Graphiques.
-
Sous Visualisations, faites glisser une Table d'annotations sur la feuille.
Cliquez sur Ajouter une dimension et sélectionnez une dimension ou un champ.
Ajoutez des colonnes de dimension et de mesure supplémentaires en cliquant sur
sous Données dans le panneau des propriétés. Un menu déroulant s'affiche. Sélectionnez l'un des éléments suivants :- Champs et éléments principaux : ouvre une boîte de dialogue avec possibilité de recherche affichant chaque champ et chaque élément principal. Vous pouvez décider d'ajouter tout élément sous forme de dimension ou de mesure.
- Expression personnalisée : ouvre une boîte de dialogue dans laquelle vous pouvez saisir une expression ou ouvrir l'éditeur d'expression
.
Ajoutez des colonnes modifiables en cliquant sur
sous Données dans le panneau des propriétés, puis en sélectionnant Colonne modifiable.Définissez une ou plusieurs clés primaires pour la table. Dans la table d'annotations, dans la colonne modifiable, cliquez sur Définir, et sélectionnez une ou plusieurs colonnes de dimension à utiliser comme clés primaires.
Pour plus d'informations sur les clés primaires, consultez Clé primaire.
Cliquez sur Enregistrer.
Après avoir créé la table d'annotations, laissez les utilisateurs interagir avec elle et ajouter des modifications aux colonnes modifiables. Vous pouvez également personnaliser l'aspect de la table d'annotations en configurant ses propriétés et en l'intégrant à des thèmes personnalisés. Consultez :
Extraction et utilisation des modifications
Lorsque les utilisateurs ajoutent des données à des colonnes modifiables, 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 un store de modifications géré 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 Store 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 :
Concepts
Cette section fournit une vue d'ensemble des concepts fondamentaux relatifs à la table d'annotations.
Colonne modifiable
Dans une table d'annotations, les colonnes modifiables permettent aux utilisateurs de saisir des données à la volée lors de l'analyse. En enregistrant les modifications apportées à une colonne modifiable, un utilisateur les écrit dans un store de modifications, à partir duquel elles peuvent être récupérées par les développeurs et les intégrateurs d'applications.
Pour plus d'informations sur l'endroit où créer des colonnes modifiables, consultez Création d'une table d'annotations.
Après avoir ajouté une colonne modifiable, vous pouvez la personnaliser davantage pour l'adapter à vos besoins.
Procédez comme suit :
-
Dans le panneau des propriétés, sous Données, cliquez sur la colonne modifiable.
Les propriétés de colonne s'ouvrent.
-
Vous pouvez modifier toutes les propriétés suivantes :
-
Titre : modifiez le titre de colonne par défaut.
-
Afficher le contenu : modifiez la façon dont les utilisateurs peuvent modifier les données de la table. Les choix suivants s'offrent à vous :
-
Sélection unique : spécifiez un ensemble de valeurs que les utilisateurs peuvent sélectionner pour chaque cellule lors de la modification. Par exemple, vous pourriez ajouter deux valeurs pour les statuts de commande : En cours et En retard. Les utilisateurs peuvent ensuite faire leur choix entre ces valeurs lorsqu'ils commentent des enregistrements de données.
-
Saisie manuelle de l'utilisateur : les utilisateurs modifient les données en saisissant manuellement du texte dans les cellules.
-
-
Afficher la colonne : permet d'afficher ou de masquer la colonne.
-
Largeur de colonne : définissez la largeur de la colonne.
-
Store de modifications
Un store de modifications est un emplacement de stockage géré par Qlik qui contient les modifications ajoutées par l'utilisateur à des colonnes modifiables de la table d'annotations. Le store de modifications est un emplacement de stockage temporaire — les modifications sont stockées pendant un maximum de 90 jours, après quoi elles sont supprimées.
Le store de modifications de votre table d'annotations est préconfiguré pour votre client et accessible via API change-stores. Avec l'ID de votre store de modifications, vous pouvez formuler des requêtes d'API et des automatisations qui synchronisent les modifications apportées par les utilisateurs à un emplacement permanent tel qu'une feuille de calcul ou une base de données. Pour plus d'informations, consultez Extraction et utilisation des modifications.
Vous pouvez copier l'ID du store de modifications de deux manières :
-
En mode d'édition de feuille après avoir créé la table d'annotations. Dans le panneau des propriétés, sous Store de modifications > ID du store de modifications, cliquez sur
.Copie de l'ID du store de modifications depuis le panneau des propriétés.
-
En mode d'analyse lors de l'affichage de la table d'annotations. Cliquez sur l'icône
dans le coin inférieur droit. Cliquez pour copier l'ID du store de modifications.Copie de l'ID du store de modifications lors de l'affichage d'une table d'annotations.
Clé primaire
Pour ajouter des colonnes modifiables à une table d'annotations, vous devez définir au moins une clé primaire.
Une clé primaire est un champ utilisé pour lier les modifications apportées aux colonnes modifiables aux données d'origine du modèle de données. Les clés primaires assurent le mappage entre les enregistrements de la table d'annotations — qui représentent les données du modèle de données — et les modifications que les utilisateurs introduisent dans les colonnes modifiables.
La clé primaire peut être un champ unique, ou il peut s'agir d'une clé composite qui s'étend sur plusieurs champs.
Après avoir défini les clés primaires d'une table d'annotations, vous pouvez les modifier à tout moment. Dans le panneau des propriétés, sous Store de modifications > Clés primaires, cliquez sur Modifier.
La clé primaire est également importante lorsque vous extrayez les modifications de API change-stores.
Utilisation des outils Qlik Cloud pour extraire les modifications 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.
Blocs Qlik Automate disponibles pour extraire les modifications de la table d'annotations
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.
Bloc List Current Changes From Change Store dans Qlik Automate
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.
Bloc List Change Store History dans Qlik Automate
Autorisations
Pour créer des tables d'annotations et interagir avec API change-stores, vous avez besoin d'autorisations spécifiques. Pour plus d'informations, consultez Autorisations des tables d'annotations.