raiseEvent (JavaScript API Reference) for Dynamics 365 Channel Integration Framework 1.0
Invokes the associated subscriber for the event.
Note
If you've created custom events using the addHandler method, then you can raise those events by passing the event name as parameter in this method.
Syntax
Microsoft.CIFramework.raiseEvent(eventName, eventInputParameters, correlationId);
Parameters
Name | Type | Required | Description |
---|---|---|---|
eventName | String | Yes | Name of the event whose handler needs to be invoked. |
eventInputParameters | JSON String | Yes | The input parameters that need to be passed to the handler function. |
correlationId | GUID | No | Is used to group all related API calls together for diagnostic telemetry. |
Return value
Promise with a value as Boolean.
Example
// Let there be an event registered to a subscriber.
handlerFunction = function(eventInput)
{
console.log(eventInput);
if(eventInput != null && eventInput != undefined && eventInput.size > 0)
{
inputData = eventInput.get("value");
correlationId = eventInput.get("correlationId");
console.log(inputData + " " + correlationId);
}
return Promise.resolve();
}
Microsoft.CIFramework.addHandler("oncustomevent", handlerFunction);
//Use raiseEvent API to invoke the subscribed handler of the event.
Microsoft.CIFramework.raiseEvent("oncustomevent", "test input value");
//In the main UCI page
Microsoft.CIFramework.addHandler("widgetEvent", handlerFunction);
///In the widget code
Microsoft.CIFramework.raiseEvent("widgetEvent", eventInput);
//In the widget code
Microsoft.CIFramework.addHandler("mainPageEvent", handlerFunction);
//In the main UCI page
Microsoft.CIFramework.raiseEvent("mainPageEvent", eventInput);
Related information
onClickToAct
onModeChanged
onPageNavigate
onSendKBArticle
onSizeChanged