Commande NOTES

Crée, modifie ou supprime une note associée à un enregistrement individuel dans une table Analytics.

Syntaxe

NOTES <IF test> <TEXT texte_note> <APPEND> <CLEAR>

Paramètres

Nom Description

IF test

optionnel

Expression conditionnelle qui doit être vraie afin de traiter chaque enregistrement. La commande est exécutée uniquement sur les enregistrements remplissant la condition.

Remarque

La condition IF est évaluée uniquement par rapport aux enregistrements restant dans une table après application des options relevant du champ d'application (WHILE, FIRST, NEXT).

  • Si vous n'indiquez pas de test IF, le texte de la note est ajouté à chaque enregistrement de la table
  • Si vous indiquez un test IF et CLEAR, les notes des enregistrements qui remplissent la condition sont supprimées
TEXT texte_note

optionnel

Texte à ajouter sous forme de note. texte_note doit être soit une chaîne entre guillemets, soit une expression caractères.

APPEND

optionnel

Le texte de la note est ajouté à la fin de toutes les notes existantes. Si vous omettez ce paramètre, toutes les notes existantes sont écrasées.

EFFACER

optionnel

Les notes sont supprimées. Même si toutes les notes des enregistrements d'un tableau sont supprimées, le champ auto-généré RecordNote n'est pas supprimé du format de la table.

Exemples

Ajout de la même note à plusieurs enregistrements

Toutes les notes existantes pour les enregistrements indiqués sont écrasées :

NOTES IF MATCH(RECNO();1;3;5;7) TEXT "texte note"

Ajout ou annexion de la même note à plusieurs enregistrements

Le nouveau texte de note est ajouté aux notes existantes pour les enregistrements indiqués :

NOTES IF MATCH(RECNO();1;3;5;7) TEXT "texte note" APPEND

Suppression de notes à partir d'enregistrements multiples

Toutes les notes d'enregistrements dans la table sont supprimées :

NOTES CLEAR

Les notes des enregistrements spécifiés sont supprimées :

NOTES IF MATCH(RECNO();1;3;5;7) CLEAR

Les notes des enregistrements 1 à 100 sont supprimées :

NOTES IF RECNO() <= 100 CLEAR

Remarques

Suppression du champ NoteEnregistrement

Pour supprimer le champ NoteEnregistrement du format de la table et toutes les notes de la table, utilisez la commande DELETE NOTES sans aucune option spécifiée.

Guide de création de scripts ACL 14.1