Dimension Value Descriptions in Dynamics AX

by | Updated February 15, 2016 | Development, Dynamics AX

I have been asked a few times to retrieve the description along with the value of a particular dimension in Dynamics AX.  For example, in AX go to a sales order and select a sales line, below the lines grid expand the Line details fast tab and click on the Financial dimensions fast tab.

Often times in reports or forms, you want to see not just OU_241 but also the descriptive name of a particular dimension, in this case Projects.  While this example is based on a sales order it applies to many different transaction types in AX.

To retrieve the descriptive name you can do the following:

  1. Find the DefaultDimension value saved on the line.  On every transaction line I have seen there is a field called DefaultDimension.  It stores the combination of dimension values saved on that line.

2.  With the DefaultDimension field retrieve the DefaultDimensionView.  You can use a query similar to this one:

3.  With the DimensionView find the corresponding DimensionAttribute:

4. With the DimensionAttribute retrieve the descriptive name from the DimensionFinancialTag table:

Related Posts


  1. Amar Singh

    Hi Becky,
    Thanks a lot for the information, My need is shown the dimension description at the report level and i have copied your code .

    DefaultDimensionView dimensionView;
    DimensionAttribute dimensionAttribute;

    select firstOnly dimensionView
    where dimensionView.DefaultDimension == 5637144584
    join dimensionAttribute
    where dimensionView.Name == dimensionAttribute.Name;

    DimensionAttribute dimAttribute; dimAttribute = DimensionAttribute::find(dimensionView.DimensionAttributeId);

    DimensionFinancialTag::findByFinancialTagCategoryAndValue(dimAttribute.financialTagCategory(), dimensionView.DisplayValue).Description;

    Here is getting the error as Invalid Token, Please have a look if you are free any time

  2. Taylor Valnes

    Hello Amar,

    I spoke with the author and they are suggesting that you create a job and debug the code so you know specifically where it’s failing. That should help you identify the problem that needs to be fixed. If you find something more specific and are unsure how to solve it feel free to respond back here with the specifics.


  3. Amar Singh

    Hi Taylor Valnes,

    Thanks for the updates,
    I got a solution , the mistake i was making in the last line of code is, i should initialize it to the str variable to get the output.. i am good.. thanks again for your help

    DimensionFinancialTag::findByFinancialTagCategoryAndValue(dimAttribute.financialTagCategory(), dimensionView.DisplayValue).Description;

  4. Taylor Valnes

    Hello Amar,

    That’s good to hear! Thank you for your blog comment!


Submit a Comment

Your email address will not be published. Required fields are marked *

Upcoming Events


02dec9:00 am12:00 pmOnline Workshop - Dynamics GP Year End Close (Morning Session)

03dec11:00 am12:00 pmConfab with Stoneridge - Livestream: Live Agents, Power Virtual Agents, Omnichannel – Oh My!

03dec1:00 pm4:00 pmOnline Workshop - Dynamics GP Year End Close (Afternoon Session)

09dec10:00 am10:30 amThe Modern Manufacturer - Manufacturing Policy Management

17dec11:00 am12:00 pmConfab with Stoneridge - Livestream - Technology in 2020: A Year in Review


06jan10:00 am10:30 amThe Modern Manufacturer - MRP v MPS – What, When and How

14jan11:00 am12:00 pmConfab with Stoneridge - Livestream - Looking Forward: Predictions for Technology in 2021

20jan10:00 am10:30 amThe Modern Manufacturer - Demand Forecasting Functionality

About Stoneridge
Stoneridge Software is a unique Microsoft Gold Partner, with emphasis on partner. With specialties in Microsoft Dynamics 365, Microsoft Dynamics AX, Microsoft Dynamics NAV, Microsoft Dynamics GP and Microsoft Dynamics CRM, we focus on attracting the most knowledgeable experts in the field to our team, and prioritize delivering stellar solutions with maximum impact for your business. At Stoneridge, we are deeply committed to your results. Each engagement is met with a dedicated team, ready to provide thorough, tailored, and expert service. Based in Minnesota, we intentionally “step into your shoes,” wherever you are. We focus on what you care about, and develop trusting, long-term relationships with our clients.

Subscribe To Our Blog

Sign up to get periodic updates on the latest posts.

Thank you for subscribing!