In this post, I am going to discuss about how the data can be retrieved, created, updated or deleted using data access and manipulating functionality provided by Dynamics AX framework. In DAX, developer doesn’t need to worry about opening the database connection, make transaction or fetching data, and close the connection. Rather doing these steps DAX framework requires only the table buffer variable to make transaction or manipulating data. What is table buffer? Hmmm, a table buffer is a variable of any Table which stores complete records, for example you can access any field of the table using that variable. Let’s take a simple example. In the Table node of the AOT, we have a table called “CustTable”, now we can declare a table buffer as,
CustTable custTable; ///table buffer variable of table type “CustTable”
A table buffer must be declared before using the select statement to retrieve data. The select statement is based on the SQL standard and quite similar to SQL server query statement except the fact that joining is little different for example there is no “ON” keyword in X++. The developer having experience in LINQ won’t have a problem in understanding the working of data access implementation in DAX. See the below simple job and its result.
static void Select_Statement(Args _args){
CustTable custTable;
select firstOnly custTable;
print custTable.AccountNum + ” ” + custTable.CustGroup;
pause;
} |
And the result after running this job is,
Now lets analyze the job, firstly a table buffer of table CustTable is declared, and in the 2nd line a select statement is written with the keyword “firstonly” which retrieves only one record based on the primary index defined on the Table. The “firstonly” keyword called the find option in DAX. The other find option keywords are “forUpdate”, “noFetch”, “firstFast”, and “reverse”. You can also define multiple find option keyword within a single select statement. A field list can also be provided with the select statement with the keyword “from”, for example,
select firstoOnly AccountNum, CustGroup from custTable;
Note: its now the BP error if not define the field list in the select statement in the AX 6.0 version.
Can we fetch multiple records? Yes, we can fetch multiple records using the “while” keyword with the select statement. The while loop will continue until all the records is fetched based on the condition in the where clause of the select statement. If now condition is defined, the loop will execute till the last record.
See and observe the output of the following job.
static void Select_Statement(Args _args){CustTable custTable;
while select AccountNum, custGroup from custTable
where custTable.CustGroup == “40”
{
print custTable.AccountNum + ” ” + custTable.CustGroup;
}
pause;
} |
Aggregate functions like sum, count, avg etc. can be used in the select statement like,
select count(AccountNum) from custTablegroup by custTable.CustGroupwhere custTable.CustGroup == “40”;
print custTAble.AccountNum; |
Lets talk about “joins” in DAX, how we can join multiple tables in the select statement. See the below simple example of join, which joins custTable with custGroup table.
static void Select_Join_Statement(Args _args){CustTable custTable;
CustGroup custGroup;
while select * from custTable
join * from custGroup
where custTable.CustGroup == custGroup.CustGroup
&& custGroup.Name == “Wholesalers”
{
print custTable.AccountNum + ” ” + custTable.Currency + ” ” + custGroup.PaymTermId;
}
pause;
} |
Instead of “On” keyword “where” keyword is used to join the same field of the tables that needs to be joined. The Join can be of type “Inner”, “outer”, “exists”, and “not exists”. There is no inner keyword so if the keyword join is written without the other keyword is referred to as inner join. See the below explanation of join types,
Join Type |
Explanation |
join |
Fetches the records that matches on both the table. It is the inner join. |
outer join |
Fetches the records whether or not records matches on both the table. |
exists join |
Fetches record from the table define before the exists keyword that matches with the records in the 2nd table. No records will be fetched from thesecondary table using exists join. |
notexists join |
Opposite of exists join. Will fetch records from the primary table, where norecords in the secondary table match the join expression. |
Try and observe the join type result by creating a job.
Now lets talk about insert, update, and delete records from the table. These will also be done by using the table buffer. In the table buffer, we have methods, of insert, update , and delete. To insert a record into table, declare table buffer, set values of the fields and call insert method of that table buffer. For example,
static void Insert_Job(Args _args){
CustTable custTable;
custTable.AccountNum = “4444”;
custTable.Currency = “USD”;
custTable.insert();
} |
Similarly, to update the record, update method will be called, but first records need to be fetched using the select statement with the keyword “forupdate”.
static void Update_Job(Args _args){
CustTable custTable;
select forupdate * from custTable where custTable.AccountNum == “4444”;
custTable.Currency = “EUR”;
custTable.update();
} |
You can also update the record using the statement “update_recordset”
update_recordset custTablesetting currency = “EUR”where custTable.AccountNum ==”4444″; |
Now to delete the record, you can delete the record in two ways, either fetch the record using the forupdate keyoword and call the delete method of table buffer or using the delete_from statement.
static void Delete_Job(Args _args){
CustTable custTable;
select
forupdate * from custTable where custTable.AccountNum == “4444”;
custTable.delete();
} |
Or using delete_from like,
delete_from custTablewhere custTable.AccountNum ==”4444″; |
Inserting, updating, and deleting records are placed under the ttsbegin; and ttscommit; block. These keywords are usually placed to make sure that the transactions to database have been done successfully. If any failure occurs during the transaction then the state will be roll back to position before the ttsbegin keyword. ttsabort; keyword is also used when any exception occurs and transaction needs to be aborted.
Thanks for reading.