Skip to main content

Connections

Connectors​

This document explains the fields and settings for configuring an Inbound REST connector.

General Section​

Field NameDescription
Connector IdThe unique identifier for the connector configuration.
DescriptionA brief description explaining the purpose of this connector.
Connector TypeThe connector type being referenced. Possible connections are Rest for Webservices. In the future, File and DB will be implemented to make connections to Azure Storage and Databases.
DirectionSpecifies the message flow direction, e.g., Inbound for incoming data, Outbound for outgoing data.

Use for GET Response Section​

Field NameDescription
Origin WH ConnectorThe warehouse connector that serves as the source for this configuration. Example: MIA-1-DEMO.
Message TypeThe type of message being processed. Example: ARRIVAL.
DirectionThe specific direction for this configuration. Example: WMSOUT.
XSLT for InventorySpecifies the XSLT (Extensible Stylesheet Language Transformations) used for inventory processing.

Body for POST/PUT Section​

Field NameDescription
BodyTemplateTemplate for the body content in POST or PUT requests.

Actions in the User Interface​

  • Edit: Modify the selected connector configuration.
  • New: Create a new connector entry.
  • Delete: Remove the currently selected connector configuration.
tip
  1. Direction Consistency:
    • Ensure the Direction field matches the expected flow of data (Inbound or Outbound).
  2. Message Type:
    • Use standardized message types like ARRIVAL, TRANSFER, or ORDER for clarity.
  3. XSLT for Inventory:
    • Always validate XSLT templates to ensure they meet the inventory processing requirements.
  4. Body Template:
    • For POST/PUT requests, design the body template to align with API specifications.

Example Configuration​

Connector Id: MIA CON Get Arrival  
Description: Inbound connector for GET Arrival messages  

General:  
  Connector Type: MIA WS GET Arrival  
  Direction: Inbound  

Use for GET Response:  
  Origin WH Connector: MIA-1-DEMO  
  Message Type: ARRIVAL  
  Direction: WMSOUT  
  XSLT for Inventory: [XSLT Template Name]  

Body for POST/PUT:  
  BodyTemplate: [JSON or XML template for the body]

Connector type​

This document explains the fields and settings for configuring a REST connector in Dynamics 365 Finance and Operations.

General Section​

Field NameDescription
NameThe display name of the connector.
Connector TypeSpecifies the type of connector being configured. For this example, it is Rest.

General Configuration Fields​

Field NameDescription
HttpActionDefines the HTTP method for the request, e.g., GET, POST, PUT, Patch, Delete or POST or PUT,.
URLThe endpoint URL for the REST API.
Content TypeSpecifies the format of the request content. For example: application/json;charset=utf-8.

Credential and Handler Details​

Field NameDescription
Credential NameReferences the configured credentials used for authentication. This links to a credential entry (e.g., MIA 1).
Handler ClassSpecifies the X++ class that handles the communication logic for the connector. At the moment, only is CNTXWHWsClientHandlersupported.

Actions in the User Interface​

  • Edit: Modify the selected connector configuration.
  • New: Create a new connector entry.
  • Delete: Remove the currently selected connector configuration.
tip
  1. Use Secure URLs:
    • Always use HTTPS URLs to ensure encrypted communication.
  2. Test the Endpoint:
    • Verify the configured API endpoint and credentials using appropriate tools (e.g., Postman).
  3. Content Type:
    • Match the Content Type to the API's requirements for correct data processing.
  4. Handler Class:
    • Ensure the custom handler class (e.g., CNTXWHWsClientHandler) contains appropriate logic for processing responses.

Example Configuration​

A sample configuration might look like this:

Name: MIA WS GET Arrival  
Connector Type: Rest  

General:  
  HttpAction: GET  
  URL: https://demo.mia-systems.at/...  
  Content Type: application/json;charset=utf-8  

Credentials:  
  Credential Name: MIA 1  
  Handler Class: CNTXWHWsClientHandler
D365 Menu Item

Warehouse Connector -> Setup -> Connections -> Connectors Warehouse Connector -> Setup -> Connections -> Connector type