Merge pull request #3648 from MicrosoftDocs/matp-gh-issue-1829

Revised per github issue 1829

Author: Mattp123

powerapps-docs/maker/model-driven-apps/embedded-canvas-app-add-classic-designer.md

@@ -1,5 +1,6 @@
 ---
 title: "Add an embedded canvas app on a model-driven form | MicrosoftDocs"
+description: Learn how to embed a canvas app into a model-driven form in Power Apps
 ms.custom: ""
 ms.date: 08/05/2020
 ms.reviewer: "matp"
@@ -43,9 +44,15 @@ Imagine that you want to create a new canvas app and embed it on a main form for
 11.	In the section below the controls list, the list of properties available to the canvas app control are displayed.
      - The **Entity name** property specifies the entity that will provide the data to your embedded canvas app. It will be set to the entity that contains the field you added in an earlier step.
          - Notice that, even though this property appears changeable, changing it has no effect on the embedded canvas app. It is meant only to serve as a reference for you.
-     - The **App ID** property specifies the ID of the embedded canvas app. It will be automatically generated and filled-in for you when the canvas app is created.
-         - Notice that any change to the **App ID** value breaks the link from the model-driven form to the embedded canvas app.
-12.	Select **Customize** to create or edit the canvas app. This opens Power Apps Studio in a new tab.
+     - The **App Name** property specifies the name of the canvas app to embed. The model-driven form looks for the canvas app with the specified name in the current environment. If a canvas app with that name can't be found in the environment, the canvas app control will use the App ID to load the canvas app. Enter the App Name for an existing canvas app.
+     - The **App ID** property specifies the ID of the embedded canvas app. You can enter an App ID for an existing canvas app or an App ID will be automatically generated and filled-in for you when you create or edit a canvas app by selecting **Customize**. The canvas App ID can be found on Power Apps, go to **Apps**, select the canvas app, and then select **Details** on the command bar.
+         
+      > [!NOTE]
+      > Notice that any change to the **App ID** value breaks the link from the model-driven form to the embedded canvas app.
+      >
+      > If neither the App Name or App ID match an existing canvas app, the form displays the message "Sorry, we didn't find that app."
+
+12.	Go to step 20 if you're adding a completed canvas app. If you are creating a new or editing an existing canvas app, continue to follow these steps. Select **Customize** to create or edit a canvas app. This opens Power Apps Studio in a new tab.
 	   > [!NOTE]
        > If opening Power Apps Studio is blocked due to a web browser pop-up blocker you must enable the make.powerapps.com site or temporarily disable the pop-up blocker and then select **Customize** again.
 13.	Observe the following: 

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

@@ -1,5 +1,6 @@
 ---
 title: "Guidelines on working with embedded canvas apps | MicrosoftDocs"
+description: Understand the recommended ways to work with embedded canvas apps in Power Apps
 ms.custom: ""
 ms.date: 08/28/2020
 ms.reviewer: ""
@@ -20,6 +21,7 @@ search.app:
 ---
 
 # Guidelines on working with embedded canvas apps
+
 This topic provides guidelines on working with embedded canvas apps as well as helpful tips to troubleshoot any issues you might encounter.
 
 -	Embedded canvas apps are only supported with Unified Interface model-driven apps.
@@ -36,10 +38,7 @@ This topic provides guidelines on working with embedded canvas apps as well as h
 -	The ModelDrivenFormIntegration.Item object is read-only. 
      - To write back data you must use the Common Data Service connector. More information: [Common Data Service](/connectors/commondataservice/)
 -	Embedded canvas apps can only be created via the host model-driven form. 
-    - Adding existing canvas apps as embedded on model-driven forms is currently not supported.
-    - Support to embed an existing canvas app in a model-driven form using App ID will be provided in a future update.
-- When you view a model-driven form with an embedded canvas app, if you see an error message that reads "Sorry we didn't find that app" make sure that the embedded canvas app is in the same solution as the model-driven form.
-- When you view a model-driven form with an embedded canvas app, if you see an error message that reads "It looks like you don’t have access to this app. Ask its owner to share it with you" make sure that the author has shared the embedded canvas app with you. More information: [Share an embedded canvas app](share-embedded-canvas-app.md).
+- When you view a model-driven form with an embedded canvas app, if you see an error message that reads "It looks like you don’t have access to this app" ask its owner to share it with you" make sure that the author has shared the embedded canvas app with you. More information: [Share an embedded canvas app](share-embedded-canvas-app.md).
 - Adding a canvas app on the sub-grid control is no longer available.
     - In the preview release, makers were able to add a canvas app on a sub-grid control. With canvas app embedding on model-driven forms now generally available, adding an embedded canvas app on a model-driven form is streamlined to the field. 
     - This makes it easier for makers since they don't have to decide up front whether to pass the current (main form) record as data context or a list of records related to the current (main form) record.