1. To-Increase Dynamics 365 for Finance & Operations
  2. Connectivity studio
  3. Concepts

Customize web service action handler class
Concept

In Connectivity studio, usually, you can design the integration setup by configuration. Sometimes, it can be required to use a customization. This topic explains the standard web service action handler handler classes in Connectivity studio and how to customize these classes. Only use customized classes if you really need specific functionality.

Standard web service action handler classes

For web service actions, several standard handler classes are available. Each web service action direction has its own handler classes:
 

Document type

Handler class

Description

Outbound handler classes

BisWsClientHandler

Runs the outbound web service action. For the request message, the target connector must be of type Azure file storage. For the Response message and error message, the source connector must be of type Azure file storage.

BisWsClientHandlerV3

Runs the outbound web service action, using streaming. For the request message, the target connector must be of type Web service. For the Response message and error message, the source connector must be of type Web service.

Outbound client HTTP classes

BisWsClientHttpFileRequest

Calls the external web service if files are used to exchange data. The result of the handler class is the input for the web service call. This class also handles the response from the web service. This response is the input for the handler class to process the response in D365 FO.

BisWsClientHttpRequest

Calls the external web service if streaming used to exchange data. The result of the handler class is the input for the web service call. This class also handles the response from the web service. This response is the input for the handler class to process the response in D365 FO.

Inbound handler classes

BisWsServerHandler

Runs the inbound web service action. For the request message, the source connector must be of type Azure file storage. For the Response message and error message, the target connector must be of type Azure file storage.

BisWsServerHandlerV3

Runs the inbound web service, using streaming. For the request message, the source connector must be of type Web service. For the Response message and error message, the target connector must be of type Web service.

Customize web service action handler class - Outbound

You can use a customized outbound web service action handler class. To do so, extend a standard outbound web service action handler class.
For a customized outbound web service action handler class, you can change the methods as desired. The commonly changed methods are:
  • runGet
  • rungetResponseMessage
  • rungetErrorMessage
  • HandleHttpRequest
  • RunPost
  • unPostResponseMessage
  • RunPostRequestMessage
  • RunPostErrorMessage
  • OnAfterPostResponseMessage
  • GetClassDescription

Customize web service action Client HTTP class - Outbound

To run the web service HTTP request, a separate class is used. If your HTTP request works different compared to the standard HTTP request, you can extend one of the standard client HTTP classes or create your own client HTTP class. Make sure, it implements the same interface with the same methods as exist in the standard client HTTP classes.
The required interface is:
The required methods are:

Customize web service action handler class - Inbound

You can use a customized inbound web service action handler class. To do so, extend a standard inbound web service action handler class.
For a customized inbound web service action handler class, you can change the methods as desired. The commonly changed methods are:
    • Runget
    • OnGetRequestMessage
    • onGetResponseMessage
    • ongetErrorMessage
    • RunPost
    • onPostRequestMessage
    • onPostResponsemessage
    • OnPostErrormessage
    • GetClassDescription

Related to Notes

Develop custom code

 		 

Set up web service action - Outbound

 		 

Set up web service action - Inbound

 		 

See also

Provide feedback