Merge branch 'master' into portals-2072317

Author: tapanm-MSFT

powerapps-docs/developer/common-data-service/webapi/retrieve-related-entities-query.md

@@ -2,7 +2,7 @@
 title: "Retrieve related entity records with a query (Microsoft Dataverse)| Microsoft Docs"
 description: "Read how you can retrieve related entity records by expanding the navigation properties."
 ms.custom: ""
-ms.date: 06/27/2020
+ms.date: 11/16/2020
 ms.service: powerapps
 ms.suite: ""
 ms.tgt_pltfrm: ""
@@ -207,9 +207,11 @@ OData-Version: 4.0
 
 ## Retrieve related entities by expanding collection-valued navigation properties
 
-If you expand on collection-valued navigation parameters to retrieve related entities for entity sets, an `@odata.nextLink` property will be returned for the related entities. You should use the value of the `@odata.nextLink` property with a new `GET` request to return the required data.  
+If you expand on collection-valued navigation parameters to retrieve related entities for entity sets, only one level of depth is returned if there is data. Otherwise the collection will return an empty array.
 
-The following example retrieves the tasks assigned to the top 2 account records.  
+In either case an `@odata.nextLink` property will be returned for the related entities. If you want to retrieve the collection separately, you can use the value of the `@odata.nextLink` property with a new `GET` request to return the required data.  
+
+The following example retrieves the tasks assigned to the top 2 account records.  One has related tasks, the other does not.
 
 **Request**
 
@@ -229,24 +231,46 @@ HTTP/1.1 200 OK
 Content-Type: application/json; odata.metadata=minimal  
 OData-Version: 4.0  
   
-{  
-   "@odata.context":"[Organization URI]/api/data/v9.1/$metadata#accounts(name,Account_Tasks,Account_Tasks(subject,scheduledstart))",
-   "value":[  
-      {  
-         "@odata.etag":"W/\"513475\"",
-         "name":"Fourth Coffee (sample)",
-         "accountid":"36dbf27c-8efb-e511-80d2-00155db07c77",
-         "Account_Tasks":[],
-         "[email protected]":"[Organization URI]/api/data/v9.1/accounts(36dbf27c-8efb-e511-80d2-00155db07c77)/Account_Tasks?$select%20=%20subject,%20scheduledstart"
-      },
-      {  
-         "@odata.etag":"W/\"513477\"",
-         "name":"Litware, Inc. (sample)",
-         "accountid":"38dbf27c-8efb-e511-80d2-00155db07c77",
-         "Account_Tasks":[],
-         "[email protected]":"[Organization URI]/api/data/v9.1/accounts(38dbf27c-8efb-e511-80d2-00155db07c77)/Account_Tasks?$select%20=%20subject,%20scheduledstart"
-      }
-   ]
+{
+    "@odata.context": "[Organization URI]/api/data/v9.1/$metadata#accounts(name,Account_Tasks(subject,scheduledstart))",
+    "value": [
+        {
+            "@odata.etag": "W/\"37867294\"",
+            "name": "Contoso, Ltd. (sample)",
+            "accountid": "7a4814f9-b0b8-ea11-a812-000d3a122b89",
+            "Account_Tasks": [
+                {
+                    "@odata.etag": "W/\"28876919\"",
+                    "subject": "Task 1 for Contoso, Ltd.",
+                    "scheduledstart": null,
+                    "_regardingobjectid_value": "7a4814f9-b0b8-ea11-a812-000d3a122b89",
+                    "activityid": "7b4814f9-b0b8-ea11-a812-000d3a122b89"
+                },
+                {
+                    "@odata.etag": "W/\"28876923\"",
+                    "subject": "Task 2 for Contoso, Ltd.",
+                    "scheduledstart": null,
+                    "_regardingobjectid_value": "7a4814f9-b0b8-ea11-a812-000d3a122b89",
+                    "activityid": "7c4814f9-b0b8-ea11-a812-000d3a122b89"
+                },
+                {
+                    "@odata.etag": "W/\"28876927\"",
+                    "subject": "Task 3 for Contoso, Ltd.",
+                    "scheduledstart": null,
+                    "_regardingobjectid_value": "7a4814f9-b0b8-ea11-a812-000d3a122b89",
+                    "activityid": "7d4814f9-b0b8-ea11-a812-000d3a122b89"
+                }
+            ],
+            "[email protected]": "[Organization URI]/api/data/v9.1/accounts(7a4814f9-b0b8-ea11-a812-000d3a122b89)/Account_Tasks?$select=subject,scheduledstart"
+        },
+        {
+            "@odata.etag": "W/\"37526208\"",
+            "name": "Fourth Coffee",
+            "accountid": "ccd685f9-cddd-ea11-a813-000d3a122b89",
+            "Account_Tasks": [],
+            "[email protected]": "[Organization URI]/api/data/v9.1/accounts(ccd685f9-cddd-ea11-a813-000d3a122b89)/Account_Tasks?$select=subject,scheduledstart"
+        }
+    ]
 }
  
 ```  
@@ -255,7 +279,7 @@ OData-Version: 4.0
 
 ## Retrieve related entities by expanding both single-valued and collection-valued navigation properties
 
-The following example demonstrates how you can expand related entities for entity sets using both single- and collection-valued navigation properties. As explained earlier, expanding on collection-valued navigation properties to retrieve related entities for entity sets returns an `@odata.nextLink` property for the related entities. You should use the value of the `@odata.nextLink` property with a new `GET` request to return the required data.  
+The following example demonstrates how you can expand related entities for entity sets using both single and collection-valued navigation properties. As explained earlier, expanding on collection-valued navigation properties to retrieve related entities for entity sets returns one level of depth and an `@odata.nextLink` property for the related entities.  
 
 In this example, we are retrieving the contact and tasks assigned to the top 2 accounts.  
 
@@ -278,33 +302,54 @@ HTTP/1.1 200 OK
 Content-Type: application/json; odata.metadata=minimal  
 OData-Version: 4.0  
   
-{  
-   "@odata.context":"[Organization URI]/api/data/v9.1/$metadata#accounts(name,primarycontactid,Account_Tasks,primarycontactid(contactid,fullname),Account_Tasks(subject,scheduledstart))",
-   "value":
-   [  
-      {  
-         "@odata.etag":"W/\"550614\"",
-         "name":"Fourth Coffee (sample)",
-         "accountid":"5b9648c3-68f7-e511-80d3-00155db53318",
-         "primarycontactid":{  
-            "contactid":"c19648c3-68f7-e511-80d3-00155db53318",
-            "fullname":"Yvonne McKay (sample)"
-         },
-         "Account_Tasks":[],
-         "[email protected]":"[Organization URI]/api/data/v9.1/accounts(5b9648c3-68f7-e511-80d3-00155db53318)/Account_Tasks?$select%20=%20subject,%20scheduledstart"
-      },
-      {  
-         "@odata.etag":"W/\"550615\"",
-         "name":"Litware, Inc. (sample)",
-         "accountid":"5d9648c3-68f7-e511-80d3-00155db53318",
-         "primarycontactid":{  
-            "contactid":"c39648c3-68f7-e511-80d3-00155db53318",
-            "fullname":"Susanna Stubberod (sample)"
-         },
-         "Account_Tasks":[],
-         "[email protected]":"[Organization URI]/api/data/v9.1/accounts(5d9648c3-68f7-e511-80d3-00155db53318)/Account_Tasks?$select%20=%20subject,%20scheduledstart"
-      }
-   ]
+{
+    "@odata.context": "[Organization URI]/api/data/v9.1/$metadata#accounts(name,primarycontactid(contactid,fullname),Account_Tasks(subject,scheduledstart))",
+    "value": [
+        {
+            "@odata.etag": "W/\"37867294\"",
+            "name": "Contoso, Ltd. (sample)",
+            "accountid": "7a4814f9-b0b8-ea11-a812-000d3a122b89",
+            "primarycontactid": {
+                "contactid": "7e4814f9-b0b8-ea11-a812-000d3a122b89",
+                "fullname": "Yvonne McKay (sample)"
+            },
+            "Account_Tasks": [
+                {
+                    "@odata.etag": "W/\"28876919\"",
+                    "subject": "Task 1 for Contoso, Ltd.",
+                    "scheduledstart": null,
+                    "_regardingobjectid_value": "7a4814f9-b0b8-ea11-a812-000d3a122b89",
+                    "activityid": "7b4814f9-b0b8-ea11-a812-000d3a122b89"
+                },
+                {
+                    "@odata.etag": "W/\"28876923\"",
+                    "subject": "Task 2 for Contoso, Ltd.",
+                    "scheduledstart": null,
+                    "_regardingobjectid_value": "7a4814f9-b0b8-ea11-a812-000d3a122b89",
+                    "activityid": "7c4814f9-b0b8-ea11-a812-000d3a122b89"
+                },
+                {
+                    "@odata.etag": "W/\"28876927\"",
+                    "subject": "Task 3 for Contoso, Ltd.",
+                    "scheduledstart": null,
+                    "_regardingobjectid_value": "7a4814f9-b0b8-ea11-a812-000d3a122b89",
+                    "activityid": "7d4814f9-b0b8-ea11-a812-000d3a122b89"
+                }
+            ],
+            "[email protected]": "[Organization URI]/api/data/v9.1/accounts(7a4814f9-b0b8-ea11-a812-000d3a122b89)/Account_Tasks?$select=subject,scheduledstart"
+        },
+        {
+            "@odata.etag": "W/\"37526208\"",
+            "name": "Fourth Coffee",
+            "accountid": "ccd685f9-cddd-ea11-a813-000d3a122b89",
+            "primarycontactid": {
+                "contactid": "384d0f84-7de6-ea11-a817-000d3a122b89",
+                "fullname": "Charlie Brown"
+            },
+            "Account_Tasks": [],
+            "[email protected]": "[Organization URI]/api/data/v9.1/accounts(ccd685f9-cddd-ea11-a813-000d3a122b89)/Account_Tasks?$select=subject,scheduledstart"
+        }
+    ]
 }
 ```
 

powerapps-docs/developer/model-driven-apps/clientapi/reference/Xrm-Navigation/openForm.md

@@ -44,7 +44,7 @@ search.app:
 <li><b>height</b>: (Optional) Number. Height of the form window to be displayed in pixels.</li>
 <li><b>navbar</b>: (Optional) String. Controls whether the navigation bar is displayed and whether application navigation is available using the areas and subareas defined in the sitemap. Valid values are: "on", "off", or "entity".<ul><li><code>on</code>: The navigation bar is displayed. This is the default behavior if the <b>navbar</b> parameter is not used.</li>
 <li><code>off</code>: The navigation bar is not displayed. People can navigate using other user interface elements or the back and forward buttons.</li><li><code>entity</code>: On an entity form, only the navigation options for related entities are available. After navigating to a related entity, a back button is displayed in the navigation bar to allow returning to the original record.</li></ul></li>
-<li><b>openInNewWindow</b>: (Optional) Boolean. Indicates whether to display form in a new window.</li>
+<li><b>openInNewWindow</b>: (Optional) Boolean. Indicates whether to display form in a new window or a new tab. If you specify <code>true</code> and do not specify values for height or width, the form will display in a new tab.</li>
 <li><b>windowPosition</b>: (Optional) Number. Specify one of the following values for the position of the form on the screen:<ul><li><code>1:center</code></li><li><code>2:side</code></li></ul>
 This does not apply to opening a new browser window.  
 <li><b>relationship</b>: (Optional) Object. Define a relationship object to display the related records on the form. The object has the following attributes.

powerapps-docs/maker/TOC.yml

@@ -403,7 +403,7 @@
               href: ./canvas-apps/controls/control-export-import.md
             - name: Gallery
               href: ./canvas-apps/controls/control-gallery.md
-            - name: Horizontal container (experimental)
+            - name: Horizontal container 
               href: ./canvas-apps/controls/control-horizontal-container.md
             - name: HTML text
               href: ./canvas-apps/controls/control-html-text.md
@@ -449,7 +449,7 @@
               href: ./canvas-apps/controls/control-timer.md
             - name: Toggle
               href: ./canvas-apps/controls/control-toggle.md
-            - name: Vertical container (experimental)
+            - name: Vertical container 
               href: ./canvas-apps/controls/control-vertical-container.md
             - name: Video
               href: ./canvas-apps/controls/control-audio-video.md

powerapps-docs/maker/canvas-apps/build-responsive-apps.md

@@ -17,8 +17,6 @@ search.app:
 
 # Building responsive apps  
 
-[This article is pre-release documentation and is subject to change.]
-
 Responsiveness refers to the ability of an app to automatically align to different screen sizes and form factors to use the available screen space sensibly, providing great UI and UX in every device, form factor, and screen size. 
 
 > [!IMPORTANT]

powerapps-docs/maker/canvas-apps/geospatial-overview.md

@@ -32,7 +32,8 @@ The following prebuilt components can be used for geospatial and mapping scenari
 ## Prerequisites
 
 1. An admin must [enable the geospatial features in the Power Platform admin center](#enable-the-geospatial-features-for-the-environment) for the environment. This requires reviewing and agreeing to specific terms of service.
-2. [Enable the geospatial features for each app](#enable-the-geospatial-features-for-each-app).
+2. An admin must [ensure the geospatial components will not be blocked by the environment's data loss prevention policies](#review-the-environments-data-loss-prevention-policies).
+3. [Enable the geospatial features for each app](#enable-the-geospatial-features-for-each-app).
 
     >[!IMPORTANT]
     >The components require the default **Organizations** data source to be present. This data source is included whenever you insert the components into an app, but if you manually delete it you'll need to add it before the components will work:
@@ -85,6 +86,12 @@ The geospatial features require additional terms of use that must be reviewed an
 
     ![Screenshot of the Save button](./media/geospatial/ppac-save.png "Screenshot of the Save button")
 
+### Review the environment's data loss prevention policies
+
+The geospatial components require the Common Data Service and Spatial Services connectors. 
+
+For the components to function properly, these connectors must not have conflicting data loss prevention policies. An admin must review the environment's data loss prevention policies and ensure that these connectors are classified under the same data group, typically the **Business** data group. [Learn more about data loss prevention policies for Power Platform](/power-platform/admin/prevent-data-loss). 
+
 ### Enable the geospatial features for each app
 
 1. Open the app for editing in Power Apps Studio at [https://create.powerapps.com](https://create.powerapps.com).