Class DeleteRequestBuilder<EntityT, DeSerializersT>

Create OData query to delete an entity.

Type Parameters

Hierarchy (View Summary)

Constructors

  • Creates an instance of DeleteRequestBuilder. If the entity is passed, version identifier will also be added.

    Type Parameters

    • EntityT extends Entity
    • DeSerializersT extends DeSerializers<
          any,
          any,
          any,
          any,
          any,
          any,
          any,
          any,
          any,
          any,
          any,
          any,
          any,
          any,
          any,
          any,
          any,
      > = DefaultDeSerializers

    Parameters

    • entityApi: EntityApi<EntityT, DeSerializersT>

      Entity API for building and executing the request.

    • keysOrEntity: Record<string, any> | EntityT

      Entity or Key-value pairs of key properties for the given entity.

    Returns DeleteRequestBuilder<EntityT, DeSerializersT>

Properties

_deSerializers: DeSerializersT

Dummy property to also include the deserializer type in the structure of the entity type.

_entity: EntityT

Dummy property whose type makes structurally identical entities distinguishable in TypeScript.

Methods

  • Add custom headers to the request. Existing headers will be overwritten.

    Parameters

    • headers: Record<string, string>

      Key-value pairs denoting additional custom headers.

    Returns this

    The request builder itself, to facilitate method chaining.

  • Add custom query parameters to the request. If a query parameter with the given name already exists it is overwritten.

    Parameters

    • queryParameters: Record<string, string>

      Key-value pairs denoting additional custom query parameters to be set in the request.

    Returns this

    The request builder itself, to facilitate method chaining.

  • Add a custom request configuration to the request. Typically, this is used when specifying a response type for downloading files. If the custom request configuration contains disallowed keys, those will be ignored.

    Parameters

    • requestConfiguration: CustomRequestConfig

      Key-value pairs denoting additional custom request configuration options to be set in the request.

    Returns this

    The request builder itself, to facilitate method chaining.

  • Append the given path to the URL. This can be used for querying navigation properties of an entity. To execute a request with an appended path use executeRaw to avoid errors during deserialization. When using this, the execute method is omitted from the return type.

    Parameters

    • ...path: string[]

      Path to be appended.

    Returns Omit<DeleteRequestBuilder<EntityT, DeSerializersT>, "execute">

    The request builder itself without "execute" function, to facilitate method chaining.

  • Instructs the request to force an overwrite of the entity by sending an 'If-Match: *' header instead of sending the ETag version identifier.

    Returns this

    The request itself to ease chaining while executing the request.

  • Set middleware for requests towards the target system given in the destination.

    Parameters

    Returns this

    The request builder itself, to facilitate method chaining.

  • Set middleware for requests towards the target system given in the destination.

    Parameters

    • ...middlewares: HttpMiddleware[]

      Middlewares to be applied to the executeHttpRequest().

    Returns this

    The request builder itself, to facilitate method chaining.

  • Create the relative URL based on configuration of the given builder.

    Returns string

    The relative URL for the request.

  • Replace the default service path with the given custom path. In case of the SAP S/4HANA APIs the basePath defaults to /sap/opu/odata/sap/<SERVICE_NAME> and can be overwritten here.

    Parameters

    • basePath: string

      Path to override the default with.

    Returns this

    The request builder itself, to facilitate method chaining.

  • Sets user-defined identifier for the batch reference.

    Parameters

    • id: string

      User-defined batch request identifier.

    Returns void

  • Add an eTag version identifier in the delete request header.

    Parameters

    • eTag: string

      The version identifier of the entity.

    Returns this

    The builder itself, to facilitate method chaining.

  • Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.

    Returns this

    The request builder itself, to facilitate method chaining.

  • Create the URL based on configuration of the given builder.

    Parameters

    Returns Promise<string>

    Promise resolving to the URL for the request.

    Copyright Ⓒ 2024 SAP SE or an SAP affiliate company. All rights reserved.