Introducing the Dynamics AX Kernel Class DictTable

By Bill Thompson | November 12, 2014

I want to introduce some rather helpful kernel based classes that have a name that starts with the word Dict (AOT >> System Documentation >> Classes node). These classes can be used within X++ code to find out information about different objects of different types. The specific class I want to bring to your attention today is the DictTable class.

This class allows the Developer to retrieve quite a bit of information programmatically about a table. Why bring this up? Well, I have seen code where some inexperienced Developers will use the treenode() object to traverse the AOT to find information about a specific table (for example, a Table ID value). While this will work, it can be a bit less performant than using the DictTable class.

This kernel based class is used in X++ code just like any X++ based class. A variable of type DictClass is defined, it is instantiated, and methods are called to retrieve specific information. The following job will retrieve information about the AOT based table CustTable.

static void DictTableExample(Args _args)


DictTable       dictTable;


dictTable = new dictTable(tableNum(CustTable));


if (dictTable)


info(strFmt(“Id: %1, Name: %2”,,;

info(strFmt(“Label: %1, Total Fields: %2”,dictTable.label(),dictTable.fieldCnt()));




The results of this job show the following:
Info       Message (04:08:02 pm) Id: 77, Name: CustTable

Info       Message (04:08:02 pm) Label: Customers, Total Fields: 189


That is quite a bit easier than writing up treenode().

The next question I can hear coming is why do I need or want to have to do this. If you are familiar with the document handling system in Dynamics AX, you will know that the DocuRef table stores the links to the many different types of document handling information across many different document types and modules. Looking at the table structure, you will see 2 columns, RefRecId, and RefTableId. These fields are really storing the specific record information (RecId) that resides in a specific table (the table Id). By using the DictTable class, you can create generic code that can respond to this information, and use it to do lookups in the parent table to retrieve whatever you need for your requirements.

More information on the DictTable class can be found on MSDN:



Related Posts

Recommended Reading:

Manage U.S. Use Tax on Purchase Orders in Dynamics 365 Finance and Operations

  Managing sales tax requirements on your business purchase can be complicated, but Dynamics 365 Finance and Operations can help […]

Read the Article
5.19.22 Dynamics CRM

How to Write a Great Support Ticket in the Stoneridge Support Portal

Submitting a support ticket through the Stoneridge Support Portal is a quick and effective way to get assistance for any […]

Read the Article

Managing Your Business Through Uncertain Times Using Dynamics 365 Finance and Operations

  Dynamics 365 Finance and Operations (F&O) can help you make informed decisions on how to move your business forward. […]

Read the Article
5.13.22 Power Platform

Using Power BI Object Level Security

  The following article will demonstrate how to use Power BI Object Level Security to disable column data based on […]

Read the Article
5.12.22 Dynamics CRM

How to Use the Stoneridge Support Portal

Stoneridge Software’s support portal is an intuitive and useful function that makes it easy for you to access resources to […]

Read the Article
5.6.22 Dynamics GP

Dynamics GP Transaction Removal: Purchase Orders

  Are you having performance issues with Purchase Orders?  Do you find that there are old Purchase Orders on your […]

Read the Article
5.5.22 Dynamics GP

The Real Story about the Long-Term Future of Dynamics GP Support

I’ve seen a number of people put forward comment that Dynamics GP is going away and you have to get […]

Read the Article

New Features in Dynamics 365 Business Central 2022 Wave 1 Release – Financial Enhancements

The Dynamics 365 Businses Central 2022 Wave 1 Release has a lot of new and exciting features to help your […]

Read the Article
4.29.22 Dynamics GP

Dynamics GP Transaction Removals: Bank Reconciliation

  This is part 2 of a 3 part series on Dynamics GP Transaction Removals. These quick tips will hopefully […]

Read the Article

Start the Conversation

It’s our mission to help clients win. We’d love to talk to you about the right business solutions to help you achieve your goals.

Subscribe To Our Blog

Sign up to get periodic updates on the latest posts.

Thank you for subscribing!