Class FunctionImportRequestBuilder<DeSerializersT, ParametersT, ReturnT>

Create OData request to execute a function import.

Type Parameters

  • DeSerializersT extends DeSerializers

  • ParametersT

    Type of the function import parameters.

  • ReturnT

    Type of the function import return value.

Hierarchy

Constructors

  • Creates an instance of FunctionImportRequestBuilder.

    Type Parameters

    • DeSerializersT extends DeSerializers<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, DeSerializersT>

    • ParametersT

    • ReturnT

    Parameters

    • method: RequestMethodType

      HTTP method to be used for the request.

    • defaultBasePath: string

      Default base path for the service the function belongs to.

    • functionImportName: string

      The name of the function import.

    • responseTransformer: ((data) => ReturnT)

      Transformation function for the response.

        • (data): ReturnT
        • Parameters

          • data: any

          Returns ReturnT

    • parameters: FunctionImportParameters<ParametersT>

      Parameters to be set in the function.

    • deSerializers: DeSerializersT

      (De-)serializers used for transformation.

    Returns FunctionImportRequestBuilder<DeSerializersT, ParametersT, ReturnT>

Properties

_deSerializers: DeSerializersT
requestConfig: ODataFunctionImportRequestConfig<DeSerializersT, ParametersT>
responseTransformer: ((data) => ReturnT)

Type declaration

    • (data): ReturnT
    • Parameters

      • data: any

      Returns ReturnT

Methods

  • 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 FunctionImportRequestBuilder<DeSerializersT, ParametersT, ReturnT>

    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: Record<string, string>

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

    Returns FunctionImportRequestBuilder<DeSerializersT, ParametersT, ReturnT>

    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

    • Rest ...path: string[]

      Path to be appended.

    Returns Omit<FunctionImportRequestBuilder<DeSerializersT, ParametersT, ReturnT>, "execute">

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

  • Execute request.

    Parameters

    • destination: HttpDestinationOrFetchOptions

      Destination or DestinationFetchOptions to execute the request against.

    • Optional dataAccessor: ((data) => any)

      A function to modify the received response data.

        • (data): any
        • Parameters

          • data: any

          Returns any

    Returns Promise<ReturnT>

    A promise resolving to the requested return type.

  • 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 FunctionImportRequestBuilder<DeSerializersT, ParametersT, ReturnT>

    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

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

    Parameters

    Returns Promise<string>

    Promise resolving to the URL for the request.

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