RSS

Connecting to Databases through X++

13 Dec

Connecting to Databases through X++

In this article, different ways through which one can connect to different databases for data manipulation operations.
In AX, the methods that I know are following. Please feel free to add more methods that you feel are also available.
  • ODBC Connection
  • ADO Connection
  • OleDB Connection
  • Connection class

Let us go through each of these options one by one.

ODBC Connection:

ODBC stands for Open Data Base Connectivity. It is a connection that is created to define a connection between a computer and a database stored on another system. The ODBC connection contains information needed to allow a computer user to access the information stored in a database that is not local to that computer. In Dynamics AX, we have ODBCConnection class to carry out this type of database connection need. This class uses LoginProperty class for login information and uses Statement and ResultSet classes for carrying out DML operations. Below is an example of how to use this class.

static void dbODBCConnection(Args _args)
{
LoginProperty   loginProp;
ODBCConnection  conn;
Resultset       resultSet, resultSetCount;
Statement       statement1, statement2;
;

    loginProp = new LoginProperty();

    loginProp.setServer(‘Arun’);
loginProp.setDatabase(‘AX2009′);

    conn = new ODBCConnection(loginProp);

    statement1  = conn.createStatement();
resultSet   = statement1.executeQuery(“SELECT * from CustTable where DATAAREAID = ‘CEU’”);

    while (resultSet.next())
{
info(resultSet.getString(1));
}
}

The above sample code is a job. Note that you may have to use respective permission classes like SQLStatementExecutePermission etc. while using in classes and any other place. Note that if you need to invoke a stored procedure then just type exec in the executeQuery instead of the select statement.

ADO Connection:

ADO is an abbreviation for ActiveX Data Objects. ADO is a set of COM objects for accessing databases or data stores. In AX we have following objects making a collection for implementing ADO concept.

  • CCADOConnection – Helps in establishing a connection to the target database.
  • CCADOCommand – Helps in executing a command (a Text type or a Stored procedure)
  • CCADORecordSet – Stores the data
  • CCADOFields – A collection of all fields in CCADORecordSet
  • CCADOField – A single field from the collection of fields
  • CCADOParameter – A class that helps in passing parameters that a command needs or demands

The example below demonstrates the working of some of these classes:

static void dbCCADOConnection(Args _args)
{
CCADOConnection connection = new CCADOConnection();
CCADOCommand    ccADOCommand;
CCADORecordSet  record;
str connectStr = “Provider=SQLNCLI.1;Integrated Security=SSPI;”+
“Persist Security Info=False;Initial Catalog=AX2009;Data Source=Arun”;

    COM     recordSet;  /*This is required to call moveNext method to parse the record set. In AX 4.0 this method was there in the CCADORecordSet class but in AX 2009 this has been deleted*/
    ;

    // Executing a SQL Statement
try
{
connection.open(connectStr);
ccADOCommand = new CCADOCommand();
ccADOCommand.commandText(“Select * from CustTable where DataAreaId = ‘CEU’”);
ccADOCommand.activeConnection(connection);
record = ccADOCommand.execute();
recordSet = record.recordSet();
while (!record.EOF())
{
info(any2str(record.fields().itemIdx(0).value()));
recordSet.moveNext();
}
}
catch
{
error(“An Exception has occurred”);
}

    connection.close();
}

The above sample code is a job. Note that you may have to use respective permission classes like SQLStatementExecutePermission etc. while using in classes and any other place.

OLEDB Connection:

OLEDB stands for Object Linking and Embedding, DataBase. It is a set of APIs designed by Microsoft and used for accessing different types of data stored in a uniform manner. Dynamics AX as such doesn’t have any specific classes built for this purpose. But one can make use of .Net Framework’s System.Data.OleDb namespace through AX’s COM Interoperability feature and use it in AX.

Below is an example code that depicts this scenario:

static void dbOLEDBConnection(Args _args)
{
System.Exception                    e;
System.Data.OleDb.OleDbConnection   objConn;
System.Data.OleDb.OleDbCommand      cmdSelect;
System.Data.OleDb.OleDbDataReader   reader;
InteropPermission                   perm;
str connectStr = “Provider=SQLNCLI.1;Integrated Security=SSPI;”+
“Persist Security Info=False;Initial Catalog=AX2009;Data Source=Arun”;
str exceptionStr;
;

    try
{
perm = new InteropPermission(InteropKind::ClrInterop);
if (perm == null)
{
throw error(“Error with file permissions”);
}
perm.assert();

        objConn = new System.Data.OleDb.OleDbConnection(connectStr);
objConn.Open();

        cmdSelect   = objConn.CreateCommand();
cmdSelect.set_CommandText(“SELECT * FROM CustTable where DATAAREAID = ‘CEU’”);
reader      = cmdSelect.ExecuteReader();

        while (reader.Read())
{
info(reader.GetString(0));
}
}
catch(Exception::CLRError)
{
CodeAccessPermission::revertAssert();

        perm = new InteropPermission(InteropKind::ClrInterop);
if (perm == null)
{
return;
}
perm.assert();

        e = ClrInterop::getLastException();

        CodeAccessPermission::revertAssert();

        while( e )
{
exceptionStr += e.get_Message();
e = e.get_InnerException();
}
info(exceptionStr);
}
catch
{
error(“An Exception has occurred”);
}

    if(objConn)
objConn.Close();
}

Connection Class:

Connection class is mainly used for accessing the database in which a user has logged into AX i.e. Current Database and carry out the operations. This class is exetensively used in ReleaseUpdateDB classes, the classes used in data upgrades. This class cannot be run on client and should always be run on server. One more unique thing that I noticed is that the statements that you want to execute should be asserted first for permissions and then passed on to other method where they are executed. Create a class with following methods and set its RunOn property to Server.

class TestSQLExecuteClass
{
}

//This method tests the permissions for statement and then calls the method that will execute the statement
static void dbConnectionClass()
{
ResultSet   rs;
SqlStatementExecutePermission perm;
;

    perm = new SQLStatementExecutePermission(“select * from CustTable where DATAAREAID = ‘CEU’”);
perm.assert();

    rs = TestSQLExecuteClass::statementExeQuery(“select * from CustTable where DATAAREAID = ‘CEU’”);

    while (rs.next())
{
info(rs.getString(1));
}
CodeAccessPermission::revertAssert();
}

//Executes the passed statement
private static ResultSet statementExeQuery(str _sql, Connection _con = null)
{
ResultSet   resultSet;
Statement   statement;
;

    try
{
if(!_con)
{
_con = new Connection();
}

        statement = _con.createStatement();

        // Do not call assert() here, do it in the caller
// BP deviation documented

resultSet = statement.executeQuery(_sql);
}
catch (Exception::Error)
{
throw error(“@SYS99562”);
}

    return resultSet;
}

Now you can call the method in a job as shown below:

static void dbConnectionClass(Args _args)
{
;

    TestSQLExecuteClass::dbConnectionClass();
}

 
Leave a comment

Posted by on December 13, 2011 in SQL, X++

 

Tags: ,

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 )

Google photo

You are commenting using your Google 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 )

Connecting to %s

 
365 by Thijs

Blogging about Microsoft 365, Azure and Automation!

axhowto

Blog about ax with sample codes, tips and tricks.

GM Dynamics Blogs

Transform IT with Digital Trasformation and Social Innovation

Ms. Dynamic Millennial

Unboxing Microsoft Dynamics 365 for Finance and Operations

DynaD365Power

Exploring the new vision of the Power platform

Dynamics Vision 365

The FinOps pulse

Breaking Bong

I write when no one is watching

ErpCoder

Microsoft Dynamics 365 Business Management Solution Enthusiast

Dynamics 365 Finance

Dynamics 365 Finance & Much More.

Microsoft Dynamics AX

“ANYONE WHO STOPS LEARNING IS OLD, WHETHER AT TWENTY OR EIGHTY.” —HENRY FORD

Sumit Potbhare

Dynamics 365 for Commerce

iotsolution.se

This is your site about D365 (Finance and Supply Chain Management), IoT (Internet of Things) and HoloLens

Omni 365

Dynamics 365 Finance and Operations Blog

DIY D365

Power Platform Done Your Way

%d bloggers like this: