Enreach.API.Xrm.createRecord

Creates an entity in Dynamics with a retry logic, to ensure that in case CIF CRUD API fails, the operation will more likely succeed.

Parameters:

• entityLogicalName: Logical name of the table you want to create. For example: "account".

• data: A JSON object defining the columns and values for the new table record.

• maxRetries: Maximum number of retries, if the operation against Dynamics API fails. Optional, default value is 3.

• delay: The amount of milliseconds to wait between two retries. Optional, default value is 1000 (1 second)

Microsoft CIF API works so, that from within the widget it sends a message to main window using window.postMessage() JavaScript method, and then waits for the main window to return the result in the same way. Timeout of this mechanism is 10 seconds, so CIF API considers the request as failed after not receiving any response in 10 secs, even if it actually succeeds after the timeout. As a result, retrying might create duplicates in Dynamics, so this API feature must be used only if duplicates don’t cause serious problems.

The purpose and usage of the method is identical to the underlying API provided by Microsoft, the only addition is the retry logic.