Live publish for 21 January 2020.

Author: buck1ey

powerapps-docs/developer/common-data-service/view-download-developer-resources.md

@@ -76,15 +76,15 @@ More information: [Azure integration](/powerapps/developer/common-data-service/a
 
 Because people may have access to multiple Common Data Service environments, the discovery services allow for retrieving the available environments that a person can access based on their user credentials.
 
-### Discovery Web API
+### Discovery RESTful API
 
-This is the endpoint address for the RESTful OData v4 version of the discovery service to use for your instance. You can also download the service document here.
+This is the endpoint address for the RESTful OData v4 version of the Discovery Service to use for your instance. You can also download the service document here.
 More information: [Developer Documentation: Discover the URL for your organization using the Web API](/powerapps/developer/common-data-service/webapi/discover-url-organization-web-api)
 
 
 ### Discovery Service
 
-This is the endpoint address for the SOAP version of the discovery service to use for your instance. You can also download the service document here.
+This is the endpoint address for the SOAP version of the Discovery Service to use for your instance. You can also download the service document here.
 More information: [Developer Documentation: Discover the URL for your organization using the Organization Service](/powerapps/developer/common-data-service/org-service/discovery-service)
 
 

powerapps-docs/developer/model-driven-apps/clientapi/reference/Xrm-WebApi/retrieveMultipleRecords.md

@@ -105,7 +105,50 @@ Xrm.WebApi.retrieveMultipleRecords("account", "?$select=name&$top=3").then(
 );
 ```
 
+### Retrieve or filter by lookup properties
+For most single-valued navigation properties you will find a computed, read-only property that uses the following naming convention: `_<name>_value` where the `<name>` is the name of the single-valued navigation property. For filtering purposes, the specific value of the single-valued navigation property can also be used.  However, for mobile clients in offline mode, these syntax options are not supported, and the single-value navigation property name should be used for both retrieving and filtering. Also, the comparison of navigation properties to null is not supported in offline mode.
 
+More information: [Lookup properties](../../../../common-data-service/webapi/web-api-types-operations.md#bkmk_lookupProperties)
+
+Here are code examples for both the scenarios:
+
+#### For online scenario (connected to server)
+
+This example queries the accounts entity set and uses the `$select` and `$filter` system query options to return the name and primarycontactid property for accounts that have a particular primary contact:
+
+```JavaScript
+Xrm.WebApi.retrieveMultipleRecords("account", "?$select=name,_primarycontactid_value&$filter=primarycontactid/contactid eq a0dbf27c-8efb-e511-80d2-00155db07c77").then(
+    function success(result) {
+        for (var i = 0; i < result.entities.length; i++) {
+            console.log(result.entities[i]);
+        }                    
+        // perform additional operations on retrieved records
+    },
+    function (error) {
+        console.log(error.message);
+        // handle error conditions
+    }
+);
+```
+
+#### For mobile offine scenario
+
+This example queries the accounts entity set and uses the `$select` and `$filter` system query options to return the name and primarycontactid property for accounts that have a particular primary contact when working in the offline mode:
+
+```JavaScript
+Xrm.WebApi.retrieveMultipleRecords("account", "?$select=name,primarycontactid&$filter=primarycontactid eq a0dbf27c-8efb-e511-80d2-00155db07c77").then(
+    function success(result) {
+        for (var i = 0; i < result.entities.length; i++) {
+            console.log(result.entities[i]);
+        }                    
+        // perform additional operations on retrieved records
+    },
+    function (error) {
+        console.log(error.message);
+        // handle error conditions
+    }
+);
+```
 ### Specify the number of entities to return in a page
 
 The following example demonstrates the use of the `maxPageSize` parameter to specify the number of records (3) to be displayed in a page.

powerapps-docs/maker/common-data-service/media/components-in-solution.png

@@ -2,7 +2,7 @@
 title: "Work with solutions in Power Apps | MicrosoftDocs"
 description: "Learn how solutions are distributed"
 ms.custom: ""
-ms.date: 12/04/2019
+ms.date: 01/21/2020
 ms.reviewer: ""
 ms.service: powerapps
 ms.suite: ""
@@ -36,7 +36,7 @@ More information: [Whitepaper: Solution Lifecycle Management](https://www.micros
 
 <a name="BKMK_SolutionComponents"></a>   
 ## Components  
- A component represents something that you can potentially customize. Anything that can be included in a solution is a component. To view the components included in a solution, in solution explorer go to **Settings** > **Solutions** and then open the solution you want. The components are listed in the **Components** list. 
+ A component represents something that you can potentially customize. Anything that can be included in a solution is a component. To view the components included in a solution, in solution explorer go to **Settings** > **Solutions** and then open the solution you want. The components are listed in the **Components** list. Notice that you can't edit components contained in a managed solution. 
 
 > [!div class="mx-imgBorder"] 
 > ![Components in solution](media/components-in-solution.png "Components in solution")