Skip to content

UpdateRequest

Aleksandr Rogov edited this page Apr 13, 2024 · 3 revisions

Interface: UpdateRequest<T>

Type parameters

Name Type
T any

Hierarchy

Table of contents

Properties

Properties

async

Optional async: boolean

XHR requests only! Indicates whether the requests should be made synchronously or asynchronously.Default value is 'true'(asynchronously).

Inherited from

UpdateRequestBase.async


bypassCustomPluginExecution

Optional bypassCustomPluginExecution: boolean

If set to true, the request bypasses custom business logic, all synchronous plug-ins and real-time workflows are disabled. Check for special exceptions in Microsft Docs.

Inherited from

UpdateRequestBase.bypassCustomPluginExecution


collection

Optional collection: string

A name of the Entity Collection or Entity Logical name.

Inherited from

UpdateRequestBase.collection


contentId

Optional contentId: string

BATCH REQUESTS ONLY! Sets Content-ID header or references request in a Change Set.

Inherited from

UpdateRequestBase.contentId


data

Optional data: T

A JavaScript object with properties corresponding to the logical name of entity attributes(exceptions are lookups and single-valued navigation properties).

Inherited from

UpdateRequestBase.data


duplicateDetection

Optional duplicateDetection: boolean

Web API v9+ only! Boolean that enables duplicate detection.

Inherited from

UpdateRequestBase.duplicateDetection


expand

Optional expand: Expand[]

An array of Expand Objects(described below the table) representing the $expand OData System Query Option value to control which related records are also returned.

Inherited from

UpdateRequestBase.expand


headers

Optional headers: HeaderCollection

Headers to supply with a request. These headers will override configuraiton headers if the identical ones were set.

Inherited from

UpdateRequestBase.headers


ifmatch

Optional ifmatch: string

Sets If-Match header value that enables to use conditional retrieval or optimistic concurrency in applicable requests.

Inherited from

UpdateRequestBase.ifmatch


impersonate

Optional impersonate: string

Impersonates a user based on their systemuserid by adding "MSCRMCallerID" header. A String representing the GUID value for the Dynamics 365 systemuserid.

Inherited from

UpdateRequestBase.impersonate


impersonateAAD

Optional impersonateAAD: string

Impersonates a user based on their Azure Active Directory (AAD) object id by passing that value along with the header "CallerObjectId". A String should represent a GUID value.

Inherited from

UpdateRequestBase.impersonateAAD


inChangeSet

Optional inChangeSet: boolean

Indicates if an operation must be included in a Change Set or not. Works in Batch Operations only. By default, it's "true", except for GET operations - they are not allowed in Change Sets.

Inherited from

UpdateRequestBase.inChangeSet


includeAnnotations

Optional includeAnnotations: string

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.

Inherited from

UpdateRequestBase.includeAnnotations


key

Optional key: string

A String representing collection record's Primary Key (GUID) or Alternate Key(s).

Inherited from

UpdateRequestBase.key


mergeLabels

Optional mergeLabels: boolean

If set to 'true', DynamicsWebApi adds a request header 'MSCRM.MergeLabels: true'. Default value is 'false'


metadataAttributeType

Optional metadataAttributeType: string

Casts the AttributeMetadata to a specific type. (Used in requests to Attribute Metadata).

Inherited from

UpdateRequestBase.metadataAttributeType


navigationProperty

Optional navigationProperty: string

A String representing the name of a single - valued navigation property.Useful when needed to retrieve information about a related record in a single request.

Inherited from

UpdateRequestBase.navigationProperty


navigationPropertyKey

Optional navigationPropertyKey: string

A String representing navigation property's Primary Key (GUID) or Alternate Key(s). (For example, to retrieve Attribute Metadata).

Inherited from

UpdateRequestBase.navigationPropertyKey


noCache

Optional noCache: boolean

If set to 'true', DynamicsWebApi adds a request header 'Cache-Control: no-cache'.Default value is 'false'.

Inherited from

UpdateRequestBase.noCache


partitionId

Optional partitionId: string

A unique partition key value of a logical partition for non-relational custom entity data stored in NoSql tables of Azure heterogenous storage.

Inherited from

UpdateRequestBase.partitionId


queryParams

Optional queryParams: string[]

Custom query parameters. Can be used to set parameter aliases for "$filter" and "$orderBy". Important! These parameters ARE NOT URI encoded!

Inherited from

UpdateRequestBase.queryParams


returnRepresentation

Optional returnRepresentation: boolean

Sets Prefer header request with value "return=representation".Use this property to return just created or updated entity in a single request.

Inherited from

UpdateRequestBase.returnRepresentation


select

Optional select: string[]

An Array(of Strings) representing the $select OData System Query Option to control which attributes will be returned.

Inherited from

UpdateRequestBase.select


signal

Optional signal: AbortSignal

The AbortSignal interface represents a signal object that allows you to communicate with a DOM request and abort it if required via an AbortController object.

Inherited from

UpdateRequestBase.signal


timeout

Optional timeout: number

Sets a number of milliseconds before a request times out.

Inherited from

UpdateRequestBase.timeout


token

Optional token: string

Authorization Token. If set, onTokenRefresh will not be called.

Inherited from

UpdateRequestBase.token

Clone this wiki locally