Merge pull request #4540 from MicrosoftDocs/Nava-clientapi

Adding new client APIs

Author: Nkrb

powerapps-docs/developer/model-driven-apps/TOC.yml

@@ -164,6 +164,8 @@
         href: clientapi/reference/save-event-arguments/isDefaultPrevented.md
       - name: preventDefault
         href: clientapi/reference/save-event-arguments/preventDefault.md
+      - name: preventDefaultOnError
+        href: clientapi/reference/save-event-arguments/preventDefaultOnError.md
     - name: Attributes
       href: clientapi/reference/attributes.md
       items:
@@ -238,6 +240,8 @@
         href: clientapi/reference/controls/addNotification.md
       - name: addOnLookupTagClick
         href: clientapi/reference/controls/addOnLookupTagClick.md
+      - name: addOnPostSave
+        href: clientapi/reference/controls/addOnPostSave.md
       - name: addOnPostSearch
         href: clientapi/reference/controls/addOnPostSearch.md
       - name: addOnResultOpened
@@ -302,6 +306,8 @@
         href: clientapi/reference/controls/refresh.md
       - name: removeOnLookupTagClick
         href: clientapi/reference/controls/removeOnLookupTagClick.md
+      - name: removeOnPostSave
+        href: clientapi/reference/controls/removeOnPostSave.md
       - name: removeOnPostSearch
         href: clientapi/reference/controls/removeOnPostSearch.md
       - name: removeOnResultOpened

powerapps-docs/developer/model-driven-apps/clientapi/reference/controls/addOnPostSave.md

@@ -0,0 +1,39 @@
+---
+title: "addOnPostSave (Client API reference) in model-driven apps| MicrosoftDocs"
+description: Includes description and supported parameters for the addOnPostSave method.
+ms.date: 05/19/2021
+ms.service: powerapps
+ms.topic: "reference"
+applies_to: "Dynamics 365 (online)"
+ms.assetid: c398dbca-0ead-487a-8a92-35b1f2953bf6
+author: "Nkrb"
+ms.author: "nabuthuk"
+manager: "kvivek"
+search.audienceType: 
+  - developer
+search.app: 
+  - PowerApps
+  - D365CE
+---
+# addOnPostSave (Client API reference)
+
+Adds an event handler to be called after the record is saved with success or failure.
+
+## Syntax
+
+```javascript
+formContext.data.entity.addOnPostSave(myFunction);
+```
+
+### Parameter
+
+|Name|Type|Required|Description|
+|------|-----|------|----------|
+|myFunction|function reference|Yes|The function to be added to the `PostSave` event after teh record is saved with success or failure.|
+
+### See also
+
+[PostSave event](../events/postsave.md)
+
+[removeOnPostSave](removeOnPostSave.md) 
+

powerapps-docs/developer/model-driven-apps/clientapi/reference/controls/removeOnPostSave.md

@@ -0,0 +1,39 @@
+---
+title: "removeOnPostSave (Client API reference) in model-driven apps| MicrosoftDocs"
+description: Includes description and supported parameters for the removeOnPostSave method.
+ms.date: 05/19/2021
+ms.service: powerapps
+ms.topic: "reference"
+applies_to: "Dynamics 365 (online)"
+ms.assetid: c398dbca-0ead-487a-8a92-35b1f2953bf6
+author: "Nkrb"
+ms.author: "nabuthuk"
+manager: "kvivek"
+search.audienceType: 
+  - developer
+search.app: 
+  - PowerApps
+  - D365CE
+---
+# removeOnPostSave (Client API reference)
+
+Removes the event handler from the [PostSave](../events/postsave.md) event.
+
+## Syntax
+
+```javascript
+formContext.data.entity.removeOnPostSave(myFunction);
+```
+
+### Parameter
+
+|Name|Type|Required|Description|
+|------|-----|------|----------|
+|myFunction|function reference|Yes|The function to be removed from the `PostSave` event.|
+
+### See also
+
+[PostSave event](../events/postsave.md)
+
+[addOnPostSave](addOnPostSave.md) 
+

powerapps-docs/developer/model-driven-apps/clientapi/reference/events/postsave.md

@@ -20,15 +20,10 @@ search.app:
 
 PostSave event occurs after the `OnSave` event is complete. This event is used to support or execute custom logic using web resources to perform after `Save` actions when the `save` event is successful or failed due to server errors.
 
-Use the `addOnPostSave`  method to manage event handlers for this event.
+Use the [addOnPostSave](../controls/addOnPostSave.md) and [removeOnPostSave](../controls/removeOnPostSave.md) methods to manage event handlers for this event.
 
 > [!NOTE]
-> This method is supported only on Unified Interface.
-
-<!--Some of the post save events include which are used by one of the first party app Field Service.
-1) When we create a work order incident, read incident type, and retrieve all incident products where incident type is equal to incident type on work order incident, then create work order products.
-2) If work order incident is primary incident on work order, modifying the work order incident that is updates the primary inc
-When a primary contact phone number is updated, update the same on the account phone number.-->
+> This method is supported only on Unified Interface
 
 ## Syntax
 
@@ -43,15 +38,6 @@ When a primary contact phone number is updated, update the same on the account p
 
 [!INCLUDE[cc-terminology](../../../../data-platform/includes/cc-terminology.md)]
 
-<!--Code Example:
-We call below method and it will display org name. For making decisions on whether the save succeeded or failed, executioncontext object will have params such as 
-1) getIsSaveSuccess() - use this method to know if the save operation on the entity succeeds or fails
-Usage - executionContext.getEventArgs(). getIsSaveSuccess();
-2) getEntityReference() - it will have entity info being saved/updated in case of success such as entity id, entity name (for eg., account or contact)
-Usage - executionContext.getEventArgs(). getEntityReference();
-3) getSaveErrorInfo() - Error details on why an entity save failed.
-Usage - executionContext.getEventArgs(). getSaveErrorInfo ();-->
-
 ### Example 
 
 The following sample code displays organization unique name as form notification.

powerapps-docs/developer/model-driven-apps/clientapi/reference/save-event-arguments/includes/preventDefaultOnError-description.md

@@ -0,0 +1 @@
+Cancels the save operation if the event handler has a script error, returns a rejected promise for an async event handler or the operation times out.

powerapps-docs/developer/model-driven-apps/clientapi/reference/save-event-arguments/preventDefaultOnError.md

@@ -0,0 +1,31 @@
+---
+title: "preventDefaultOnError (Client API reference) in model-driven apps| MicrosoftDocs"
+description: Includes description and supported parameters for the preventDefaultOnError method.
+ms.date: 05/18/2021
+ms.service: powerapps
+ms.topic: "reference"
+applies_to: "Dynamics 365 (online)"
+ms.assetid: 9a8802ad-80aa-4386-a192-573280587546
+author: "Nkrb"
+ms.author: "nabuthuk"
+manager: "kvivek"
+search.audienceType: 
+  - developer
+search.app: 
+  - PowerApps
+  - D365CE
+---
+# preventDefaultOnError (Client API reference)
+
+[!INCLUDE[./includes/preventDefaultOnError-description.md](./includes/preventDefaultOnError-description.md)]
+
+## Syntax
+
+`executionContext.getEventArgs().preventDefaultOnError();`
+
+
+### Related topics
+
+[getSaveMode](getSaveMode.md)
+
+[isDefaultPrevented](isDefaultPrevented.md)