added a tag property in a base request. closing #186

Author: AleksandrRogov

.github/README.md

@@ -398,6 +398,7 @@ returnRepresentation | `boolean` | `create`, `update`, `upsert` | Sets Prefer he
 savedQuery | `string` | `retrieve` | A String representing the GUID value of the saved query.
 select | `string[]` | `retrieve`, `retrieveMultiple`, `retrieveAll`, `update`, `upsert`, `callFunction` | An array (of Strings) representing the $select OData System Query Option to control which attributes will be returned.
 signal | `AbortSignal` | All | Specifies an `AbortSignal` that can be used to abort a request if required via an `AbortController` object. [More Info](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal)
+tag | `string` | All | `v2.3.0+` Use the tag parameter to include a shared variable value that is accessible within a plug-in.
 timeout | `number` | All | Sets a number of milliseconds before a request times out.
 token | `string` | All | Authorization Token. If set, onTokenRefresh will not be called.
 top | `number` | `retrieveMultiple`, `retrieveAll` | Limit the number of results returned by using the $top system query option. Do not use $top with $count!

README.md

@@ -14,13 +14,14 @@ As well as Microsoft Dynamics 365 CE (online), Microsoft Dynamics 365 CE (on-pre
 
 - **Microsoft Dataverse Search API**. Access the full power of its Search, Suggestion and Autocomplete capabilities.
 - **Batch Requests**. Convert all requests into a Batch operation with two lines of code.
-- **Simplicity and Automation**. Such as automated paging, big file downloading/uploading in chunks of data, automated conversion of requests with long URLs into a Batch Request in the background and more!
+- **Simplicity and Automation**. Automated paging, big file downloading/uploading in chunks of data, automated conversion of requests with long URLs into a Batch Request and more!
 - **CRUD operations**. Including Fetch XML, Actions and Functions in Microsoft Dataverse Web API.
 - **Table Definitions (Entity Metadata)**. Query and modify Table, Column, Choice (Option Set) and Relationship definitions.
 - **File Fields**. Upload, Download and Delete data stored in the File Fields.
 - **Abort Signal and Abort Controller** (Browser and Node.js 15+). Abort requests when they are no longer need to be completed.
 - **Node.js and a Browser** support.
 - **Proxy Configuration** support.
+- **Background Operations** support.
 - Works with **Microsoft Power Pages** (aka Microsoft Portal). `v2.1.0+`
 
 Browser-compiled script and type definitions can be found in a v2 [dist](https://github.com/AleksandrRogov/DynamicsWebApi/tree/v2/dist) folder.
@@ -61,7 +62,7 @@ Once the web file is uploaded, it can be included in a template, a page or a for
 
 With CDN, it is a bit easier: no need to create and upload a web file - just include the script in your template, page or a form:
 ```html
-<script type="text/javascript" src="https://unpkg.com/dynamics-web-api@2.1.4/dist/dynamics-web-api.min.js"></script>
+<script type="text/javascript" src="https://unpkg.com/dynamics-web-api@2.3.0/dist/dynamics-web-api.min.js"></script>
 ```
 
 And you are good to go! DynamicsWebApi will automatically detect if the library is running on Power Pages and will supply an anti-forgery token with each request.

dist/browser/esm/dynamics-web-api.js

@@ -450,15 +450,9 @@ export interface BaseRequest {
      * Important! These parameters ARE NOT URI encoded! */
     queryParams?: string[];
     /**
-     * A callback URL when the background operation is completed.
-     * Dataverse uses this URL to send a POST request.
+     * Use this parameter to include a shared variable value that is accessible within a plug-in.
      */
-    backgroundOperationCallbackUrl?: string;
-    /**
-     * Use background operations to send requests that Dataverse processes asynchronously.
-     * Background operations are useful when you don't want to maintain a connection while a request runs.
-     */
-    respondAsync?: boolean;
+    tag?: string;
 }
 export interface BatchRequest extends BaseRequest {
     /** Sets Prefer header to "odata.continue-on-error" that allows more requests be processed when errors occur. The batch request will return '200 OK' and individual response errors will be returned in the batch response body. */
@@ -702,6 +696,16 @@ export interface UnboundActionRequest<TAction = any> extends BaseRequest {
     actionName: string;
     /**An object that represents a Dynamics 365 action. */
     action?: TAction;
+    /**
+     * A callback URL when the background operation is completed.
+     * Dataverse uses this URL to send a POST request.
+     */
+    backgroundOperationCallbackUrl?: string;
+    /**
+     * Use background operations to send requests that Dataverse processes asynchronously.
+     * Background operations are useful when you don't want to maintain a connection while a request runs.
+     */
+    respondAsync?: boolean;
 }
 export interface BoundActionRequest<TAction = any> extends UnboundActionRequest<TAction>, Request {
     /**A String representing the GUID value for the record. */