Options
All
  • Public
  • Public/Protected
  • All
Menu

Create OData request to create an entity.

Type parameters

  • EntityT: Entity

    Type of the entity to be created

Hierarchy

Implements

  • EntityIdentifiable<EntityT>

Index

Constructors

constructor

  • new CreateRequestBuilder<EntityT>(_entityConstructor: Constructable<EntityT, unknown>, _entity: EntityT): CreateRequestBuilder<EntityT>
  • Creates an instance of CreateRequestBuilder.

    Type parameters

    Parameters

    • _entityConstructor: Constructable<EntityT, unknown>

      Constructor type of the entity to be created

    • _entity: EntityT

      Entity to be created

    Returns CreateRequestBuilder<EntityT>

Properties

Readonly _entity

_entity: EntityT

Readonly _entityConstructor

_entityConstructor: Constructable<EntityT, unknown>

Readonly deserializer

deserializer: EntityDeserializer<any>

Readonly odataUri

odataUri: ODataUri

requestConfig

requestConfig: ODataCreateRequestConfig<EntityT>

Readonly responseDataAccessor

responseDataAccessor: ResponseDataAccessor

Readonly serializer

serializer: EntitySerializer<any, any>

Accessors

entity

  • get entity(): EntityT
  • Returns EntityT

Methods

addCustomHeaders

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

    Parameters

    • headers: Record<string, string>

      Key-value pairs denoting additional custom headers.

    Returns CreateRequestBuilder<EntityT>

    The request builder itself, to facilitate method chaining.

addCustomQueryParameters

  • 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 CreateRequestBuilder<EntityT>

    The request builder itself, to facilitate method chaining

addCustomRequestConfiguration

  • addCustomRequestConfiguration(requestConfiguration: Record<string, string>): CreateRequestBuilder<EntityT>
  • 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: Record<string, string>

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

    Returns CreateRequestBuilder<EntityT>

    The request builder itself, to facilitate method chaining.

appendPath

  • 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

    • Rest ...path: string[]

      Path to be appended.

    Returns Omit<CreateRequestBuilder<EntityT>, "execute">

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

asChildOf

  • asChildOf<ParentEntityT>(parentEntity: ParentEntityT, linkField: Link<ParentEntityT, EntityT>): CreateRequestBuilder<EntityT>
  • Specifies the parent of the entity to create.

    Type parameters

    Parameters

    • parentEntity: ParentEntityT

      Parent of the entity to create

    • linkField: Link<ParentEntityT, EntityT>

      Static representation of the navigation property that navigates from the parent entity to the child entity

    Returns CreateRequestBuilder<EntityT>

    The entity itself, to facilitate method chaining

build

execute

  • Execute query.

    Parameters

    Returns Promise<EntityT>

    A promise resolving to the created entity

executeRaw

prepare

  • deprecated

    Since v1.29.0. This method should never be called, it has severe side effects. * Builds the payload of the query.

    Returns CreateRequestBuilder<EntityT>

    the builder itself

relativeUrl

  • relativeUrl(): string
  • Create the relative URL based on configuration of the given builder.

    Returns string

    The relative URL for the request

setCustomServicePath

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

    Parameters

    • servicePath: string

      Path to override the default with

    Returns CreateRequestBuilder<EntityT>

    The request builder itself, to facilitate method chaining

skipCsrfTokenFetching

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

    Returns CreateRequestBuilder<EntityT>

    The request builder itself, to facilitate method chaining.

url

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

    Parameters

    Returns Promise<string>

    Promise resolving to the URL for the request

withCustomHeaders

  • deprecated

    Since version 1.34.0 Use addCustomHeaders instead. Add custom headers to the request.

    Parameters

    • headers: Record<string, string>

      Key-value pairs denoting additional custom headers.

    Returns CreateRequestBuilder<EntityT>

    The request builder itself, to facilitate method chaining.

withCustomQueryParameters

  • deprecated

    Since version 1.34.0 Use addCustomQueryParameters instead. Add custom query parameters to the request.

    Parameters

    • queryParameters: Record<string, string>

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

    Returns CreateRequestBuilder<EntityT>

    The request builder itself, to facilitate method chaining.

withCustomServicePath

  • deprecated

    Since version 1.34.0 Use setCustomServicePath instead. Replace the default service path with the given custom path. In case of the SAP S/4HANA APIs the servicePath defaults to /sap/opu/odata/sap/<SERVICE_NAME> and can be overwritten here.

    Parameters

    • servicePath: string

      Path to override the default with.

    Returns CreateRequestBuilder<EntityT>

    The request builder itself, to facilitate method chaining.

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