added new impersonate to callbacks library; updated readme and ignore files

Author: AleksandrRogov

.gitignore

@@ -253,6 +253,7 @@ ModelManifest.xml
 /scripts
 /coverage
 /tests/browser
+*.d.ts.map
 
 # Webstorm
 .idea

.npmignore

@@ -8,4 +8,6 @@ obj
 .ntvs_analysis.dat
 
 # Exclude type definitions for callbacks version
-/types/dynamics-web-api-callbacks.d.ts
+/types/dynamics-web-api-callbacks.d.ts
+
+*.d.ts.map

README.md

@@ -200,7 +200,7 @@ dynamicsWebApi.setConfig({ webApiVersion: '8.2' });
 Property Name | Type | Description
 ------------ | ------------- | -------------
 impersonate | String | A String representing the GUID value for the Dynamics 365 system user id. Impersonates the user.
-impersonateAAD | String | A String representing the GUID value for the Azure active directory object id. Impersonates the user.
+impersonateAAD | String | `v.1.6.12+` A String representing the GUID value for the Azure active directory object id. Impersonates the user. [More Info](https://docs.microsoft.com/en-us/powerapps/developer/common-data-service/webapi/impersonate-another-user-web-api)
 includeAnnotations | String | Defaults Prefer header with value "odata.include-annotations=" and the specified annotation. Annotations provide additional information about lookups, options sets and other complex attribute types.
 maxPageSize | Number | Defaults the odata.maxpagesize preference. Use to set the number of entities returned in the response.
 onTokenRefresh | Function | A callback function that triggered when DynamicsWebApi requests a new OAuth token. (At this moment it is done before each call to Dynamics 365, as [recommended by Microsoft](https://msdn.microsoft.com/en-ca/library/gg327838.aspx#Anchor_2)).
@@ -252,7 +252,7 @@ id | String | `retrieveRequest`, `createRequest`, `updateRequest`, `upsertReques
 ifmatch | String | `retrieveRequest`, `updateRequest`, `upsertRequest`, `deleteRequest` | Sets If-Match header value that enables to use conditional retrieval or optimistic concurrency in applicable requests. [More Info](https://msdn.microsoft.com/en-us/library/mt607711.aspx)
 ifnonematch | String | `retrieveRequest`, `upsertRequest` | Sets If-None-Match header value that enables to use conditional retrieval in applicable requests. [More Info](https://msdn.microsoft.com/en-us/library/mt607711.aspx).
 impersonate | String | All | A String representing the GUID value for the Dynamics 365 system user id. Impersonates the user.
-impersonateAAD | String | All | A String representing the GUID value for the Azure active directory object id. Impersonates the user.
+impersonateAAD | String | All | `v.1.6.12+` A String representing the GUID value for the Azure active directory object id. Impersonates the user. [More Info](https://docs.microsoft.com/en-us/powerapps/developer/common-data-service/webapi/impersonate-another-user-web-api)
 includeAnnotations | String | `retrieveRequest`, `retrieveMultipleRequest`, `retrieveAllRequest`, `createRequest`, `updateRequest`, `upsertRequest` | Sets Prefer header with value "odata.include-annotations=" and the specified annotation. Annotations provide additional information about lookups, options sets and other complex attribute types.
 key | String | `retrieveRequest`, `createRequest`, `updateRequest`, `upsertRequest`, `deleteRequest` | `v.1.3.4+` A String representing collection record's Primary Key (GUID) or Alternate Key(s).
 maxPageSize | Number | `retrieveMultipleRequest`, `retrieveAllRequest` | Sets the odata.maxpagesize preference value to request the number of entities returned in the response.

lib/dynamics-web-api-callbacks.js

@@ -107,7 +107,8 @@ function DynamicsWebApi(config) {
     var _internalConfig = {
         webApiVersion: "8.0",
         webApiUrl: "",
-        impersonate: null,
+		impersonate: null,
+		impersonateAAD: null,
         onTokenRefresh: null,
         includeAnnotations: null,
         maxPageSize: null,
@@ -147,7 +148,11 @@ function DynamicsWebApi(config) {
 
         if (config.impersonate) {
             _internalConfig.impersonate = ErrorHelper.guidParameterCheck(config.impersonate, "DynamicsWebApi.setConfig", "config.impersonate");
-        }
+		}
+
+		if (config.impersonateAAD) {
+			_internalConfig.impersonateAAD = ErrorHelper.guidParameterCheck(config.impersonateAAD, "DynamicsWebApi.setConfig", "config.impersonateAAD");
+		}
 
         if (config.onTokenRefresh) {
             ErrorHelper.callbackParameterCheck(config.onTokenRefresh, "DynamicsWebApi.setConfig", "config.onTokenRefresh");

types/dynamics-web-api-callbacks.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for dynamics-web-api-callbacks v1.6.11
+// Type definitions for dynamics-web-api-callbacks v1.6.12
 // Project: https://github.com/AleksandrRogov/DynamicsWebApi
 // Definitions by: Aleksandr Rogov https://github.com/AleksandrRogov/
 
@@ -562,6 +562,8 @@ declare namespace DynamicsWebApi {
 		async?: boolean;
 		/**Impersonates the user.A String representing the GUID value for the Dynamics 365 system user id. */
 		impersonate?: string;
+		/**Impersonates the user.A String representing the GUID value for the Azure active directory object id. */
+		impersonateAAD?: string;
 		/** If set to 'true', DynamicsWebApi adds a request header 'Cache-Control: no-cache'.Default value is 'false'. */
 		noCache?: boolean;
 		/** Authorization Token. If set, onTokenRefresh will not be called. */
@@ -692,8 +694,10 @@ declare namespace DynamicsWebApi {
 		webApiUrl?: string;
 		/**The version of Web API to use, for example: "8.1" */
 		webApiVersion?: string;
-		/**A String representing a URL to Web API(webApiVersion not required if webApiUrl specified)[not used inside of CRM] */
+		/**A String representing a GUID value for the Dynamics 365 system user id */
 		impersonate?: string;
+		/**Impersonates the user. A String representing the GUID value for the Azure active directory object id. */
+		impersonateAAD?: string;
 		/**A function that is called when a security token needs to be refreshed. */
 		onTokenRefresh?: (callback: OnTokenAcquiredCallback) => void;
 		/**Sets Prefer header with value "odata.include-annotations=" and the specified annotation.Annotations provide additional information about lookups, options sets and other complex attribute types.*/

types/dynamics-web-api.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for dynamics-web-api v1.6.11
+// Type definitions for dynamics-web-api v1.6.12
 // Project: https://github.com/AleksandrRogov/DynamicsWebApi/
 // Definitions by: Aleksandr Rogov https://github.com/AleksandrRogov/