非维度属性
描述¶
与表单和报表相关的非维度函数具有一些属性，可用于获取有关这些对象的信息。
下面描述表单和报表列表的非维度属性。
Code 属性
| 元素 | 描述 |
|---|---|
| 可用性 | 从 3.0912 起 |
| 适用性 | 非维度 "form" 对象 |
| 语法 | code |
| 返回值 | 包含当前表单代码的字符串 |
示例
report.code
返回当前表单代码。
Desc 属性
| 元素 | 描述 |
|---|---|
| 可用性 | 从 3.0912 起 |
| 适用性 | 非维度 "form" 对象 |
| 语法 | desc([language]) |
| 参数 | language（可选）以整数表示的表语言代码 |
| 返回值 | 包含当前表单描述的字符串。可选参数仅在存在多语言描述时受支持。如果省略，则使用用户语言。 |
示例
report.desc(2)
返回当前表单在表语言 2 中的描述。
Path 属性
| 元素 | 描述 |
|---|---|
| 可用性 | 从 4.2.0 起 |
| 适用性 | 非维度 "form" 对象 |
| 语法 | Path([level], [separator]) |
| 参数 | - level（可选）在表单组中向上追溯的层级数。如果省略或为零，则追溯到组的根节点 - separator（可选）字符串中每个元素之间使用的分隔符。如果省略，则使用反斜杠 "\" |
| 返回值 | 由当前元素路径节点上定义的表达式连接而成的字符串。 |
示例
对于与表单组 "$" 的 "DE - Data Entry" \ "CE - Profit And Loss" 节点相关的表单：
- Report.path
返回字符串 "$\DE\CE"。
- Report.path(2)
返回字符串 "DE\CE"。
- Report.path(".")
返回字符串 "$.DE.CE"。
ReportFile 属性
| 元素 | 描述 |
|---|---|
| 可用性 | 从 4.2.1 (SP20) 起 |
| 语法 | reportFile |
| 属性 | - filename - filepath - fullName |
| 返回值 | 如果当前表单是即席表单，则返回与磁盘上包含表单结构的文件相关的一些信息。如果表单是共享的，则返回空字符串。 |
示例
要判断表单是否为即席表单：
if(report.reportFile.filename="", "Form shared", "Form Ad hoc")
Report.reportfile.filename
返回：
- 对于 "myReport.xlsx" 即席表单，返回字符串 "myReport.xlsx"，
- 对于共享表单，返回空字符串，
- 对于尚未保存的即席表单，返回 "book1"。
Report.reportfile.filepath
返回：
- 对于保存在用户文档文件夹中的 "myReport.xlsx" 即席表单，返回字符串 "C:\Users\Username\Documents"，
- 对于共享表单，返回空字符串，
- 对于尚未保存的即席表单，返回空字符串。
Report.reportfile.fullFileName
返回：
- 对于保存在用户文档文件夹中的 "myReport.xlsx" 即席表单，返回字符串 "C:\Users\Username\Documents\myReport.xlsx"，
- 对于共享表单，返回空字符串，
- 对于尚未保存的即席表单，返回 "book1"。
RunDate 属性
| 元素 | 描述 |
|---|---|
| 可用性 | 从 3.0903 起 |
| 语法 | runDate([dataFormat],[timeFormat]) |
| 参数 | - dataFormat：可取值如下： - -1：无格式。不打印日期 - 0：使用 Full 格式 - 1：使用 Long 格式 - 2：使用 dd-mmm-yyyy 格式 - 3（或省略）：使用 Short 格式 - timeFormat：可取值如下： - -1（或省略）：无格式。不打印日期 - 1：使用 Full 格式 - 2：使用 Long 格式 - 3：使用 hh.mm 格式 |
| 返回值 | 表单在应用服务器时区中运行的日期和时间。由于 RunDate 属性是根据表单的执行上下文赋值的，因此当表单从 Web 端运行与通过 Excel 加载项运行时，日期和时间可能会有所不同。可选地，可以为日期指定一种格式类型，为时间指定一种格式类型。实际格式还取决于用户的本地格式设置。 |
示例
一个表单于 2013 年 3 月 15 日 15:27 运行，格式设置 = "Italian"。
- report.runDate
返回 15/03/13。
- report.runDate(0)
返回 Friday 15 March 2013。
- report.runDate(1)
返回 15 March 2013。
- report.runDate(2)
返回 15-Mar-2013。
- report.runDate(1,1)
返回 15 March 2013 15.27.59 GMT+01:00。
- report.runDate(1,2)
返回 15 March 2013 15.27.59。
- report.runDate(1,3)
返回 15 March 2013 15.27。
- report.runDate(-1,2)
返回 15.27.59。
Code 属性
| 元素 | 描述 |
|---|---|
| 可用性 | 从 3.0912 起 |
| 适用性 | 非维度 "ReportList" 对象 |
| 语法 | code |
| 返回值 | 包含报表列表所在表单代码的字符串 |
示例
ReportList.code
返回当前报表列表的表单代码。
Desc 属性
| 元素 | 描述 |
|---|---|
| 可用性 | 从 3.0912 起 |
| 适用性 | 非维度 "ReportList" 对象 |
| 语法 | desc([language]) |
| 参数 | - language（可选）以整数表示的表语言代码 |
| 返回值 | 包含报表列表所在表单描述的字符串。该参数仅在存在多语言描述时受支持。如果省略，则使用用户语言 |
示例
ReportList.desc
返回包含当前报表列表的报表的描述。
ReportListFile 属性
| 元素 | 描述 |
|---|---|
| 可用性 | 从 4.2.1 (SP20) 起 |
| 语法 | ReportListFile |
| 属性 | - filename - filepath - fullName |
| 返回值 | 包含当前报表列表的表单。如果不存在包含它的表单，即报表列表是"即时"创建的，则会生成错误。只能与插入到报表列表创建向导中的参数化表达式一起使用。 |
示例
${reportList.reportListFile.filePath}\myOutput.xlsx
在报表列表结构所在的同一文件夹中定义一个 "myOutput.xlsx" 文件，作为报表列表的输出文件。
ReportList.reportListfile.filename
返回：
- 对于 "myReportList.xlsx" 报表列表，返回字符串 "myReportList.xlsx"，
- 对于保存在表中的报表列表，返回空字符串，
- 对于尚未保存的即席报表列表，返回字符串 "book 1"。
ReportList.reportListFile.filePath
返回：
- 对于保存在用户文档文件夹中的 "myReportList.xlsx" 报表列表，返回 "C:\Users\Nomeutente\Documents"，
- 对于在表中运行的报表，返回空字符串，
- 对于尚未保存的即席报表，返回空字符串。
Report.reportfile.fullFileName
返回：
- 对于保存在文档文件夹中的 "myReportList.xlsx" 报表列表，返回 "C:\Users\Username\Documents\myReportList.xlsx"，
- 对于保存在表中的报表列表，返回空字符串，
- 对于尚未保存的即席报表列表，返回 "book 1"