When triggered, the inbound web service action first runs the request message, if defined. This is managed by the handler class as defined for the web service action.
The goal of the request message depends on the HTTP action of the web service action. In general, the request message provides D365 FO with data from the external application.
If the HTTP action is:
- Post, use the request message to provide the data to be created in D365 FO.
- Put, use the request message to provide the data to be updated in D365 FO.
- Get, no request message is used. The data to be get is defined by arguments. So, if the HTTP action is Get, set up the relevant arguments.
- Patch, use the request message to provide the data to be updated in D365 FO. Use this to only update a part of a record. For example, only update a contact person of a customer.
- Delete, use the request message to provide the data to be deleted from D365 FO.
- Post or put, use the request message to provide the data to be created or updated in D365 FO.
For a request message the:
- Source connector must be of type Azure file storage or Web service
- Source document must be an external file-based document.
- Target connector must be of type D365 FO.
- Target document must be an internal document.