AIF outbound ports (form)

Article
10/09/2018

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

Click System administration > Setup > Services and Application Integration Framework > Outbound ports.

Use this form to create a new outbound port or to configure the selected outbound port for services.

When integration ports, services, or adapters have been added to the Application Object Tree (AOT), they must be registered to work in Application Integration Framework (AIF). Unregistered integration ports, services, and adapters are not displayed in this form. To register integration ports, services, and adapters:

Click System administration > Setup > Checklists > Initialization checklist.
Expand the Initialize system node.
Click Set up Application Integration Framework.

This form is organized into a series of FastTabs. As you continue through the tabs, several settings depend on (or require) configurations on a previous tab or in another form. For example, you must specify at least one service operation before you can add a pipeline component, because pipeline components depend on service operations.

Task that uses this form

Managing integration ports

Navigating the form

The following tables provide descriptions for the controls in this form.h

Tabs

Tab	Description
Service contract customizations	Specify which service operations are available, which data policies are used to customize documents, and the default encoding format.
Processing options	Specify how documents are processed when handled through the outbound port.
Troubleshooting	Specify troubleshooting options.
Security	Restrict access to the outbound port.

Buttons

Button	Description
Activate	Activate the outbound port. Caution Activating an integration port causes all integration ports on the Application Object Server (AOS) to reactivate. You should avoid clicking this button when integration ports are processing messages.
Deactivate	Inactivate the outbound port. You must inactivate an integration port before you can change the port's configuration. Caution Inactivating an integration port causes all integration ports on the Application Object Server (AOS) to reactivate. You should avoid clicking this button when integration ports are processing messages.
Configure	Open the configuration form for the selected adapter. For example, when you click this button, the Service Configuration Editor for Windows Communication Foundation (WCF) -based services opens.
Service operations	Open Select service operations form, where you can select service operations to make available on the outbound port.
Data policies	Open the Document data policies form, where you can specify XSD restrictions and field-level legal values for documents that are handled through the outbound port.
Outbound pipelines	Open the Outbound pipelines form, where you can specify or configure pipeline components.
Outbound transforms	Open the Outbound transforms form, where you can specify transforms to apply to documents that are handled through the outbound port.
Value mapping	Open the Value mapping form, where you can specify the translation, based on business rules, of field data values. For example, internal item numbers can be translated to vendor-specific item numbers or industry-standard numbers, depending on the trading partner.

Fields

Field	Description
Adapter	The type of adapter used by the outbound integration port to provide the transport mechanism for outbound messages. If the adapter that you expect to use is not listed, click Register adapters.
URI	The URI that points to the location of the source that is used by the outbound port. Some services require that you use a specific adapter with a specific type of URI.
Expose service operations	This field is always selected to make service operations available on the outbound port. Click Service operations to specify which service operations to apply.
Customize documents	Select this check box to apply data policies to documents that are handled through the outbound port. Click Data policies to specify XSD restrictions and legal values.
Validate document XML	Select this check box to enforce schema validation. Caution Disable schema validation only for trusted messages, such as messages that originate from trusted, internal sources. Disabling schema validation after you define custom data policies can cause unexpected results. For example, required fields cannot be determined when you disable schema validation.
Default encoding format	Select the type of character encoding to use by default, such as UTF8.
Post-process service operation responses	Select this check box to enable post-processing of responses through the outbound port. Click Outbound pipelines to configure the post-processing pipeline.
Transform all responses	Select this check box to enable transforms for responses that are handled through the outbound port. Click Outbound transforms to specify which transforms to apply to documents.
Apply value mapping	Select this check box to enable value mapping. Click Value mapping to specify how various field data values are translated by the inbound port.
Logging mode	You can store copies of documents that are exchanged then viewed them by using the History form. Select a logging mode from the following options: Original document All document versions Message header only Logging disabled When you select Logging disabled, the following features are also disabled: document correlation with database records, document histories, and tests for idempotence.
Include exceptions in fault	Select this check box to specify that X++ error messages from the service are displayed to port users.
Restrict to company	Select a company name to grant exclusive access to the port to. Clear to remove the restriction.