Customize web service action handler class

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.
Outbound handler classes	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.
Outbound client HTTP classes	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.
Inbound handler classes	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: