AIF outbound ports (form) [AX 2012]

Updated: May 5, 2011

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:

  1. Click System administration > Setup > Checklists > Initialization checklist.

  2. Expand the Initialize system node.

  3. 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.

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

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.

Button

Description

Activate

Activate the outbound port.

Caution noteCaution

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 noteCaution

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.

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 noteCaution

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.


Announcements: To see known issues and recent fixes, use Issue search in Microsoft Dynamics Lifecycle Services (LCS).

Community Additions

Show: