Annotation devuelve la información solicitada sobre una anotación específica de un objeto de cuadrícula. Puede definir qué información desea devolver.
Sintaxis:
<<Annotation("GridName", Row, Col, Page, Attributes, Reference, Attachments)>>
<<Annotation("GridName", Row, Col, Page)>>
<<Annotation("GridName", Row, Col, Page, Attributes, Reference)>>
<<Annotation("GridName", Row, Col, Page, Attributes, Attachments)>>
<Annotation("GridName", AllRows, AllCols, Page, Attributes, Attachments)>>
donde:
GridName es el nombre de la cuadrícula que contiene las anotaciones. La palabra clave "current" se soporta cuando se utiliza Attribute en la celda de texto de una cuadrícula o en la cabecera personalizada.
Row es el número de fila de la cuadrícula. La palabra clave "current" se soporta cuando se utiliza Attribute en la celda de texto de una cuadrícula o en la cabecera personalizada.
Nota:
Para seleccionar todas las filas, row se puede reemplazar por la palabra clave AllRows.
Col es la referencia de columna (letra) de la cuadrícula. La palabra clave "current" se soporta cuando se utiliza Attribute en la celda de texto de una cuadrícula o en la cabecera personalizada.
Nota:
Para seleccionar todas las columnas, Col se puede reemplazar por la palabra clave AllCols.
Page es un valor numérico que representa el índice de combinaciones de miembros en todas las dimensiones de página de la cuadrícula. La primera combinación de dimensión de página en una cuadrícula tiene un índice 1, la segunda un índice 2, y así sucesivamente.
Attributes identifica la información que debe devolver la anotación. Puede incluir la palabra clave All (valor predeterminado) o una combinación de una o más de las palabras clave siguientes: Title & Description & Author & Date & Category. Las palabras clave de Attribute pueden ordenarse en cualquier orden de salida. Cada atributo deberá separarse con un ampersand (&).
Reference es una palabra clave que denota las anotaciones que se devolverán, donde:
All (valor predeterminado) devuelve la anotación inicial y todas las respuestas.
Top <n> devuelve la anotación inicial y las primeras <n> respuestas.
Bottom <n> devuelve la anotación inicial y las últimas <n> respuestas. La anotación inicial siempre se muestra y el número <n> no incluye dicha anotación inicial.
BottomOnly <n> devuelve las últimas <n> respuestas. La anotación inicial se muestra para 4 o menos respuestas <n>; no se muestran las anotaciones iniciales con 5 o más respuestas <n>.
First devuelve solo la anotación inicial.
Replies devuelve todas las respuestas. La anotación inicial no se muestra.
Attachments es un valor booleano (true/false) que indica si se imprimirán los adjuntos asociados a la anotación junto con el informe, donde:
True significa que los adjuntos se imprimirán al final del informe.
False significa que no se imprimirá ningún documento adjunto.
Ejemplos:
<<Annotation("Grid1", cur, A, cur, All, All, true)>>
<<Annotation("Grid1", cur, A, cur, Title & Description & Author & Date & Category, Top 10, true)>>
<<Annotation("Grid10", 284, AB, cur, Title & Description & Date & Category, Bottom 10, false)>>
<<Annotation("Grid1", cur, A, cur, Title & Description & Author, BottomOnly 4, false)>>
<<Annotation("Grid Name", 1, A, 1, All)>>
<<Annotation("Grid Name","AllRows", "AllCols", 1, All)>>
<<Annotation("Grid Name", 1, A, 1, All, First)>>
<<Annotation("Grid Name", 1, cur, cur, All, Replies)>>
<<Annotation("Grid Name", 1, cur, cur)>>
<<Annotation("Grid Name",1, cur, cur, Desc, Replies)>>
<<Annotation(cur, cur, A, cur, Desc)>>
<<Annotation(cur, 3, ABC, cur, title & Desc, true)>>
<<Annotation("folder1\folder2\Grid2", 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)>>
Comportamiento de las anotaciones en cuadros de texto
El comportamiento de las anotaciones en las filas de texto y los cuadros de texto de la cuadrícula al usar la palabra clave "cur" es diferente.
Para filas de texto, puede usar la palabra clave "cur".
Por ejemplo, <<Annotation("Grid1", 1, A, cur, All, All, true)>>
Para cuadros de texto, la palabra clave "cur" no devuelve ningún valor. Como resultado, introducirá <<Annotation("Grid1", 1, A, 1, All, All, true)>>