D365 FO财务维度
AX2012与之前AX版本最大的改变是财务维度,AX2012之前的版本,财务维度通过数组实现,默认只支持3个财务维度,可以花钱增加,但总数量受限且就一个主表维护,来源固定,很不灵活。
AX2012以后的财务维度不受限制,几乎所有的数据都可以拿来用做财务维度。
为了实现这个需求AX2012设计了复杂的表结构,对码农来说用AX2012之前直接读写表的方式来处理维度的相关逻辑,即便可能也是大费周章,还不见得能写对。
具体维度的设计参看下文:
https://docs.microsoft.com/en-us/dynamics365/fin-ops-core/dev-itpro/financial/ledgeraccountcombinations
所以AX2012提供了很多辅助类来处理维度值,用的比较多的是AxdDimensionUtil,通过这个类的getLedgerAccountId方法可以得到LedgerDimension的值,通过getDimensionAttributeValueSetId方法可以得到DefualtDimension的值。
D365 FO代码里还能看到AxdDimensionUtil这个类,但是属性标记了是个废弃类。
[SysObsoleteAttribute('This class is no longer supported, use the DimensionResolver classes.', true)]
建议使用DimensionResolver去实现相应的功能,这个类本身是个抽象类,其子类如下图所示:
我暂时只用了中间两个标记出来的类DimensionDynamicAccountResolver和DimensionDefaultResolver分别用来生成LedgerDimension和DefaultDimension,调用示例代码如下所示:
1 //Defalut Dimension 2 DimensionDefaultResolver defaultResolver = DimensionDefaultResolver::newResolver("11-001-1010-080" + "-" +strReplace("CNMF-000001", "-", "\\-")); 3 RecId recId = defaultResolver.resolve(); 4 info (int642Str(recId)); 5 6 //Ledger Dimension 7 DimensionDynamicAccountResolver accountResolver = DimensionDynamicAccountResolver::newResolver("530198-11-001-1010-080"); 8 recId = accountResolver.resolve(); 9 info (int642Str(recId));
这个已经封装到没法再简洁了,只要一行代码就可以实现了,调用者唯一要做的就是按照 总账->会计科目表->维度->用于集成应用程序的财务维度配置 配置的结构,把字符串拼出来调用就可以了。
具体配置方法参见下文:
https://www.cnblogs.com/Farseer1215/p/12810071.html
DimensionResolver提供了静态方法getEntityDisplayValue用来帮助拼字符串,调用方法如下所示:
1 Array arrayName = new Array(Types::String); 2 arrayName.value(1, "MainAccount"); 3 arrayName.value(2, "BusinessUnit"); 4 arrayName.value(3, "CostCenter_CN"); 5 6 Array arrayValue = new Array(Types::String); 7 arrayValue.value(1, "530198"); 8 arrayValue.value(2, "11"); 9 arrayValue.value(3, "1010"); 10 11 info (DimensionResolver::getEntityDisplayValue(arrayName, arrayValue, extendedTypeStr(DimensionDynamicAccount)));
上述方法可以返回处符合要求的DisplayValue供newResolver调用。
上述示例是获取LedgerDimension的DisplayValue的方法,获取DimensionDefault,大同小异,不包含MainAccount,然后把extendedTypeStr换成DimensionDefault这个EDT类型就可以了。
当然D365 FO还提供了LedgerDimensionFacade和DimensionDefaultFacade封装了一些方法方便操作LedgerDimension和DefaultDimension,通过这些可以方便地获取需要的信息。