Merge pull request #7437 from MicrosoftDocs/pakempar/updateRetriveMultipleExample

Add a fetchXML based example for retrieve multiple with lookup filter

Author: JimDaly

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

@@ -3,7 +3,7 @@ title: "retrieveMultipleRecords (Client API reference) in model-driven apps| Mic
 description: Includes description and supported parameters for the retrieveMultipleRecords method.
 author: adrianorth
 ms.author: aorth
-ms.date: 04/19/2022
+ms.date: 12/15/2022
 ms.reviewer: jdaly
 ms.topic: reference
 search.audienceType: 
@@ -219,6 +219,40 @@ Xrm.WebApi.retrieveMultipleRecords("account", "?$select=name,primarycontactid&$f
     }
 );
 ```
+
+#### Using FetchXML to retrieve or filter by lookup properties (online and offline scenario)
+
+You can use the `FetchXML` parameter while online or offline to retrieve the `name` and `primarycontactid` property for account records that have a primary contact that matches a condition:
+
+```JavaScript
+var fetchXml = `?fetchXml=
+    <fetch mapping='logical'>
+    	<entity name='account'>
+    		<attribute name='name'/>
+    		<attribute name='primarycontactid'/>
+    		<link-entity name='contact' from='contactid' to='primarycontactid'>
+    			<filter type='and'>
+    				<condition attribute='lastname' operator='eq' value='Contoso'/>
+    			</filter>
+    		</link-entity>
+    	</entity>
+    </fetch>`;
+
+Xrm.WebApi.retrieveMultipleRecords("account", fetchXml).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 tables 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.