Updated per github pull request 2110

Author: Mattp123

powerapps-docs/maker/model-driven-apps/embedded-canvas-app-guidelines.md

@@ -2,7 +2,7 @@
 title: "Guidelines and troubleshooting when working with embedded canvas apps | MicrosoftDocs"
 description: Understand the recommended ways to work with embedded canvas apps in Power Apps
 ms.custom: ""
-ms.date: 04/02/2021
+ms.date: 06/17/2021
 ms.reviewer: ""
 ms.service: powerapps
 ms.suite: ""
@@ -61,6 +61,11 @@ This topic provides guidelines on working with embedded canvas apps as well as h
 3. In the list of controls select the default control and then select the **Web** option.
 4. Select **OK**.
 
+## Saving data in an embedded canvas app
+- A save event made from a model-driven app, such as selecting the Save button on the main form command bar, doesn’t save changes made in the embedded canvas app. 
+- To save changes made in an embedded canvas app, use the Dataverse connector.
+- The ModelDrivenFormIntegration control OnDataRefresh action should only be used to refresh data within the embedded canvas app. We don’t recommend that you use the OnDataRefresh action to save changes within the embedded canvas app. 
+
 ## Known issues and limitations with embedded canvas apps
 
 ### Limitations

powerapps-docs/maker/model-driven-apps/embedded-canvas-app-properties-actions.md

@@ -2,7 +2,7 @@
 title: "ModelDrivenFormIntegration control properties and actions | MicrosoftDocs"
 description: Learn about ModelDrivenFormIntegration control properties and actions
 ms.custom: ""
-ms.date: 06/25/2019
+ms.date: 06/17/2021
 ms.reviewer: ""
 ms.service: powerapps
 ms.suite: ""
@@ -35,7 +35,7 @@ This topic explains the properties and actions available on the ModelDrivenFormI
 |:--------------|:-------------------------|
 |**DataSource** | Should be set to the data source connected to the parent table of the host model-driven form. <br />Automatically set when [embedding a new canvas app](embedded-canvas-app-add-classic-designer.md). |
 |**Item** | Read-only property that enables the embedded canvas app to access the row from the host model-driven form. <br />As an example, to get the value of a column with the name accountnumber and display name Account Number, you can use ModelDrivenFormIntegration.Item.accountnumber or ModelDrivenFormIntegration.Item.'Account Number'. |
-|**OnDataRefresh** | The formula in this property is evaluated when the host model-driven form saves data. <br />Use it to refresh the data source connected to the parent table of the host model-driven form and to perform other actions like setting or updating variables. <br /> As an example, setting it to the formula below will refresh the Accounts data source and set a variable named CurrentAccountNumber to the value of the Account Number column of the current row. <br /> Refresh(Accounts); Set(CurrentAccountNumber, ModelDrivenFormIntegration.Item.'Account Number') |
+|**OnDataRefresh** | The formula in this property is evaluated when the host model-driven form saves data. <br />Use it to refresh the data source connected to the parent table of the host model-driven form and to perform other actions like setting or updating variables. <br /> As an example, setting it to the formula below will refresh the Accounts data source and set a variable named CurrentAccountNumber to the value of the Account Number column of the current row. <br /> Refresh(Accounts); Set(CurrentAccountNumber, ModelDrivenFormIntegration.Item.'Account Number') <br /> The OnDataRefresh action should only be used to refresh data within the embedded canvas app. We don’t recommend that you use the OnDataRefresh action to save changes within the embedded canvas app. More information: [Saving data in an embedded canvas app](embedded-canvas-app-guidelines.md) |
 |**RefreshForm** | Refreshes the data on the host model-driven form. <br />See [Perform predefined actions on the host form](embedded-canvas-app-actions.md#refreshformshowprompt) for details. |
 |**SaveForm** | Saves the data on the host model-driven form. <br />See [Perform predefined actions on the host form](embedded-canvas-app-actions.md#saveform) for details.  |
 |**NavigateToMainForm** | Navigates the host model-driven form to a main form and displays the specified row. <br />See [Perform predefined actions on the host form](embedded-canvas-app-actions.md#navigatetomainformentityname-mainformname-recordid) for details. |