[AX]AX2012 Number sequence framework ：（三）再谈Number sequence

AX2012的number sequence framework中引入了两个Scope和segment两个概念，它们的具体作用从下面序列的例子说起。

法国/中国的法律要求财务凭证的Journal number包含公司代码和财务期间，比如这样的号码J-20-Jan11-000340，J表上Journal，20代表的是公司代码，Jan11为财务期间，000340才是系统生成的流水号。

在创建Numer sequence的界面上可以选择需要的Scope：

Company and fiscal calendar period是较为复杂的scope类型，要求选择相应的公司和财务日历期间：

Segment中自动包含company和Fiscal calendar period用于生成具体的序列号码，Segment仍然是可以修改的，包括Company和Fiscal calendar period segment都是可以的，也允许创建多个Company和Fiscal calendar period segment。

公司Scope的EDT序列引用

Sequence number常常用于EDT类型字段的自动生成，可以认为EDT类型和Sequence number refrence是一回事，在自定义NumberSeqApplicationModule.LoadModule()中注册EDT类型的序列号引用：

Sequence number常常用于EDT类型字段的自动生成，可以认为EDT类型和Sequence number refrence是一回事，在自定义NumberSeqApplicationModule.LoadModule()中注册EDT类型的序列号引用：

public void loadModule()

{

    NumberSeqDatatype datatype = NumberSeqDatatype::construct();

    ;

    /* Work Order Number */

    datatype.parmDatatypeId(extendedTypeNum(WorkOrderNum));

    datatype.parmReferenceHelp("Unique identifier for work orders");

    datatype.parmWizardIsContinuous(false);

    datatype.parmWizardIsManual(NoYes::No);

    datatype.parmWizardIsChangeDownAllowed(NoYes::No);

    datatype.parmWizardIsChangeUpAllowed(NoYes::No);

    datatype.parmSortField(1);

    datatype.parmWizardHighest(999999);

    datatype.addParameterType(NumberSeqParameterType::DataArea, true, false);

    this.create(datatype);

}

注意datatype.addParameterType(NumberSeqParameterType::DataArea, true, false)的第一个参数NumberSeqParameterType::DataArea，它明确EDT引用的Sequence number的Scope类型为Company，使用Organization administration > Common > Number sequences > Number sequences界面的Generate为这个EDT类型自动创建Sequence number时会为每一个公司创建一个序列，序列scope为Company并指定相应的公司：

通常我们会在模块的参数表上创建numRefXXX()方法方便在代码中引用，上面例子中EDT的numRefXXX()方法类似：

client server static NumberSequenceReference numRefWorkOrderNum()

{

    NumberSeqScope scope = NumberSeqScopeFactory::createDataAreaScope(selectableDataArea _dataArea = curext());

    return NumberSeqReference::findReference(extendedtypenum(WorkOrderNum), scope);

}

注意调用NumberSeqScopeFactory::createDataAreaScope(curext())从基于当前公司创建的序列Scope。

Company and fiscal calendar period Scope的EDT序列引用

为EDT创建Company and fiscal calendar period Scope 的序列引用需要修改的第一个地方是LoadModule：

public void loadModule()

{

    NumberSeqDatatype datatype = NumberSeqDatatype::construct();

    ;

    /* Work Order Number - Company and fiscal calendar*/

    datatype.parmDatatypeId(extendedTypeNum(WorkOrderNum_CompFiscal));

    datatype.parmReferenceHelp("Unique identifier for work orders - Company and fiscal calendar");

    datatype.parmWizardIsContinuous(false);

    datatype.parmWizardIsManual(NoYes::No);

    datatype.parmWizardIsChangeDownAllowed(NoYes::No);

    datatype.parmWizardIsChangeUpAllowed(NoYes::No);

    datatype.parmSortField(1);

    datatype.parmWizardHighest(999999);

    datatype.addParameterType(NumberSeqParameterType::DataArea, true, false);

    datatype.addParameterType(NumberSeqParameterType::FiscalCalendarPeriod, true, false);

    this.create(datatype);

}

注意调用了两次addParameterType()来添加DataArea和FiscalCalendarPeriod两种Scope类型，这种类型的Refrence在模块的Parameters form上可能看不到，通常在参数form的numberSeqPreInit()方法中我们通常是创建一个DataArea的Scope对象：

 scope = NumberSeqScopeFactory::createDataAreaScope();

第二个需要修改的地方是参数表上的numRefXXX()方法，我们需要创建对应的DataAreaFiscalCalendarPeriod Scope：

client server static NumberSequenceReference numRefWorkOrderNum_CompFiscal(TransDate _date = systemdateget())

{

    NumberSeqScope scope = NumberSeqScopeFactory::CreateDataAreaFiscalCalendarPeriodScope(

        curext(),

        FiscalCalendars::findPeriodByPeriodCodeDate(CompanyInfo::fiscalCalendarRecId(),_date).RecId 

        );

    return NumberSeqReference::findReference(extendedtypenum(WorkOrderNum), scope);

}

对于Company and fiscal calendar period Scope的EDT，“Set up number sequence” wizard工具是不会为我们创建相应的序列的，我们只能手工创建，在Number sequence编辑窗口的Refrence下选择引用到具体的EDT类型。

Shared Scope的EDT序列引用

Shared scope是个比较特殊的序列Scope，它不和任何公司和财务日历关联，创建Shared Scope的EDT类型引用不需要调用addParameterType()：

public void loadModule()

{

    NumberSeqDatatype datatype = NumberSeqDatatype::construct();

    ;

    /* Work Order Number - Shared*/

    datatype.parmDatatypeId(extendedTypeNum(WorkOrderNum_Shared));

    datatype.parmReferenceHelp("Unique identifier for work orders - Shared");

    datatype.parmWizardIsContinuous(false);

    datatype.parmWizardIsManual(NoYes::No);

    datatype.parmWizardIsChangeDownAllowed(NoYes::No);

    datatype.parmWizardIsChangeUpAllowed(NoYes::No);

    datatype.parmSortField(1);

    datatype.parmWizardHighest(999999);

    this.create(datatype);

}

同样需要修改numRefXXX()方法，我们需要创建Global Scope：

client server static NumberSequenceReference numRefWorkOrderNum_Shared()

{

    NumberSeqScope scope = NumberSeqScopeFactory::CreateGlobalScope();

    return NumberSeqReference::findReference(extendedtypenum(WorkOrderNum), scope);

}

“Set up number sequence” wizard工具能够为Shared scope的EDT类型创建引用序列，当然只会创建一个Sequence number，而不是一个公司一个Sequence number。

可配置的EDT序列引用

还没有讲到的datatype.addParameterType(NumberSeqParameterType::DataArea, true, false)的最后一个参数，这个参数为true上表示EDT引用的序列类型是可以配置的，看下面的例子：

public void loadModule()

{

    NumberSeqDatatype datatype = NumberSeqDatatype::construct();

    ;

    /* Work Order Number - Configurable*/

    datatype.parmDatatypeId(extendedTypeNum(WorkOrderNum_Configurable));

    datatype.parmReferenceHelp("Unique identifier for work orders - Configurable");

    datatype.parmWizardIsContinuous(false);

    datatype.parmWizardIsManual(NoYes::No);

    datatype.parmWizardIsChangeDownAllowed(NoYes::No);

    datatype.parmWizardIsChangeUpAllowed(NoYes::No);

    datatype.parmSortField(1);

    datatype.parmWizardHighest(999999);

    datatype.addParameterType(NumberSeqParameterType::DataArea, true, true);

    this.create(datatype);    

}

可配置体现在Organization Administration > Common > Number sequences > Segment configuration界面上可以修改Segments下的选项：

因为这是Company socpe的EDT，所有能修改的选项只有“Company”一个。如果我们取消勾选“Company”，Work orders-Configurable EDT就变成了Shared scope类型。

另外这个窗口上的“Countries/regions”内容来自于EDT类型的CountryRegionCodes属性设置。

需要指出的是不能将Number sequence指派给不同Scope类型的EDT，AX会报“Unable to find a unique Number sequence code record corresponding to the entered values.”错误信息，在Number sequence编辑窗口的Refrence添加Refrence时下拉框中自动过滤掉不兼容的EDT。

删除EDT序列引用

最后要说的是调用NumberSeqApplicationModule.create()创建EDT的序列引用，但是没有对应的方法在不需要时删除EDT的序列引用，NumberSeqApplicationModule.create()内部调用的是NumberSeqDatatype.Create()，观察NumberSeqDatatype.Create()涉及到的表是NumberSequenceDatatype和NumberSequenceDatatypeParameterType，于是删除EDT序列引用可以这样写：

static void DeleteNumSeqRef(Args _args)

{

    NumberSeqDatatype datatype= NumberSeqDatatype::construct();

    NumberSequenceDatatype record;

    NumberSequenceDatatypeParameterType parameter;

    ;

    datatype.find(extendedTypeNum(WorkOrderNum2));

    if(datatype.parmRecId())

    {

        ttsBegin;

        delete_from parameter where parameter.NumberSequenceDatatype == datatype.parmRecId();

        delete_from record where record.RecId==datatype.parmRecId();

        ttsCommit;

    }

}

参考资料：White Paper: Using the Enhanced Number Sequence Framework in Microsoft Dynamics AX 2012

时间： 2024-10-24 21:12:21

[AX]AX2012 Number sequence framework ：（三）再谈Number sequence的相关文章

GoF设计模式三作者15年后再谈模式

Erich Gamma, Richard Helm, 和 Ralph Johnson在GoF设计模式发表15年以后,再谈模式,另外一位作者,也是四色原型的发明者Peter已经过世. 提问者:如今有85,000 iPhone的小应用遍布全球,使用PHP就能够写一个简单的"Hello, World! The time is X"Web网页,那么,面向对象设计是难的,这句话是否还正确呢? Richard Helm: 软件设计总是很难的,尽管大多数现代开发环境已经降低了复杂性,通过重用库和工具

[Dynamics AX] Data import/export framework(DIXF, DMF) on AX2012 and above

After install Data import/export framework (DIXF, DMF) on AX 2012 R2 and above, we should make sure two following things ready The "Microsoft Dynamics Ax Data Import Export Framework Service Users" group exist under Local Users and Groups > G

OpenCV2马拉松第9圈——再谈对比度(对比度拉伸，直方图均衡化)

收入囊中 lookup table 对比度拉伸 直方图均衡化 葵花宝典 lookup table是什么东西呢? 举个例子,假设你想把图像颠倒一下,f[i] = 255-f[i],你会怎么做? for( int i = 0; i < I.rows; ++i) for( int j = 0; j < I.cols; ++j ) I.at<uchar>(i,j) = 255 - I.at<uchar>(i,j); 大部分人应该都会这么做.或者: for( i = 0; i &

WCF技术剖析之二：再谈IIS与ASP.NET管道

原文:WCF技术剖析之二:再谈IIS与ASP.NET管道 在2007年9月份,我曾经写了三篇详细介绍IIS架构和ASP.NET运行时管道的文章,深入介绍了IIS 5.x与IIS 6.0HTTP请求的监听与分发机制,以及ASP.NET运行时管道对HTTP请求的处理流程: [原创]ASP.NET Process Model之一:IIS 和 ASP.NET ISAPI [原创]ASP.NET Process Model之二:ASP.NET Http Runtime Pipeline - Part I

Java编程思想(十八) —— 再谈反射

在Java编程思想(十五) -- 类型信息之反射和Java编程思想(十六) -- 联系JVM再谈Class,书上只用了3页就讲完了,还有讲了那么多Class的东西,接下来要从反射中怎么用,自己结合API和其他资料再写多一些. 示例:Test.java public class Test { public Test() {     }      public Test(int i) {         System.out.println(i);     } private void pri()

从一起“盗币”事件再谈合约安全问题

目录 从一起"盗币"事件再谈合约安全问题 一. 起因 二. solidity复杂变量的地址计算问题 一个示例 简单变量的地址 动态数组以及Map的地址 三. 先来玩demo 部署合约 初次调用newRecords 从失败中找到正确方法 构造成功的调用 四. 再一起来玩DVPgame 覆盖token 随便转点以太坊给DVPgame 看看别人怎么玩的 五. 剩下的问题 六. 小测试工具 从一起"盗币"事件再谈合约安全问题 本来是受到从一起"盗币"事件

C++ Primer 学习笔记_73_面向对象编程 --再谈文本查询示例

面向对象编程 --再谈文本查询示例 引言: 扩展第10.6节的文本查询应用程序,使我们的系统可以支持更复杂的查询. 为了说明问题,将用下面的简单小说来运行查询: Alice Emma has long flowing red hair. Her Daddy says when the wind blows through her hair, it looks almost alive, like a fiery bird in flight. A beautiful fiery bird, he

C++ Primer 学习笔记_74_面向对象编程 --再谈文本查询示例[续/习题]

面向对象编程 --再谈文本查询示例[续/习题] //P522 习题15.41 //1 in TextQuery.h #ifndef TEXTQUERY_H_INCLUDED #define TEXTQUERY_H_INCLUDED #include <iostream> #include <fstream> #include <sstream> #include <vector> #include <set> #include <map&g

再谈MySQL全库备份

再谈MySQL全库备份 简介 Part1:写在最前 在很早之前,我写过一个MySQL生产库全库备份脚本,今天有同事问我是不是要再加一个-R参数来备份存储过程,理由的话是由于mysqldump --help中 关于存储过程的默认备份是false. routines                          FALSE MySQL生产库全库备份脚本 http://suifu.blog.51cto.com/9167728/1758022 实战 Part1:写在最前 我备份一般就三个参数 --s