Utiliser des commentaires dans des projets Analytics

Dans Analytics, vous pouvez créer différents types de commentaires pour consigner des informations sur certains éléments de projet. Les commentaires sont particulièrement utiles pour enregistrer des informations sur un processus qui est régulièrement répété. Lorsque plusieurs personnes travailleront sur un projet Analytics, les commentaires leur faciliteront la compréhension des procédures que vous créez.

Vous pouvez ajouter des commentaires aux éléments suivants :

  • Projet Analytics
  • format de table
  • vue
  • enregistrement
  • champ
  • script
  • environnement de travail

Ajouter ou modifier des commentaires sur les projets Analytics

Vous pouvez ajouter un commentaire à un projet Analytics pour enregistrer tout détail à son sujet que vous souhaitez conserver à des fins de référence future ou pour documenter votre projet à l'attention d'autres utilisateurs. Vous pouvez modifier le contenu d'un commentaire de projet à tout moment.

  1. Cliquez avec le bouton droit de la souris sur le projet Analytics, dans l'onglet Vue globale du Navigateur.Analytics

    Le projet Analytics est l'entrée située au plus haut niveau au sein de l'arborescence.

  2. Sélectionnez Propriétés.
  3. Dans la boîte de dialogue Propriétés du projet, cliquez sur l'onglet Commentaires.
  4. Entrez un nouveau commentaire ou modifiez le commentaire existant.

    Pour supprimer le commentaire, supprimez tout le texte.

  5. Cliquez sur OK pour fermer la boîte de dialogue et enregistrer vos changements.

Ajouter ou modifier des commentaires de format de table

Vous pouvez ajouter un commentaire à un format de table pour enregistrer des informations comme l'heure et le mode d'accès à la source de données, les champs calculés définis ou les étapes d'analyse à effectuer sur la table. Vous pouvez ajouter un commentaire à un format de table dans la boîte de dialogue Format de table ou dans l'onglet Vue globale du Navigateur. Vous pouvez modifier le contenu d'un commentaire du format de table à tout moment.

Si vous conservez les commentaires du format de table dans le Navigateur, il n'est pas nécessaire d'ouvrir la table pour ajouter, modifier, supprimer ou lire le commentaire.

Les commentaires du format de table apparaissent dans les rapports Analytics imprimés si l'option Inclure l'historique du rapport avec les rapports est sélectionnée dans la boîte de dialogue Options (paramètre par défaut). Pour plus d'informations, consultez la rubrique Options d'impression.

Ajouter ou modifier un commentaire à partir de l'onglet Vue globale

  1. Cliquez avec le bouton droit de la souris sur la table dans l'onglet Vue globale du Navigateur, puis sélectionnez Propriétés.
  2. Dans la boîte de dialogue Propriétés de la table, cliquez sur l'onglet Commentaires.
  3. Entrez un nouveau commentaire ou modifiez le commentaire existant.

    Pour supprimer le commentaire, supprimez tout le texte.

  4. Cliquez sur OK pour fermer la boîte de dialogue et enregistrer vos changements.

Ajouter ou modifier un commentaire à partir de la boîte de dialogue Format de table

  1. Sélectionnez Modifier > Format de table.
  2. Cliquez sur l'onglet Options de format de table.
  3. Cliquez sur Modifier le commentaire de format de table .
  4. Entrez un nouveau commentaire ou modifiez le commentaire existant.

    Pour supprimer le commentaire, supprimez tout le texte.

  5. Cliquez sur Fermer .

    Le commentaire est enregistré automatiquement.

  6. Cliquez sur Fermer  pour quitter la boîte de dialogue Format de table.

Ajouter ou modifier des commentaires sur des vues

Vous pouvez ajouter un commentaire à une vue pour fournir des informations supplémentaires à propos de la vue. Le commentaire est propre à cette vue particulière et est copié dans toutes les nouvelles vues créées à partir de celle-ci. Vous pouvez modifier le contenu d'un commentaire des vues à tout moment.

Les commentaires des vues s'affichent dans les rapports Analytics imprimés si vous sélectionnez Inclure les commentaires des vues dans l'historique du rapport dans la boîte de dialogue Options. Pour plus d'informations, consultez la rubrique Options d'impression.

  1. Cliquez avec le bouton droit de la souris sur le bouton correspondant à la vue à laquelle vous voulez ajouter un commentaire, en bas de l'onglet Vue, puis sélectionnez Propriétés.
  2. Dans la boîte de dialogue Propriétés de la vue, cliquez sur l'onglet Commentaires.
  3. Entrez un nouveau commentaire ou modifiez le commentaire existant.

    Pour supprimer le commentaire, supprimez tout le texte.

  4. Cliquez sur OK pour fermer la boîte de dialogue et enregistrer vos changements.

Ajouter ou modifier des commentaires sur des enregistrements

Vous pouvez ajouter un commentaire pour fournir des informations supplémentaires sur l'enregistrement ou pour créer un lien vers un fichier associé. Un commentaire ajouté à un enregistrement est disponible dans toutes les vues de la table qui incluent l'enregistrement. Vous pouvez modifier le contenu d'un commentaire d'enregistrement à tout moment.

Icône commentaire

Les enregistrements auxquels un commentaire est joint sont identifiés à l'aide d'une icône commentaire, située en regard du numéro de l'enregistrement dans la vue . Une icône commentaire située dans le coin inférieur gauche de l'icône standard des tables permet d'identifier les tables comprenant un ou plusieurs enregistrements avec commentaire dans l'onglet Vue globale du Navigateur.

Le champ NoteEnregistrement

Lorsque vous ajoutez le premier commentaire d'enregistrement dans une table, Analytics ajoute automatiquement un champ nommé NoteEnregistrement au format de table, qui est utilisé pour contenir les commentaires des enregistrements. Vous pouvez afficher les commentaires d'enregistrement dans les vues ou les inclure dans les rapports Analytics imprimés en ajoutant la colonne NoteEnregistrement à la vue. Après avoir ajouté la colonne NoteEnregistrement, vous pouvez double-cliquer sur les valeurs de la colonne pour facilement gérer les commentaires des enregistrements.

Étapes

Astuce

Pour ajouter ou modifier plusieurs commentaires d'enregistrement en même temps, utilisez la commande NOTES.

  1. Cliquez avec le bouton droit de la souris sur le numéro d'enregistrement approprié dans la colonne du numéro d'enregistrement dans l'onglet Vue (première colonne grise tout à gauche), puis sélectionnez Modifier le commentaire.
  2. Entrez un nouveau commentaire ou modifiez le commentaire existant.

    Pour supprimer le commentaire, supprimez tout le texte.

  3. Pour créer un lien vers un fichier associé, procédez comme suit :
    1. Dans le commentaire, placez le curseur là où vous souhaitez insérer le lien.
    2. Cliquez sur Référence du fichier .
    3. Sélectionnez le fichier approprié dans la boîte de dialogue Ouvrir, puis cliquez sur Ouvrir.

      Un lien vers le fichier est ajouté dans le commentaire à l'aide de la syntaxe suivante :

      fichier:///<chemin_vers_fichier>

  4. Cliquez sur OK pour fermer la boîte de dialogue et enregistrer vos changements.
  5. Si vous souhaitez afficher des commentaires d'enregistrement dans une vue, ou les inclure dans les rapports Analytics imprimés, procédez comme suit :
    1. Cliquez dans la zone d'affichage avec le bouton droit de la souris, puis sélectionnez Ajouter des colonnes.
    2. Dans la liste Champs disponibles, double-cliquez sur NoteEnregistrement et cliquez sur OK.

Enregistrer des commentaires d'enregistrement

Au besoin, vous pouvez enregistrer des commentaires d'enregistrement dans un fichier texte ou dans une autre table Analytics.

À chaque fois que vous mettez à jour les données dans une table Analytics (Rafraîchir depuis la source), tous les commentaires d'enregistrement contenus dans la table sont supprimés automatiquement. Vous pouvez enregistrer les commentaires d'enregistrement avant de mettre à jour la table ou vous pouvez utiliser l'option Analytics vous permettant d'enregistrer les commentaires dans le processus de mise à jour de la table. Les commentaires enregistrés présentent un format légèrement différent en fonction de leur mode d'enregistrement.

Enregistrer les commentaires dans un fichier texte avant de mettre à jour une table

  1. Entrez la syntaxe suivante dans la ligne de commande :

    LIST Recno() NoteEnregistrement to <nom_fichier.txt>

    Par exemple, LIST Recno() NoteEnregistrement to Notes_enregistrement_trans_fournisseurs.txt

    Le nom du fichier texte ne doit pas inclure d'espaces.

  2. Cliquez sur Exécuter .

Enregistrer les commentaires d'enregistrement dans une autre table Analytics avant de mettre à jour une table

  1. Exécutez une extraction standard par champs, puis sélectionnez le champ NoteEnregistrement.
  2. Sélectionnez au moins un autre champ à extraire ou créez l'expression « Recno( ) », puis ajoutez l'expression sous forme de champ supplémentaire à extraire.

    Analytics ne permet pas d'extraire le champ NoteEnregistrement tout seul.

Enregistrer les commentaires d'enregistrement dans un fichier texte pendant la mise à jour d'une table

Pendant le processus de mise à jour d'une table, cliquez sur Oui lorsque vous êtes invité à enregistrer les commentaires dans un fichier.

Les commentaires d'enregistrement sont enregistrés dans un fichier intitulé <nom_table.txt>. Le fichier se trouve dans le même répertoire que le projet Analytics.

Supprimer des commentaires d'enregistrement

Vous pouvez supprimer des commentaires d'enregistrement d'une manière individuelle ou sélective ou bien supprimer simultanément l'ensemble des commentaires d'enregistrement contenus dans une table.

Supprimer des commentaires d'enregistrement de manière individuelle

  1. Cliquez avec le bouton droit de la souris sur le numéro d'enregistrement approprié dans la colonne du numéro d'enregistrement dans l'onglet Vue (première colonne grise tout à gauche), puis sélectionnez Modifier le commentaire.
  2. Supprimez tout le contenu de la boîte de dialogue Modifier le commentaire, en veillant à supprimer les espaces ou les retours chariot précédant ou suivant le texte, puis cliquez sur OK.

Remarque

Lorsque vous supprimez tous les commentaires d'enregistrement d'une table de façon individuelle, le champ NoteEnregistrement généré automatiquement n'est pas supprimé du format de table. Autrement dit, l'icône représentant le commentaire continue d'apparaître avec l'icône de la table dans l'onglet Vue globale dans le Navigateur.

Si votre objectif est de supprimer l'ensemble des commentaires d'enregistrement contenus dans une table, utilisez la méthode permettant de supprimer tous les commentaires d'enregistrement, qui supprime également le champ NoteEnregistrement.

Supprimer des commentaires d'enregistrement de manière sélective

  1. Entrez l'expression suivante dans la ligne de commande, en utilisant une instruction IF qui identifie les enregistrements contenant les commentaires à supprimer :

    NOTES IF <critères de filtre appropriés> CLEAR

    Par exemple, NOTES IF Emplacement = "03" CLEAR supprime les commentaires des enregistrements Emplacement 3.

  2. Cliquez sur Exécuter .

Supprimer tous les commentaires d'enregistrement d'une table à la fois

  1. Si la colonne NoteEnregistrement s'affiche dans la vue, supprimez-la en cliquant avec le bouton droit de la souris sur l'en-tête de colonne et en sélectionnant Supprimer les colonnes sélectionnées.
  2. Sélectionnez Modifier > Commentaires > Supprimer tous les commentaires de la table.
  3. Cliquez sur OK dans la boîte de dialogue de confirmation.

    Une fois tous les commentaires d'enregistrement supprimés, le champ NoteEnregistrement est supprimé du format de table ; au moment du rafraîchissement de l'écran, l'icône de commentaire disparaît de l'icône de table dans le Navigateur.

Ajouter ou modifier des commentaires dans des champs

Vous pouvez ajouter un commentaire à un champ pour fournir des informations supplémentaires à propos du champ. Le commentaire s'affiche dans la colonne Commentaire de l'onglet Modifier champs/expressions de la boîte de dialogue Format de table. Vous pouvez modifier le contenu d'un commentaire de champ à tout moment.

Les commentaires de champ s'affichent dans les rapports Analytics imprimés si vous sélectionnez Inclure les définitions de champs dans l'historique de la table dans la boîte de dialogue Options. Pour plus d'informations, consultez la rubrique Options d'impression.

  1. Sélectionnez Modifier > Format de table.
  2. Dans l'onglet Modifier champs/expressions, double-cliquez sur le champ auquel vous voulez ajouter un commentaire.
  3. Cliquez sur Modifier le commentaire du champ .
  4. Entrez un nouveau commentaire ou modifiez le commentaire existant.

    Pour supprimer le commentaire, supprimez tout le texte.

  5. Cliquez sur Fermer .

    Le commentaire est enregistré automatiquement.

  6. Cliquez sur Accepter l'entrée  .

Ajouter ou modifier des commentaires dans des scripts

Vous pouvez ajouter un commentaire à un élément de projet de script pour enregistrer tout détail général à son sujet que vous souhaitez conserver à des fins de référence future ou pour documenter votre projet à l'attention d'autres utilisateurs.

Les commentaires ajoutés à un élément de projet de script sont externes au script lui-même ; ils ne sont pas équivalents aux commentaires incorporés au corps d'un script. Vous pouvez modifier le contenu d'un commentaire d'élément de projet de script à tout moment.

Il n'est pas nécessaire d'ouvrir le script pour ajouter, modifier, supprimer ou lire le commentaire.

  1. Cliquez avec le bouton droit de la souris sur le script dans l'onglet Vue globale du Navigateur.
  2. Sélectionnez Propriétés.
  3. Dans la boîte de dialogue Propriétés du script, cliquez sur l'onglet Commentaires.
  4. Entrez un nouveau commentaire ou modifiez le commentaire existant.

    Pour supprimer le commentaire, supprimez tout le texte.

  5. Cliquez sur OK pour fermer la boîte de dialogue et enregistrer vos changements.

Ajouter ou modifier des commentaires d'environnement de travail

Pour plus d'informations, consultez la section Ajouter ou modifier un commentaire d'environnement de travail.