Introducing the Dynamics AX Kernel Class DictTable

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

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


Submit a Comment

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

Upcoming Events


01sep10:00 am10:30 amEnsuring Quality and Compliance for Batch Manufacturers in Life Sciences

01sep12:00 pm12:30 pmIs it Worth It to Move to the Cloud? A Look at Considerations for Current Agribusinesses Using Dynamics GP

01sep2:00 pm2:45 pmWhat’s New in Dynamics 365 Finance and Supply Chain

09sep11:00 am12:00 pmConfab Live with Stoneridge – Data Strategy and Reporting – Mining Decision Making Insights

15sep10:00 am11:00 amSolving the Biggest Challenges in Agribusiness Through Innovation and Technology

22sep12:00 am12:30 pmSimplifying Payroll and HR Management with ADP Workforce Now

22sep10:00 am10:30 amStreamlining Batch Manufacturing with Technology

22sep2:00 pm2:30 pmProcess Automation for Microsoft Dynamics D365 for Business Central, Finance and Operations and GP

23sep11:00 am12:00 pmConfab LIVE with Stoneridge - Riding the Wave 2 Release – Key Features Coming to Dynamics 365 this October

29sep10:00 am11:00 amTop Five Reasons Why NOW is the Right Time to Move from Salesforce to Dynamics 365 Customer Engagement

29sep12:00 pm12:45 pmUnderstanding Job Costing and Tax Management in Business Central

29sep2:00 pm3:00 pmDigitalizing Horticulture & Agriculture - How to Sell Plants Online and Simplify Business Management

30sep12:00 pm4:00 pmSecurity and Permissions Training for D365 Business Central or Dynamics NAV


06oct10:00 am10:30 amPreview of D365 Business Central Fall Release Features and Functionality

06oct12:00 pm12:30 pmInsider's Guide to New Features Available in the Fall Release of D365 Finance and Supply Chain

07oct11:00 am12:00 pmConfab LIVE with Stoneridge - Dataverse and Dynamics in Review – Let’s Get Technical

21oct11:00 am12:00 pmConfab LIVE with Stoneridge - Dataverse and Dynamics in Review – Let’s Get Functional

26oct(oct 26)9:00 am28(oct 28)5:00 pmStoneridge Connect Leadership and Community Conference

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!