What's happening?
When using the Channel Integration Framework (CIF) 2.0 widget in Dynamics 365, the customer encounters a situation where the JavaScript API method Microsoft.CIFramework.getMode() returns a value of "3" when the widget panel is manually collapsed to the left side. However, attempting to programmatically set this mode using Microsoft.CIFramework.setMode(3) results in an error message:"The setMode parameter value must be 0, 1 or 2."
Reason:
The value "3" for the setMode() method is currently not documented or supported by Microsoft. Although the getMode() method returns "3" when the panel is manually collapsed, the setMode() method explicitly supports only values "0", "1", or "2".
Resolution:
This scenario is currently unsupported by Microsoft and is considered by-design. The setMode() method does not accept the value "3" as it is not documented or supported at this time. Microsoft has acknowledged this limitation and has created a feature request to potentially implement and support this functionality in the future. However, there is no estimated time of arrival (ETA) for this feature, as it is not considered a high-priority task.
Customers requiring this functionality should be informed that it is currently unsupported, and manual interaction remains the only available method to achieve the desired panel state.