规则函数:getConAttr

栏目:云星瀚知识作者:金蝶来源:金蝶云社区发布:2024-09-22浏览:1

规则函数:getConAttr

1 简介

1.1 功能介绍

getConAttr函数,可以获取合并所有权页面的以下信息:

  • 合并节点信息设置-合并数据来源

  • 合并架构信息设置-是否参与合并

  • 合并架构信息设置-组织变更类型

  • 合并架构信息设置-合并方法

  • 合并架构信息设置-自定义项1

  • 合并架构信息设置-自定义项2

  • 合并架构信息设置-自定义项3


1.2 应用场景

在业务规则中需要获取合并所有权设置页面中的设置作为相关逻辑的判断条件时,可以使用getConAttr来获取。


1.3 函数定义

/**
  * @function getConAttr(attrCode,[dimStr],[isNewCT])
  * @description 根据输入的参数,获取合并所有权页面中合并数据来源、业务变更类型、合并方法编码、是否合并状态标记、自定义字段1~3的值
  * @param {string} attrCode:类别编码,必需,可输入以下值,
 *              "CM"表示获取合并方法,
 *              "AS"表示获取是否向上合并,
 *              "CT"表示获取组织业务变更类型,
 *              "DS"表示获取合并节点的合并数据来源,
 *              "UD1"表示获取自定义字段1的值,
 *              "UD2"表示获取自定义字段2的值,
 *              "UD3"表示获取自定义字段3的值
 * @param {string} dimStr:维度成员组合定义字符串,不同维度之间用逗号分隔,可指定以下维度,
 *        Entity,组织,形如"ParentCode_ChildCode",可选,留空时取当前组织的虚拟编码,即"父_子"
 *        Scenario,情景,可选,留空时取当前情景编码
 *        Year,财年,可选,留空时取当前财年编码
 *        Period,期间,可选,留空时取当前期间编码
 * @param {boolean} isNewCT:针对获取业务变更类型(即attrCode参数值为"CT")时有效,是否返回新的编码值,默认false,当传入true时,返回实际的编码,非必需;当需要指定该参数时,要求前面两个参数都必需指定,如果不想指定dimStr参数,可以写空字符串""
 * 函数返回值说明
 * @returns {string} 返回值
 *    1) 若指定的虚拟组织中的parentCode与childCode非直接父子关系时,返回null;
 *    2) 若attrCode为CM,获取对应的合并方法编码;
 *    3) 若attrCode为"AS",获取对应的是否向上合并的标识,"是"返回"Y","否"返回"N"
 *    4) 若attrCode为"CT",获取组织业务变更类型,
 *      ① 若isNewCT是false时返回值列表如下:
 *        系统上线初始化新增 1
 *        新设子公司 8
 *        并购子公司(非同控)新增 2
 *        并购子公司(同控)新增 3
 *        子公司(同控)处置 6
 *        子公司(非同控)处置 4
 *        清算后重新回购新增 5
 *        禁用 7
 *        新设合并变更启用 9
 *        新设合并变更禁用 10
 *        其他的返回实际编码
 *      ② 若isNewCT是true时返回值都是实际的编码。
 *    5) 若attrCode为"DS",获取合并节点的合并数据来源,"合并汇总"返回1,"合并录入"返回2,若对应组织为明细组织,返回-1
 *    6) 若attrCode为"UD1"~"UD3",获取对应的自定义字段里的值,按值返回字符串,若无值返回空串""
  * 
*/


1.3.1 参数说明

参数详细解释
attrCode类别编码,参数必需;输入"DS"表示获取合并节点的合并数据来源,输入"AS"表示获取是否参与合并,输入"CT"表示获取组织变更类型,输入"CM"表示获取合并方法,输入"UD1"表示获取自定义项1的值,输入"UD2"表示获取自定义项2的值,输入"UD3"表示获取自定义项3的值
dimStr维度成员组合定义字符串,参数非必需;可指定以下维度成员,组织、情景、财年、期间,不指定时以当前上下文维度组合带入;当需要指定组织时,要求组织成员编码必须为"父_子"形式
isNewCT
是否返回新的组织变更类型编码,参数非必需,可传入true或false;仅在当attrCode参数传入"CT"时有效,影响组织变更类型的返回值,详细参考1.3.2 返回值说明;参数未指定时,系统默认传入false


1.3.2 返回值说明

获取属性返回值
合并数据来源"报表汇总"返回1,"合并录入"返回2,若对应组织为明细组织,返回-1
是否参与合并"是"返回"Y","否"返回"N"
组织变更类型

① 若isNewCT是false时返回值列表如下

    系统上线初始化新增 1

    新设子公司 8
    并购子公司(非同控)新增 2
    并购子公司(同控)新增 3
    子公司(同控)处置 6
    子公司(非同控)处置 4
    清算后重新回购新增 5

    禁用 7

    新设合并变更启用 9

    新设合并变更禁用 10
    其他的返回实际编码

② 若isNewCT是true时返回值统一的实际编码。

合并方法

按值返回字符串,若无值返回空串""

自定义项1~3按值返回字符串,若无值返回空串""


2 函数使用示例

假设体系中在2021年1月存如下合并所有权设置的内容

组织编码组织名称是否明细合并数据来源是否参与合并组织变更类型
合并方法自定义项1~3
C0000集团大合并
报表汇总-系统上线初始化新增


  E0000集团母公司-系统上线初始化新增

  C0001子集团1合并报表汇总系统上线初始化新增

    E0001子集团1母公司-系统上线初始化新增

    S0001子集团1子公司1-系统上线初始化新增

  C0002子集团2合并合并录入系统上线初始化新增

    E0002子集团2母公司-系统上线初始化新增

    S0002
子集团2子公司1-系统上线初始化新增

S0000集团子公司-系统上线初始化新增

2.1 在当前情景、财年、期间下,获取当前组织是否向父级组织合并的标识

let ctxConActiveStatus = getConAttr("AS");
debug(ctxConActiveStatus );


调试上下文

调试输出

2.2 在当前情景、财年、期间下,获取当前组织的合并数据来源

let ctxConDataSource = getConAttr("DS");
debug(ctxConDataSource);

调试上下文

调试输出

2.3 获取指定情景、财年、期间、组织的合并所有权相关设置信息

// 获取组织C0000_C0001的合并数据来源
let conDataSource = getConAttr("DS","E@C0000_C0001");
debug(conDataSource);
// 获取组织C0000_C0002的变更类型
let conChangeType = getConAttr("CT","E@C0000_C0002");
debug(conChangeType);
// 获取组织C0000_C0002的变更类型,按统一编码返回值
conChangeType = getConAttr("CT","E@C0000_C0002",true);
debug(conChangeType);

调试上下文

调试输出



变更记录

产品版本

更新内容更新时间

V6.0.8

初始版本2024年03月




规则函数:getConAttr

1 简介1.1 功能介绍getConAttr函数,可以获取合并所有权页面的以下信息:合并节点信息设置-合并数据来源合并架构信息设置-是否参与合并合...
点击下载文档
确认删除?
回到顶部
客服QQ
  • 客服QQ点击这里给我发消息