Using Basic Integration Ports


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 R3, Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012

Basic integration ports provide a way to define an endpoint for a service in Microsoft Dynamics AX. For example, you might create a basic port to use when you are testing a custom service in a non-production environment, and then create an enhanced port for the service in a production environment. Like an enhanced port, a basic port can contain more than one service. All services on one port must be either document services or custom services to guarantee consistency in the generated Web Services Description Language (WSDL).

Basic ports have limited options for customization. Use a basic port to expose services without configuring processing options, advanced security, or troubleshooting options. You must create an enhanced integration port to make a service available on the Internet using IIS, or to configure any of the following processing options:

  • Service contract customizations (for example, to select certain service operations to expose)

  • Data policies

  • Transforms

  • Pipeline components

  • Value mappings

  • Document filters

You create a basic port in the AOT when you create and deploy a service group that contains a service. To view basic ports, open the Inbound ports form. (Click System administration > Setup > Services and Application Integration Framework > Inbound ports.) Both basic and enhanced ports appear in the list.


AIF system services use basic ports that are provided as part of the Microsoft Dynamics AX installation. However, settings on the basic ports for system services cannot be viewed or changed on the Inbound ports form.

See also

How to: Create a Basic Inbound Integration Port

Integration ports

Managing integration ports

Create, edit, or delete an enhanced integration port

Configure processing options

AIF System Services