Working with Financial dimensions in D365FO

March 06, 2019

Working with the financial dimensions framework has become much more difficult starting with the AX2012. This post describes the most common problems and how to resolve them.

The current problems

The current challenges that I saw on the projects while working with the financial dimensions framework were the following:

Misunderstanding of the concept

There is no starting point if you want to learn Financial dimensions framework. The best I found is the original Implementing the Account and Financial Dimensions Framework for Microsoft Dynamics AX 2012 Applications whitepaper that explains the concept, but its content is quite outdated for D365FO. GitHub request to update this document was closed, standard D365FO Financials development home page contains some really specific information and no basic overview.

Reference to the dimension

Sometimes you need to reference just one dimension value(for example get or set "Cost center" value). You don't see many examples of this in the standard application, as in most cases dimension merging is using. In AX2009 it was quite easy - you had an enum and could use it to get or set the value. In the current version, you need somehow to reference a record in the DimensionAttribute table and there is no "recommended" way of doing this. So, I have seen different implementations:

  • Add DimensionAttribute to parameters(as String or as RecId)

  • Create a new table with enum and reference to DimensionAttribute

  • Search DimensionAttribute by backing table ID

  • Search DimensionAttribute by name defined as a Macro

  • ... sometimes combinations of these options to access the same dimensions

All this can create a real mess, some of these options require a setup, some aren't compatible with cross-references.

Problem: Methods for working with Dimensions

There are a lot of classes to manipulate dimensions, so it is often difficult to find the right one. Moreover, classes related to dimension were renamed in D365FO(comparing to AX2012). As a result, developers sometimes create a duplicate of the existing methods.

For example, if you google "assign a value to default dimension" the first link will point to the 2-page method


Probably it can work but can cause difficulties with the support, performance and upgrades.

Proposed solution - DEVDimensionHelper class

To resolve the described issues I have created DEVDimensionHelper class(you can rename it with your project prefix or use the default DEV). The idea is to collect all the necessary stuff in one place.

In order to reference a dimension, you create a static method in this class with a default value

    static protected Name BusinessUnit   = 'BusinessUnit';
    static public Name BusinessUnit()  
        return BusinessUnit;  

In this case, you don't need to perform any setup and can use "Find All References".

Currently this class contains the following references:

  • Create a new dimension
  • Query filter by dimension
  • Get Dimension value as string from the DefaultDimension
  • Get Dimension value as string from the LedgerDimension
  • Get a DefaultAccount from the LedgerDimension
  • Get a DefaultDimension from the LedgerDimension
  • Create a DefaultAccount from the MainAccount(String)
  • Create a DefaultAccount from the MainAccount(RecId)
  • Create a LedgerDimension from the DefaultAccount and DefaultDimension
  • Create a DefaultDimension from the Dim value(String)
  • Merge DefaultDimension with the DefaultDimension
  • SQL statement to get dimension(used for debug purposes)


As you see, there is no new code, all these it's just references(or small wrappers) to the standard classes. These methods will cover typical project requirements, if you need more, you can add them to this class.

The idea is to use this class as a starting point for any dimension related question on the project(even before Googling something). You get some dimension related question, you check this class, if there is no answer in it, research how to do this task and update the class with the solution(either in form of new methods or just references to existing objects).

Update 10/02/2020:

To avoid always hardcode dimension names, I have made the following adjustment in the solution:

Created a static constructor in DEVDimensionHelper class that allows overriding the default dimension names(you need to uncomment this code or add your code)

Static constructor

Created a simple table and a form(DEVDimNamesReference) where you can setup dimension name references(this can be used for example in situations where you have CostCenter and CostCente dimensions)


This form usage is optional, and even if it is used it requires zero setup - if the value in this form is not specified the default value from the class will be used.


You can download this class using the following link

If you know some other methods that can be added into this class feel free to create a GitHub pull request or leave a comment.

Tagged with:
Denis Trunin
Written by Denis Trunin

Get notifications about new posts on Twitter, RSS .