

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Rubriques relatives à l'utilisation d'Amazon Quick Sight
<a name="topics"></a>


|  | 
| --- |
|  S’applique à : édition Enterprise  | 


|  | 
| --- |
|    Public cible : administrateurs et auteurs d'Amazon Quick  | 

Les *sujets* sont des collections d'un ou de plusieurs ensembles de données qui représentent un domaine sur lequel les utilisateurs de votre entreprise peuvent poser des questions. 

Grâce à la préparation automatique des données de Quick Sight, vous bénéficiez d'une assistance basée sur le ML pour vous aider à créer un sujet pertinent pour vos utilisateurs finaux. Le premier processus commence par une sélection et une classification automatisées des champs, comme suit :
+ La préparation automatique des données choisit un petit nombre de champs à inclure par défaut afin de créer un espace de données ciblé que les lecteurs peuvent explorer.
+ La préparation automatique des données sélectionne les champs que vous utilisez dans d'autres actifs tels que les rapports et les tableaux de bord. 
+ La préparation automatique des données importe également des champs supplémentaires à partir de toute analyse associée dans laquelle un sujet est activé. 
+ Elle identifie les dates, les dimensions et les mesures pour savoir comment les champs peuvent être utilisés dans les réponses.

Cet ensemble automatique de champs aide l’auteur à se lancer rapidement dans l’analyse en langage naturel. Les auteurs peuvent toujours exclure des champs ou en inclure d’autres, selon leurs besoins, en utilisant le bouton **Inclure**.

Ensuite, la préparation automatique des données poursuit le processus en étiquetant automatiquement les champs et en identifiant les synonymes. La préparation automatique des données met à jour les noms de champs avec des noms conviviaux et des synonymes utilisant des termes courants. Par exemple, un champ `SLS_PERSON` peut être renommé en `Sales person` et se voir attribuer des synonymes tels que : `salesman`, `saleswoman`, agent et `sales representative`. Bien que vous puissiez laisser la préparation automatique des données effectuer une grande partie du travail, il est utile de revoir les champs, les noms et les synonymes afin de les personnaliser davantage pour vos utilisateurs finaux. Par exemple, si les utilisateurs désignent un vendeur comme un « représentant » ou un « concessionnaire » dans les conversations courantes, vous prenez en charge ce terme en ajoutant `rep` et `dealer` aux synonymes de `SLS_PERSON`. 

Enfin, la préparation automatique des données détecte le type sémantique de chaque champ, en échantillonnant ses données et en examinant les formats appliqués par l'auteur lors de l'analyse. La préparation automatique des données met automatiquement à jour la configuration des champs, en définissant les formats des valeurs utilisées pour chaque champ. Les réponses aux questions sont ainsi fournies dans les formats attendus pour les dates, les devises, les identifiants, les booléens, les personnes, etc. 

Pour en savoir plus sur l'utilisation des sujets, consultez les sections suivantes de ce chapitre.

**Topics**
+ [Rubriques de navigation](navigating-topics.md)
+ [Création de sujets Quick Sight](topics-create.md)
+ [Espace de travail de rubrique](topics-interface.md)
+ [Utilisation de jeux de données dans une rubrique Quick Sight](topics-data.md)
+ [Création de sujets pour Quick Sight natural-language-friendly](topics-natural-language.md)
+ [Partage de sujets de Quick Sight](topics-sharing.md)
+ [Gestion des autorisations des rubriques Amazon Quick Sight](topics-sharing-permissions.md)
+ [Examen des performances du sujet Quick Sight et des commentaires](topics-performance.md)
+ [Actualisation des index des rubriques de Quick Sight](topics-index.md)
+ [Travaillez sur des sujets Quick Sight à l'aide d'Amazon Quick Sight APIs](topics-cli.md)

# Rubriques de navigation
<a name="navigating-topics"></a>

Dans Quick Sight, il existe plusieurs manières de créer et de gérer un sujet. Vous pouvez commencer sur une page d'accueil ou une page « d'accueil » d'Amazon Quick. Vous pouvez également commencer à l’intérieur d’une analyse.

**Topics**
+ [Depuis la page d'accueil d'Amazon Quick](starting-from-home.md)
+ [À partir d'une analyse Amazon Quick Sight](starting-from-sheets.md)
+ [Gérer les questions dans une analyse Amazon Quick Sight](starting-from-questions-on-sheets.md)

# Depuis la page d'accueil d'Amazon Quick
<a name="starting-from-home"></a>

À partir de votre page de démarrage rapide, vous pouvez créer et gérer des **sujets en sélectionnant Rubriques** dans le volet de navigation de gauche. Quick fournit un flux de travail guidé pour créer des sujets. Vous pouvez sortir du flux guidé et y revenir plus tard, sans interrompre votre travail. 

Lorsque vous créez un sujet, les utilisateurs de votre entreprise peuvent poser des questions à ce sujet. À tout moment, vous pouvez ouvrir une rubrique pour la modifier ou examiner son fonctionnement.

Pour ouvrir une rubrique, cliquez sur son nom.

Si vous voulez à tout moment revenir à la liste de toutes vos rubriques, choisissez **Toutes les rubriques** à gauche de l’espace de travail de la rubrique.

# À partir d'une analyse Amazon Quick Sight
<a name="starting-from-sheets"></a>

Pour commencer par une analyse Amazon Quick Sight, ouvrez l'analyse que vous souhaitez utiliser dans le cadre de la préparation automatique des données.

Pour ouvrir ou créer un sujet, cliquez sur l'icône du sujet dans la barre de navigation supérieure.

À tout moment, vous pouvez ouvrir une rubrique pour la modifier ou examiner son fonctionnement.

Pour ouvrir une rubrique à partir d’une analyse, sélectionnez le nom de la rubrique dans la barre de navigation supérieure, s’il n’est pas déjà affiché. Sélectionnez ensuite l’icône d’ellipse verticale (` ⋮ `) dans la barre de navigation supérieure. 

Pour afficher des informations sur la rubrique, sélectionnez **À propos de la rubrique**.

Pour afficher les champs de données inclus dans la rubrique, sélectionnez **Champs de données** dans la liste des onglets.

# Gérer les questions dans une analyse Amazon Quick Sight
<a name="starting-from-questions-on-sheets"></a>

En naviguant parmi les questions et les réponses d’une rubrique d’une analyse, vous pouvez apprendre comment la rubrique est utilisée. Ces informations peuvent vous permettre de procéder à des ajustements si nécessaire. 

À partir d'une analyse déjà liée à un sujet, sélectionnez la barre de recherche dans la barre de navigation supérieure, puis saisissez une question. La réponse s'affiche sur un écran thématique qui affiche également toutes les options disponibles pour travailler avec le sujet dans une analyse. 
+ Pour modifier le type de représentation visuelle affichée dans la réponse, sélectionnez l’icône de type (qui ressemble à un diagramme à barres).
+ Pour afficher les suggestions d’amélioration, sélectionnez la bulle de dialogue, qui est mise en évidence si vous avez des suggestions non affichées.
+ Pour afficher les analyses liées à une question, sélectionnez l’icône en forme d’ampoule.
+ Pour ajouter ou supprimer une question du tableau d’affichage, cliquez sur l’icône **Ajouter au tableau d’affichage** ou **Supprimer du tableau d’affichage**. Vous pouvez afficher le tableau d’affichage en sélectionnant l’icône du tableau d’affichage dans la barre de navigation supérieure.
+ Pour afficher des informations sur cette rubrique, sélectionnez le *i* minuscule encerclé (` ![\[alt text not found\]](http://docs.aws.amazon.com/fr_fr/quick/latest/userguide/images/status-info.png) `).
+ Sélectionnez le menu ellipse ( ` … `) pour effectuer l’une des actions suivantes : 
  + **Exporter au format CSV** – Exporter les données affichées dans la représentation visuelle sélectionnée.
  + **Copier l’ID de demande** – Capturer l’ID de la demande de ce processus pour le dépannage. Amazon Quick Sight génère un identifiant de demande alphanumérique pour identifier de manière unique chaque processus. 
  + **Partager cette représentation visuelle** – Partager en toute sécurité une URL pour la rubrique utilisée dans la représentation visuelle.
  + **Décomposition de réponse** – Pour afficher une explication détaillée de votre réponse.

En bas de l’écran de la rubrique, vous pouvez ajouter ou modifier des variantes de la question en sélectionnant **Modifier les variantes de la question**. Toujours en bas, lorsque vous êtes satisfait de la question et de la réponse, marquez la rubrique comme révisée en sélectionnant **Marquer comme révisée**. Ou, si vous constatez qu’une rubrique déjà examinée nécessite un examen plus approfondi, choisissez **Désélectionner comme examiné**. 

À tout moment, vous pouvez ouvrir une rubrique pour la modifier ou examiner son fonctionnement. Pour travailler directement avec les paramètres d’une rubrique, tels que les champs inclus ou les synonymes, utilisez la page **Rubriques**.

**Pour ouvrir une rubrique liée à une analyse**

1. Ouvrez la page des **sujets** d'Amazon Quick Sight depuis la page de démarrage rapide, en sélectionnant **Sujets** dans le volet de navigation de gauche.

   Si vous voulez garder votre analyse ouverte, vous pouvez ouvrir la page **Rubriques** dans un nouvel onglet ou une nouvelle fenêtre du navigateur.

1. Pour ouvrir une rubrique, cliquez sur son nom. Si vous avez récemment quitté la page d'analyse, le nom est probablement toujours affiché dans la barre de recherche en haut de l'écran.

1. Si vous voulez à tout moment revenir à la liste de toutes vos rubriques, choisissez **Toutes les rubriques** à gauche de l’espace de travail de la rubrique.

# Création de sujets Quick Sight
<a name="topics-create"></a>


|  | 
| --- |
|  S’applique à : édition Enterprise  | 


|  | 
| --- |
|    Public cible : administrateurs et auteurs d'Amazon Quick  | 

Pour activer les questions pour vos jeux de données, vous devez créer une rubrique. Quick Sight fournit un flux de travail guidé pour créer des sujets. Vous pouvez sortir du flux guidé et y revenir plus tard, sans interrompre votre travail. 

Il existe deux façons de créer une rubrique :
+ Créer la rubrique en sélectionnant un jeu de données. Lorsque vous créez des sujets dans Quick Sight, vous pouvez y ajouter plusieurs ensembles de données et également activer les sujets dans les analyses. 
+ Créez la rubrique à l’aide d’une analyse. Lorsque vous créez un sujet dans une analyse ou que vous liez un sujet existant à une analyse, la préparation automatique des données apprend de la façon dont vous analysez vos données et l'applique automatiquement à votre sujet. 

Une fois que vous avez partagé votre sujet avec les lecteurs de Quick et qu'ils l'ont utilisé pour poser des questions dans la barre de recherche, vous pouvez voir un résumé des performances du sujet. Vous pouvez également voir une liste de toutes les questions posées par les utilisateurs et des réponses reçues, ainsi que de toutes les réponses que vous avez vérifiées. Il est important d'examiner les commentaires afin que les utilisateurs de votre entreprise puissent continuer à recevoir les visualisations et les réponses appropriées à leurs questions.

## Création d’une rubrique
<a name="topics-create-how"></a>

Utilisez la procédure suivante pour créer une rubrique.

**Pour créer une rubrique**

1. Sur la page d'accueil de Quick, sélectionnez **Sujets**.

1. Sur la page **Sujets** qui s'ouvre, choisissez **Créer un sujet** en haut à droite.

1. Sur la page **Créer un sujet** qui s'ouvre, procédez comme suit :

   1. Dans **Nom de la rubrique**, saisissez un nom descriptif pour la rubrique.

      Vos utilisateurs professionnels identifient la rubrique par ce nom et l’utilisent pour poser des questions.

   1. Pour **Description**, saisissez une description de la rubrique.

      Vos utilisateurs peuvent utiliser cette description pour obtenir plus de détails sur la rubrique.

   1. Sélectionnez **Continuer**.

1. Sur la page **Ajouter des données à la rubrique** qui s’ouvre, choisissez l’une des options suivantes :
   + Pour ajouter un ou plusieurs jeux de données dont vous êtes propriétaire ou pour lesquels vous disposez d’une autorisation, choisissez **Jeux de données**, puis sélectionnez le ou les jeux de données que vous voulez ajouter.
   + Pour ajouter des ensembles de données provenant de tableaux de bord que vous avez créés ou qui ont été partagés avec vous, choisissez **Ensembles de données dans un tableau de bord**, puis sélectionnez un tableau de bord dans la liste.

1. Choisissez **Ajouter des données**.

   Votre rubrique est créée et la page de cette rubrique s’ouvre. L'étape suivante consiste à configurer les métadonnées du sujet natural-language-friendly pour qu'elles soient accessibles à vos lecteurs. Pour de plus amples informations, veuillez consulter [Création de sujets pour Quick Sight natural-language-friendly](topics-natural-language.md). Vous pouvez également passer à la rubrique suivante pour explorer l’espace de travail des rubriques.

# Espace de travail de rubrique
<a name="topics-interface"></a>


|  | 
| --- |
|  S’applique à : édition Enterprise  | 


|  | 
| --- |
|    Public cible : administrateurs et auteurs d'Amazon Quick  | 

Après avoir créé une rubrique, ou lorsque vous choisissez une rubrique existante dans la liste de la page **Rubriques**, la rubrique s’ouvre sur l’espace de travail de cette rubrique. Quatre onglets apparaissent ici, que vous pouvez utiliser comme décrit dans les sections suivantes. Quick Sight fournit un flux de travail guidé pour les sujets. Vous pouvez sortir du flux guidé et y revenir plus tard, sans interrompre votre travail. 

## Résumé
<a name="topics-interface-summary"></a>

L’onglet **Résumé** comporte trois zones importantes :
+ **Suggestions** — Les suggestions fournissent des step-by-step conseils pour améliorer un sujet. Ces étapes vous aident à comprendre comment créer des rubriques plus performantes.

  Pour suivre une suggestion, choisissez le bouton d’action dans la bannière des suggestions et suivez les étapes recommandées.

  Actuellement, huit suggestions prédéfinies sont proposées dans l'ordre indiqué dans le tableau suivant. Lorsque vous avez terminé une étape d’une suggestion, une nouvelle suggestion vous est proposée lorsque vous revenez à l’onglet **Résumé**.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/quick/latest/userguide/topics-interface.html)
+ **Mesures et indicateurs de performance clés (KPIs) relatifs à l'engagement et à la performance par sujet** — Dans cette section, vous pouvez voir comment vos lecteurs interagissent avec vos sujets, ainsi que les commentaires et les notes qu'ils donnent aux réponses fournies. Vous pouvez afficher l’engagement pour toutes les questions posées par les utilisateurs ou sélectionner une question spécifique. Vous pouvez également modifier l’intervalle de temps des métriques d’un an à une semaine.

  Pour de plus amples informations, veuillez consulter [Examen des performances du sujet Quick Sight et des commentaires](topics-performance.md).
+ **Jeux de données** – Cette section présente les jeux de données utilisés pour créer la rubrique. Dans cette section, vous pouvez ajouter des jeux de données supplémentaires ou importer des jeux de données à partir de tableaux de bord existants. Vous pouvez également modifier les métadonnées d’un jeu de données de rubrique, définir un calendrier d’actualisation des données, modifier le nom du jeu de données, etc. Pour de plus amples informations, veuillez consulter [Utilisation de jeux de données dans une rubrique Quick Sight](topics-data.md).

## Données
<a name="topics-interface-data"></a>

L’onglet **Données** affiche tous les champs inclus dans la rubrique. Vous configurez ici les métadonnées de votre sujet pour créer votre sujet natural-language-friendly et améliorer ses performances. Pour de plus amples informations, veuillez consulter [Création de sujets pour Quick Sight natural-language-friendly](topics-natural-language.md).

## Activité de l’utilisateur
<a name="topics-interface-user"></a>

Cet onglet montre toutes les questions que votre rubrique reçoit et le retour d’information global pour chaque question. Vous pouvez voir une vue d’ensemble du nombre de questions posées et du pourcentage de questions positives et négatives. Vous pouvez filtrer en fonction du retour d’information et si quelqu’un a laissé un commentaire avec son retour d’information. Pour de plus amples informations, veuillez consulter [Examen des performances du sujet Quick Sight et des commentaires](topics-performance.md).

## Réponses vérifiées
<a name="topics-interface-answers"></a>

Les *réponses vérifiées* sont des questions pour lesquelles vous avez préconfiguré des représentations visuelles. Vous pouvez créer une réponse vérifiée à une question en posant la question dans la barre de recherche, puis en la marquant comme révisée. L’onglet **Réponses vérifiées** vous permet d’examiner vos réponses vérifiées et les commentaires qu’elles suscitent chez vos utilisateurs.

# Utilisation de jeux de données dans une rubrique Quick Sight
<a name="topics-data"></a>


|  | 
| --- |
|  S’applique à : édition Enterprise  | 


|  | 
| --- |
|    Public cible : administrateurs et auteurs d'Amazon Quick  | 

Lorsque vous créez une rubrique, vous pouvez y ajouter des jeux de données supplémentaires ou importer des jeux de données à partir de tableaux de bord existants. À tout moment, vous pouvez modifier les métadonnées d’un jeu de données et définir un calendrier d’actualisation des données. Vous pouvez également ajouter de nouveaux champs à un jeu de données dans une rubrique en créant des champs calculés, des filtres ou des entités nommées.

**Topics**
+ [Ajouter des ensembles de données à une rubrique dans Amazon Quick Sight](topics-data-add.md)
+ [Ajouter des ensembles de données avec sécurité au niveau des lignes (RLS) à une rubrique Amazon Quick Sight](topics-data-rls.md)
+ [Actualisation des ensembles de données dans une rubrique Quick Sight](topics-data-refresh.md)
+ [Supprimer des ensembles de données d'une rubrique Amazon Quick Sight](topics-data-remove.md)
+ [Ajouter des champs calculés à un ensemble de données thématiques Amazon Quick Sight](topics-data-calculated-fields.md)
+ [Ajouter des filtres à un ensemble de données thématiques Amazon Quick Sight](topics-data-filters.md)
+ [Ajouter des entités nommées à un ensemble de données thématiques Amazon Quick Sight](topics-data-entities.md)

# Ajouter des ensembles de données à une rubrique dans Amazon Quick Sight
<a name="topics-data-add"></a>

Vous pouvez à tout moment ajouter des jeux de données à une rubrique. Utilisez la procédure suivante pour savoir comment faire.

**Pour ajouter des jeux de données à une rubrique**

1. Ouvrez la rubrique à laquelle vous voulez ajouter un ou plusieurs jeux de données.

1. Sur la page **Résumé**, sélectionnez **Données**. Ensuite, sous **Ensembles de données, choisissez Ajouter des** **ensembles de données**.

1. Sur la page **Ajouter des jeux de données** qui s’ouvre, choisissez le ou les jeux de données que vous voulez ajouter, puis cliquez sur **Ajouter des jeux de données**.

   L'ensemble de données est ajouté à la rubrique et les valeurs de chaîne uniques de l'ensemble de données sont indexées. Vous pouvez modifier les configurations des champs immédiatement. Pour de plus amples informations, veuillez consulter [Actualisation des index des rubriques de Quick Sight](topics-index.md). Pour plus d'informations sur la modification des configurations de champs, consultez[Création de sujets pour Quick Sight natural-language-friendly](topics-natural-language.md).

# Ajouter des ensembles de données avec sécurité au niveau des lignes (RLS) à une rubrique Amazon Quick Sight
<a name="topics-data-rls"></a>

Vous pouvez ajouter des ensembles de données contenant une sécurité au niveau des lignes (RLS) aux rubriques. Toutes les rubriques d’une rubrique respectent les règles RLS appliquées à votre jeu de données. Par exemple, si un utilisateur demande « Afficher les ventes par région », les données renvoyées sont basées sur l'accès de l'utilisateur aux données sous-jacentes. Ainsi, s'ils ne sont autorisés à voir que la région Est, seules les données de la région Est apparaissent dans la réponse.

Les règles RLS sont appliquées aux suggestions automatiques lorsque les utilisateurs posent des questions. Lorsque les utilisateurs saisissent des questions, seules les valeurs auxquelles ils ont accès leur sont suggérées. Si un utilisateur pose une question sur une valeur dimensionnelle à laquelle il n’a pas accès, il ne reçoit pas de réponse pour cette valeur. Par exemple, supposons que le même utilisateur saisisse la question « montrez-moi les ventes dans la région Ouest ». Dans ce cas, il n’obtient pas de suggestion ni de réponse, même s’il pose la question, parce qu’il n’a pas accès au SJR de cette région.

Par défaut, Quick Sight permet aux utilisateurs de poser des questions concernant les champs en fonction des autorisations de l'utilisateur dans RLS. Continuez à utiliser cette option si votre champ contient des données sensibles dont vous voulez restreindre l’accès. Si vos champs ne contiennent pas d'informations sensibles et que vous souhaitez que tous les utilisateurs voient ces informations sous forme de suggestions, vous pouvez choisir d'autoriser les questions pour toutes les valeurs du champ.

**Pour autoriser les questions pour tous les champs**

1. Sur la page d'accueil de Quick, sélectionnez **Data**.

1. Sous l'onglet **Ensembles** de données, choisissez le jeu de données auquel vous avez ajouté RLS, puis sélectionnez **Modifier** le jeu de données.

   Pour plus d’informations sur l’ajout de RLS à un jeu de données, consultez la rubrique [Utilisation de la sécurité au niveau des lignes dans Amazon Quick](row-level-security.md).

1. Sur la page de préparation des données, choisissez le menu des champs (les trois points) correspondant au champ que vous souhaitez autoriser, puis sélectionnez **Sécurité au niveau des lignes**.

1. Sur la page **Sécurité au niveau des lignes pour Quick** qui s'ouvre, choisissez **Autoriser les utilisateurs à poser des questions concernant toutes les valeurs de ce champ**.

1. Cliquez sur **Appliquer**.

1. Lorsque vous avez terminé de modifier le jeu de données, choisissez **Enregistrer et publier** dans la barre d’outils bleue en haut à droite.

1. Ajoutez le jeu de données à votre sujet. Pour plus d’informations, consultez la section précédente, [Ajouter des ensembles de données à une rubrique dans Amazon Quick Sight](topics-data-add.md).

Si vous autorisez actuellement les utilisateurs à poser des questions sur toutes les valeurs, mais que vous voulez mettre en œuvre les règles RLS du jeu de données pour protéger les informations sensibles, répétez les étapes 1 à 4 et choisissez **Autoriser les utilisateurs à poser des questions sur ce champ en fonction de leurs autorisations**. Lorsque vous avez terminé, actualisez le jeu de données dans votre rubrique. Pour de plus amples informations, veuillez consulter [Actualisation des ensembles de données dans une rubrique Quick Sight](topics-data-refresh.md).

# Actualisation des ensembles de données dans une rubrique Quick Sight
<a name="topics-data-refresh"></a>

Lorsque vous ajoutez un jeu de données à une rubrique, vous pouvez spécifier la fréquence à laquelle vous voulez que ce jeu de données soit actualisé. Lorsque vous actualisez les ensembles de données d'une rubrique, l'index est actualisé pour cette rubrique avec toutes les informations nouvelles et mises à jour. 

Vos ensembles de données ne sont pas répliqués lorsque vous les ajoutez à une rubrique. Un index de valeurs de chaîne uniques est créé et les métriques ne sont pas indexées. Par exemple, les mesures stockées sous forme de nombres entiers ne sont pas indexées. Les questions posées permettent toujours d'obtenir les derniers indicateurs de ventes en fonction des données de votre ensemble de données.

Pour plus d’informations sur l’actualisation de l’index des rubriques, consultez la rubrique [Actualisation des index des rubriques de Quick Sight](topics-index.md)

Vous pouvez définir un calendrier d’actualisation pour un jeu de données dans une rubrique, ou actualiser le jeu de données manuellement. Vous pouvez également voir quand les données ont été actualisées pour la dernière fois. 

**Pour définir un calendrier d’actualisation pour un jeu de données d’une rubrique**

1. Ouvrez la rubrique que vous voulez modifier.

1. Sur la page **Résumé**, sélectionnez **Données**. Ensuite, sous **Ensembles** de données, développez le jeu de données pour lequel vous souhaitez définir un calendrier d'actualisation.

1. Choisissez **Ajouter une planification**, puis effectuez l’une des opérations suivantes dans la page **Ajouter une planification d’actualisation** qui s’affiche.
   + Si le jeu de données est un jeu de données SPICE, sélectionnez **Actualiser la rubrique lorsque le jeu de données est importé dans SPICE**.

     Actuellement, les SPICE ensembles de données actualisés toutes les heures ne sont pas pris en charge. SPICEles ensembles de données configurés pour être actualisés toutes les heures sont automatiquement convertis en actualisation quotidienne. Pour plus d’informations sur la définition de calendriers d’actualisation pour les jeux de données SPICE, consultez la rubrique [Actualisation des données SPICE](refreshing-imported-data.md).
   + Si le jeu de données est un jeu de données d’interrogation directe, procédez comme suit :

     1. Dans le champ **Timezone** (Fuseau horaire), choisissez un fuseau horaire.

     1. Pour **Répétitions**, choisissez la fréquence à laquelle vous voulez que l’actualisation se produise. Vous pouvez choisir d’actualiser le jeu de données quotidiennement, hebdomadairement ou mensuellement.

     1. Pour **Heure d’actualisation**, entrez l’heure à laquelle vous voulez que l’actualisation commence.

     1. Pour **Démarrer la première actualisation le**, choisissez une date à laquelle vous voulez commencer l’actualisation du jeu de données.

1. Choisissez **Enregistrer**.

**Pour actualiser manuellement un jeu de données**

1. Sur la page **Résumé** du sujet, sélectionnez **Données**. Ensuite, sous **Ensembles de données**, choisissez le jeu de données que vous souhaitez actualiser.

1. Choisissez **Actualiser maintenant**.

**Pour afficher l’historique d’actualisation d’un jeu de données**

1. Sur la page **Résumé** du sujet, sélectionnez **Données**. Ensuite, sous **Ensembles** de données, choisissez le jeu de données dont vous souhaitez voir l'historique d'actualisation.

1. Choisissez **Afficher l’historique**.

   La page **Historique des actualisations** s’ouvre avec une liste des fois où le jeu de données a été actualisé.

# Supprimer des ensembles de données d'une rubrique Amazon Quick Sight
<a name="topics-data-remove"></a>

Vous pouvez supprimer des jeux de données d’une rubrique. Le fait de supprimer des ensembles de données d'une rubrique ne les supprime pas de Quick Sight. 

Suivez la procédure suivante pour supprimer un jeu de données d’une rubrique.

**Pour supprimer un jeu de données d’une rubrique**

1. Ouvrez la rubrique que vous voulez modifier.

1. Sur la page **Résumé**, sélectionnez **Données**. Ensuite, sous **Ensembles** de données, choisissez le menu du jeu de données (les trois points) à droite, puis choisissez **Supprimer du sujet**.

1. Sur la page **Voulez-vous vraiment supprimer ?** qui s’affiche, choisissez **Supprimer** pour retirer le jeu de données de la rubrique. Choisissez **Annuler** si vous ne voulez pas supprimer le jeu de données de la rubrique.

# Ajouter des champs calculés à un ensemble de données thématiques Amazon Quick Sight
<a name="topics-data-calculated-fields"></a>

Vous pouvez créer de nouvelles rubriques dans une rubrique en créant des rubriques calculées. Les *rubriques calculées* sont des rubriques qui utilisent une combinaison d’une ou deux rubriques d’un jeu de données avec une fonction prise en charge pour créer de nouvelles données. 

Par exemple, si votre jeu de données contient des colonnes pour les ventes et les dépenses, vous pouvez les combiner dans un champ calculé avec une fonction simple pour créer une colonne de bénéfices. La fonction peut ressembler à ce qui suit : `sum({Sales}) - sum({Expenses})`.

**Pour ajouter une rubrique calculée à une rubrique**

1. Ouvrez la rubrique que vous voulez modifier.

1. Dans la rubrique, sélectionnez l’onglet **Données**.

1. Dans **Actions**, sélectionnez **Ajouter un champ calculé**.

1. Dans l’éditeur de calculs qui s’ouvre, procédez comme suit :

   1. Donnez un nom convivial au champ calculé.

   1. Pour **Jeux de données**, à droite, choisissez un jeu de données que vous voulez utiliser pour le champ calculé.

   1. Saisissez un calcul dans l’éditeur de calcul situé à gauche.

      La liste des champs du jeu de données s’affiche dans le volet **Champs** à droite. Vous pouvez également consulter la liste des fonctions prises en charge dans le volet **Fonctions** à droite.

      Pour plus d'informations sur les fonctions et les opérateurs que vous pouvez utiliser pour créer des calculs dans Quick Sight, consultez le[Fonction de champ calculée et référence d'opérateur pour Amazon QuickFonctions et opérateurs](calculated-field-reference.md).

1. Lorsque vous avez terminé, choisissez **Save (Sauvegarder)**.

   Le champ calculé est ajouté à la liste des champs de la rubrique. Vous pouvez lui ajouter une description et configurer des métadonnées pour la rendre plus conviviale en langage naturel.

# Ajouter des filtres à un ensemble de données thématiques Amazon Quick Sight
<a name="topics-data-filters"></a>

Il arrive que vos utilisateurs professionnels (lecteurs) posent des questions contenant des termes qui mappent plusieurs cellules de valeurs dans les données. Supposons, par exemple, que l'un de vos lecteurs vous demande : « Montrez-moi la tendance des ventes hebdomadaires dans l'Ouest ». Dans ce cas, l’*Ouest* fait référence aux valeurs `Northwest` et `Southwest` du champ `Region` et nécessite un filtrage des données pour générer une réponse. Vous pouvez ajouter des filtres à une rubrique pour répondre à des demandes de ce type.

**Pour ajouter un filtre à une rubrique**

1. Ouvrez la rubrique à laquelle vous voulez ajouter un filtre.

1. Dans la rubrique, sélectionnez l’onglet **Données**.

1. Pour **Actions**, choisissez **Ajouter un filtre**.

1. Dans la page **Configuration du filtre** qui s’ouvre, procédez comme suit :

   1. Pour **Nom**, saisissez un nom convivial pour le filtre.

   1. Pour **Jeu de données**, choisissez un jeu de données auquel vous voulez appliquer le filtre.

   1. Pour **Champ**, choisissez le champ que vous voulez filtrer.

      Selon le type de champ choisi, différentes options de filtrage vous sont proposées.
      + Si vous avez choisi un champ de texte (par exemple, `Region`), procédez comme suit :

        1. Pour **Type de filtre**, choisissez le type de filtre que vous voulez.

           Pour plus d’informations sur les champs de texte de filtrage, consultez la rubrique [Ajout des filtres de texte](add-a-text-filter-data-prep.md).

        1. Pour **Règle**, choisissez une règle.

        1. Pour **Valeur**, saisissez une ou plusieurs valeurs.
      + Si vous avez choisi une zone de date (par exemple, `Date`), procédez comme suit :

        1. Pour **Type de filtre**, choisissez le type de filtre que vous voulez, puis saisissez la ou les dates auxquelles vous souhaitez appliquer le filtre.

           Pour plus d’informations sur le filtrage des dates, consultez la rubrique [Ajout des filtres de date](add-a-date-filter2.md).
      + Si vous avez choisi une rubrique numérique (par exemple, `Compensation`), procédez comme suit :

        1. Pour **Agrégation**, choisissez comment vous voulez agréger les valeurs filtrées.

        1. Pour **Règle**, choisissez une règle pour le filtre, puis saisissez une valeur pour cette règle.

        Pour plus d’informations sur le filtrage des champs numériques, consultez la rubrique [Ajout de filtres numériques](add-a-numeric-filter-data-prep.md).

   1. (Facultatif) Pour spécifier quand le filtre est appliqué, sélectionnez **Appliquer le filtre à chaque fois que le jeu de données est utilisé**, puis choisissez l’une des options suivantes :
      + **Appliquer toujours** – Lorsque vous choisissez cette option, le filtre est appliqué chaque fois qu’une colonne du jeu de données que vous avez spécifié est liée à une question.
      + **Appliquer toujours, sauf si une question entraîne un filtre explicite du jeu de données** – Lorsque vous choisissez cette option, le filtre est appliqué chaque fois qu’une colonne du jeu de données que vous avez spécifié est liée à une question. Toutefois, si la question mentionne un filtre explicite sur le même champ, le filtre n’est pas appliqué.

   1. Lorsque vous avez terminé, choisissez **Save (Sauvegarder)**.

      Le filtre est ajouté à la liste des champs de la rubrique. Vous pouvez modifier sa description ou ajuster le moment où le filtre est appliqué.

# Ajouter des entités nommées à un ensemble de données thématiques Amazon Quick Sight
<a name="topics-data-entities"></a>

Lorsqu’ils posent des questions sur votre rubrique, vos lecteurs peuvent faire référence à plusieurs colonnes de données sans les énoncer explicitement. Par exemple, ils peuvent demander l’adresse d’une transaction. En réalité, ils veulent connaître le nom de l’agence, l’état et la ville où la transaction a été effectuée. Pour répondre à ce type de demande, vous pouvez créer une entité nommée.

Une *entité nommée* est un ensemble de champs qui s’affichent ensemble dans une réponse. Par exemple, en reprenant l’exemple de l’adresse de la transaction, vous pouvez créer une entité nommée `Address`. Vous pouvez ensuite lui ajouter les colonnes `Branch Name`, `State` et `City`, qui existent déjà dans le jeu de données. Lorsque quelqu’un pose une question sur l’adresse, la réponse affiche la succursale, l’état et la ville où une transaction a eu lieu.

**Pour ajouter une entité nommée à une rubrique**

1. Ouvrez la rubrique que vous voulez modifier.

1. Dans la rubrique, sélectionnez l’onglet **Données**.

1. Pour **Actions**, choisissez **Ajouter une entité nommée**.

1. Dans la page **Entité nommée** qui s’ouvre, procédez comme suit :

   1. Pour **Jeu de données**, choisissez un jeu de données.

   1. Pour **Nom**, saisissez un nom convivial pour l’entité nommée.

   1. Pour **Description**, saisissez une description de l’entité nommée.

   1. (Facultatif) Pour **Synonymes**, ajoutez tout autre nom que vos lecteurs pourraient utiliser pour désigner l’entité nommée ou les données qu’elle contient.

   1. Choisissez **Ajouter un champ**, puis choisissez un champ dans la liste.

      Choisissez à nouveau **Ajouter un champ** pour en ajouter un autre.

      L’ordre des champs énumérés ici correspond à l’ordre dans lequel ils apparaissent dans les réponses. Pour déplacer un champ, choisissez les six points situés à gauche du nom du champ et faites glisser le champ dans l’ordre que vous voulez.

   1. Lorsque vous avez terminé, choisissez **Save (Sauvegarder)**.

   L’entité nommée est ajoutée à la liste des champs de la rubrique. Vous pouvez modifier sa description et lui ajouter des synonymes pour la rendre plus conviviale en langage naturel.

# Création de sujets pour Quick Sight natural-language-friendly
<a name="topics-natural-language"></a>


|  | 
| --- |
|  S’applique à : édition Enterprise  | 


|  | 
| --- |
|    Public cible : administrateurs et auteurs d'Amazon Quick  | 

Lorsque vous créez une rubrique, Quick Sight crée, stocke et gère un index contenant les définitions des données de cette rubrique. Cet index est utilisé pour générer des réponses correctes, fournir des suggestions de saisie semi-automatique lorsque quelqu'un pose une question et suggérer des mappages de termes avec des colonnes ou des valeurs de données. C'est ainsi que les termes clés peuvent être interprétés dans les questions de vos lecteurs et mis en correspondance avec vos données. 

Pour faciliter l'interprétation de vos données et mieux répondre aux questions de vos lecteurs, fournissez autant d'informations que possible sur vos ensembles de données et les champs associés.

Pour ce faire, utilisez les procédures suivantes, afin d'améliorer vos sujets natural-language-friendly.

**Astuce**  
Vous pouvez modifier plusieurs champs à la fois à l’aide d’actions groupées. Utilisez la procédure suivante pour modifier en bloc des rubriques dans une rubrique.

**Pour modifier en bloc des rubriques dans une rubrique**

1. Ouvrez la rubrique que vous voulez modifier.

1. Dans la rubrique, sélectionnez l’onglet **Données**.

1. Sous **Champs**, sélectionnez deux ou plusieurs champs que vous voulez modifier.

1. Sélectionnez **Actions en bloc** en haut de la liste.

1. Dans la page **Actions en bloc** qui s’ouvre, configurez les champs comme vous le voulez, puis choisissez **Appliquer à**.

   Les options de configuration sont décrites dans les étapes suivantes.

## Étape 1 : Donner aux jeux de données des noms et des descriptions conviviaux
<a name="topics-natural-language-dataset-name"></a>

Les noms des jeux de données sont souvent basés sur des conventions d’appellation techniques que vos lecteurs n’utiliseront peut-être pas naturellement pour s’y référer. Nous vous recommandons de donner à vos jeux de données des noms et des descriptions conviviaux afin de fournir davantage d’informations sur les données qu’ils contiennent. Ces noms et descriptions conviviaux sont utilisés pour comprendre le contenu des ensembles de données et sélectionner un ensemble de données en fonction de la question du lecteur. Les noms des ensembles de données sont également présentés au lecteur afin de fournir un contexte supplémentaire pour une réponse.

Par exemple, si votre jeu de données s’appelle `D_CUST_DLY_ORD_DTL`, vous pouvez le renommer dans la rubrique en `Customer Daily Order Details`. Ainsi, lorsque vos lecteurs le voient répertorié dans la barre de recherche de votre sujet, ils peuvent rapidement déterminer si les données les concernent ou non.

**Pour donner à un jeu de données un nom et une description conviviaux**

1. Ouvrez la rubrique que vous voulez modifier.

1. Dans l'onglet **Résumé**, sélectionnez **Données**. Ensuite, sous **Ensembles** de données, cliquez sur la flèche vers le bas à l'extrême droite du jeu de données pour le développer.

1. Choisissez l’icône en forme de crayon à côté du nom du jeu de données à gauche, puis saisissez un nom convivial. Nous vous recommandons d’utiliser un nom que vos lecteurs comprendront.

1. Pour **Description**, saisissez une description du jeu de données qui décrit les données qu’il contient.

## Étape 2 : Expliquer comment utiliser les champs de date dans vos ensembles de données
<a name="topics-natural-language-dataset-time-basis"></a>

Si votre jeu de données contient des informations de date et d'heure, nous vous recommandons d'indiquer comment utiliser ces informations pour répondre aux questions. Cela est particulièrement important si vous avez plusieurs colonnes de date et d’heure dans une rubrique.

Dans certains cas, il existe plusieurs colonnes de dates valides dans une rubrique, comme la date de commande et la date d’expédition. Dans ces cas, vous pouvez aider les lecteurs en spécifiant une date par défaut à utiliser pour répondre à leurs questions. Les lecteurs peuvent choisir une autre date si la date par défaut ne répond pas à leur question.

Vous pouvez également déterminer le degré de précision de vos colonnes de date et d'heure en spécifiant une base horaire. La *base temporelle* d’un jeu de données est le niveau le plus bas de granularité temporelle pris en charge par toutes les mesures du jeu de données. Ce paramètre permet d'agréger les métriques du jeu de données sur différentes dimensions temporelles et s'applique aux ensembles de données qui prennent en charge une granularité de date et d'heure unique. Cette option peut être définie pour les jeux de données dénormalisés comportant un grand nombre de métriques. Par exemple, si un jeu de données prend en charge plusieurs métriques à une agrégation quotidienne, vous pouvez définir la base temporelle de ce jeu de données sur **Quotidien**. Ceci est ensuite utilisé pour déterminer comment agréger les métriques.

**Pour définir la date et l’heure par défaut d’un jeu de données**

1. Ouvrez la rubrique que vous voulez modifier.

1. Dans l'onglet **Résumé**, sélectionnez **Données**. Ensuite, sous **Ensembles de données**, cliquez sur la flèche vers le bas à l'extrême droite du jeu de données pour le développer.

1. Pour **Date par défaut**, sélectionnez un champ de date.

1. Pour **Base temporelle**, choisissez le niveau de granularité le plus bas auquel vous souhaitez agréger les métriques du jeu de données. Vous pouvez regrouper les métriques d’une rubrique au niveau quotidien, hebdomadaire, mensuel, trimestriel ou annuel.

## Étape 3 : Exclure les champs inutilisés
<a name="topics-natural-language-exclude-fields"></a>

Lorsque vous ajoutez un jeu de données à une rubrique, toutes les colonnes (champs) du jeu de données sont ajoutées par défaut. Si votre jeu de données contient des champs que vous ou vos lecteurs n’utilisez pas, ou que vous ne voulez pas inclure dans les réponses, vous pouvez les exclure de la rubrique. L'exclusion de ces champs les supprime des réponses et de l'index et améliore la précision des réponses que reçoivent vos lecteurs.

**Pour exclure des rubriques d’une rubrique**

1. Ouvrez la rubrique que vous voulez modifier.

1. Dans la rubrique, sélectionnez l’onglet **Données**.

1. Dans la section **Champs**, sous **Inclure**, désactivez l’icône.

## Étape 4 : renommer les champs pour qu'ils soient natural-language-friendly
<a name="topics-natural-language-rename-fields"></a>

Les champs d’un jeu de données sont souvent nommés en fonction de conventions d’appellation techniques. Vous pouvez rendre les noms de vos champs plus conviviaux dans vos rubriques en les renommant et en ajoutant des descriptions. 

Les noms de champs sont utilisés pour comprendre les champs et les relier aux termes utilisés dans les questions de vos lecteurs. Lorsque les noms de vos champs sont faciles à utiliser, il est plus facile d'établir des liens entre les données et la question d'un lecteur. Ces noms conviviaux sont également présentés aux lecteurs dans le cadre de la réponse à leur question afin de fournir un contexte supplémentaire.

**Pour renommer et ajouter des descriptions à un champ**

1. Ouvrez la rubrique que vous voulez modifier.

1. Dans la rubrique, sélectionnez l’onglet **Données**.

1. Dans la section **Champs**, cliquez sur la flèche vers le bas située à l’extrême droite du champ pour le développer.

1. Cliquez sur l’icône représentant un crayon en regard du nom du champ à gauche, puis saisissez un nom convivial.

1. Pour **Description**, saisissez une description du champ.

## Étape 5 : Ajouter des synonymes aux champs et à leurs valeurs
<a name="topics-natural-language-synonyms"></a>

Même si vous avez modifié les noms de vos champs pour les rendre plus conviviaux et que vous leur avez donné une description, il se peut que vos lecteurs utilisent des noms différents pour les désigner. Par exemple, un champ `Sales` peut être désigné par `revenue`, `rev` ou `spending` dans les questions de vos lecteurs.

Pour mieux comprendre ces termes et les associer aux champs appropriés, vous pouvez ajouter un ou plusieurs synonymes à vos champs. Cela permet d'améliorer la précision.

Comme pour les noms de champs, vos lecteurs peuvent utiliser des noms différents pour désigner des valeurs spécifiques dans vos champs. Par exemple, si un champ contient les valeurs `NW`, `SE`, `NE` et `SW`, vous pouvez ajouter des synonymes pour ces valeurs. Vous pouvez ajouter `Northwest` pour `NW`, `Southeast` pour `SE`, etc.

**Pour ajouter des synonymes à un champ**

1. Ouvrez la rubrique que vous voulez modifier.

1. Dans la rubrique, sélectionnez l’onglet **Données**.

1. Dans la section **Champs**, sous **Synonymes**, cliquez sur l’icône du crayon pour le champ, saisissez un mot ou une phrase, puis appuyez sur la touche Entrée de votre clavier. Pour ajouter un autre synonyme, cliquez sur l’icône **\$1**.

**Pour ajouter des synonymes à une valeur dans un champ**

1. Ouvrez la rubrique que vous voulez modifier.

1. Dans la rubrique, sélectionnez l’onglet **Données**.

1. Dans la section **Champs**, cliquez sur la flèche vers le bas à l’extrême droite pour développer les informations sur le champ.

1. Sous **Aperçu de la valeur** à droite, choisissez **Configurer les synonymes de la valeur**.

1. Sur la page **Synonymes de valeur de champ** qui s’ouvre, choisissez **Ajouter**, puis procédez comme suit :

   1. Pour **Valeur**, choisissez la valeur à laquelle vous voulez ajouter des synonymes.

   1. Pour **Synonymes**, saisissez un ou plusieurs synonymes pour la valeur.

1. Choisissez **Enregistrer**.

1. Pour ajouter des synonymes à une autre valeur, répétez les étapes 5 et 6.

1. Lorsque vous avez terminé, cliquez sur **Terminé**.

## Étape 6 : Expliquez davantage vos champs
<a name="topics-natural-language-semantics"></a>

Pour mieux comprendre comment utiliser vos données pour répondre aux questions des lecteurs, vous pouvez expliquer davantage les champs de vos ensembles de données. 

Vous pouvez indiquer si un champ de votre jeu de données est une dimension ou une mesure et spécifier comment ce champ doit être agrégé. Vous pouvez également préciser le format des valeurs d’un champ et le type de données qu’il contient. La configuration de ces paramètres supplémentaires permet de créer des réponses précises pour vos lecteurs lorsqu'ils posent une question.

Utilisez les procédures suivantes pour en savoir plus sur vos champs.

### Attribution des rôles aux champs
<a name="topics-natural-language-semantics-role"></a>

Chaque champ de votre jeu de données est soit une dimension, soit une mesure. Les *dimensions* sont des données catégorielles et les *mesures* sont des données quantitatives. Savoir si un champ est une dimension ou une mesure détermine quelles opérations peuvent ou ne peuvent pas être effectuées sur un champ. 

Par exemple, définir les champs `Patient ID``Employee ID`, et `Ratings` aide à interpréter ces champs comme des entiers. Ce paramètre signifie que les champs ne seront pas agrégés lorsqu'ils seront mesurés.

**Pour définir le rôle d’un champ**

1. Ouvrez la rubrique que vous voulez modifier.

1. Dans la rubrique, sélectionnez l’onglet **Données**.

1. Dans la section **Champs**, cliquez sur la flèche vers le bas à l’extrême droite pour développer les informations sur le champ.

1. Pour **Rôle**, choisissez un rôle.

   Vous pouvez choisir une mesure ou une dimension.

1. (Facultatif) Si votre mesure est inversement proportionnelle (par exemple, plus le nombre est faible, mieux c’est), sélectionnez **Mesure inversée**.

   Cela explique comment interpréter et afficher les valeurs de ce champ.

### Définition des agrégations de champs
<a name="topics-natural-language-semantics-aggregation"></a>

La définition d'agrégations de champs permet de déterminer quelle fonction doit ou ne doit pas être utilisée lorsque ces champs sont agrégés sur plusieurs lignes. Vous pouvez définir une agrégation par défaut pour un champ et une agrégation non autorisée.

L’*agrégation par défaut* est celle qui est appliquée lorsqu’aucune fonction d’agrégation explicite n’est mentionnée ou identifiée dans la question d’un lecteur. Supposons, par exemple, que l'un de vos lecteurs demande : « Combien de produits ont été vendus hier ? » Dans ce cas, Q utilise le champ `Product ID`, dont l’agrégation par défaut est `count distinct`, pour répondre à la question. En procédant ainsi, on obtient une représentation visuelle montrant le décompte distinct de l’identifiant du produit.

Les *agrégations non autorisées* sont des agrégations qui ne peuvent pas être utilisées sur un champ pour répondre à une question. Ils sont exclus même si la question demande spécifiquement un agrégat non autorisé. Par exemple, disons que vous spécifiez que le champ `Product ID` ne doit jamais être agrégé par `sum`. Même si l'un de vos lecteurs vous demande : « Combien de produits au total ont été vendus hier ? » `sum` n'est pas utilisé pour répondre à la question.

Si les fonctions d'agrégation ne sont pas correctement appliquées à un champ, nous vous recommandons de définir des agrégations non autorisées pour le champ.

**Pour définir les agrégations de champs**

1. Ouvrez la rubrique que vous voulez modifier.

1. Dans la rubrique, sélectionnez l’onglet **Données**.

1. Dans la section **Champs**, cliquez sur la flèche vers le bas à l’extrême droite pour développer les informations sur le champ.

1. Pour **Agrégation par défaut**, choisissez l'agrégation à laquelle vous souhaitez agréger le champ par défaut.

   Vous pouvez agréger les mesures par somme, moyenne, maximum et minimum. Vous pouvez agréger les dimensions par comptage et comptage distinct.

1. (Facultatif) Pour **Agrégations non autorisées**, choisissez une agrégation que vous ne souhaitez pas utiliser.

1. (Facultatif) Si vous ne souhaitez pas agréger le champ dans un filtre, choisissez **Ne jamais agréger dans un filtre**.

### Indiquer comment formater les valeurs des champs
<a name="topics-natural-language-semantics-values"></a>

Si vous souhaitez expliquer comment formater les valeurs de vos champs, vous pouvez le faire. Par exemple, supposons que vous disposiez de la rubrique `Order Sales Amount`, qui contient des valeurs que vous voulez formater en dollars américains. Dans ce cas, vous pouvez expliquer comment formater les valeurs du champ en devise américaine lorsqu'elles sont utilisées dans les réponses.

**Pour spécifier le formatage des valeurs d’un champ**

1. Ouvrez la rubrique que vous voulez modifier.

1. Dans la rubrique, sélectionnez l’onglet **Données**.

1. Dans la section **Champs**, cliquez sur la flèche vers le bas à l’extrême droite pour développer les informations sur le champ.

1. Pour **Format de la valeur**, choisissez la façon dont vous voulez formater les valeurs du champ.

### Spécifier les types sémantiques des champs
<a name="topics-natural-language-semantics-types"></a>

Un *type sémantique* de champ est le type d’information représenté par les données d’un champ. Par exemple, un champ peut contenir des données de localisation, des données monétaires, des données d’âge ou des données booléennes. Vous pouvez spécifier un type sémantique et un sous-type sémantique supplémentaire pour les champs. Le fait de les spécifier permet de comprendre la signification des données stockées dans vos champs.

Suivez la procédure suivante pour spécifier les types et sous-types sémantiques des champs.

**Pour spécifier des types sémantiques de champ**

1. Ouvrez la rubrique que vous voulez modifier.

1. Dans la rubrique, sélectionnez l’onglet **Données**.

1. Dans la section **Champs**, cliquez sur la flèche vers le bas à l’extrême droite pour développer les informations sur le champ.

1. Pour le **type sémantique**, choisissez le type d’information que les données représentent.

   Pour les mesures, vous pouvez sélectionner les types durée, partie de date, emplacement, booléen, devise, pourcentage, âge, distance et identifiant. Pour les dimensions, vous pouvez sélectionner les types suivants : partie de date, lieu, booléen, personne, organisation et identifiant.

1. Pour le **sous-type sémantique**, choisissez une option pour spécifier davantage le type d’information que les données représentent.

   Les options disponibles dépendent du type sémantique que vous avez choisi et du rôle associé au champ. Pour obtenir une liste des types sémantiques et des sous-types associés pour les mesures et les dimensions, reportez-vous au tableau suivant.


| Type sémantique | Sous-type sémantique | Disponible pour les éléments suivants | 
| --- | --- | --- | 
|  Age  |  | Mesures | 
|  Booléen  |  | Dimensions et mesures | 
|  Currency  |  USD EUR GBP  | Mesures | 
|  Partie de date  |  jour semaine Mois Année Trimestre  | Dimensions et mesures | 
|  Distance  |  Kilomètre Compteur Yard Foot  | Mesures | 
|  Duration  |  Seconde Minute Heure jour  | Mesures | 
|  Identifiant  |  | Dimensions et mesures | 
|  Location  |  Code Zip Pays State Ville  | Dimensions et mesures | 
|  Organisation  |  | Dimensions | 
|  Pourcentage  |  | Mesures | 
|  Personne  |  | Dimensions | 

# Partage de sujets de Quick Sight
<a name="topics-sharing"></a>


|  | 
| --- |
|  S’applique à : édition Enterprise  | 


|  | 
| --- |
|    Public cible : administrateurs et auteurs d'Amazon Quick  | 

Après avoir créé une rubrique, vous pouvez la partager avec d’autres personnes de votre organisation. Le partage d'un sujet permet à vos utilisateurs de sélectionner le sujet et de poser des questions à son sujet dans la barre de recherche. Une fois que vous avez partagé une rubrique avec vos utilisateurs, vous pouvez leur attribuer des autorisations qui précisent qui peut modifier la rubrique.

**Pour partager une rubrique**

1. Sur la page de démarrage rapide, choisissez **Sujets sur** la gauche.

1. Sur la page **Rubriques** qui s’ouvre, ouvrez la rubrique que vous voulez partager.

1. Sur la page qui s’ouvre, choisissez **Partager** en haut à droite.

1. Sur la page **Partager la rubrique avec les utilisateurs** qui s’ouvre, choisissez l’utilisateur ou les utilisateurs avec lesquels vous voulez partager la rubrique.

   Vous pouvez utiliser la barre de recherche pour rechercher des utilisateurs par adresse e-mail.

1. Choisissez **Lecteur** ou **Copropriétaire** dans la colonne **Autorisation** pour attribuer des autorisations à vos utilisateurs.

   Pour plus d’informations sur ces autorisations, consultez la section suivante, [Gestion des autorisations des rubriques Amazon Quick Sight](topics-sharing-permissions.md).

1. Lorsque vous avez terminé de sélectionner les utilisateurs, choisissez **Partager**.

# Gestion des autorisations des rubriques Amazon Quick Sight
<a name="topics-sharing-permissions"></a>

Lorsque vous partagez vos sujets avec d'autres membres de votre organisation, vous souhaiterez peut-être contrôler qui peut les modifier. Pour ce faire, indiquez quels utilisateurs sont des lecteurs et lesquels sont des copropriétaires. *Les utilisateurs* peuvent voir le sujet dans la barre de recherche lorsqu'ils le sélectionnent dans la liste, mais ils ne peuvent pas modifier les données du sujet. *Les copropriétaires* peuvent voir le sujet dans la barre de recherche, et ils peuvent également changer de sujet.

**Pour attribuer des autorisations de rubrique à vos utilisateurs**

1. Sur la page de démarrage rapide, sélectionnez **Sujets**.

1. Sur la page **Sujets** qui s'ouvre, ouvrez le sujet pour lequel vous souhaitez gérer les autorisations.

1. Sur la page de la rubrique qui s’ouvre, choisissez **Partager** en haut à droite.

1. Sur la page **Partager la rubrique avec les utilisateurs** qui s’ouvre, choisissez **Gérer l’accès à la rubrique**.

1. Sur la page **Gérer les autorisations de la rubrique** qui s’ouvre, recherchez l’utilisateur dont vous voulez gérer l’accès, puis choisissez l’une des options suivantes pour **Autorisation** :
   + Pour permettre à un utilisateur d’afficher et de modifier la rubrique, choisissez **Copropriétaire**.
   + Pour permettre à un utilisateur d’afficher la rubrique uniquement, sélectionnez **Lecteur**.

# Examen des performances du sujet Quick Sight et des commentaires
<a name="topics-performance"></a>


|  | 
| --- |
|  S’applique à : édition Enterprise  | 


|  | 
| --- |
|    Public cible : administrateurs et auteurs d'Amazon Quick  | 

Après avoir créé une rubrique et l’avoir partagée avec vos utilisateurs, vous pouvez examiner les performances de cette rubrique. Lorsque quelqu'un utilise votre sujet pour poser une question ou fournit des commentaires sur la qualité de la réponse, celle-ci est enregistrée dans les onglets **Résumé** et **Activité utilisateur** du sujet.

Dans l’onglet **Résumé** de la rubrique, vous pouvez consulter les données historiques du nombre de questions posées au fil du temps, sur des périodes allant de sept jours à un an. Vous pouvez également voir la répartition des questions qui ont reçu un retour positif, négatif ou aucun retour, ainsi que les questions auxquelles il n’a pas été possible de répondre.

Dans l’onglet **Activité de l’utilisateur**, vous pouvez consulter une liste des questions posées par les utilisateurs et des commentaires positifs ou négatifs qu’ils ont laissés.

L’examen de ces informations peut vous aider à déterminer si votre rubrique répond aux besoins de vos utilisateurs. Par exemple, disons que vous avez une rubrique qui reçoit beaucoup de commentaires négatifs de la part de vos utilisateurs. Lorsque vous examinez l'activité de vos utilisateurs, vous remarquez que plusieurs utilisateurs laissent des commentaires sur une question qui leur a révélé des données erronées. En réponse, vous examinez les questions qu’ils ont posées et remarquez qu’ils utilisent un terme que vous n’aviez pas anticipé. Vous décidez d’ajouter ce terme comme synonyme au champ correct de la rubrique. Au fil du temps, vous constatez une augmentation des commentaires positifs.

## Examen des performances d’une rubrique
<a name="topics-performance-statistics"></a>

Utilisez la procédure suivante pour visualiser les performances d’une rubrique.

**Pour afficher les performances d’une rubrique**

1. Sur la page de démarrage rapide, choisissez **Sujets sur** la gauche.

1. Sur la page **Rubriques** qui s’ouvre, ouvrez la rubrique que vous voulez examiner.

   La rubrique s’ouvre et la section **Statistiques** affiche les statistiques de la rubrique.

1. (Facultatif) Pour modifier la quantité de données historiques affichées dans le graphique, choisissez l’une des options suivantes : **7 jours**, **30 jours**, **90 jours**, **120 jours** ou **12 mois**.

1. (Facultatif) Pour supprimer des données les questions auxquelles il était impossible de répondre, désactivez l’option **Inclure les données auxquelles il est impossible de répondre**.

1. (Facultatif) Pour supprimer des données les questions qui n’ont pas reçu de réponse, désactivez l’option **Inclure les données sans réponse**.

## Révision des questions d’une rubrique et du retour d’information
<a name="topics-performance-user-activity"></a>

Suivez les procédures suivantes pour examiner les questions et les commentaires d’une rubrique.

**Pour passer en revue les questions et les commentaires d’une rubrique**

1. Sur la page de démarrage rapide, sélectionnez **Sujets**.

1. Sur la page **Rubriques** qui s’ouvre, ouvrez la rubrique dont vous voulez examiner le retour d’information.

1. Sur la page de la rubrique qui s’ouvre, choisissez l’onglet **Activité de l’utilisateur**.

   L’activité de l’utilisateur pour la rubrique s’affiche. En haut, vous pouvez voir le nombre total de questions posées et le nombre de questions auxquelles il a été possible de répondre et de questions auxquelles il n’a pas été possible de répondre. Vous pouvez également voir le pourcentage de questions qui ont été évaluées positivement et négativement. En outre, vous pouvez voir le pourcentage de questions qui ont été désambiguïsées. Cela signifie que quelqu’un a saisi une question et mappé l’un des mots de la question à un champ de la rubrique.

   Vous pouvez choisir l’une de ces statistiques pour filtrer la liste des questions.

1. (Facultatif) Pour afficher un commentaire laissé par un utilisateur sur une question, cliquez sur la flèche vers le bas à droite de la question.

   Le commentaire est affiché à gauche.

1. (Facultatif) Pour afficher les champs utilisés pour répondre à une question, cliquez sur la flèche vers le bas à droite de la question.

   Les champs utilisés sont affichés à droite. Choisissez le nom d’un champ pour modifier ses métadonnées.

1. (Facultatif) Pour afficher une question désambiguïsée, cliquez sur la flèche vers le bas à droite d’une question dont le terme est surligné en rouge. 

   Une description du terme et du champ utilisé pour le désambiguïser s’affiche. Pour ajouter des synonymes au champ, sélectionnez **Ajouter des synonymes**.

1. (Facultatif) Pour voir comment une question a reçu une réponse, choisissez **Afficher** à côté de la question dans la liste.

1. (Facultatif) Pour filtrer la liste des questions, choisissez **Filtrer par** à droite, puis filtrez selon l’une des options suivantes.
   + **Voir toutes les questions** – Cette option supprime tous les filtres et affiche toutes les questions reçues par une rubrique.
   + **Répondable** – Cette option filtre la liste des questions en fonction de celles auxquelles il est possible de répondre. Les questions auxquelles on peut répondre sont celles auxquelles Q a pu répondre.
   + **Impossible de répondre** – Cette option permet de filtrer la liste des questions en fonction de celles auxquelles il est impossible de répondre. Les questions sans réponse sont des questions auxquelles Q n’a pas pu répondre.
   + **Désambiguïsées** – Cette option filtre la liste des questions vers celles qui ont été désambiguïsées, c’est-à-dire les questions dont les termes ont été mappés manuellement par les utilisateurs.
   + **Pas de retour** – Cette option filtre la liste des questions vers celles qui n’ont pas reçu de retour.
   + **Négatif** – Cette option filtre la liste des questions vers celles qui ont reçu un retour négatif.
   + **Positif** – Cette option filtre la liste des questions vers celles qui ont reçu un feedback positif.
   + **Pas de commentaires** – Cette option filtre la liste des questions vers celles qui n’ont pas reçu de commentaires de la part des utilisateurs.
   + **A des commentaires** – Cette option filtre la liste des questions vers celles qui ont reçu des commentaires de la part des utilisateurs.
   + **Utilisateur** – Cette option permet de filtrer la liste des questions sur celles qui ont été posées par un utilisateur ayant un nom d’utilisateur spécifique que vous avez saisi.

# Actualisation des index des rubriques de Quick Sight
<a name="topics-index"></a>


|  | 
| --- |
|  S’applique à : édition Enterprise  | 


|  | 
| --- |
|    Public cible : administrateurs et auteurs d'Amazon Quick  | 

Lorsque vous créez une rubrique, Quick Sight crée, stocke et gère un index contenant les définitions des données de cette rubrique. Cet index n'est pas exposé aux auteurs de Quick Sight. Il ne s’agit pas non plus d’une copie des jeux de données inclus dans une rubrique. Les métriques ne sont pas indexées. Par exemple, les mesures stockées sous forme de nombres entiers ne sont pas indexées.

L’index des rubriques est un index des valeurs uniques des rubriques incluses dans une rubrique. Cet index est utilisé pour générer des réponses correctes, fournir des suggestions de saisie semi-automatique lorsque quelqu'un pose une question et suggérer des mappages de termes avec des colonnes ou des valeurs de données.

Pour actualiser l’index d’une rubrique, actualisez les jeux de données de la rubrique. Vous pouvez actualiser manuellement tous les jeux de données d’une rubrique ou actualiser un jeu de données individuel. Vous pouvez également afficher l’historique des actualisations des jeux de données pour suivre les actualisations passées et définir un calendrier d’actualisation récurrent pour chaque jeu de données de la rubrique. Pour les jeux de données SPICE, vous pouvez synchroniser le calendrier d’actualisation de l’index de la rubrique avec le calendrier d’actualisation SPICE. Pour plus d’informations sur la définition des programmes d’actualisation SPICE, consultez la rubrique [Actualisation d’un jeu de données sur une planification](refreshing-imported-data.md#schedule-data-refresh).

**Note**  
Actuellement, les programmes d'actualisation horaire ne sont pas pris en charge. Vous pouvez définir un calendrier d'actualisation pour actualiser les ensembles de données d'une rubrique jusqu'à une fois par jour.

Nous vous recommandons de mettre à jour régulièrement les index des rubriques pour vous assurer que les définitions et les valeurs les plus récentes sont enregistrées. La mise à jour de l’index d’une rubrique prend environ 15 à 30 minutes, en fonction du nombre et de la taille des jeux de données inclus dans la rubrique.

**Pour actualiser l’index d’une rubrique**

1. Sur la page de démarrage rapide, sélectionnez **Sujets**.

1. Sur la page **Rubriques** qui s’ouvre, ouvrez la rubrique que vous voulez actualiser.

   La rubrique s’ouvre sur l’onglet **Résumé**, qui affiche les jeux de données inclus dans la rubrique en bas de page. Il indique également la date de la dernière actualisation de la rubrique en haut à droite.

1. Sélectionnez **Actualisé** en haut à droite pour actualiser l’index de la rubrique, puis choisissez **Actualiser les données**. Cette opération permet d’actualiser manuellement tous les jeux de données de la rubrique.

   Pour plus d’informations sur l’actualisation des jeux de données individuels d’une rubrique, consultez la rubrique [Actualisation des ensembles de données dans une rubrique Quick Sight](topics-data-refresh.md).

# Travaillez sur des sujets Quick Sight à l'aide d'Amazon Quick Sight APIs
<a name="topics-cli"></a>


|  | 
| --- |
|  S’applique à : édition Enterprise  | 


|  | 
| --- |
|    Public cible : développeurs Amazon Quick  | 

Utilisez cette section pour apprendre à utiliser les rubriques Quick Sight à l'aide de l'interface de ligne de commande (CLI) Amazon Quick Sight.

**Conditions préalables**

Avant de commencer, assurez-vous que vous disposez d'un rôle Gestion des identités et des accès AWS (IAM) qui autorise l'utilisateur de la CLI à appeler les opérations de l'API Quick Sight. Le tableau suivant indique les autorisations qui doivent être ajoutées à la politique IAM pour utiliser des opérations d’API spécifiques. Pour utiliser toutes les opérations d'API de la rubrique, ajoutez toutes les autorisations répertoriées dans le tableau.


| Opération API | Politique IAM | 
| --- | --- | 
|  `CreateTopic`  |  `quicksight:CreateTopic` `quicksight:PassDataSet`  | 
|  `ListTopics`  |  `quicksight:ListTopics`  | 
|  `DescribeTopic`  |  `quicksight:DescribeTopic`  | 
|  `DescribeTopicPermissions`  |  `quicksight:DescribeTopicPermissions`  | 
|  `DescribeTopicRefresh`  |  `quicksight:DescribeTopicRefresh`  | 
|  `DeleteTopic`  |  `quicksight:DeleteTopic`  | 
|  `UpdateTopic`  |  `quicksight:UpdateTopic` `quicksight:PassDataSet`  | 
|  `UpdateTopicPermissions`  |  `quicksight:UpdateTopicPermissions`  | 
|  `CreateTopicRefreshSchedule`  |  `quicksight:CreateTopicRefreshSchedule`  | 
|  `ListTopicRefreshSchedules`  |  `quicksight:ListTopicRefreshSchedules`  | 
|  `DescribeTopicRefreshSchedule`  |  `quicksight:DescribeTopicRefreshSchedule`  | 
|  `UpdateTopicRefreshSchedule`  |  `quicksight:UpdateTopicRefreshSchedule`  | 
|  `DeleteTopicRefreshSchedule`  |  `quicksight:DeleteTopicRefreshSchedule`  | 
|  `BatchCreateTopicReviewedAnswer`  |  `quicksight:BatchCreateTopicReviewedAnswer`  | 
|  `BatchDeleteTopicReviewedAnswer`  |  `quicksight:BatchDeleteTopicReviewedAnswer`  | 
|  `ListTopicReviewedAnswers`  |  `quicksight:ListTopicReviewedAnswers`  | 

L’exemple suivant montre une politique IAM qui permet à un utilisateur d’utiliser l’opération d’API `ListTopics`.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "quicksight:ListTopics"
            ],
            "Resource": "*"
        }
    ]
}
```

------

Après avoir configuré les autorisations pour créer des rubriques Quick Sight avec Quick Sight APIs, utilisez les rubriques suivantes pour créer et utiliser des rubriques Quick Sight APIs.

**Topics**
+ [Travaillez avec les sujets de Quick Sight à l'aide du Quick Sight APIs](topic-cli-examples.md)
+ [Configurer les programmes d'actualisation des rubriques de Quick Sight à l'aide de la CLI Quick Sight](topic-refresh-apis.md)
+ [Copier et migrer les rubriques Quick Sight au sein et entre les deux Comptes AWS](topic-cli-walkthroughs.md)
+ [Créez et modifiez des réponses révisées dans les rubriques de Quick Sight avec le Quick Sight APIs](topic-reviewed-answer-apis.md)

# Travaillez avec les sujets de Quick Sight à l'aide du Quick Sight APIs
<a name="topic-cli-examples"></a>

L'exemple suivant crée un nouveau sujet.

```
aws quicksight create-topic
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--topic TOPIC
```

Vous pouvez également créer une nouvelle rubrique en utilisant un fichier squelette CLI avec la commande suivante. Pour plus d'informations sur les fichiers de squelette de la CLI, consultez la section [Utilisation des fichiers de squelette de la CLI](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) dans le manuel *Amazon Quick Sight Developer Guide*.

```
aws quicksight create-topic
--cli-input-json file://createtopic.json
```

Lorsque vous créez une nouvelle rubrique, la configuration d'actualisation du jeu de données n'est pas copiée dans la rubrique. Pour définir un calendrier de rafraîchissement des rubriques pour votre nouvelle rubrique, vous pouvez effectuer un appel d’API `create-topic-refresh-schedule`. Pour plus d’informations sur la configuration des calendriers de rafraîchissement des rubriques avec la CLI, consultez la rubrique [Configurer les programmes d'actualisation des rubriques de Quick Sight à l'aide de la CLI Quick Sight](topic-refresh-apis.md).

Après avoir créé votre premier sujet, vous pouvez le mettre à jour, le supprimer, le répertorier ou demander un résumé d'un sujet.

L'exemple suivant met à jour une rubrique.

```
aws quicksight update-topic
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--topic TOPIC
```

Vous pouvez également mettre à jour une rubrique à l'aide d'un fichier squelette de la CLI avec la commande suivante. Pour plus d'informations sur les fichiers de squelette de la CLI, consultez la section [Utilisation des fichiers de squelette de la CLI](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) dans le manuel *Amazon Quick Sight Developer Guide*.

```
aws quicksight update-topic
--cli-input-json file://updatetopic.json
```

L'exemple suivant fournit une liste de toutes les rubriques d'un compte Quick.

```
aws quicksight list-topics 
--aws-account-id AWSACCOUNTID
```

L'exemple suivant supprime une rubrique.

```
aws quicksight delete-topic 
--aws-account-id AWSACCOUNTID 
--topic-id TOPICID
```

L'exemple suivant fournit des informations sur la façon dont une rubrique a été configurée.

```
aws quicksight describe-topic 
--aws-account-id AWSACCOUNTID 
--topic-id TOPICID
```

La commande suivante met à jour les autorisations d'une rubrique.

```
aws quicksight update-topic-permissions
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--grant-permissions Principal=arn:aws:quicksight:us-east-1:AWSACCOUNTID:user/default/USERNAME,Actions=quicksight:DescribeTopic
--revoke-permissions Principal=arn:aws:quicksight:us-east-1:AWSACCOUNTID:user/default/USERNAME,Actions=quicksight:DescribeTopic
```

Utilisez le `grant-permissions` paramètre pour accorder des autorisations de lecture et de création aux utilisateurs du compte Quick. Pour accorder des autorisations de lecture à un utilisateur de compte, saisissez la valeur suivante : `"quicksight:DescribeTopic"`. Pour accorder des autorisations à un utilisateur de compte, entrez les valeurs suivantes :
+ `"quicksight:DescribeTopic"`
+ `"quicksight:DescribeTopicRefresh"`
+ `"quicksight:ListTopicRefreshSchedules"`
+ `"quicksight:DescribeTopicRefreshSchedule"`
+ `"quicksight:DeleteTopic"`
+ `"quicksight:UpdateTopic"`
+ `"quicksight:CreateTopicRefreshSchedule"`
+ `"quicksight:DeleteTopicRefreshSchedule"`
+ `"quicksight:UpdateTopicRefreshSchedule"`
+ `"quicksight:DescribeTopicPermissions"`
+ `"quicksight:UpdateTopicPermissions"`

Le paramètre `RevokePermissions` révoque toutes les autorisations accordées à un utilisateur de compte.

La commande suivante décrit toutes les autorisations associées à une rubrique.

```
aws quicksight describe-topic-permissions 
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
```

Après avoir créé un sujet Quick Sight, vous pouvez utiliser Amazon Quick Sight APIs pour [configurer un calendrier d'actualisation des sujets](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-refresh-apis), [migrer les sujets Quick Sight au sein de comptes ou entre](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-cli-walkthroughs) eux, et [créer des réponses révisées](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-reviewed-answer-apis).

# Configurer les programmes d'actualisation des rubriques de Quick Sight à l'aide de la CLI Quick Sight
<a name="topic-refresh-apis"></a>

La commande suivante crée un calendrier d'actualisation d'une rubrique.

```
aws quicksight create-topic-refresh-schedule
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--dataset-arn DATASETARN
--refresh-schedule REFRESHSCHEDULE
```

Après avoir créé un calendrier d'actualisation pour un sujet, vous pouvez le mettre à jour, le supprimer, le répertorier ou demander un résumé du calendrier d'actualisation du sujet.

La commande suivante met à jour le calendrier d'actualisation d'une rubrique.

```
aws quicksight update-topic-refresh-schedule 
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--dataset-id DATASETID
--refresh-schedule REFRESHSCHEDULE
```

L'exemple suivant fournit une liste de toutes les programmations d'actualisation configurées pour une rubrique.

```
aws quicksight list-topic-refresh-schedules
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
```

L’exemple suivant supprime un programme d’actualisation d’une rubrique.

```
aws quicksight delete-topic-refresh-schedule 
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--dataset-id DATASETID
```

L’exemple suivant fournit des informations sur la configuration d’un programme d’actualisation de rubrique.

```
aws quicksight describe-topic-refresh-schedule  
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--dataset-id DATASETID
```

# Copier et migrer les rubriques Quick Sight au sein et entre les deux Comptes AWS
<a name="topic-cli-walkthroughs"></a>

Vous pouvez migrer vos sujets Quick Sight d'un compte à un autre à l'aide de l'interface de ligne de commande (CLI) de Quick Sight. Au lieu de répliquer manuellement le même sujet sur plusieurs tableaux de bord, espaces de noms ou comptes, vous pouvez utiliser la CLI Quick Sight pour réutiliser le même sujet à plusieurs reprises. Cette fonctionnalité permet aux auteurs de Quick Sight de gagner du temps et de créer une expérience thématique standardisée pour les lecteurs de tableaux de bord sur plusieurs tableaux de bord.

Pour migrer des rubriques à l'aide de la CLI Quick Sight, procédez comme suit

**Pour migrer un sujet vers un autre compte**

1. Commencez par identifier la rubrique que vous voulez migrer. Vous pouvez consulter la liste de tous les sujets de votre compte Quick à l'aide d'une commande `list-topics` API.

   ```
   aws quicksight list-topics --aws-account-id AWSACCOUNTID
   ```

1. Une fois que vous avez une liste de sujets, localisez le sujet que vous souhaitez migrer et passez un `describe-topic` appel pour recevoir une structure JSON de configuration du sujet.

   ```
   aws quicksight describe-topic 
       --aws-account-id AWSACCOUNTID
       --topic-id TOPICID
   ```

   Vous trouverez ci-dessous un exemple de réponse `describe-topic` de l’API.

   ```
   {
       "Status": 200,
       "TopicId": "TopicExample", 
       "Arn": "string",
       "Topic": [
           {
               "Name": "{}",
               "DataSets": [
               {
               "DataSetArn": "{}",
               "DataSetName": "{}",
               "DataSetDescription": "{}",
               "DataAggregation": "{}",
               "Filters": [],
               "Columns": [],
               "CalculatedFields": [],
               "NamedEntities": []
               }
               ]
           }
       ],
       "RequestId": "requestId"
       }
   ```

1. Utilisez la réponse JSON pour créer un fichier squelette que vous pouvez saisir lors d'un nouvel `create-topic` appel dans votre autre compte Quick. Avant d'effectuer un appel d'API avec votre fichier squelette, assurez-vous de modifier l' Compte AWS ID et l'ID du jeu de données dans le fichier squelette pour qu'ils correspondent à l' Compte AWS ID et à l'ID du jeu de données auxquels vous ajoutez le nouveau sujet. Pour plus d'informations sur les fichiers de squelette de la CLI, consultez la section [Utilisation des fichiers de squelette de la CLI](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) dans le manuel *Amazon Quick Sight Developer Guide*.

   ```
   aws quicksight create-topic --aws-account-id AWSACCOUNTID \
   --cli-input-json file://./create-topic-cli-input.json
   ```

Après avoir `create-topic` appelé l'API Quick Sight, le nouveau sujet apparaît dans votre compte. Pour vérifier que le nouveau sujet existe, `list-topics` appelez l'API Quick Sight. Si la rubrique source qui a été dupliquée contient des réponses vérifiées, celles-ci ne sont pas migrées vers la nouvelle rubrique. Pour afficher une liste de toutes les réponses vérifiées qui sont configurées pour la rubrique d'origine, utilisez un appel d'API `describe-topic`.

# Créez et modifiez des réponses révisées dans les rubriques de Quick Sight avec le Quick Sight APIs
<a name="topic-reviewed-answer-apis"></a>

Après avoir créé un sujet Quick Sight, vous pouvez utiliser le Quick Sight APIs pour créer, répertorier, mettre à jour et supprimer les réponses révisées pour les sujets.

La commande ci-dessous crée par lots jusqu'à 100 réponses révisées pour un sujet de Quick Sight.

```
aws quicksight batch-create-topic-reviewed-answer \
--topic-id TOPICID \
--aws-account-id AWSACCOUNTID \                 
—answers ANSWERS
```

Vous pouvez également créer par lots des réponses révisées à partir d’un fichier squelette CLI à l’aide de la commande suivante. Pour plus d'informations sur les fichiers de squelette de la CLI, consultez la section [Utilisation des fichiers de squelette de la CLI](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) dans le manuel *Amazon Quick Sight Developer Guide*.

```
aws quicksight batch-create-topic-reviewed-answer \ 
--cli-input-json file://createTopicReviewedAnswer.json
```

La commande ci-dessous répertorie toutes les réponses révisées dans une rubrique Quick Sight.

```
aws quicksight list-topic-reviewed-answers \
--aws-account-id AWSACCOUNTID \
--topic-id TOPICID \
```

L’exemple ci-dessous supprime par lots jusqu’à 100 réponses révisées d’une rubrique.

```
aws quicksight batch-delete-topic-reviewed-answer \
--topic-id TOPICID \
--aws-account-id AWSACCOUNTID \                 
—answer-ids: ["AnswerId1, AnswerId2…"]
```

Vous pouvez également créer par lots des réponses révisées à partir d’un fichier squlette CLI à l’aide de la commande suivante. Pour plus d'informations sur les fichiers de squelette de la CLI, consultez la section [Utilisation des fichiers de squelette de la CLI](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) dans le manuel *Amazon Quick Sight Developer Guide*.

```
aws quicksight batch-delete-topic-reviewed-answer \
--cli-input-json file://deleteTopicReviewedAnswer.json
```

Pour mettre à jour une réponse révisée, supprimez la réponse existante de la rubrique à l’aide de l’API `batch-delete-topic-reviewed-answer`. Utilisez ensuite l’API `batch-create-topic-reviewed-answer` pour ajouter la réponse révisée mise à jour au sujet.