RSS

QUERYING DATE EFFECTIVE TABLES IN MICROSOFT DYNAMICS AX 2012

24 Sep

QUERYING DATE EFFECTIVE TABLES IN MICROSOFT DYNAMICS AX 2012

In Microsoft Dynamics AX 2012, valid time state tables (date effective tables) were introduced to help organizations keep track of data that changes over time. For example, currency exchange rates change over time and it is necessary to view exchange rate data at a specific point in time.

For this blog, the exchange rate table will be used as an example.

This blog discusses how developers can query data in date effective tables and examines the results when using forms, queries, views and X++ code. If not properly understood by the developer, incorrect or incomplete data will be returned when querying the database.

Exchange rate table

The exchange rate table holds exchange rate data between two (2) currencies. The standard Microsoft Dynamics AX form can show current, past and future the exchange rate data as show below.

Creating custom forms

A custom screen was created to display the exchange rate table. The exchange rate table was used as a data source and a grid was added to display the data.

The data that is returned only shows data that is current based on a current date of 1/2/2015. Prior and future exchange rates are excluded.

The ExchangeRate datasource property ‘ValidTimeStateAutoQuery’ is used to control what data is returned.

Change this to ‘DateRange’ and all records will be returned.

Querying the data using a query

A custom query was created to query the ExchangeRate table.

The following code is used to run this query:

static void AXMExchangeRateQuery(Args _args)
{
    QueryRun        queryRun;
    ExchangeRate    ExchangeRate;
    ;
    query = new query(queryStr(AXMExchangeRateQuery));
    
    queryRun = new QueryRun(query);
    
    while (queryRun.next())
    {
        ExchangeRate = queryRun.get(tableNum(ExchangeRate));  
        info(strFmt("%1 %1", ExchangeRate.ValidFrom, ExchangeRate));
    }
}

Running the query returns only current records.

It is possible to change the behavior of the query results set to return data at a previous point in time, for example prior exchange rates.

The following code can be used to query data for different date ranges:

static void AXMExchangeRateQuery(Args _args)
{
    QueryRun        queryRun;
    ExchangeRate    ExchangeRate;
    FromDate        FromDate = mkDate(1,1,2014);
    ToDate          ToDate   = mkDate(1,6,2015);
    ;
    query = new query(queryStr(AXMExchangeRateQuery));
    query.validTimeStateDateRange(FromDate, ToDate);
    
    queryRun = new QueryRun(query);

    
    while (queryRun.next())
    {
        ExchangeRate = queryRun.get(tableNum(ExchangeRate));  
        info(strFmt("%1 %2", ExchangeRate.ValidFrom, ExchangeRate.ExchangeRate));
    }
}

Running the query returns the following data.

Use the validateTimeStateASOfDate method to return data that is valid at a specific date. For example, if you want to know what the exchange rate should be for a transaction with a date of 3/7/2014, run the following code:

static void AXMExchangeRateQuery(Args _args)
{
    QueryRun        queryRun;
    ExchangeRate    ExchangeRate;
    TransDate       TransDate = mkDate(3,7,2014);
    ;
    query = new query(queryStr(AXMExchangeRateQuery));    
    query.validTimeStateAsOfDate(TransDate);
    
    queryRun = new QueryRun(query);

    
    while (queryRun.next())
    {
        ExchangeRate = queryRun.get(tableNum(ExchangeRate));  
        info(strFmt("%1 %2", ExchangeRate.ValidFrom, ExchangeRate.ExchangeRate));
    }
}

The following data is returned.

Querying the data using x++

The following x++ code is used to access the data:

static void AXMExchangeRateAccess(Args _args)
{
    ExchangeRate ExchangeRate;
    ;
    while select ExchangeRate
    {
        info(strFmt("%1 %2", ExchangeRate.ValidFrom, ExchangeRate.ExchangeRate));
    }
}

The following data is returned, again only current data is returned with a current date of 1/2/2015. It is important to note this as not all records are returned from the databse, despite no filtering applied in the X++ while select statement.

It is possible to return data as of a specific point in time using the validTimeState keyword.

The following code can be used to find data that is valid for a given data range:

static void AXMExchangeRateAccess(Args _args)
{
    ExchangeRate    ExchangeRate;
    FromDate        fromDate = mkDate(1,1,2014);
    ToDate          toDate = mkDate(1,1,2016);
    ;
    while select validTimeState(fromDate, toDate) ExchangeRate
    {
        info(strFmt("%1 %2", ExchangeRate.ValidFrom, ExchangeRate.ExchangeRate));
    }
}

The following data is returned. By changing the from and to dates, we can control the amount of data being returned.

If you want to know what the exchange rate should be for a transaction with a data of 3/7/2014, run the following code:

static void AXMExchangeRateAccess(Args _args)
{
    ExchangeRate    ExchangeRate;
    TransDate       TransDate = mkDate(3,7,2014);
    
    while select validTimeState(TransDate) ExchangeRate
    {
        info(strFmt("%1 %2", ExchangeRate.ValidFrom, ExchangeRate.ExchangeRate));
    }
}

The following data is returned.

Creating a view

Microsoft Dynamics AX Views can be created in the AOT to return data from data effective tables. This can be used to overcome issues when you need to return all data from a date effective table and cannot use the query object or X++ parameters to control the date effective options.

The following view was created in the AOT.

Using a view in a form data source

A new form was created and the view above was used as datasource.

The following records are shown, the date effective filters do not apply.

Using a view in a query

A custom query was created to query the ExchangeRate table using a view.

The following code is used to run this query:

static void AXMExchangeRateViewQuery(Args _args)
{
    queryRun                queryRun;
    AXMExchangeRateView     AXMExchangeRateView;
    ;
    queryRun = new queryRun(queryStr(AXMExchangeRateViewQuery));
    while (queryRun.next())
    {
        AXMExchangeRateView = queryRun.get(tableNum(AXMExchangeRateView));   
        
        info(strFmt("%1 %2", AXMExchangeRateView.ValidFrom, AXMExchangeRateView.ExchangeRate));
    }
}

Running the query returns all records, the date effective filters do not apply.

Using a view in a x++ while select

The following X++ code is used is used to access data in the view:

static void AXMExchangeRateViewAccess(Args _args)
{
    AXMExchangeRateView AXMExchangeRateView;
    ;
    while select AXMExchangeRateView
    {          
        info(strFmt("%1 %2", AXMExchangeRateView.ValidFrom, AXMExchangeRateView.ExchangeRate));
    }
}

Running the code returns all records, the date effective filters do not apply.

Modifying the view properties

By default, using a view to display data form a date effective table disables the date effective search results, which is useful when it is necessary to always return all data. However, it is possible to enable the date effective parameters, by changing the view property below

– See more at: http://axmentor.com/learninglab/blog/development/querying-date-effective-tables-in-microsoft-dynamics-ax-2012/#sthash.UNiQlWBs.dpuf

Advertisements
 
Leave a comment

Posted by on September 24, 2015 in Uncategorized

 

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

 
All About Dynamics 365

Dynamics 365, D365, Implementor

syedrafayali

This blog contains information about Functional techniques and guidelines in Microsoft Dynamics AX, including tips, tricks, tutorials, tools and upcoming news enhancement in Microsoft Dynamics Ax

Philippsen's Blog

Everyday findings in my world of .net and related stuff

Microsoft Dynamics AX

A great WordPress.com site

Finite Minds

Adventures in IoT

Dynamics Ax

Technical Knowledge

timsaxblog

A blog about implementing Microsoft Dynamics AX and Dynamics 365 for Operations

Microsoft Dynamics 365 Blog

All Things Dynamics 365 - Enterprise Edition, A Blog by Sandeep Chaudhury

DEVSerra - Dynamics AX development blog

Your official Microsoft Dynamics AX blog.

OrganicAX

Discovering Dynamics

AX

A blog by Hai Nguyen

Learn Dynamics Ax with Johnkrish

Live as if you were to die tomorrow. Learn as if you were to live forever - Mahatma Gandhi ****** The more I learn, the less I know - Albert Einstein

Twisted Untwirled

Just another WordPress.com site

ramdynamicsax

Just another WordPress.com site

guyterry's Dynamics AX blog

Just another Dynamics AX blog

Chaitanya kumar

Happy DAXing...!!! :)

%d bloggers like this: