Consuming Microsoft Dynamics AX Services from an External Client


This content is archived and is not being updated. For the latest documentation, see Microsoft Dynamics 365 product documentation. For the latest release plans, see Dynamics 365 and Microsoft Power Platform release plans.

Applies To: Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012

You can consume services that are hosted by Microsoft Dynamics AX from external clients that use .NET Framework languages such as C#. For example, your C# code can call a document service or a custom service. Any service that is exposed by using an integration port in Microsoft Dynamics AX can be consumed by an external client. For more information about the different types of services in Microsoft Dynamics AX, see Developing with Services and AIF.

The capability to call Microsoft Dynamics AX document services from external clients provides integration scenarios such as the following:

  • Updating customer information from an external client

  • Adding sales order and purchase order information to Microsoft Dynamics AX from an external client

  • Exchanging data with other enterprise software systems

Security for services that are consumed from an external client is based on the role-based security that is used in Microsoft Dynamics AX. For more information, see About role-based security in services and AIF and Security best practices for services and AIF.

To call Microsoft Dynamics AX services from clients on the Internet, you publish Microsoft Dynamics AX services through Internet Information Services (IIS). For more information, see Install web services on IIS and Application Integration Framework topology.

Consuming a Service from a .NET Framework Client

Before you can consume a Microsoft Dynamics AX service, it must be registered and exposed on an integration port. For more information about integration ports, see Integration ports. For more information about registering services and exposing service operations, see the sections “Register services” and “Expose service operations” in Customize service contracts.

The following topic illustrates how to call a Microsoft Dynamics AX service from a C# program to create a sales order in an inbound exchange:

See also

Application integration

Using the Call Context