PROPERTIES( ) 函数

返回指定 Analytics 项目条目的属性信息。

语法

PROPERTIES(名称, 对象类型, 信息类型)

参数

名称 类型 描述
名称 字符

您需要其相关信息的 Analytics 项目条目的名称。名称不区分大小写。

如果项目条目为 Analytics 表,请指定表布局名称,而不是数据文件名。例如:指定 "Invoices" 而非 "january_invoices.fil"

如果您使用 PROPERTIES( ) 函数返回活动表的名称,请指定名称 "activetable"

对象类型 字符

名称所引用的 Analytics 项目条目的类型。

说明

当前,"table" 是受支持的唯一项目条目类型。

信息类型 字符

您需要的有关 Analytics 项目条目的信息的类型。

要了解更多信息,请参考属性信息的类型

输出

字符。输出字符串的最大长度为 260 个字符。如果找不到属性信息,则返回空字符串。

示例

基本示例

有关 Analytics 数据文件 (.fil) 的信息

返回 "Ap_Trans.fil":

PROPERTIES("亚太地区交易", "table", "filename")

返回 "C:\ACL DATA\Sample Data Files":

PROPERTIES("亚太地区交易", "table", "filepath")

有关打开的 Analytics 表的信息

返回 "Ap_Trans":

PROPERTIES("activetable", "table", "open")

有关外部数据源的信息

返回 "Trans_May.xls":

PROPERTIES("交易五月", "table", "sourcename")

返回 "C:\Project Data\Monthly Invoices_Excel":

PROPERTIES("交易五月", "table", "sourcepath")

返回 "EXCEL":

PROPERTIES("交易五月", "table", "sourcetype")

备注

文件信息

以 "File" 开头的信息类型提供与 Analytics 表相关联的 Analytics 数据文件 (.fil) 的相关信息。

源信息

以 "source" 开头的信息类型提供可与 Analytics 表相关联的外部数据源的相关信息。只有那些支持刷新 Analytics 表的外部数据源可以使用 PROPERTIES( ) 函数进行报告:

  • Microsoft Excel
  • Microsoft Access
  • 分隔文本
  • Adobe Acrobat (PDF)
  • 打印图像(报告)
  • SAP 专有文件格式/DART
  • XML
  • XBRL
  • ODBC 数据源

属性信息的类型

下表列出了可由 PROPERTIES( ) 函数返回的属性信息的类型。Analytics 表是目前可与 PROPERTIES( ) 函数一起使用的唯一的 Analytics 项目条目:

对象类型

信息类型

返回:

"table"

"filename"

与 Analytics 表相关联的数据文件的名称。

"filepath"

与 Analytics 表相关联的数据文件的路径。

"filesize"

与 Analytics 表相关联的数据文件的大小(单位为 KB)。

"filemodifiedat"

上次修改与 Analytics 表相关联的数据文件的时间和日期。

"sourcename"

与 Analytics 表相关联的数据源的名称。

数据源可以是 Excel、Access、PDF、XML、定界文本文件或 ODBC 数据源等外部文件。

"sourcepath"

与 Analytics 表相关联的数据源的路径。

不支持 ODBC 数据源。

"sourcetype"

与 Analytics 表相关联的数据源的类型。

"sourcesize"

与 Analytics 表相关联的数据源的大小(单位为 KB)。

不支持 ODBC 数据源。

"sourcemodifiedat"

上次修改与 Analytics 表相关联的数据源的时间和日期。

不支持 ODBC 数据源。

"open"

当前活动 Analytics 表的名称。

说明

多个 Analytics 表可以同时打开,但在用户界面中,一次只能有一个表是活动的。

ACL 脚本指南 14.1