Add OnPreProcessStatusChange event docs

Author: MSFTMan

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

@@ -23,6 +23,8 @@
         href: ./reference/events/grid-onsave.md
       - name: OnProcessStatusChange event
         href: ./reference/events/onprocessstatuschange.md
+      - name: OnPreProcessStatusChange event
+        href: ./reference/events/onpreprocessstatuschange.md
       - name: OnReadyStateComplete event
         href: ./reference/events/onreadystatecomplete.md
       - name: OnResultOpened event
@@ -279,12 +281,16 @@
       items:
       - name: Event handler methods
         items:
+        - name: addOnPreProcessStatusChange
+          href: reference/formContext-data-process/eventhandlers/addOnPreProcessStatusChange.md
         - name: addOnProcessStatusChange
           href: reference/formContext-data-process/eventhandlers/addOnProcessStatusChange.md
         - name: addOnStageChange
           href: reference/formContext-data-process/eventhandlers/addOnStageChange.md
         - name: addOnStageSelected
           href: reference/formContext-data-process/eventhandlers/addOnStageSelected.md
+        - name: removeOnPreProcessStatusChange
+          href: reference/formContext-data-process/eventhandlers/removeOnPreProcessStatusChange.md
         - name: removeOnProcessStatusChange
           href: reference/formContext-data-process/eventhandlers/removeOnProcessStatusChange.md
         - name: removeOnStageChange

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

@@ -0,0 +1,22 @@
+---
+title: "OnPreProcessStatusChange Event (Client API reference) in Dynamics 365 for Customer Engagement| MicrosoftDocs"
+ms.date: 10/31/2017
+ms.service: crm-online
+ms.topic: reference
+applies_to: Dynamics 365 for Customer Engagement (online)
+ms.assetid: 
+author: MSFTMan
+ms.author: Deonhe
+manager: KVivek
+search.audienceType: 
+  - developer
+search.app: 
+  - D365CE
+---
+# OnPreProcessStatusChange Event (Client API reference)
+
+[!INCLUDE[](../../../../includes/cc_applies_to_update_9_0_0.md)]
+
+This event occurs **before** the status of a process instance changes. 
+
+Use the **formContext.data.process**.[addOnPreProcessStatusChange](../formContext-data-process/eventhandlers/addOnPreProcessStatusChange.md) method to add event handlers for this event and the **formContext.data.process**.[removeOnPreProcessStatusChange](../formContext-data-process/eventhandlers/removeOnPreProcessStatusChange.md) method to remove them. 

powerapps-docs/developer/model-driven-apps/clientapi/reference/formContext-data-process.md

@@ -27,6 +27,7 @@ Use the following events and event handler methods to write scripts for business
 
 |Event | Event handler methods|
 |--|--|
+|[OnPreProcessStatusChange](events/onpreprocessstatuschange.md)|[addOnPreProcessStatusChange](formContext-data-process/eventhandlers/addOnPreProcessStatusChange.md)<br/>[removeOnPreProcessStatusChange](formContext-data-process/eventhandlers/removeOnPreProcessStatusChange.md)|
 |[OnProcessStatusChange](events/onprocessstatuschange.md)|[addOnProcessStatusChange](formContext-data-process/eventhandlers/addOnProcessStatusChange.md)<br/>[removeOnProcessStatusChange](formContext-data-process/eventhandlers/removeOnProcessStatusChange.md)|
 |[OnStageChange](events/OnStageChange.md)|[addOnStageChange](formContext-data-process/eventhandlers/addOnStageChange.md)<br/>[removeOnStageChange](formContext-data-process/eventhandlers/removeOnStageChange.md)|
 |[OnStageSelected](events/OnStageSelected.md)|[addOnStageSelected](formContext-data-process/eventhandlers/addOnStageSelected.md)<br/>[removeOnStageSelected](formContext-data-process/eventhandlers/removeOnStageSelected.md)|

powerapps-docs/developer/model-driven-apps/clientapi/reference/formContext-data-process/eventhandlers/addOnPreProcessStatusChange.md

@@ -0,0 +1,36 @@
+---
+title: "addOnPreProcessStatusChange (Client API reference) in Dynamics 365 for Customer Engagement| MicrosoftDocs"
+ms.date: 11/20/2017
+ms.service: crm-online
+ms.topic: reference
+applies_to: Dynamics 365 for Customer Engagement (online)
+ms.assetid: 
+author: KumarVivek
+ms.author: kvivek
+manager: amyla
+search.audienceType: 
+  - developer
+search.app: 
+  - D365CE
+---
+# addOnPreProcessStatusChange (Client API reference)
+
+[!INCLUDE[](../../../../../includes/cc_applies_to_update_9_0_0.md)]
+
+[!INCLUDE[./includes/addOnPreProcessStatusChange-description.md](./includes/addOnPreProcessStatusChange-description.md)]
+
+## Syntax
+
+`formContext.data.process.addOnPreProcessStatusChange(myFunction);`
+
+## Parameter
+
+|Name|Type|Required|Description|
+|--|--|--|--|
+|myFunction|Function reference|Yes|The function to be executed when the business process flow status changes. The function will be added to the bottom of the event handler pipeline. The execution context is automatically passed as the first parameter to the function. See [Execution context](../../../clientapi-execution-context.md) for more information.<br/><br/>You should use a reference to a named function rather than an anonymous function if you may later want to remove the event handler.|
+
+### Related topics
+
+[removeOnProcessStatusChange](removeOnProcessStatusChange.md)
+
+[formContext.data.process](../../formContext-data-process.md)

powerapps-docs/developer/model-driven-apps/clientapi/reference/formContext-data-process/eventhandlers/includes/RemoveOnPreProcessStatusChange-description.md

@@ -0,0 +1 @@
+Removes an event handler from the [OnPreProcessStatusChange](../../../events/onpreprocessstatuschange.md) event.

powerapps-docs/developer/model-driven-apps/clientapi/reference/formContext-data-process/eventhandlers/includes/addOnPreProcessStatusChange-description.md

@@ -0,0 +1 @@
+Adds a function as an event handler for the [OnPreProcessStatusChange](../../../events/onpreprocessstatuschange.md) event so that it will be called **before** the business process flow status changes.

powerapps-docs/developer/model-driven-apps/clientapi/reference/formContext-data-process/eventhandlers/removeOnPreProcessStatusChange.md

@@ -0,0 +1,36 @@
+---
+title: "removeOnPreProcessStatusChange (Client API reference) in Dynamics 365 for Customer Engagement| MicrosoftDocs"
+ms.date: 06/20/2019
+ms.service: crm-online
+ms.topic: reference
+applies_to: Dynamics 365 for Customer Engagement (online)
+ms.assetid: 
+author: MSFTMan
+ms.author: Deonhe
+manager: KVivek
+search.audienceType: 
+  - developer
+search.app: 
+  - D365CE
+---
+# removeOnPreProcessStatusChange (Client API reference)
+
+[!INCLUDE[](../../../../../includes/cc_applies_to_update_9_0_0.md)]
+
+[!INCLUDE[./includes/removeOnPreProcessStatusChange-description.md](./includes/removeOnPreProcessStatusChange-description.md)]
+
+## Syntax
+
+`formContext.data.process.removeOnPreProcessStatusChange(myFunction);`
+
+## Parameter
+
+|Name|Type|Required|Description|
+|--|--|--|--|
+|myFunction|Function reference|Yes|The function to be removed from the [OnPreProcessStatusChange](../../events/onpreprocessstatuschange.md) event.|
+
+### Related topics
+
+[addOnProcessStatusChange](addOnProcessStatusChange.md)
+
+[formContext.data.process](../../formContext-data-process.md)