From 1255ac3331d598f5f66896b5ef72cac97a5f5d14 Mon Sep 17 00:00:00 2001
From: DigitalFlow <DigitalFlow@users.noreply.github.com>
Date: Thu, 23 Feb 2017 20:40:58 +0100
Subject: [PATCH] Update README.md

---
 README.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/README.md b/README.md
index 5ca738b..a426e25 100644
--- a/README.md
+++ b/README.md
@@ -23,6 +23,7 @@ The package name is xrm-webapi-client, check it out:
 
 
 [![NPM version](https://img.shields.io/npm/v/xrm-webapi-client.svg?style=flat)](https://www.npmjs.com/package/xrm-webapi-client)
+
 ### GitHub Release
 You can always download the browserified version of this framework by downloading the release.zip file from the latest [release](https://github.com/DigitalFlow/Xrm-WebApi-Client/releases).
 
@@ -143,6 +144,29 @@ WebApiClient.Retrieve(request)
     });
 ```
 
+#### Auto expand collection-valued navigation properties
+When retrieving collection-valued navigation properties, the expand is being deferred, i.e. you don't retrieve immediate results, but a property ending in "@odata.nextLink" that contains an URL to the results for this expand. You can read more about this [here](https://msdn.microsoft.com/en-us/library/gg334767.aspx#bkmk_expandRelated).
+For easing to retrieve these, we can use the `WebApiClient.Expand` function. It takes an array of records and expands all properties, that end in "@odata.nextLink".
+You can additionally pass headers to the request, that will be appended to each retrieve request for properties.
+
+```JavaScript
+WebApiClient.Retrieve({
+    entityName: "account", 
+    queryParams: "?$expand=contact_customer_accounts"
+})
+.then(function(response){
+    return WebApiClient.Expand({
+        records: response.value
+    });
+})
+.then(function(response){        
+    // Process response
+})
+.catch(function(error) {
+    // Handle error
+});
+```
+
 ### Update
 Update requests are supported. You have to pass the entity logical name, the ID of the record to update and an update object: