AIF outbound ports (form)
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
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:
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. |
See also
Announcements: To see known issues and recent fixes, use Issue search in Microsoft Dynamics Lifecycle Services (LCS).