Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

Configure an endpoint

When you configure an endpoint, you enter information in the form about the following:

  • Identifying information for the endpoint, including a unique identifier, a friendly name, the active status, error handling information, the intercompany status, local endpoint, Microsoft Dynamics AX company identification for an intercompany exchange, outbound channel information, and encoding format for the transfer.

  • Constraints on the endpoint that restrict document exchange by defining valid Microsoft Dynamics AX customers, vendors, or warehouses.

  • Microsoft Dynamics AX users and trusted intermediaries that are allowed to submit documents for the exchange.

  • Endpoint action policies that relate actions to the endpoint.

  • Pipeline components for an action related to the endpoint.

  • Endpoint action data policies that define which fields in a document are allowed or required for the exchange.

In the form, user interface tabs are available depending on what type of endpoint you select in the tab.

Endpoint type

Tabs enabled

Default endpoint

Specific endpoint

Specific intercompany endpoint

Microsoft Dynamics AX ships with a default endpoint that can be used to enable data exchanges as soon as services are generated. The default endpoint has minimal configuration options, and you cannot add any constraints or users to the default endpoint. By default, all actions are enabled for the default endpoint but you must still enable the service actions on the form.

You can change the following options on the default endpoint:

  • In the form, you can update the field and the field. For more information about these fields, see Create an endpoint.

  • In the form, you can enable and configure actions.

  • In the form, you can define which fields are allowed or required in the data exchange.

  • In the form, you can define data transformations for inbound or outbound exchanges.

  • In the form, you can view the schema of the action parameters and the return value and optionally save them to an .xsd file.

  • In the form, you can configure value mapping.

  1. Click > > .> .

  2. Press CTRL+N to create a new endpoint, or select an existing endpoint from the list to be modified.

  3. Enter the information for the endpoint on the tab, including the unique endpoint identification information, the friendly name for the endpoint, the local endpoint ID, and the default encoding format.

  4. Select to return detailed error messages to the endpoint.

    NoteNote

    By default, Microsoft Dynamics AX logs detailed errors and sends a generic error back to the endpoint. Enabling this field will send the detailed error to the endpoint. Only select this field if it is acceptable to send detailed error information to an endpoint.


  5. For intercompany transfers, select if the endpoint is a company within your Microsoft Dynamics AX installation, and select a company in the field.

  6. Do not select unless the endpoint is to be used in an intercompany transfer. For more information about these transfers, see "Manage intercompany sales orders" or "Manage intercompany purchase orders" in the Application and Business Processes Help.

  7. Selecting an outbound channel is not required for all exchanges. However, if your Microsoft Dynamics AX installation is sending messages to this endpoint (for example, if you are configuring an outbound-only exchange), you must select a channel in the field.

  8. In the field, select the local endpoint that participates in exchanges with this endpoint.

    NoteNote

    There may be more than one local endpoint configured for your Microsoft Dynamics AX installation. If that is the case, then make sure to select the correct local endpoint to participate in the exchange with the endpoint that you are configuring.


  9. View the pre-populated setting for encoding format in the field. This setting defaults to the value set on the form.

  1. Click > > > .

  2. Press CTRL+N to create a new endpoint, or select an existing endpoint from the list to be modified.

    NoteNote

    You cannot add constraints to the default endpoint so the tab will not be enabled if the default endpoint is selected.


  3. On the tab, select to clear the form and allow data to be exchanged regardless of any association. The check box becomes unavailable. However, if you add constraints later, the check box clears itself.

  4. Press CTRL+N to create a new constraint.

  5. Choose the (, , or ).

  6. Select a from the list. The field is completed when you select the .

  7. On the tab, select to activate the endpoint.

    Messages flow through the framework from the local endpoint to and from any active endpoints.

You must enter information for at least one endpoint user or trusted intermediary who is authorized to initiate transactions for the endpoint on the tab.

NoteNote

When configuring users on an endpoint, remember that these Microsoft Dynamics AX users may represent outside interests and must have permissions set appropriately. For more information about configuring Microsoft Dynamics AX users, see "Setting up and maintaining security" in the Microsoft Dynamics AX Installation Guide and the following topics in the System and Application Setup Help: "Manage security permissions for user groups and domain combinations," "Manage user groups," and "Manage users."

You must also set the appropriate security keys and record-level security for any users that are granted access to Microsoft Dynamics AX through Application Integration Framework (AIF), to help prevent unauthorized data access. For more information, see "Manage record level security" in the Application and Business Processes Help.

Certain actions cause data to be written directly to the Microsoft Dynamics AX database without manual end-user verification (for example, creating exchange rates). When configuring endpoints and creating new actions, be especially careful to restrict access to trusted and reliable partners or applications.


Configure an endpoint user

  1. Click > > > .

  2. Press CTRL+N to create a new endpoint, or select an existing endpoint from the list to be modified.

    NoteNote

    You cannot add users or user groups to the default endpoint so the tab will not be enabled if the default endpoint is selected.


  3. Click the tab.

  4. Under , in the field, select either or .

  5. In the field, select a valid Microsoft Dynamics AX user or user group name. The field is filled in automatically.

    For more information about Microsoft Dynamics AX users and user groups, see "Setting up and maintaining security" in the System and Application Setup Help.

Configure a trusted intermediary

Trusted intermediaries are middleware applications that reside between external endpoints and AIF. That is, they are Microsoft Dynamics AX users (or user groups) that are authorized to submit inbound requests on behalf of the endpoint. A trusted intermediary prevents an unauthorized user from accessing AIF and is typically used in a business-to-business data exchange scenario. For more information about trusted intermediaries, see Security considerations for AIF.

For more information about Microsoft Dynamics AX users and user groups, see "Setting up and maintaining security" in the System and Application Setup Help.

  1. Under , select to enable a trusted intermediary for exchanges with this endpoint.

    NoteNote

    If the box is checked, there must be at least one entry in the grid.


  2. Under , in the field, also select either or .

  3. In the field, select a valid Microsoft Dynamics AX user or user group name. The field is filled in automatically.

  1. After you have completed the preceding steps, click to configure actions on the endpoint.

    For more information about action policies, see Configure endpoint action policies.

  2. Press CTRL+S to save the action policy.

  3. From the form, select an action, press CTRL+S, and click to enter information about which fields are required and which are optional in the document to be exchanged.

  4. Click to perform document-specific configuration, including value mapping, for the document exchange.

    Value mapping is translation of field data values based on business rules, for example, translating internal item numbers to vendor-specific item numbers or industry standard numbers depending on the trading partner. For more information, see Configure endpoint action data policies.

  5. Click or to configure the pipeline components for any custom transformations performed on the document. For more information, see Creating and configuring a pipeline.

  6. Click to see a list of parameters and the return value for the selected action. On the form, click to view the XML schema for the selected parameter or return value. On the form, you can click to save the schema as an .xsd file.

When you configure an endpoint for Web services, you must configure an endpoint user and/or trusted intermediary, as outlined above. Next, you must give that Microsoft Dynamics AX user or user group access to the Business Connector.

  1. Click > > and select the user group for the endpoint, or the user group that contains the user for the endpoint.

  2. Click .

  3. On the tab, select and then select .

  4. Click .

To disable an endpoint, follow these steps.

  1. Click > > > .

  2. Select an endpoint in the grid and clear the field.

    ImportantImportant

    For adapter-based exchanges, outbound messages are processed completely even when the endpoint is disabled during processing and a response may still be sent. To ensure that no data is sent from AIF when disabling an endpoint, first disable the batch processing jobs. Be sure that there are no outbound messages in the queue, disable the endpoint, and then restart the batch processing jobs.


Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.