How to create a custom number sequence

 How to create a custom number sequence in Dynamics.


To create a custom number sequence, you need the following:

1. An EDT for the number sequence. EDT is called extended data type, an extension of the primitive data types in Dynamics, which includes: anytype, boolean, date, enum, guid, int, int64, real, str, timeOfDay, utcdatetime.

2. Extended the class for managing number sequences in Dynamics (NumberSeqApplicationModule)

3. Override the class's load module method. This method is protected, which means it can only be accessed by its definition class and subclasses.

4. Specify the specific module you would like the number sequence to be, by returning the specified enum.

5. Subscribe to the build modules map method of the Number Sequence Global class(NumberSeqGlobal).

6. Run the load module as a job class to initialise the number sequence on the parameters module.

7. Run the number sequence wizard to generate the value on the parameters module.


Let's assume we want to create a custom number sequence called Probation Id.


1. Create a Probation Id as an EDT 


2. Create a new class and name it ProbationIdSeq  Extend the NumberSeqApplicationModule class.

public class ProbationIdSeq extends NumberSeqApplicationModule

{}

3. Override the class's load module method.

protected void loadModule()

{

    

   //instantiate the data type of the number sequence and its expected behaviour

NumberSeqDatatype datatype = NumberSeqDatatype::construct();


    datatype.parmDatatypeId(extendedTypeNum(ProbationId));

    datatype.parmReferenceHelp(literalStr("Unique key used for the Probation Id."));

    datatype.parmWizardIsContinuous(false);

    datatype.parmWizardIsManual(NoYes::No);

    datatype.parmWizardFetchAheadQty(10);

    datatype.parmWizardIsChangeDownAllowed(NoYes::No);

    datatype.parmWizardIsChangeUpAllowed(NoYes::No);

    datatype.parmSortField(1);


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

    this.create(datatype);

4. Specify the specific modules for the number sequence. In this case, we will use the Human Resources module.

 public NumberSeqModule numberSeqModule()

 {

     return NumberSeqModule::HRM;

 }

5.  Subscribe to the build modules map method of the Number Sequence Global class(NumberSeqGlobal).

[SubscribesTo(classstr(NumberSeqGlobal),delegatestr(NumberSeqGlobal,buildModulesMapDelegate))]

static void buildModulesMapSubsciber(Map numberSeqModuleNamesMap)

{

    NumberSeqGlobal::addModuleToMap(classnum(ProbationIdSeq), numberSeqModuleNamesMap);

}

6. Run the load module as a job class to initialise the number sequence on the parameters module.

public static void main(Args _args)

{

    Go2FMNPerfProbationIdSeq budgetIdNumSeq = new Go2FMNPerfProbationIdSeq();

        budgetIdNumSeq.load();

    

}

Result:


7. Run the number sequence wizard to generate the value on the parameters module. To get the final result above.

Below are the full code snippets.

1. For custom Number sequence creation

public class ProbationIdSeq extends NumberSeqApplicationModule

{

    protected void loadModule()

    {

        NumberSeqDatatype datatype = NumberSeqDatatype::construct();


        datatype.parmDatatypeId(extendedTypeNum(ProbationId));

        datatype.parmReferenceHelp(literalStr("Unique key used for the Probation Id."));

        datatype.parmWizardIsContinuous(false);

        datatype.parmWizardIsManual(NoYes::No);

        datatype.parmWizardFetchAheadQty(10);

        datatype.parmWizardIsChangeDownAllowed(NoYes::No);

        datatype.parmWizardIsChangeUpAllowed(NoYes::No);

        datatype.parmSortField(1);


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

        this.create(datatype);

    }


    public NumberSeqModule numberSeqModule()

    {

        return NumberSeqModule::HRM;

    }


    [SubscribesTo(classstr(NumberSeqGlobal),delegatestr(NumberSeqGlobal,buildModulesMapDelegate))]

    static void buildModulesMapSubsciber(Map numberSeqModuleNamesMap)

    {

        NumberSeqGlobal::addModuleToMap(classnum(ProbationIdSeq), numberSeqModuleNamesMap);

    }


}


2. Job class to run to initialise the number sequence in the module's parameters.

internal final class ProbationLoadId

{

    /// <summary>

    /// Class entry point. The system will call this method when a designated menu 

    /// is selected or when execution starts and this class is set as the startup class.

    /// </summary>

    /// <param name = "_args">The specified arguments.</param>

    public static void main(Args _args)

    {

        ProbationIdSeq probationIdNumSeq = new ProbationIdSeq();

            probationIdNumSeq.load();

        

    }


}


Happy coding....




Comments

Post a Comment

Popular posts from this blog

Integration Capabilities and Support in Microsoft Dynamics 365 Finance & Operations (F&O) - An Overview

Image
Integration Capabilities and Support in Microsoft Dynamics 365 Finance & Operations (F&O) : Title: Unlocking the Power of Integration with Microsoft Dynamics 365 Finance & Operations In today’s fast-paced digital economy, businesses require agile, connected systems to manage operations effectively. Microsoft Dynamics 365 Finance & Operations (F&O) stands out by offering robust integration capabilities, allowing organizations to streamline operations, improve data consistency, and enhance productivity across platforms. This blog post explores the various integration options and support mechanisms that make Dynamics 365 F&O a top choice for enterprise resource planning (ERP). 1. Data Management Framework (DMF) The Data Management Framework , also known as the Data Import Export Framework (DIXF), is one of the core components for integrating data into and out of Dynamics 365 F&O. Key Features: Staging and target data model: Ensures validation before...
Read more

Performance and Monitoring in dynamics 365 F&O.

Image
  Performance and Monitoring in dynamics 365 F&O. If your Dynamics 365 Finance & Operations (F&O) environment feels sluggish, users are frustrated, or you’re flying blind when issues strike, then it’s time to talk performance and monitoring. Performance tuning is one part some deployments overlook. Can I tell you a secret? Your Dynamics system is not supposed to lag, if it lags then something needs fixing. Let’s be real: F&O is powerful, but without proactive tuning and eyes on the right metrics, even the best deployments can turn into digital traffic jams. In this post, we’ll break down how to boost performance, monitor proactively , and keep your ERP humming like a well-oiled machine.   Why Performance & Monitoring Matter Performance issues aren’t just annoying, they're expensive. Slow load times and failing batch jobs can delay operations, disrupt finance processes, and frustrate users. I have seen cases in implementations where performan...
Read more

Dynamics 365 F&O Deployment Architecture: What You Need to Know

Image
  Dynamics 365 F&O Deployment Architecture (Cloud Based): What You Need to Know When it comes to Dynamics 365 Finance & Operations (D365 F&O) , understanding the deployment architecture isn’t just a "nice-to-have", it’s a must for ensuring scalability, performance, and long-term maintainability. Whether you're planning a new implementation or optimizing an existing one, this guide will help you understand the building blocks of a well-architected D365 F&O environment. What Is Deployment Architecture? In simple terms, deployment architecture defines how the components of a system are organized, how they interact, and how they're deployed in environments like dev, test, UAT, and production. With D365 F&O, this architecture lives in the cloud-first, SaaS-based world , but there are still many moving parts to consider. ☁️ Cloud-Hosted vs. Microsoft-Managed Deployments There are two primary options: 1. Microsoft-Managed (Pr...
Read more