Annotation renvoie les informations demandées relatives à une annotation dans un objet de grille. Vous pouvez définir les informations à renvoyer.
Syntaxe :
<<Annotation("NomGrille", Ligne, Col, Page, Attributs, Référence, PiècesJointes)>>
<<Annotation("NomGrille", Ligne, Col, Page)>>
<<Annotation("NomGrille", Ligne, Col, Page, Attributs, Référence)>>
<<Annotation("NomGrille", Ligne, Col, Page, Attributs, PiècesJointes)>>
<Annotation("NomGrille", AllRows, AllCols, Page, Attributs, PiècesJointes)>>
où :
NomGrille est le nom de la grille contenant les annotations. Le mot-clé "current" est pris en charge lorsque l'attribut est utilisé dans une cellule de texte ou un en-tête personnalisé de la grille.
Ligne est le numéro de la ligne dans la grille. Le mot-clé "current" est pris en charge lorsque l'attribut est utilisé dans une cellule de texte ou un en-tête personnalisé de la grille.
Remarque :
Pour sélectionner toutes les lignes, vous pouvez remplacer Ligne par le mot-clé AllRows.
Col est la référence (ou lettre) de la colonne dans la grille. Le mot-clé "current" est pris en charge lorsque l'attribut est utilisé dans une cellule de texte ou un en-tête personnalisé de la grille.
Remarque :
Pour sélectionner toutes les colonnes, vous pouvez remplacer Col par le mot-clé AllCols.
Page est une valeur numérique représentant l'index des combinaisons de membres sur toutes les dimensions de page de la grille. La première combinaison de dimensions de page d'une grille possède un index de 1, la deuxième un index de 2, et ainsi de suite.
Attributs identifie les informations de l'annotation à renvoyer. Ils peuvent inclure le mot-clé All (valeur par défaut) ou une combinaison des mots-clés suivants : Title & Description & Author & Date & Category. Les mots-clés d'attribut peuvent être disposés dans n'importe quel ordre de sortie. Les attributs doivent être séparés par des esperluettes (&).
Référence correspond à un mot-clé indiquant les annotations à renvoyer. Il peut s'agir de :
All (par défaut) renvoie l'annotation initiale et toutes les réponses.
Top <n> renvoie l'annotation initiale et les <n> premières réponses.
Bottom <n> renvoie l'annotation initiale et les <n> dernières réponses. L'annotation initiale est toujours affichée et le nombre <n> n'inclut pas l'annotation initiale.
BottomOnly <n> renvoie les <n> dernières réponses. L'annotation initiale est affichée si <n> est inférieur ou égal à 4 ; elle ne l'est pas si <n> est supérieur ou égal à 5.
First renvoie uniquement l'annotation initiale.
Replies renvoie toutes les réponses. L'annotation initiale n'est pas affichée.
PiècesJointes est une valeur booléenne (true/false) indiquant si les pièces jointes associées à l'annotation doivent être imprimées avec le rapport :
True : les pièces jointes sont imprimées à la fin du rapport.
False : les pièces jointes ne sont pas imprimées.
Exemples :
<<Annotation("Grille1", cur, A, cur, All, All, true)>>
<<Annotation("Grille1", cur, A, cur, Title & Description & Author & Date & Category, Top 10, true)>>
<<Annotation("Grille10", 284, AB, cur, Title & Description & Date & Category, Bottom 10, false)>>
<<Annotation("Grille1", cur, A, cur, Title & Description & Author, BottomOnly 4, false)>>
<<Annotation("NomGrille", 1, A, 1, All)>>
<<Annotation("Nom Grille","AllRows", "AllCols", 1, All)>>
<<Annotation("NomGrille", 1, A, 1, All, First)>>
<<Annotation("NomGrille", 1, cur, cur, All, Replies)>>
<<Annotation("NomGrille", 1, cur, cur)>>
<<Annotation("NomGrille",1, cur, cur, Desc, Replies)>>
<<Annotation(cur, cur, A, cur, Desc)>>
<<Annotation(cur, 3, ABC, cur, title & Desc, true)>>
<<Annotation("dossier1\dossier2\Grille2", 3,A,cur, Title & Description, true)>>
<<Annotation(current, 294, AB, cur, Title & Description, Top 19)>>
<<Annotation(current, 39, AB, cur, Title & Description & Author, Bottom 40)>>
Comportement des annotations dans les zones de texte
Le comportement des annotations dans les zones de texte et lignes de texte de grille lors de l'utilisation du mot-clé "cur" est différent.
Pour les lignes de texte, vous pouvez utiliser le mot-clé "cur".
Par exemple, <<Annotation("Grille1", 1, A, cur, All, All, true)>>
Pour les zones de texte, le mot-clé "cur" ne renvoie aucun résultat. Par conséquent, vous devez saisir <<Annotation("Grille1", 1, A, cur, All, All, true)>>.