Table d'annotations

Dans la Table d'annotations, vous pouvez apporter des modifications aux colonnes modifiables lors de l'analyse des données. Vos modifications peuvent être utilisées par les développeurs d'analyses pour mettre en œuvre des processus automatisés en temps réel et garantir la qualité des données.

Utilisation des tables d'annotations

Ce processus explique comment intégrer la table d'annotations dans vos opérations, du développement à l'analyse et aux actions axées sur les données.

1. Création d'une table d'annotations

   Le développeur d'applications commence par créer la table d'annotations. Il doit définir une clé primaire basée sur une ou plusieurs dimensions dans la table d'annotations, puis ajouter des colonnes modifiables qui peuvent être utilisées pour recueillir les modifications des utilisateurs.

   Création d'une table d'annotations

2. Utilisation de la table d'annotations

   Les utilisateurs interagissent avec le graphique et apportent des modifications aux colonnes modifiables. Par exemple, les utilisateurs peuvent ajouter des mises à jour concernant les statuts de commande, les stocks ou les retours d'information des clients.

   Les modifications sont enregistrées pendant 90 jours dans un store de modifications fourni par Qlik.

   Interaction avec une table d'annotations

3. Extraction des modifications

   Les développeurs d'applications récupèrent les modifications auprès du store de modifications via l'API. Les modifications peuvent être sauvegardées de manière permanente dans Qlik Cloud ou sur des systèmes externes et utilisées dans des opérations automatisées—par exemple, l'achat automatisé de stocks en un clic sur un bouton.

   Extraction et utilisation des modifications de la table d'annotations

   Utilisation des outils Qlik Cloud pour extraire les modifications des tables d'annotations

Interaction avec une table d'annotations

Vous pouvez ajouter des modifications aux colonnes modifiables dans la table d'annotations. Selon la façon dont le graphique a été configuré par le développeur d'applications, il existe deux façons d'ajouter des modifications : la saisie manuelle et la sélection unique. Après avoir effectué vos modifications, enregistrez-les afin qu'elles soient envoyées au store de modifications et deviennent visibles aux autres utilisateurs.

Saisie manuelle

Avec la saisie manuelle, vous saisissez directement des informations dans les cellules de la colonne modifiable.

Procédez comme suit :

1. Dans une colonne modifiable, cliquez sur une cellule que vous souhaitez modifier.

2. Saisissez le texte souhaité.

3. Cliquez sur Enregistrer.

Les modifications sont enregistrées dans le store de modifications.

Sélection unique

Avec la sélection unique, vous utilisez un menu déroulant pour faire votre choix parmi des valeurs préconfigurées.

Procédez comme suit :

1. Dans une colonne modifiable, cliquez sur une cellule que vous souhaitez modifier.

2. Sélectionnez l'option souhaitée.

3. Cliquez sur Enregistrer.

Les modifications sont enregistrées dans le store de modifications.

Autres interactions

Pour les autres actions, vous pouvez interagir avec une table d'annotations comme vous le faites avec d'autres graphiques basés sur des tables.

Procédure de sélection

Dans une table d'annotations, vous pouvez effectuer des sélections par clic ou par tracé dans les colonnes de dimension. Il n'est pas possible de faire des sélections sur les colonnes modifiables, car ces données ne font pas partie du modèle de données de l'application.

Les sélections fonctionnent de la même manière dans les tables d'annotations que dans les tableaux simples. Pour plus d'informations consultez la documentation sur les tableaux simples à la section Sélections dans des tableaux simples.

Recherche de colonnes

Dans une table d'annotations, vous pouvez effectuer des recherches dans les colonnes de dimension et des sélections dans la liste obtenue.

Procédez comme suit :

1. Cliquez sur l'en-tête de colonne d'une dimension sur laquelle vous souhaitez effectuer une recherche.

2. Cliquez sur Search.

   Une fenêtre contextuelle des sélections s'affiche, présentant la liste de toutes les valeurs du champ. Cette liste comprend les valeurs exclues par des sélections. Les valeurs exclues sont signalées en gris foncé.

3. Saisissez la chaîne de recherche. Vous pouvez utiliser n'importe lequel des types de recherche disponibles. Consultez Recherche parmi les sélections ou les visualisations.

   À mesure que vous tapez, la liste est filtrée de manière à n'afficher que les éléments correspondant à vos critères.

4. Effectuez une sélection par clic ou par tracé.

5. Confirmez la sélection.

   Note ConseilVous pouvez confirmer la sélection de tous les éléments correspondant à vos critères en appuyant sur Entrée.

Sélection de champs actifs de dimensions cycliques

Si une table d'annotations utilise une dimension cyclique, les analyseurs peuvent sélectionner le champ actif de la dimension cyclique.

Procédez comme suit :

1. Cliquez sur dans une colonne de dimension cyclique.

2. Cliquez sur <Nom de la dimension> et sélectionnez une dimension de la dimension cyclique.

Scénarios de déplacement, de publication, de suppression et de duplication

Cette section décrit le comportement prévu des tables d'annotations lorsque le contenu est déplacé, publié, supprimé et dupliqué.

Publication

Un comportement différent est prévu entre la première publication de l'application dans un espace géré et chaque republication ultérieure de l'application.

Première publication

Lorsqu'une application avec une table d'annotations est publiée pour la première fois dans un espace géré :

• De nouveaux stores de modifications sont créés dans l'espace cible.

• L'application publiée utilisera ces nouveaux stores de modifications.

Republication sans modifications apportées à la configuration d'écriture

Dans ce scénario, rien ne change. L'application publiée continue d'utiliser les stores de modifications de l'espace géré.

Republication après l'ajout de nouvelles colonnes modifiables à l'application source

Dans ce scénario, les stores de modifications cibles sont mis à jour de sorte à supporter ces nouvelles colonnes.

Republication après le retrait de colonnes modifiables de l'application source

Dans ce scénario :

• La table d'annotations de l'application publiée n'affichera plus les colonnes modifiables supprimées.

• Les stores de modifications cibles conservent ces colonnes supprimées.

Suppression

La suppression implique la suppression des graphiques, des feuilles, des applications et des espaces.

Suppression d'un graphique, d'une feuille ou d'une application

Après la suppression d'un graphique, d'une feuille ou d'une application contenant une table d'annotations, le store de modifications continue d'exister dans l'espace et est accessible via l'API.

Suppression d'un espace

Lorsqu'un espace contenant des tables d'annotations est supprimé, tous les stores de modifications qui se trouvaient dans l'espace sont perdus et irrécupérables.

Déplacement

Il se produit un déplacement lorsqu'une application avec une table d'annotations est déplacée vers un espace différent. Lors d'un déplacement, le comportement est le suivant :

• Un nouveau store de modifications vide est créé dans l'espace cible.

• La table d'annotations de l'application n'est plus liée au store de modifications de l'espace d'origine.

Limitations

Limites de données et de configuration

• Le nombre maximal de colonnes modifiables par store de modifications est de 50. Cette limitation s'applique par store de modifications et non par visualisation de table d'annotations.

• Le nombre maximal de champs de clé primaire est de 20.

• Il n'est pas possible d'ajouter d'autres colonnes à une table d'annotations.

• Vous ne pouvez pas ajouter de condition d'affichage à une colonne qui est utilisée comme clé primaire.

• Les dimensions cycliques ne peuvent pas être utilisées comme clés primaires.

• L'utilisateur peut saisir un maximum de 1 000 caractères par cellule de colonne modifiable.

Store de modifications et rétention de données

• Il n'est pas possible de connecter plusieurs tables d'annotations au même store de modifications. En cas de duplication, vous devez supprimer la visualisation de table d'annotations dupliquée. Pour plus d'informations, consultez Duplication.

• Après l'enregistrement d'une modification dans une colonne modifiable, la modification est stockée pendant 90 jours dans le store de modifications. Au bout de 90 jours, elle est supprimée et cette opération est irréversible. Si vous devez sauvegarder ces valeurs, utilisez Qlik Automate ou des scripts de chargement pour extraire ces modifications vers des systèmes externes ou des QVD dans Qlik Cloud.

Restrictions en matière de visualisations et d'interactions

• Les tables d'annotations ne peuvent pas être définies comme des visualisations principales.

• Les rayures de zèbre et les filtres de visualisation ne sont pas supportés dans la table d'annotations.

• La pagination est activée par défaut dans la table d'annotations. Vous ne pouvez pas désactiver la pagination dans cette visualisation.

• Le paramètre Renvoi à la ligne du texte des cellules n'est pas supporté pour les colonnes modifiables dans un tableau d'annotations.

• Les entrées multilignes ne sont pas supportées dans les colonnes modifiables.

• Les colonnes modifiables ne représentent pas des dimensions ni des mesures, et elles ne sont pas connectées au modèle de données de l'application. Par conséquent, de nombreuses propriétés disponibles pour les colonnes de dimension et de mesure ne sont pas applicables aux colonnes modifiables.

• Il n'est pas possible de couper des tables d'annotations.

• Les tables d'annotations ne peuvent pas être glissées dans des conteneurs d'onglets ni dans des conteneurs de disposition.

• La table d'annotations supporte les thèmes personnalisés. Les limitations suivantes s'appliquent :

  • Vous ne pouvez pas utiliser de thèmes personnalisés pour modifier les couleurs qui définissent les statuts des cellules (orange, vert et bleu).

  • Vous ne pouvez pas utiliser de thèmes personnalisés pour définir le style des colonnes modifiables.

• La table d'annotations n'est pas supportée lors de l'utilisation de l'ordre de lecture de droite à gauche dans l'application.

Disponibilité des applications et des plateformes

• Les visualisations de table d'annotations ne sont pas supportées dans les applications de modèle à la demande.

• Les tables d'annotations ne peuvent pas être définies comme des vues dynamiques.

• La table d'annotations n'est pas disponible dans les applications Direct Query.

• La table d'annotations n'est pas disponible dans Qlik Sense Client-Managed.

• La table d'annotations ne supporte pas l'accès anonyme et n'est pas disponible dans les abonnements Qlik Anonymous Access.

• La table d'annotations est disponible uniquement pour les produits d'abonnement suivants :

  • Qlik Cloud Analytics - Premium

  • Qlik Cloud Enterprise

  • Qlik Sense Enterprise SaaS

• L'intégration de la table d'annotations n'est pas supportée.

• La table d'annotations ne supporte pas le contrôle d'accès à grain fin. Si un utilisateur a accès à une application sans être membre de l'espace, il ne peut pas afficher, modifier, analyser ni créer de tables d'annotations sur des feuilles dans l'application.

• Les tables d'annotations ne sont pas supportées dans l'évaluation des performances de l'application.

Support des instantanés et de la mise en récit

• La table d'annotations ne supporte pas les instantanés. Cela inclut les instantanés de mise en récit, les instantanés intégrés et la création d'instantanés à partir d'API.

Comportement mobile et d'affichage

• Dans l'application mobile Qlik Analytics, les tables d'annotations sont affichées en mode en lecture seule.

• Les tables d'annotations ne sont pas disponibles lorsque vous ouvrez une application hors connexion dans l'application mobile Qlik Analytics.

• En mode petit écran, les tables d'annotations sont affichées en mode en lecture seule.

Limitations en termes d'Accès de section

Accès de section s'applique uniquement aux données utilisées par le moteur Qlik. De plus, les enregistrements affichés dans une table d'annotations dépendent de la clé primaire, qui est configurée à l'aide des données du moteur. Par conséquent, si la table d'annotations est utilisée dans une application qui comporte Accès de section, les enregistrements affichés dans la table seront limités par Accès par section.

Cependant, les données d'interaction de la table d'annotations — les modifications créées lors des sessions d'analyse — sont stockées dans un store de modifications, qui est distinct du moteur. Accès de section n'est pas appliqué à un store de modifications ni à API change-stores. Par conséquent, les utilisateurs disposant d'autorisations d'API pourront lire toutes les données d'un store de modifications, indépendamment des règles d'Accès de section.