PlanningAnnotations

PlanningAnnotations 是文本函数,可从 Planning 数据库连接中检索与单元格的规划单元关联的重要注释或备注。规划单元是方案、版本和实体的组合,并且通过网格中的单元格引用在 Financial Reporting 中得出。

语法:

<<PlanningAnnotations("GridName", Row, Column, Page, Attributes, Range)>>

<<PlanningAnnotations("GridName", Row, Column, Page, Attributes)>>

参数 说明

GridName

(必需)网格的名称。

Row

(必需)表示网格行号的数值。网格中第一行的索引为 1,第二行的索引为 2,依此类推。

Column

(必需)表示网格的列的字母。网格中第一列的索引为 A,第二列的索引为 B,依此类推。

Page

(必需)表示网格的所有页维上的成员组合的索引的数值。网格中第一个页维组合的索引为 1,第二个页维组合的索引为 2,依此类推。

Attributes

以下任何值:All、Title、Author、Date、Text、PlanningUnit。(PlanningUnit 是方案、版本和实体的组合,根据 GridNameRowColumnPage 得出。)

按所需的输出顺序排列各属性,并用和号 (&) 将各属性分开。

Range

使用关键字 All、Top 或 Bottom,可从输出的顶端或底部选择特定数目的注释或所有注释。

  • All 返回所有注释

  • Top 5 返回前五个注释

  • Bottom 10 返回最后十个注释

  • Bottom 1 返回最后一个注释

示例 1:

"All" 用于 Range 参数。

<<PlanningAnnotations("Grid Name", 1,a,1,All, All)>>
<<PlanningAnnotations("Grid Name", 100,AB,10,All, All)>>
<<PlanningAnnotations(cur, cur,a,cur,Text & Title & Author, Top 5)>>
<<PlanningAnnotations(cur, 315, AB, 255, Text&Title&Author, Top 5)>>
<<PlanningAnnotations(cur, cur A, Cur, PlanningUnit, Top 5)>>
<<PlanningAnnotations(cur, 123, ABC, 101, PlanningUnit, Top5)>>
<<PlanningAnnotations(Grid1, 1, current, cur, Title & Text, Bottom 10)>>
<<PlanningAnnotations(Grid1, 105, ABC, cur, Title & Text, Bottom 10)>>
<<PlanningAnnotations(Current, 34, BB, cur, All, Top 40)>>
<<PlanningAnnotations(cur, cur, A cur, Text & Title & Author, Top 5)>>
<<PlanningAnnotations(cur, cur, A, cur, Text&Title&Author, bottom15)>>
<<PlanningAnnotations(cur, 1(3), A(B), cur, Title&Author&Date&Text, All)>>
<<PlanningAnnotations(cur, 1(3), A(B), cur, Title&Author&Date&Text, All)>>

示例 2:

检索当前页上的网格的第 1 行 A 列中的注释。显示底部 3 个注释以及与注释关联的所有属性(标题、作者、日期、文本和规划单元)。

在文本单元格中使用该语法:

<<PlanningAnnotations(Current, 1, A, Current, All, Bottom 3)

将按日期时间的降序返回注释,最新的注释位于顶端,最早的注释位于底端。得到的注释文本类似于以下内容:

Title: Status - Under Review

Author: John Smith

Date: Mar 25, 2003 10:32:49 AM

Planning Unit: Budget, 1st Draft, East

Text: Please review and approve

— — — — — — — — — — — — — — — — —

Title: Status - Not Signed Off

Author: Mary Brown

Date: Mar 21, 2003 2:59:11 PM

Planning Unit: Budget, 1st Draft, West

Text: Sorry, Try Again

— — — — — — — — — — — — — — — — —

Title: Status - Under Review

Author: Admin

Date: Mar 21, 2003 2:54:16 PM

Planning Unit: Budget, 1st Draft, South

Text: Please review and approve budget for 1st draft

注:

仅当在网格单元格(不是文本框对象、页眉或页脚)中使用时,PlanningAnnotations 才支持 Current 关键字。请参阅“在文本函数中使用 Current/Cur 关键字”。