非维度函数说明
Dataprocessing 函数
| 元素 | 描述 |
|---|---|
| 可用性 | 从 3.1106 起 |
| 语法 | dataprocessing |
| 属性 | - desc - dataprocessingcount |
示例
- dataprocessing.desc
在存在对表单筛选器定义的维度集合进行操作的数据处理时,以用户的应用语言返回字符串 "Data Processing in progress",否则返回空字符串。
- dataprocessing.dataprocessingcount
返回对表单筛选器定义的维度集合正在进行的数据处理的数量。
Datasource 函数
| 元素 | 描述 |
|---|---|
| 可用性 | 从 3.1103 起 |
| 语法 | datasource |
| 属性 | - code - desc |
示例
- Datasource.code
返回正在使用的数据源的代码。
- Datasource.desc
返回正在使用的数据源的描述。
Process 函数
| 元素 | 描述 |
|---|---|
| 可用性 | 从 3.0903 起 |
| 语法 | process([scenario],[period]) |
| 属性 | - code - desc - BusinessCycle - Scenarios - Periods |
| 参数 | - (可选)scenario:场景代码 - (可选)period:期间代码 |
示例
- Process.code
返回在其上执行数据录入的流程的代码。如果表单未在数据录入模式下运行,则会生成错误。
- Process.desc
返回在其上执行数据录入的流程的描述。如果表单未在数据录入模式下运行,则会生成错误。
- Process($Scenario.code,$Period.code).code
返回表单/选项卡筛选器中存在的场景/期间所关联的流程的代码。如果场景-期间组合没有关联的流程,此函数将生成错误。
- Process($Scenario.code,$Period.code).desc
返回表单/选项卡筛选器中存在的场景/期间所关联的流程的描述。如果场景-期间组合没有关联的流程,此函数将生成错误。
BusinessCycle 函数
| 元素 | 描述 |
|---|---|
| 可用性 | 从 5.3.11 起 |
| 语法 | process.BusinessCycle |
| 属性 | - code - desc |
| 参数 | 无参数。 |
示例
- Process.BusinessCycle.code
返回流程提交类型的代码。对于单次提交,返回 "U";对于场景/期间,返回 "S"。
- Process.BusinessCycle.desc
返回流程提交类型的描述。对于单次提交,返回 "Single";对于场景/期间,返回 "Scenario/Period"。
Scenarios 函数
| 元素 | 描述 |
|---|---|
| 可用性 | 从 5.3.11 起 |
| 语法 | process.Scenarios |
| 属性 | - code |
| 参数 | 无参数。 |
示例
Process.Scenarios.code
返回与当前流程关联的场景的代码。
| 元素 | 描述 |
|---|---|
| 可用性 | 从 5.3.14 起 |
| 语法 | process([processo]).Scenarios |
| 属性 | - code |
| 参数 | (可选)process:流程代码 |
示例
Process(@PARAMETRO_PROCESSO).Scenarios
返回通过动态参数指定的流程所关联的原始场景和合并场景的代码。此函数可插入基于平面维度或层次维度的场景类型参数中。
Periods 函数
| 元素 | 描述 |
|---|---|
| 可用性 | 从 5.3.SP14 起 |
| 语法 | process.Periods |
| 属性 | code |
| 参数 | (可选)process:流程代码 |
示例
- Process.Periods
返回与当前流程关联的期间的代码。
- Process(@COD_PROCESSO).Periods
返回与指定为参数的流程关联的期间的代码。
Item(n) 函数
| 元素 | 描述 |
|---|---|
| 可用性 | 从 5.3.11 起 |
| 语法 | process.Scenarios.Item(n) |
| 参数 | n:要定位的场景,按代码从 0 开始以字母升序排列。 |
| 返回值 | 与流程关联的场景中的第 n 个场景 |
ProcessScenarioPeriods 函数
| 元素 | 描述 |
|---|---|
| 可用性 | 从 5.3.SP14 起 |
| 语法 | ProcessScenarioPeriods(codProcesso,codScenario) |
| 参数 | - codProcesso:流程代码 - codScenario:场景代码 |
| 返回值 | 属于所选流程的场景的可用(未锁定)期间 |
示例
- ProcessScenarioPeriods("ACT","2019BDG")
如果存在代码为 "ATC" 的流程,其中包含代码为 "2019BDG" 的场景,则返回与该流程关联的场景的未锁定期间。
- ProcessScenarioPeriods(@COD_PROCESSO,@COD_SCENARIO)
如果选择了代码为 @COD_PROCESSO 的参数和代码为 @COD_SCENARIO 的场景类型参数,并且该场景属于该流程,则返回与该流程关联的该特定场景的未锁定期间。
Server 函数
| 元素 | 描述 |
|---|---|
| 可用性 | 从 4.2.1 起 |
| 语法 | server |
| 属性 | url |
示例
Server.url
返回包含客户端所连接服务器的 url 的字符串。
User 函数
| 元素 | 描述 |
|---|---|
| 可用性 | 从 3.0903 起 |
| 语法 | user |
| 返回值 | 执行登录的用户(当前用户) |
| 属性 | - code - desc - appLang - code - desc - langIndex - tablesLang - code - desc - langIndex |
示例
- User.code
返回当前用户的代码。
- User.desc
返回用户的描述。
- User.appLang.code
返回用户应用语言的代码。
- User.appLang.desc
返回用户应用语言的描述。
- User.appLang.langIndex
返回标识用户应用语言的整数。
- User.tablesLang.code
返回用户表语言的代码。
- User.tablesLang.desc
返回用户表语言的描述。
- User.tablesLang.langIndex
返回标识用户表语言的整数。
Dict 函数
| 元素 | 描述 |
|---|---|
| 可用性 | 从 4.3.2 起 |
| 语法 | dict(codVoceDizionario, [language]) |
| 返回值 | 包含由 codVoceDizionario 标识的字典项描述的字符串。 |
| 参数 | - codVoceDizionario:共享字典项代码 - [language](可选):返回字典项描述所用的语言(数字 0 到 4)。如果省略,则返回运行表单所用语言的描述。 |
Datasetpartition 函数
| 元素 | 描述 |
|---|---|
| 可用性 | 从 5.3.SP7 起 |
| 语法 | DATASETPARTITION(codWorkspace, codDataset, [codProcesso], [codScenario], [codPeriodo], [codAzienda], [codTipologia], [valoreSeMancante]) |
| 返回值 | 包含由 codDataset 代码标识、属于代码为 codWorkspace 的工作区的数据集物理分区名称的字符串。根据分区类型,需要指定其他附加参数。 |
| 参数 | - codWorkspace。工作区代码 - codDataset。数据集代码 - codProcesso。流程代码 - codScenario。场景代码 - codPeriodo。期间代码 - codAzienda。实体代码 - codTipologia。类型代码 - valoreSeMancante。(可选)如果分区不存在则返回的字符串 |
参数的特定功能¶
参数可以使用固定值(双引号之间)或使用专用语法来指定。请参阅用于计算默认值的高级选择脚本详细信息。
参数值以逗号分隔,根据其指定的位置进行解释(第一个字符串解释为工作区代码,第二个解释为数据集代码,依此类推)。若要省略可选参数,请在相应位置指定空字符串,用双引号括起或以其他方式表示。
- 对于未分区的数据集:仅设置前两个参数。如果指定了其他参数,系统将忽略它们。
- 对于按业务周期分区的数据集:还需指定流程。如果流程是按场景/期间提交,则还需要指定场景和期间,否则 codScenario 和 codPeriodo 参数为可选,如果指定,系统将忽略它们。如果流程是单次提交,则除了参考数据集和工作区外,只需指定流程。
- 对于按业务周期和实体分区的数据集:指定流程和实体。如果所选流程是按场景/期间提交,则还需要指定场景和期间,否则系统将忽略 codScenario 和 codPeriodo 参数。这些参数在任何情况下都必须设置,但可以使用空值来设置。 如果数据集按实体分区,则必须指定实体。 如果某些参数因分区类型不需要而未指定,则它们将被忽略。当这些参数不必要时,用户可以避免指定它们,使用多个连续逗号(与要忽略的参数数量相同)或空字符串。
若要访问与报告层不同类型的数据:除了所使用的分区类型的各种参数外,还需指定类型参数。
通常,访问计算类型需要用户指定他们想要访问的实体(或实体节点 - 层次代码 pipe 节点代码):若要动态解析上下文的最低层级元素或实体节点,可以使用以下语法指定实体参数: if($Entity.isleaf,$Entity.code,$Entity.Dimension.hierarchyCode +"|" + $Entity(False).code)
例如,可以获得 DatasetPARTITION("001", "000007", "ACT", "2019ACT", "05", , "TYPOL") 的分区,该数据集按业务周期分区,代码为 "000007",位于代码为 "001" 的工作区中,假设流程是按场景/流程提交,相对于 "ACT" 流程,场景 "2019ACT" 的期间 "05",类型为 "TYPOL" 但不按实体分区。使用以下写法(带引号)可获得相同的行为:DatasetPARTITION("001", "000007", "ACT", "2019ACT", "05", "", "TYPOL")。
如果指定的参数未标识系统上存在的任何分区,单元格字段将不会返回错误,而是返回空字符串;如果将其用作提取表用于查询,则在读取时将返回语法错误消息。如果分区不存在,但指定了在分区缺失时要返回的值(valoreSeMancante 参数)作为最后一个参数,则该函数将返回作为参数插入的值。
示例
- DatasetPARTITION("001", "000006")
对于代码为 "001" 的工作区中代码为 "000006" 的未分区数据集,如果存在,则返回单个物理分区的名称。
- DatasetPARTITION("001", "000007", "BUD")
对于代码为 "001" 的工作区中代码为 "000007" 的按业务周期分区的数据集,并且假设 "BUD" 为单次提交流程,如果存在,则返回与 "BUD" 流程相关的单个物理分区的名称。
- DatasetPARTITION("001", "000007", "ACT", "2019ACT", "01")
对于代码为 "001" 的工作区中代码为 "000007" 的按业务周期分区的数据集,并且假设 "ACT" 为场景/期间提交流程,如果存在,则返回与 "ACT" 流程、场景 "2019ACT" 的期间 "01" 相关的单个物理分区的名称。
- DatasetPARTITION("001", "000007", process("2019ACT","01"), "2019ACT", "01")
对于代码为 "001" 的工作区中代码为 "000007" 的按业务周期分区的数据集,如果存在,则返回与场景 "2019ACT" 的期间 "01" 以及该场景-期间组合所关联的流程相关的单个物理分区的名称。该流程由 "process("2019ACT","01")" 函数返回。
- DatasetPARTITION("001", "000008", "BUD", "", "", "CORP")
对于代码为 "001" 的工作区中代码为 "000008" 的按业务周期 - 实体分区的数据集,并且假设 "BUD" 为单次提交流程,如果存在,则返回与 "BUD" 流程、实体 "CORP" 相关的单个物理分区的名称。
- DatasetPARTITION("001", "000008", "ACT", "2019ACT", "01", "CORP")
对于代码为 "001" 的工作区中代码为 "000008" 的按业务周期 - 实体分区的数据集,并且假设 "ACT" 为场景/期间提交流程,如果存在,则返回与 "ACT" 流程、场景 "2019ACT" 的期间 "01"、实体 "CORP" 相关的单个物理分区的名称。
- DatasetPARTITION("001", "000008", process("2019ACT","01") , "2019ACT", "01", "CORP")
对于代码为 "001" 的工作区中代码为 "000007" 的按业务周期分区的数据集,如果存在,则返回与实体 "CORP"、场景 "2019ACT" 的期间 "01" 以及该场景-期间组合所关联的流程相关的单个物理分区的名称。该流程由 "process("2019ACT","01")" 函数返回。
DatasetPARTITION("001", "000007", "ACT", "2019ACT", "05", , , "TGK_DUAL")
对于代码为 "001" 的工作区中代码为 "000007" 的按业务周期分区的数据集,并且假设 "ACT" 为场景/期间提交流程,与 "ACT" 流程、场景 "2019ACT" 的期间 "05" 相关,并且未为该场景/期间对生成任何分区,则返回作为最后一个 "TGK_DUAL" 参数报告的文本。