.NET Business Connector Overview
The following sections provide information about .NET Business Connector for Microsoft Dynamics AX.
.NET Business Connector is a Microsoft Dynamics AX component that enables you to integrate with Microsoft Dynamics AX from a .NET-connected application. You can call Microsoft Dynamics AX business logic or access data from a .NET-connected application. For an example of using .NET Business Connector to access data, see Walkthrough: Integrate an Application with Microsoft Dynamics AX Using .NET Business Connector. For information about the other ways to integrate with Microsoft Dynamics AX, see Integrating Other Applications with Microsoft Dynamics AX.
Calling Business Logic
You can call business logic in Microsoft Dynamics AX using the CallStaticClass method. For the steps to call business logic using .NET Business Connector, see How to: Call Business Logic Using .NET Business Connector. You can also debug X++ code that you access from a .NET-connected application. For more information, see How to: Debug X++ Code Running in .NET Business Connector.
Accessing Data
You can access data in Microsoft Dynamics AX using the AxaptaRecord class. For the steps to create data by using .NET Business Connector, see How to: Create Data Using .NET Business Connector. You can also read, update, and delete Microsoft Dynamics AX data. For more information, see How to: Read Data Using .NET Business Connector, How to: Update Data Using .NET Business Connector, and How to: Delete Data Using .NET Business Connector.
Managed Classes
.NET Business Connector provides interoperability with the .NET Framework. This is enabled by providing .NET Framework 2.0 managed classes. The following table provides a description of the managed classes.
|
.NET managed class |
Description |
|---|---|
|
Provides the ability to connect to the Microsoft Dynamics AX system, create Microsoft Dynamics AX classes, records, containers, buffer objects, execute transactions, and perform other Microsoft Dynamics AX system tasks. | |
|
Provides the ability to add data to and retrieve data from a buffer. This class is used with AxaptaContainer objects. | |
|
Provides the ability to read and write to containers. | |
|
Provides the ability to call X++ class methods. | |
|
Provides the ability to read and write to Axapta records. Records are tables in the Dynamics Axapta database. Also provides the ability to call X++ methods defined on the table. |
For an example that uses some of these classes, see Walkthrough: Integrate an Application with Microsoft Dynamics AX Using .NET Business Connector. For more information about these classes, see the BusinessConnectorNet namespace.
Accessing AOT Form Restrictions
Forms in the Application Object Tree (AOT) cannot be accessed from the Microsoft Dynamics AX Business Connector. Forms are intended to be accessed from only the Microsoft Dynamics AX client application. Any attempt to access a form from the Microsoft Dynamics AX .NET Business Connector causes a null value to be returned.
Handling Decimals
Business Connector .NET converts all decimals to doubles before passing them to Microsoft Dynamics AX. This could result in precision loss and inaccurate rounding. For more information about converting decimals to doubles, see Decimal Structure.
Handling Parameters and Defaults
If a parameter for a .NET Business Connector method is optional, you can specify null except where indicated for specific methods.
Default values are not supported for .NET Business Connector methods.
Disposing .NET Business Connector Classes
Because all classes in the Microsoft Dynamics AX .NET Business Connector implement the IDisposable interface, a user should call the dispose method on any Microsoft Dynamics AX .NET Business Connector object that has been instantiated. Once dispose has been invoked on an object, any try to reference the disposed object causes an ObjectDisposedException exception to be raised.
Invoking the Logoff()()() method of the Axapta class causes all Microsoft Dynamics AX .NET Business Connector objects to be disposed.
- Walkthrough: Integrate an Application with Microsoft Dynamics AX Using .NET Business Connector
-
- How to: Create Data Using .NET Business Connector
-
- How to: Read Data Using .NET Business Connector
-
- How to: Update Data Using .NET Business Connector
-
- How to: Delete Data Using .NET Business Connector
-
- How to: Call Business Logic Using .NET Business Connector
-
- How to: Debug X++ Code Running in .NET Business Connector
-
- How to: Connect to Microsoft Dynamics AX Using the LogonAs Method
-
- Security and .NET Business Connector Applications
-