Type of the function import parameters
+Type of the function import return value
+Base class for function and actions imports
+Transformation function for the response.
+Request config for a action or function import.
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Execute request
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the requested return type
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+Create the relative URL based on configuration of the given builder.
+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 servicePath defaults to /sap/opu/odata/sap/<SERVICE_NAME>
and can be overwritten here.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Create an OData request to execute an action import.
+Type of the action import parameters
+Type of the action import return value
+Creates an instance of ActionImportRequestBuilder.
+Default path for the service the action belongs to
+The name of the action import.
+Transformation function for the response
+Parameters to be set in the action
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Execute request
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the requested return type
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+Create the relative URL based on configuration of the given builder.
+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 servicePath defaults to /sap/opu/odata/sap/<SERVICE_NAME>
and can be overwritten here.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Type of the entity the field belongs to
+Creates an instance of EdmTypeField.
+Actual name of the field used in the OData request.
+Constructor type of the entity the field belongs to.
+Type of the field according to the metadata description.
+Optional settings for this field.
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Representation of a batch change set, which holds a collection of write operations.
+Create an instance of BatchChangeSet.
+Requests to combine to one change set.
+Request boundary for separation of sub requests. Defaults to an auto generated value.
+Create a batch request to invoke multiple requests as a batch. The batch request builder accepts retrieve requests, i. e. getAll and getByKey requests and change sets, which in turn can contain create, update or delete requests. + The retrieve and change sets will be executed in order, while the order within a change set can vary.
+Creates an instance of ODataBatchRequestBuilder.
+Service path
+An array of retrieve requests or change sets
+A map that holds the entity type to constructor mapping
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+Create the relative URL based on configuration of the given builder.
+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 servicePath defaults to /sap/opu/odata/sap/<SERVICE_NAME>
and can be overwritten here.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Represents the state needed to deserialize a parsed batch response using OData version specific deserialization data access.
+Creates an instance of BatchResponseTransformer.
+A map that holds the entity type to constructor mapping.
+Response data access module.
+Entity deserializer.
+Deserialize the parsed batch response.
+Two dimensional list of parsed batch sub responses.
+An array of parsed sub responses of the batch response.
+Type of the entity the field belongs to
+Creates an instance of EdmTypeField.
+Actual name of the field used in the OData request.
+Constructor type of the entity the field belongs to.
+Type of the field according to the metadata description.
+Optional settings for this field.
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ge', i.e. >=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'gt', i.e. >
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'le', i.e. <=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'lt', i.e. <
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Type of the entity the field belongs to
+Creates an instance of EdmTypeField.
+Actual name of the field used in the OData request.
+Constructor type of the entity the field belongs to.
+Type of the field according to the metadata description.
+Optional settings for this field.
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Type of the entity the field belongs to
+Creates an instance of EdmTypeField.
+Actual name of the field used in the OData request.
+Constructor type of the entity the field belongs to.
+Type of the field according to the metadata description.
+Optional settings for this field.
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Type of the entity the field belongs to
+Creates an instance of EdmTypeField.
+Actual name of the field used in the OData request.
+Constructor type of the entity the field belongs to.
+Type of the field according to the metadata description.
+Optional settings for this field.
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Type of the entity the field belongs to
+Creates an instance of EdmTypeField.
+Actual name of the field used in the OData request.
+Constructor type of the entity the field belongs to.
+Type of the field according to the metadata description.
+Optional settings for this field.
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Representation of a filter function, that returns a value of type boolean.
+Creates an instance of BooleanFilterFunction.
+Name of the function that returns a boolean value
+Representation of the parameters passed to the filter function
+Creates an instance of Filter for this filter function and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this filter function and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Names of parents in case the function is part of a filter on a navigation property
+The filter function as string
+Representation of a cache to transiently store objects locally for faster access.
+Type of the cache entries.
+Clear all cached items.
+Getter of cached entries.
+The key of the entry to retrieve.
+The corresponding entry to the provided key if it is still valid, returns undefined
otherwise.
Specifies whether an entry with a given key is defined in cache.
+The entry's key
+boolean A boolean value that indicates whether the entry exists in cache
+Setter of entries in cache.
+The entry's key
+The entry to cache
+The time expressed in UTC in which the given entry expires
+Represents a field of an entity or a complex type, that can have a collection as value.
+Type of the entity the field belongs to.
+Type of of elements of the collection. This can either be an EDM type or complex type.
+Boolean type that represents whether the field is nullable.
+Boolean type that represents whether the field is selectable.
+Creates an instance of CollectionField.
+Actual name of the field used in the OData request.
+The constructor of the entity or the complex type field this field belongs to.
+Edm type of the field according to the metadata description.
+Optional settings for this field.
+Gets the path to the complex type property represented by this.
+The path to the complex type property.
+Type of the entity the field belongs to
+Creates an instance of ComplexTypeAnyPropertyField.
+Actual name of the field used in the OData request
+The constructor of the entity or the complex type this field belongs to
+Type of the field according to the metadata description
+The constructor of the entity or the complex type this field belongs to
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries. Combines the parent complex type name with the field name.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Type of the entity the field belongs to
+Creates an instance of ComplexTypeBigNumberPropertyField.
+Actual name of the field used in the OData request
+The constructor of the entity or the complex type this field belongs to
+Type of the field according to the metadata description
+Creates an instance of ComplexTypeBigNumberPropertyField.
+Actual name of the field used in the OData request
+Constructor type of the entity the field belongs to
+Name of the parent complex type
+Type of the field according to the metadata description
+The constructor of the entity or the complex type this field belongs to
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries. Combines the parent complex type name with the field name.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ge', i.e. >=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'gt', i.e. >
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'le', i.e. <=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'lt', i.e. <
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Type of the entity the field belongs to
+Creates an instance of ComplexTypeBinaryPropertyField.
+Actual name of the field used in the OData request
+The constructor of the entity or the complex type this field belongs to
+Type of the field according to the metadata description
+Creates an instance of ComplexTypeBinaryPropertyField.
+Actual name of the field used in the OData request
+Constructor type of the entity the field belongs to
+Name of the parent complex type
+Type of the field according to the metadata description
+The constructor of the entity or the complex type this field belongs to
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries. Combines the parent complex type name with the field name.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Type of the entity the field belongs to
+Creates an instance of ComplexTypeBooleanPropertyField.
+Actual name of the field used in the OData request
+The constructor of the entity or the complex type this field belongs to
+Type of the field according to the metadata description
+Creates an instance of ComplexTypeBooleanPropertyField.
+Actual name of the field used in the OData request
+Constructor type of the entity the field belongs to
+Name of the parent complex type
+Type of the field according to the metadata description
+The constructor of the entity or the complex type this field belongs to
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries. Combines the parent complex type name with the field name.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Type of the entity the field belongs to
+Creates an instance of ComplexTypeDatePropertyField.
+Actual name of the field used in the OData request
+The constructor of the entity or the complex type this field belongs to
+Type of the field according to the metadata description
+Creates an instance of ComplexTypeDatePropertyField.
+Actual name of the field used in the OData request
+Constructor type of the entity the field belongs to
+Name of the parent complex type
+Type of the field according to the metadata description
+The constructor of the entity or the complex type this field belongs to
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries. Combines the parent complex type name with the field name.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ge', i.e. >=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'gt', i.e. >
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'le', i.e. <=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'lt', i.e. <
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Type of the entity the field belongs to
+Creates an instance of ComplexTypeDurationPropertyField.
+Actual name of the field used in the OData request
+The constructor of the entity or the complex type this field belongs to
+Type of the field according to the metadata description
+Creates an instance of ComplexTypeDurationPropertyField.
+Actual name of the field used in the OData request
+Constructor type of the entity the field belongs to
+Name of the parent complex type
+Type of the field according to the metadata description
+The constructor of the entity or the complex type this field belongs to
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries. Combines the parent complex type name with the field name.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ge', i.e. >=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'gt', i.e. >
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'le', i.e. <=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'lt', i.e. <
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Type of the entity the field belongs to
+Creates an instance of ComplexTypeEnumPropertyField.
+Actual name of the field used in the OData request
+The constructor of the entity or the complex type this field belongs to
+The constructor of the entity or the complex type this field belongs to
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries. Combines the parent complex type name with the field name.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Represents a complex type property of an entity or a complex type.
+ComplexTypeField
s are used as static properties of entities and are generated from the metadata, i.e. for each property of
+ an OData entity, that has a complex type, there exists one static instance of ComplexTypeField
(or rather one of its subclasses) in the corresponding generated class file.
+ ComplexTypeField
s are used to represent the domain of complex or custom structures that can be used in select, filter and order by functions.
+ For example, when constructing a query on the TimeSheetEntry entity, an instance of ComplexTypeField<TimeSheetEntry>
+ can be supplied as argument to the select function, e.g. TimeSheetEntry.TIME_SHEET_DATA_FIELDS
.
+ Moreover, classes implementing this abstract class will provide property fields, that can be used for filtering and ordering.
See also: Selectable
+Type of the entity the field belongs to.
+Type of complex type represented by this field.
+Boolean type that represents whether the field is nullable.
+Boolean type that represents whether the field is selectable.
+Actual name of the field as used in the OData request.
+Constructor type of the entity the field belongs to.
+Name of the type of the field according to the metadata description.
+Actual name of the field as used in the OData request.
+Either the parent entity constructor of the parent complex type this field belongs to.
+Creates an instance of ComplexTypeField.
+Actual name of the field as used in the OData request.
+Either the parent entity constructor of the parent complex type this field belongs to.
+The complex type of the complex type property represented by this.
+Optional settings for this field.
+The complex type of the complex type property represented by this.
+Gets the path to the complex type property represented by this.
+The path to the complex type property.
+Type of the entity the field belongs to
+Creates an instance of ComplexTypeNumberPropertyField.
+Actual name of the field used in the OData request
+The constructor of the entity or the complex type this field belongs to
+Type of the field according to the metadata description
+Creates an instance of ComplexTypeNumberPropertyField.
+Actual name of the field used in the OData request
+Constructor type of the entity the field belongs to
+Name of the parent complex type
+Type of the field according to the metadata description
+The constructor of the entity or the complex type this field belongs to
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries. Combines the parent complex type name with the field name.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ge', i.e. >=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'gt', i.e. >
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'le', i.e. <=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'lt', i.e. <
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Type of the entity the field belongs to
+Creates an instance of ComplexTypeStringPropertyField.
+Actual name of the field used in the OData request
+The constructor of the entity or the complex type this field belongs to
+Type of the field according to the metadata description
+Creates an instance of ComplexTypeStringPropertyField.
+Actual name of the field used in the OData request
+Constructor type of the entity the field belongs to
+Name of the parent complex type
+Type of the field according to the metadata description
+The constructor of the entity or the complex type this field belongs to
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries. Combines the parent complex type name with the field name.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Type of the entity the field belongs to
+Creates an instance of ComplexTypeTimePropertyField.
+Actual name of the field used in the OData request
+The constructor of the entity or the complex type this field belongs to
+Type of the field according to the metadata description
+Creates an instance of ComplexTypeTimePropertyField.
+Actual name of the field used in the OData request
+Constructor type of the entity the field belongs to
+Name of the parent complex type
+Type of the field according to the metadata description
+The constructor of the entity or the complex type this field belongs to
+Path to the field to be used in filter and order by queries. Combines the parent complex type name with the field name.
+Path to the field to be used in filter and order by queries.
+Create an OData request to count entities based on the configuration of the request.
+ A CountRequestBuilder
allows only for execution of the request.
+ If you want to apply query parameters like filter, skip or top do it on the GetAllRequestBuilder the count is created from.
Type of the entity to be requested
+Creates an instance of CountRequestBuilder.
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Execute request.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the number of entities
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+Create the relative URL based on configuration of the given builder.
+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 servicePath defaults to /sap/opu/odata/sap/<SERVICE_NAME>
and can be overwritten here.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Create OData request to create an entity.
+Type of the entity to be created
+Creates an instance of CreateRequestBuilder.
+Constructor type of the entity to be created
+Entity to be created
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Specifies the parent of the entity to create.
+Parent of the entity to create
+Static representation of the navigation property that navigates from the parent entity to the child entity
+The entity itself, to facilitate method chaining
+Execute query.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the created entity
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+the builder itself
+Create the relative URL based on configuration of the given builder.
+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 servicePath defaults to /sap/opu/odata/sap/<SERVICE_NAME>
and can be overwritten here.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Abstract create request class holding the parts shared in OData v2 and v4.
+Type of the entity to be created
+Creates an instance of CreateRequestBuilder.
+Constructor type of the entity to be created
+Entity to be created
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Specifies the parent of the entity to create.
+Parent of the entity to create
+Static representation of the navigation property that navigates from the parent entity to the child entity
+The entity itself, to facilitate method chaining
+Execute query.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the created entity
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+the builder itself
+Create the relative URL based on configuration of the given builder.
+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 servicePath defaults to /sap/opu/odata/sap/<SERVICE_NAME>
and can be overwritten here.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Create OData request to create an entity.
+Type of the entity to be created
+Creates an instance of CreateRequestBuilder.
+Constructor type of the entity to be created
+Entity to be created
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Specifies the parent of the entity to create.
+Parent of the entity to create
+Static representation of the navigation property that navigates from the parent entity to the child entity
+The entity itself, to facilitate method chaining
+Execute query.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the created entity
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+the builder itself
+Create the relative URL based on configuration of the given builder.
+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 servicePath defaults to /sap/opu/odata/sap/<SERVICE_NAME>
and can be overwritten here.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Type of the entity the field belongs to
+Creates an instance of EdmTypeField.
+Actual name of the field used in the OData request.
+Constructor type of the entity the field belongs to.
+Type of the field according to the metadata description.
+Optional settings for this field.
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ge', i.e. >=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'gt', i.e. >
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'le', i.e. <=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'lt', i.e. <
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Type of the entity the field belongs to
+Creates an instance of EdmTypeField.
+Actual name of the field used in the OData request.
+Constructor type of the entity the field belongs to.
+Type of the field according to the metadata description.
+Optional settings for this field.
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ge', i.e. >=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'gt', i.e. >
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'le', i.e. <=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'lt', i.e. <
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Create OData query to delete an entity.
+Type of the entity to be deleted
+Creates an instance of DeleteRequestBuilder. If the entity is passed, version identifier will also be added.
+Constructor type of the entity to be deleted
+Entity or Key-value pairs of key properties for the given entity
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Execute query.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving once the entity was deleted
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+Instructs the request to force an overwrite of the entity by sending an 'If-Match: *' header instead of sending the ETag version identifier.
+this The request itself to ease chaining while executing the request
+Create the relative URL based on configuration of the given builder.
+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 servicePath defaults to /sap/opu/odata/sap/<SERVICE_NAME>
and can be overwritten here.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Add an eTag version identifier in the delete request header.
+The version identifier of the entity
+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.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Abstract class to delete an entity holding the shared parts between OData v2 and v4
+Type of the entity to be deleted
+Creates an instance of DeleteRequestBuilder. If the entity is passed, version identifier will also be added.
+Constructor type of the entity to be deleted
+ODataUri conversion interface at runtime either v2 or v4
+Entity or Key-value pairs of key properties for the given entity
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Execute query.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving once the entity was deleted
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+Instructs the request to force an overwrite of the entity by sending an 'If-Match: *' header instead of sending the ETag version identifier.
+this The request itself to ease chaining while executing the request
+Create the relative URL based on configuration of the given builder.
+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 servicePath defaults to /sap/opu/odata/sap/<SERVICE_NAME>
and can be overwritten here.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Create OData query to delete an entity.
+Type of the entity to be deleted
+Creates an instance of DeleteRequestBuilder. If the entity is passed, version identifier will also be added.
+Constructor type of the entity to be deleted
+Entity or Key-value pairs of key properties for the given entity
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Execute query.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving once the entity was deleted
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+Instructs the request to force an overwrite of the entity by sending an 'If-Match: *' header instead of sending the ETag version identifier.
+this The request itself to ease chaining while executing the request
+Create the relative URL based on configuration of the given builder.
+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 servicePath defaults to /sap/opu/odata/sap/<SERVICE_NAME>
and can be overwritten here.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Add ETag version identifier in the delete request header.
+The version identifier of the entity.
+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.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Type of the entity the field belongs to
+Creates an instance of EdmTypeField.
+Actual name of the field used in the OData request.
+Constructor type of the entity the field belongs to.
+Type of the field according to the metadata description.
+Optional settings for this field.
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ge', i.e. >=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'gt', i.e. >
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'le', i.e. <=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'lt', i.e. <
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Type of the entity the field belongs to
+Creates an instance of EdmTypeField.
+Actual name of the field used in the OData request.
+Constructor type of the entity the field belongs to.
+Type of the field according to the metadata description.
+Optional settings for this field.
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ge', i.e. >=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'gt', i.e. >
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'le', i.e. <=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'lt', i.e. <
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Represents a property of an OData entity with an EDM type.
+EdmTypeField
s are used as static properties of entities or EDM typed fields of complex type fields. They are generated from the OData metadata, i.e. for each property of
+ an OData entity, that has an EDM type, there is one static instance of EdmTypeField
(or rather one of its subclasses) in the corresponding generated class file.
+ EdmTypeField
s are used to represent the domain of more or less primitive values that can be used in select, filter and order by functions.
+ For example, when constructing a query on the BusinessPartner entity, an instance of EdmTypeField<BusinessPartner, string>
+ can be supplied as argument to the select function, e.g. BusinessPartner.FIRST_NAME
.
See also: Selectable
+Type of the entity the field belongs to
+EDM type of the field. Deprecated: Field type of the field.
+Boolean type that represents whether the field is nullable.
+Boolean type that represents whether the field is selectable.
+Creates an instance of EdmTypeField.
+Actual name of the field used in the OData request.
+Constructor type of the entity the field belongs to.
+Type of the field according to the metadata description.
+Optional settings for this field.
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Super class for all representations of OData v2 entity types.
+A mapper representing custom fields in an entity. + Custom fields are represented by their field names and the corresponding values. + A custom field can be added or updated using setCustomField method.
+The current ETag version of the entity in the remote system. + The ETag identified the version of the in the remote system. It will be automatically set in the "if-match" header of update requests and can be set as a custom header for delete requests. + When no ETag is provided by the remote system the value of this variable defaults to "*".
+The remote state of the entity. + Remote state refers to the last known state of the entity on the remote system from which it has been retrieved or to which it has been posted. + It is stored as map, where the keys are stored in the format of the original OData properties.
+ETag version identifier accessor.
+The ETag version identifier of the retrieved entity, returns undefined
if not retrieved.
Creates an object containing all defined properties, navigation properties and custom fields in the entity.
+List of entities to check in case of circular dependencies.
+Entity as an object with all defined entity fields
+List of entities to check in case of circular dependencies.
+Entity with all defined entity fields
+Custom field value getter.
+The name of the custom field
+The value of the corresponding custom field
+Returns a map that contains all entity custom fields.
+A map of all defined custom fields in the entity
+Returns all updated custom field properties compared to the last known remote state.
+An object containing all updated custom properties, with their new values.
+Returns all changed properties compared to the last known remote state. + The returned properties do not include custom fields. + Use getUpdatedCustomFields, if you need custom fields.
+Entity with all properties that changed
+Returns all changed property names compared to the last known remote state. + The returned properties names do not include custom fields. + Use getUpdatedCustomFields, if you need custom fields.
+Entity with all properties that changed
+Validates whether a custom field exists in the entity.
+The name of the custom field to update
+A boolean value, that indicates whether a custom field is defined in entity
+Extracted custom fields from a retrieved entity.
+The entity itself, to facilitate method chaining.
+Validates whether a field name does not conflict with an original field name and thus can be defined as custom fields.
+Field name to check
+Boolean value that describes whether a field name can be defined as custom field
+Sets a new custom field in the entity or updates it. + Throws an error, if the provided custom field name is already defined by an original field in entity.
+The name of the custom field to update
+The value of the field
+The entity itself, to facilitate method chaining
+Sets custom fields on an entity.
+Custom fields to set on the entity.
+The entity itself, to facilitate method chaining
+State to be set as remote state.
+The entity itself, to facilitate method chaining
+Set the ETag version identifier of the retrieved entity.
+The returned ETag version of the entity.
+The entity itself, to facilitate method chaining.
+Super class for all representations of OData entity types.
+A mapper representing custom fields in an entity. + Custom fields are represented by their field names and the corresponding values. + A custom field can be added or updated using setCustomField method.
+The current ETag version of the entity in the remote system. + The ETag identified the version of the in the remote system. It will be automatically set in the "if-match" header of update requests and can be set as a custom header for delete requests. + When no ETag is provided by the remote system the value of this variable defaults to "*".
+The remote state of the entity. + Remote state refers to the last known state of the entity on the remote system from which it has been retrieved or to which it has been posted. + It is stored as map, where the keys are stored in the format of the original OData properties.
+ETag version identifier accessor.
+The ETag version identifier of the retrieved entity, returns undefined
if not retrieved.
Creates an object containing all defined properties, navigation properties and custom fields in the entity.
+List of entities to check in case of circular dependencies.
+Entity as an object with all defined entity fields
+List of entities to check in case of circular dependencies.
+Entity with all defined entity fields
+Custom field value getter.
+The name of the custom field
+The value of the corresponding custom field
+Returns a map that contains all entity custom fields.
+A map of all defined custom fields in the entity
+Returns all updated custom field properties compared to the last known remote state.
+An object containing all updated custom properties, with their new values.
+Returns all changed properties compared to the last known remote state. + The returned properties do not include custom fields. + Use getUpdatedCustomFields, if you need custom fields.
+Entity with all properties that changed
+Returns all changed property names compared to the last known remote state. + The returned properties names do not include custom fields. + Use getUpdatedCustomFields, if you need custom fields.
+Entity with all properties that changed
+Validates whether a custom field exists in the entity.
+The name of the custom field to update
+A boolean value, that indicates whether a custom field is defined in entity
+Extracted custom fields from a retrieved entity.
+The entity itself, to facilitate method chaining.
+Validates whether a field name does not conflict with an original field name and thus can be defined as custom fields.
+Field name to check
+Boolean value that describes whether a field name can be defined as custom field
+Sets a new custom field in the entity or updates it. + Throws an error, if the provided custom field name is already defined by an original field in entity.
+The name of the custom field to update
+The value of the field
+The entity itself, to facilitate method chaining
+Sets custom fields on an entity.
+Custom fields to set on the entity.
+The entity itself, to facilitate method chaining
+State to be set as remote state.
+The entity itself, to facilitate method chaining
+Set the ETag version identifier of the retrieved entity.
+The returned ETag version of the entity.
+The entity itself, to facilitate method chaining.
+Super class for all representations of OData v4 entity types.
+A mapper representing custom fields in an entity. + Custom fields are represented by their field names and the corresponding values. + A custom field can be added or updated using setCustomField method.
+The current ETag version of the entity in the remote system. + The ETag identified the version of the in the remote system. It will be automatically set in the "if-match" header of update requests and can be set as a custom header for delete requests. + When no ETag is provided by the remote system the value of this variable defaults to "*".
+The remote state of the entity. + Remote state refers to the last known state of the entity on the remote system from which it has been retrieved or to which it has been posted. + It is stored as map, where the keys are stored in the format of the original OData properties.
+ETag version identifier accessor.
+The ETag version identifier of the retrieved entity, returns undefined
if not retrieved.
Creates an object containing all defined properties, navigation properties and custom fields in the entity.
+List of entities to check in case of circular dependencies.
+Entity as an object with all defined entity fields
+List of entities to check in case of circular dependencies.
+Entity with all defined entity fields
+Custom field value getter.
+The name of the custom field
+The value of the corresponding custom field
+Returns a map that contains all entity custom fields.
+A map of all defined custom fields in the entity
+Returns all updated custom field properties compared to the last known remote state.
+An object containing all updated custom properties, with their new values.
+Returns all changed properties compared to the last known remote state. + The returned properties do not include custom fields. + Use getUpdatedCustomFields, if you need custom fields.
+Entity with all properties that changed
+Returns all changed property names compared to the last known remote state. + The returned properties names do not include custom fields. + Use getUpdatedCustomFields, if you need custom fields.
+Entity with all properties that changed
+Validates whether a custom field exists in the entity.
+The name of the custom field to update
+A boolean value, that indicates whether a custom field is defined in entity
+Extracted custom fields from a retrieved entity.
+The entity itself, to facilitate method chaining.
+Validates whether a field name does not conflict with an original field name and thus can be defined as custom fields.
+Field name to check
+Boolean value that describes whether a field name can be defined as custom field
+Sets a new custom field in the entity or updates it. + Throws an error, if the provided custom field name is already defined by an original field in entity.
+The name of the custom field to update
+The value of the field
+The entity itself, to facilitate method chaining
+Sets custom fields on an entity.
+Custom fields to set on the entity.
+The entity itself, to facilitate method chaining
+State to be set as remote state.
+The entity itself, to facilitate method chaining
+Set the ETag version identifier of the retrieved entity.
+The returned ETag version of the entity.
+The entity itself, to facilitate method chaining.
+Represents a property with an enum value.
+Type of the entity the field belongs to.
+Enum type that contains all valid enum entries for this field.
+Boolean type that represents whether the field is nullable.
+Boolean type that represents whether the field is selectable.
+Creates an instance of EnumField.
+Actual name of the field used in the OData request.
+The constructor of the entity or the complex type field this field belongs to.
+Enum type of the field according to the metadata description.
+Optional settings for this field.
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Gets the path to the complex type property represented by this.
+The path to the complex type property.
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Abstract representation a property of an OData entity.
+Field
s are used as static properties of entities or properties of ComplexTypeFields and are generated from the metadata, i.e. for each property of
+ an OData entity, there exists one static instance of Field
(or rather one of its subclasses) in the corresponding generated class file.
+ Fields are used to represent the domain of values that can be used in select, filter and order by functions.
See also: Selectable, EdmTypeField, ComplexTypeField
+Type of the entity the field belongs to.
+Boolean type that represents whether the field is nullable.
+Boolean type that represents whether the field is selectable.
+Creates an instance of Field.
+Actual name of the field used in the OData request
+Constructor type of the entity the field belongs to
+Optional settings for this field.
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Field builder to orchestrate the creation of the different kinds of fields.
+Type of the entity or complex type field this field belongs to.
+Creates an instance of FieldBuilder
.
Entity or complex type field, for which the field builder shall create fields.
+Build a field for a property with a collection type. + The type of the field can either be an EDM type or a complex type. + Fields of entities are selectable; fields of complex types are not selectable.
+Name of the field.
+Type of the collection. Can either be an EDM type or complex type (not complex type field).
+Whether the field is nullable.
+A collection field with the given collection type.
+Build a field for a property with a complex type. + Fields of entities are selectable; fields of complex types are not selectable.
+Name of the field.
+Constructor of the complex type field.
+Whether the field is nullable.
+A complex type field of the given type.
+Build a field for a property with a enum type.
+Name of the field.
+Enum type of this field.
+Whether the field is nullable.
+A collection field with the given collection type.
+Represents a filter expression to narrow the data on a GetAllRequestBuilder request for multiple entities that match the specified criteria.
+ A filter refers to the field of an entity and restricts the request based on an operator and a value. Entity.FIELD_NAME.operator(value)
Example: Product.NAME.equals('cloud-sdk')
creates a filter for the entity Product
that matches in case the field NAME
equals 'cloud-sdk'.
See also: Filterable
+Type of the entity to be filtered on
+Type of the field to be filtered by, see also: FieldType
+Creates an instance of Filter.
+Name of the field of the entity to be filtered on or a filter function
+Function to be used for matching
+Value to be used by the operator
+EDM type of the field to filter on, needed for custom fields
+Entity type of the entity tp be filtered.
+Constructor type of the entity to be filtered.
+Data structure to represent OData filter functions.
+ Use the factory function filterFunction to create instances of FilterFunction
.
Creates an instance of FilterFunction.
+Name of the function.
+Representation of the parameters passed to the filter function.
+EDM type of the return type of the filter function.
+Creates an instance of Filter for this filter function and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this filter function and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Names of parents in case the function is part of a filter on a navigation property
+The filter function as string
+hidden
+Data structure to represent filter on properties of a navigation property (link). + In OData v2 filtering for navigation properties is ONLY supported for properties with a one-to-one cardinality (OneToOneLink).
+Example:
+ In the following filter statement Entity.requestBuilder().filter(Entity.to_NavProperty.filter(LinkedEntity.property.equals(value)))
,
+ Entity.to_NavProperty.filter(LinkedEntity.property.equals(value))
is a FilterLink
.
In OData v4 filtering is also possible on one-to-many links. See OneToManyLink.
+Type of the entity to be filtered.
+Type of the linked entity which is used in the filter.
+Creates an instance of FilterLink
.
Linked entity to be used in the filter.
+List of filterables for the linked entity.
+Entity type of the entity tp be filtered.
+Constructor type of the entity to be filtered.
+Linked entity to be filtered by.
+Data structure to combine Filterables conjunctively and / or disjunctively. A FilterList matches when all filterables within the andFilters
match and when at least one filterable within the orFilters
matches. Should not be used directly.
-
+Creates an instance of FilterList.
+Filters to be combined by logical conjunction (and
)
Filters to be combined by logical disjunction (or
)
Entity type of the entity tp be filtered.
+Constructor type of the entity to be filtered.
+Flattened filter list.
+Internal representation of function import parameters. It adds metadata to the value.
+Type of the value
+Creates an instance of FunctionImportParameter.
+The original name of the parameter in the OData service.
+Original EDM type.
+Value to be used as parameter.
+Create OData request to execute a function import.
+Type of the function import parameters
+Type of the function import return value
+Creates an instance of FunctionImportRequestBuilder.
+HTTP method to be used for the request
+Default path for the service the function belongs to
+The name of the function import.
+Transformation function for the response
+Parameters to be set in the function
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Execute request
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the requested return type
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+Create the relative URL based on configuration of the given builder.
+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 servicePath defaults to /sap/opu/odata/sap/<SERVICE_NAME>
and can be overwritten here.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Create OData request to execute a function import.
+Type of the function import parameters
+Type of the function import return value
+Creates an instance of FunctionImportRequestBuilder.
+Default path for the service the function belongs to
+The name of the function import.
+Transformation function for the response
+Parameters to be set in the function
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Execute request
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the requested return type
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+Create the relative URL based on configuration of the given builder.
+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 servicePath defaults to /sap/opu/odata/sap/<SERVICE_NAME>
and can be overwritten here.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Creates an instance of GetAllRequestBuilder.
+Constructor of the entity to create the request for
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Count the number of entities.
+A count request builder for execution
+Execute request.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the requested entities
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+Add filter statements to the request.
+Filter expressions to restrict the response
+The request builder itself, to facilitate method chaining
+Add order-by statements to the request.
+OrderBy statements to order the response by
+The request builder itself, to facilitate method chaining
+Create the relative URL based on configuration of the given builder.
+The relative URL for the request
+Restrict the response to the given selection of properties in the request.
+Fields to select in the request
+The request builder itself, to facilitate method chaining
+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.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Skip number of entities.
+Number of matching entities to skip. Useful for paging
+The request builder itself, to facilitate method chaining
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Limit number of returned entities.
+Maximum number of entities to return in the response. Can be less, if less entities match the request
+The request builder itself, to facilitate method chaining
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Base class for the get all request builders GetAllRequestBuilderV2 and GetAllRequestBuilderV4
+Type of the entity to be requested
+Creates an instance of GetAllRequestBuilder.
+Constructor of the entity to create the request for
+Request config of the get all request.
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Count the number of entities.
+A count request builder for execution
+Execute request.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the requested entities
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+Add order-by statements to the request.
+OrderBy statements to order the response by
+The request builder itself, to facilitate method chaining
+Create the relative URL based on configuration of the given builder.
+The relative URL for the request
+Restrict the response to the given selection of properties in the request.
+Fields to select in the request
+The request builder itself, to facilitate method chaining
+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.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Skip number of entities.
+Number of matching entities to skip. Useful for paging
+The request builder itself, to facilitate method chaining
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Limit number of returned entities.
+Maximum number of entities to return in the response. Can be less, if less entities match the request
+The request builder itself, to facilitate method chaining
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Creates an instance of GetAllRequestBuilder.
+Constructor of the entity to create the request for
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Count the number of entities.
+A count request builder for execution
+Execute request.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the requested entities
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+Add filter statements to the request.
+Filter expressions to restrict the response
+The request builder itself, to facilitate method chaining
+Add order-by statements to the request.
+OrderBy statements to order the response by
+The request builder itself, to facilitate method chaining
+Create the relative URL based on configuration of the given builder.
+The relative URL for the request
+Restrict the response to the given selection of properties in the request.
+Fields to select in the request
+The request builder itself, to facilitate method chaining
+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.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Skip number of entities.
+Number of matching entities to skip. Useful for paging
+The request builder itself, to facilitate method chaining
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Limit number of returned entities.
+Maximum number of entities to return in the response. Can be less, if less entities match the request
+The request builder itself, to facilitate method chaining
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Create an OData request to get a single entity based on its key properties. + The properties available in the response can be restricted by creating a selection, where no selection is equal to selecting all fields. + Note that navigational properties are automatically expanded if they included in a select.
+Type of the entity to be requested
+Creates an instance of GetByKeyRequestBuilder.
+Constructor of the entity to create the request for
+Key-value pairs where the key is the name of a key property of the given entity and the value is the respective value
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Execute request.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the requested entity
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+Create the relative URL based on configuration of the given builder.
+The relative URL for the request
+Restrict the response to the given selection of properties in the request.
+Fields to select in the request
+The request builder itself, to facilitate method chaining
+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.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Abstract class to create a get by key request containing the shared functionality for OData v2 and v4.
+Type of the entity to be requested
+Creates an instance of GetByKeyRequestBuilder.
+Constructor of the entity to create the request for
+Key-value pairs where the key is the name of a key property of the given entity and the value is the respective value
+Uri conversion methods
+Entity deserializer
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Execute request.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the requested entity
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+Create the relative URL based on configuration of the given builder.
+The relative URL for the request
+Restrict the response to the given selection of properties in the request.
+Fields to select in the request
+The request builder itself, to facilitate method chaining
+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.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Create an OData request to get a single entity based on its key properties. + The properties available in the response can be restricted by creating a selection, where no selection is equal to selecting all fields of the entity. + Navigational properties need to expanded explicitly by GetAllRequestBuilderV4.expand. + where no selection is equal to selecting all fields.
+Type of the entity to be requested
+Creates an instance of GetByKeyRequestBuilder.
+Constructor of the entity to create the request for
+Key-value pairs where the key is the name of a key property of the given entity and the value is the respective value
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Execute request.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the requested entity
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+Create the relative URL based on configuration of the given builder.
+The relative URL for the request
+Restrict the response to the given selection of properties in the request.
+Fields to select in the request
+The request builder itself, to facilitate method chaining
+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.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Represents a navigation property of an OData entity.
+OData is a relational data model, i.e. entities can be related to one another.
+ For example, BusinessPartner is in a 1:n relation with BusinessPartnerAddress and in a 1:1 relation with Customer.
+ Like normal properties, navigation properties can be used for selecting (expanding) and filtering.
+ For example, when constructing a query on the BusinessPartner entity, an instance of Link<BusinessPartner, Customer>
+ can be passed as argument to the select function, e.g. BusinessPartner.TO_CUSTOMER
.
NOTE: Due to historical development the Link and its extensions are used in the following way: + OData v2 entity: 1:N is a Link, 1:0..1 is a OneToOneLink + OData v4 entity: 1:N is a OneToManyLink, 1:0..1 is a OneToOneLink
+See also: Selectable
+Type of the entity to be linked from
+Type of the entity to be linked to
+Creates an instance of Link.
+Name of the linking field to be used in the OData request.
+Constructor type of the entity the field belongs to
+Constructor type of the linked entity
+List of selectables on the linked entity.
+Create a new link based on a given link.
+Newly created link
+Creates a selection on a linked entity. Has the same behavior as GetAllRequestBuilderV2.select and GetByKeyRequestBuilderV4.select but for linked entities.
+See also, Selectable
+Selection of fields or links on a linked entity
+The link itself, to facilitate method chaining
+Link to be cloned
+Newly created link
+Base class for all request builders.
+Creates an instance of MethodRequestBuilder.
+Request configuration to initialize with.
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Create the relative URL based on configuration of the given builder.
+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 servicePath defaults to /sap/opu/odata/sap/<SERVICE_NAME>
and can be overwritten here.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Type of the entity the field belongs to
+Creates an instance of EdmTypeField.
+Actual name of the field used in the OData request.
+Constructor type of the entity the field belongs to.
+Type of the field according to the metadata description.
+Optional settings for this field.
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ge', i.e. >=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'gt', i.e. >
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'le', i.e. <=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'lt', i.e. <
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Type of the entity the field belongs to
+Creates an instance of EdmTypeField.
+Actual name of the field used in the OData request.
+Constructor type of the entity the field belongs to.
+Type of the field according to the metadata description.
+Optional settings for this field.
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ge', i.e. >=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'gt', i.e. >
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'le', i.e. <=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'lt', i.e. <
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Representation of a filter function, that returns a value of type number. This supports int, double and decimal values.
+Creates an instance of NumberFilterFunction.
+Name of the function that returns a numeric value
+Representation of the parameters passed to the filter function
+Type of the returned numeric value. This influences the formatting of the returned value.
+Creates an instance of Filter for this filter function and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this filter function and the given value using the operator 'ge', i.e. >=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this filter function and the given value using the operator 'gt', i.e. >
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this filter function and the given value using the operator 'le', i.e. <=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this filter function and the given value using the operator 'lt', i.e. <
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this filter function and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Names of parents in case the function is part of a filter on a navigation property
+The filter function as string
+Creates an instance of ODataActionImportRequestConfig.
+Default path of the service
+The name of the action import.
+Parameters of the action imports
+Add custom headers to the request. This is useful in case you want to provide your own authorization headers for example.
+Key-value pairs where the key is the name of a header property and the value is the respective value
+Add custom query parameters to the request. This is useful in case your OData service allows non-standard query parameters.
+Key-value pairs where the key is the name of a query parameter and the value is the respective value
+Add custom request configuration to the request.
+Key-value pairs where the key is the name of a request configuration and the value is the respective value
+Create an instance of ODataBatchChangeSet.
+Requests to combine to one change set.
+Boundary used in the multipart request.
+Create an instance of ODataBatchChangeSet.
+Requests to combine to one change set.
+Boundary used in the multipart request.
+The default OData service path
+The batch id for building the header and the payload.
+Add custom headers to the request. This is useful in case you want to provide your own authorization headers for example.
+Key-value pairs where the key is the name of a header property and the value is the respective value
+Add custom query parameters to the request. This is useful in case your OData service allows non-standard query parameters.
+Key-value pairs where the key is the name of a query parameter and the value is the respective value
+Add custom request configuration to the request.
+Key-value pairs where the key is the name of a request configuration and the value is the respective value
+Create a batch request to invoke multiple requests as a batch. The batch request builder accepts retrieve requests, i. e. getAll and getByKey requests and change sets, which in turn can contain create, update or delete requests. + The retrieve and change sets will be executed in order, while the order within a change set can vary.
+Creates an instance of ODataBatchRequestBuilder.
+Service path
+An array of retrieve requests or change sets
+A map that holds the entity type to constructor mapping
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Execute the given request and return the according promise. Please notice: The sub-requests may fail even the main request is successful.
+Targeted destination on which the request is performed.
+Options to employ when fetching destinations.
+Promise resolving to the requested data.
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+Create the relative URL based on configuration of the given builder.
+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 servicePath defaults to /sap/opu/odata/sap/<SERVICE_NAME>
and can be overwritten here.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Create a batch request to invoke multiple requests as a batch. The batch request builder accepts retrieve requests, i. e. getAll and getByKey requests and change sets, which in turn can contain create, update or delete requests. + The retrieve and change sets will be executed in order, while the order within a change set can vary.
+Creates an instance of ODataBatchRequestBuilder.
+Service path
+An array of retrieve requests or change sets
+A map that holds the entity type to constructor mapping
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Execute the given request and return the according promise. Please notice: The sub-requests may fail even the main request is successful.
+Targeted destination on which the request is performed.
+Options to employ when fetching destinations.
+Promise resolving to the requested data.
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+Create the relative URL based on configuration of the given builder.
+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 servicePath defaults to /sap/opu/odata/sap/<SERVICE_NAME>
and can be overwritten here.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Creates an instance of ODataBatchRequestConfig.
+The default OData service path
+Request boundary for separation of subrequests. Defaults to an autogenerated value.
+Add custom headers to the request. This is useful in case you want to provide your own authorization headers for example.
+Key-value pairs where the key is the name of a header property and the value is the respective value
+Add custom query parameters to the request. This is useful in case your OData service allows non-standard query parameters.
+Key-value pairs where the key is the name of a query parameter and the value is the respective value
+Add custom request configuration to the request.
+Key-value pairs where the key is the name of a request configuration and the value is the respective value
+OData create request configuration for an entity type.
+Type of the entity to setup a request for
+Creates an instance of ODataRequest.
+Constructor type of the entity to create a configuration for
+Field that links the parent entity class to the child entity class.
+Keys of the parent of the entity to create. Defined only when attempting to create child entities.
+Add custom headers to the request. This is useful in case you want to provide your own authorization headers for example.
+Key-value pairs where the key is the name of a header property and the value is the respective value
+Add custom query parameters to the request. This is useful in case your OData service allows non-standard query parameters.
+Key-value pairs where the key is the name of a query parameter and the value is the respective value
+Add custom request configuration to the request.
+Key-value pairs where the key is the name of a request configuration and the value is the respective value
+Type of the entity to setup a request for
+Creates an instance of ODataRequest.
+Constructor type of the entity to create a configuration for
+Field that links the parent entity class to the child entity class.
+Keys of the parent of the entity to create. Defined only when attempting to create child entities.
+Add custom headers to the request. This is useful in case you want to provide your own authorization headers for example.
+Key-value pairs where the key is the name of a header property and the value is the respective value
+Add custom query parameters to the request. This is useful in case your OData service allows non-standard query parameters.
+Key-value pairs where the key is the name of a query parameter and the value is the respective value
+Add custom request configuration to the request.
+Key-value pairs where the key is the name of a request configuration and the value is the respective value
+OData delete request configuration for an entity type.
+Type of the entity to setup a request for
+Creates an instance of ODataDeleteRequestConfig.
+Constructor type of the entity to create a configuration for
+Add custom headers to the request. This is useful in case you want to provide your own authorization headers for example.
+Key-value pairs where the key is the name of a header property and the value is the respective value
+Add custom query parameters to the request. This is useful in case your OData service allows non-standard query parameters.
+Key-value pairs where the key is the name of a query parameter and the value is the respective value
+Add custom request configuration to the request.
+Key-value pairs where the key is the name of a request configuration and the value is the respective value
+Type of the entity to setup a request for
+Creates an instance of ODataRequest.
+Constructor type of the entity to create a configuration for
+Add custom headers to the request. This is useful in case you want to provide your own authorization headers for example.
+Key-value pairs where the key is the name of a header property and the value is the respective value
+Add custom query parameters to the request. This is useful in case your OData service allows non-standard query parameters.
+Key-value pairs where the key is the name of a query parameter and the value is the respective value
+Add custom request configuration to the request.
+Key-value pairs where the key is the name of a request configuration and the value is the respective value
+Creates an instance of ODataFunctionImportRequestConfig.
+HTTP method for the request
+Default path of the service
+The name of the function import.
+Object containing the parameters with a value and additional meta information
+ODataUri conversion interface at runtime either v2 or v4
+Add custom headers to the request. This is useful in case you want to provide your own authorization headers for example.
+Key-value pairs where the key is the name of a header property and the value is the respective value
+Add custom query parameters to the request. This is useful in case your OData service allows non-standard query parameters.
+Key-value pairs where the key is the name of a query parameter and the value is the respective value
+Add custom request configuration to the request.
+Key-value pairs where the key is the name of a request configuration and the value is the respective value
+Type of the original parameters object
+Creates an instance of ODataFunctionImportRequestConfig.
+HTTP method for the request
+Default path of the service
+The name of the function import.
+Object containing the parameters with a value and additional meta information
+Add custom headers to the request. This is useful in case you want to provide your own authorization headers for example.
+Key-value pairs where the key is the name of a header property and the value is the respective value
+Add custom query parameters to the request. This is useful in case your OData service allows non-standard query parameters.
+Key-value pairs where the key is the name of a query parameter and the value is the respective value
+Add custom request configuration to the request.
+Key-value pairs where the key is the name of a request configuration and the value is the respective value
+Creates an instance of ODataFunctionImportRequestConfig.
+HTTP method for the request
+Default path of the service
+The name of the function import.
+Object containing the parameters with a value and additional meta information
+ODataUri conversion interface at runtime either v2 or v4
+Add custom headers to the request. This is useful in case you want to provide your own authorization headers for example.
+Key-value pairs where the key is the name of a header property and the value is the respective value
+Add custom query parameters to the request. This is useful in case your OData service allows non-standard query parameters.
+Key-value pairs where the key is the name of a query parameter and the value is the respective value
+Add custom request configuration to the request.
+Key-value pairs where the key is the name of a request configuration and the value is the respective value
+OData getAll request configuration for an entity type.
+Type of the entity to setup a request for
+Creates an instance of ODataGetAllRequestConfig.
+Constructor type of the entity to create a configuration for
+Add custom headers to the request. This is useful in case you want to provide your own authorization headers for example.
+Key-value pairs where the key is the name of a header property and the value is the respective value
+Add custom query parameters to the request. This is useful in case your OData service allows non-standard query parameters.
+Key-value pairs where the key is the name of a query parameter and the value is the respective value
+Add custom request configuration to the request.
+Key-value pairs where the key is the name of a request configuration and the value is the respective value
+Type of the entity to setup a request for
+Creates an instance of ODataGetAllRequestConfig.
+Constructor type of the entity to create a configuration for
+Add custom headers to the request. This is useful in case you want to provide your own authorization headers for example.
+Key-value pairs where the key is the name of a header property and the value is the respective value
+Add custom query parameters to the request. This is useful in case your OData service allows non-standard query parameters.
+Key-value pairs where the key is the name of a query parameter and the value is the respective value
+Add custom request configuration to the request.
+Key-value pairs where the key is the name of a request configuration and the value is the respective value
+OData getByKey request configuration for an entity type.
+Type of the entity to setup a request for
+Creates an instance of ODataGetByKeyRequestConfig.
+Constructor type of the entity to create a configuration for
+Add custom headers to the request. This is useful in case you want to provide your own authorization headers for example.
+Key-value pairs where the key is the name of a header property and the value is the respective value
+Add custom query parameters to the request. This is useful in case your OData service allows non-standard query parameters.
+Key-value pairs where the key is the name of a query parameter and the value is the respective value
+Add custom request configuration to the request.
+Key-value pairs where the key is the name of a request configuration and the value is the respective value
+Type of the entity to setup a request for
+Creates an instance of ODataGetByKeyRequestConfig.
+Constructor type of the entity to create a configuration for
+Add custom headers to the request. This is useful in case you want to provide your own authorization headers for example.
+Key-value pairs where the key is the name of a header property and the value is the respective value
+Add custom query parameters to the request. This is useful in case your OData service allows non-standard query parameters.
+Key-value pairs where the key is the name of a query parameter and the value is the respective value
+Add custom request configuration to the request.
+Key-value pairs where the key is the name of a request configuration and the value is the respective value
+OData request configuration for an entity type.
+Creates an instance of ODataRequest.
+Configuration of the request.
+Destination to setup the request against.
+Get all custom headers.
+Key-value pairs where the key is the name of a header property and the value is the respective value
+Get all default headers. If custom headers are set, those take precedence.
+Key-value pairs where the key is the name of a header property and the value is the respective value
+Get the eTag related headers, e. g. if-match
.
Key-value pairs where the key is the name of a header property and the value is the respective value
+Execute the given request and return the according promise.
+Promise resolving to the requested data
+Create object containing all headers, including custom headers for the given request.
+Key-value pairs where the key is the name of a header property and the value is the respective value
+Specifies whether the destination needs a specific authentication or not.
+A boolean value that specifies whether the destination needs authentication or not
+Get query parameters as string. Leads with ?
if there are parameters to return.
Query parameter string
+Returns the relative URL to a specific OData resource.
+Whether or not to include the service path in the URL.
+The relative URL of the resource.
+Returns the service URL relative to the url of the destination for a given OData request.
+The relative URL of the service the given entity belongs to.
+Constructs a URL relative to the destination.
+Whether or not to include the service path in the URL.
+Whether or not to include the query parameters in the URL.
+The relative URL for the request.
+Returns the URL to a specific OData .resource, i.e. the entity collection.
+The URL of the resource
+Returns the service URL for a given OData request.
+The URL of the service the given entity belongs to
+Constructs an absolute URL for the given request.
+The absolute URL for the request.
+OData update request configuration for an entity type.
+Type of the entity to setup a request for
+Creates an instance of ODataUpdateRequestConfig.
+Constructor type of the entity to create a configuration for
+Add custom headers to the request. This is useful in case you want to provide your own authorization headers for example.
+Key-value pairs where the key is the name of a header property and the value is the respective value
+Add custom query parameters to the request. This is useful in case your OData service allows non-standard query parameters.
+Key-value pairs where the key is the name of a query parameter and the value is the respective value
+Add custom request configuration to the request.
+Key-value pairs where the key is the name of a request configuration and the value is the respective value
+Type of the entity to setup a request for
+Creates an instance of ODataUpdateRequestConfig.
+Constructor type of the entity to create a configuration for
+Add custom headers to the request. This is useful in case you want to provide your own authorization headers for example.
+Key-value pairs where the key is the name of a header property and the value is the respective value
+Add custom query parameters to the request. This is useful in case your OData service allows non-standard query parameters.
+Key-value pairs where the key is the name of a query parameter and the value is the respective value
+Add custom request configuration to the request.
+Key-value pairs where the key is the name of a request configuration and the value is the respective value
+Creates an instance of Link.
+Name of the linking field to be used in the OData request.
+Constructor type of the entity the field belongs to
+Constructor type of the linked entity
+List of selectables on the linked entity.
+Create a new link based on a given link.
+Newly created link
+Create filter statements to be applied to the OData request based on the linked entity values.
+Newly created FilterLink
.
Add order-by statements to the request.
+The request builder itself, to facilitate method chaining.
+Creates a selection on a linked entity. Has the same behavior as GetAllRequestBuilderV2.select and GetByKeyRequestBuilderV4.select but for linked entities.
+See also, Selectable
+Selection of fields or links on a linked entity
+The link itself, to facilitate method chaining
+Skip number of entities.
+Number of matching entities to skip. Useful for paging.
+The request builder itself, to facilitate method chaining.
+Number of returned entities.
+Maximum number of entities to return in the response. Can be less, if less entities match the request.
+The request builder itself, to facilitate method chaining.
+Link to be cloned
+Newly created link
+Represents a link from one entity to one other linked entity (as opposed to a list of linked entities). In OData v2 a OneToOneLink
can be used to filter and order a selection on an entity based on filters and orders on a linked entity.
Type of the entity to be linked from
+Type of the entity to be linked to
+Creates an instance of Link.
+Name of the linking field to be used in the OData request.
+Constructor type of the entity the field belongs to
+Constructor type of the linked entity
+List of selectables on the linked entity.
+Filterables to apply to the given entity based on the linked entity.
+List of criteria of the linked entity to order the given entity by with descending priority.
+Create a new link based on a given link.
+Newly created link
+Create filter statements to be applied to the OData request based on the linked entity values.
+Filters based on the linked entity.
+Newly created FilterLink.
+Create order statements for the OData request based on the linked entity. The given statements have descending priority.
+Example:
+Entity.requestBuilder()
+ .getAll()
+ .orderBy(Entity.TO_LINKED_ENTITY.orderBy(asc(LinkedEntity.PROPERTY1), desc(LinkedEntity.PROPERTY2)));
+
+ Criteria to order by
+Newly created order link
+Creates a selection on a linked entity. Has the same behavior as GetAllRequestBuilderV2.select and GetByKeyRequestBuilderV4.select but for linked entities.
+See also, Selectable
+Selection of fields or links on a linked entity
+The link itself, to facilitate method chaining
+Link to be cloned
+Newly created link
+Request builder for OpenAPI requests.
+Type of the response for the request.
+Create an instance of OpenApiRequestBuilder
.
HTTP method of the request to be built.
+Path for the request containing path parameter references as in the OpenAPI specification.
+Query parameters and or body to pass to the request.
+Add custom headers to the request. If a header field with the given name already exists it is overwritten.
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Add custom request configuration to the request. Typically, this is used when specifying response type for downloading files. + If the custom request configuration contains keys in this list defaultDisallowedKeys, they will be removed.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+The request builder itself, to facilitate method chaining.
+Execute request and get the response data. Use this to conveniently access the data of a service without technical information about the response.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+A promise resolving to the requested return type.
+Execute request and get a raw HttpResponse, including all information about the HTTP response. + This especially comes in handy, when you need to access the headers or status code of the response.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+A promise resolving to an HttpResponse.
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+OData queries take this to determine the order of results.
+-
+Creates an instance of Order.
+Field to order by
+Type of ordering, can be 'asc' for ascending or 'desc' for descending
+Link to represent an order by on a linked entity.
+Type of the entity to link from
+Type of the entity to link to
+Creates an instance of OrderLink.
+Link to the entity to order by
+A list of orderables based on the linked entity
+EdmTypeField, that represents a property with an EDM type, that can be compared with greaterThan
, greaterOrEqual
, lessThan
and lessOrEqual
.
Type of the entity the field belongs to
+EDM type of the field.
+Boolean type that represents whether the field is nullable.
+Boolean type that represents whether the field is selectable.
+Creates an instance of EdmTypeField.
+Actual name of the field used in the OData request.
+Constructor type of the entity the field belongs to.
+Type of the field according to the metadata description.
+Optional settings for this field.
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ge', i.e. >=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'gt', i.e. >
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'le', i.e. <=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'lt', i.e. <
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Representation of a filter function, that returns a value of an orderable type. This supports int, double and decimal values.
+Creates an instance of OrderableFilterFunction.
+Name of the function that returns a numeric value
+Representation of the parameters passed to the filter function
+Type of the returned numeric value. This influences the formatting of the returned value.
+Creates an instance of Filter for this filter function and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this filter function and the given value using the operator 'ge', i.e. >=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this filter function and the given value using the operator 'gt', i.e. >
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this filter function and the given value using the operator 'le', i.e. <=
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this filter function and the given value using the operator 'lt', i.e. <
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this filter function and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Names of parents in case the function is part of a filter on a navigation property
+The filter function as string
+Type of the entity the field belongs to
+Creates an instance of EdmTypeField.
+Actual name of the field used in the OData request.
+Constructor type of the entity the field belongs to.
+Type of the field according to the metadata description.
+Optional settings for this field.
+Creates an instance of Filter for this field and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Creates an instance of Filter for this field and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Representation of a filter function, that returns a value of type string.
+Creates an instance of StringFilterFunction.
+Name of the function that returns a string value
+Representation of the parameters passed to the filter function
+Creates an instance of Filter for this filter function and the given value using the operator 'eq', i.e. ==
.
Value to be used in the filter
+The resulting filter
+Creates an instance of Filter for this filter function and the given value using the operator 'ne', i.e. !=
.
Value to be used in the filter
+The resulting filter
+Names of parents in case the function is part of a filter on a navigation property
+The filter function as string
+Type of the entity the field belongs to
+Creates an instance of EdmTypeField.
+Actual name of the field used in the OData request.
+Constructor type of the entity the field belongs to.
+Type of the field according to the metadata description.
+Optional settings for this field.
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Type of the entity the field belongs to
+Creates an instance of EdmTypeField.
+Actual name of the field used in the OData request.
+Constructor type of the entity the field belongs to.
+Type of the field according to the metadata description.
+Optional settings for this field.
+Path to the field to be used in filter and order by queries.
+Path to the field to be used in filter and order by queries.
+Create OData query to update an entity.
+Type of the entity to be updated
+Creates an instance of UpdateRequestBuilder.
+Constructor type of the entity to be updated
+Entity to be updated
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Executes the query.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the entity once it was updated
+Execute request and return an HttpResponse. The request is only executed if some properties of the entity are modified.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse when the request is executed or undefined
otherwise.
Executes the query.
+Request object to be executed.
+A promise resolving to the entity once it was updated.
+Instructs the request to force an overwrite of the entity by sending an 'If-Match: *' header instead of sending the ETag version identifier.
+The request itself to ease chaining while executing the request.
+Enumeration of the fields to be ignored.
+The entity itself, to facilitate method chaining.
+the builder itself
+Create the relative URL based on configuration of the given builder.
+The relative URL for the request
+Explicitly configure 'PUT' as the method of the update request. By default, only the properties that have changed compared to the last known remote state are sent using 'PATCH', while with 'PUT', the whole entity is sent.
+The entity itself, to facilitate method chaining.
+Enumeration of the fields to be required.
+The entity itself, to facilitate method chaining.
+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.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Sets entity fields to ignore by the update request.
+Enumeration of the fields to be ignored.
+The entity itself, to facilitate method chaining.
+Sets required entity keys for the update request.
+Enumeration of the fields to be required.
+The entity itself, to facilitate method chaining.
+Sets ETag version identifier of the entity to update.
+Custom ETag version identifier to be sent in the header of the request.
+The request itself to ease chaining while executing the request.
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Custom ETag version identifier to be sent in the header of the request.
+The request itself to ease chaining while executing the request.
+Abstract class to create OData query to update an entity containing methods shared for OData v2 and v4.
+Type of the entity to be updated
+Creates an instance of UpdateRequestBuilder.
+Constructor type of the entity to be updated
+Entity to be updated
+Collection of URI conversion methods
+Entity serializer
+Extractor for ETag from payload
+Manipulator for the payload.
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Executes the query.
+Request object to be executed.
+A promise resolving to the entity once it was updated.
+Instructs the request to force an overwrite of the entity by sending an 'If-Match: *' header instead of sending the ETag version identifier.
+The request itself to ease chaining while executing the request.
+Enumeration of the fields to be ignored.
+The entity itself, to facilitate method chaining.
+the builder itself
+Create the relative URL based on configuration of the given builder.
+The relative URL for the request
+Explicitly configure 'PUT' as the method of the update request. By default, only the properties that have changed compared to the last known remote state are sent using 'PATCH', while with 'PUT', the whole entity is sent.
+The entity itself, to facilitate method chaining.
+Enumeration of the fields to be required.
+The entity itself, to facilitate method chaining.
+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.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Sets entity fields to ignore by the update request.
+Enumeration of the fields to be ignored.
+The entity itself, to facilitate method chaining.
+Sets required entity keys for the update request.
+Enumeration of the fields to be required.
+The entity itself, to facilitate method chaining.
+Sets ETag version identifier of the entity to update.
+Custom ETag version identifier to be sent in the header of the request.
+The request itself to ease chaining while executing the request.
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Custom ETag version identifier to be sent in the header of the request.
+The request itself to ease chaining while executing the request.
+Creates an instance of UpdateRequestBuilder.
+Constructor type of the entity to be updated
+Entity to be updated
+Add custom headers to the request. Existing headers will be overwritten.
+Key-value pairs denoting additional custom headers.
+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.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+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.
+Key-value pairs denoting additional custom request configuration options to be set in the request.
+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.
Path to be appended.
+The request builder itself without "execute" function, to facilitate method chaining.
+Executes the query.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the entity once it was updated
+Execute request and return an HttpResponse.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to an HttpResponse.
+Executes the query.
+Request object to be executed.
+A promise resolving to the entity once it was updated.
+Instructs the request to force an overwrite of the entity by sending an 'If-Match: *' header instead of sending the ETag version identifier.
+The request itself to ease chaining while executing the request.
+Enumeration of the fields to be ignored.
+The entity itself, to facilitate method chaining.
+the builder itself
+Create the relative URL based on configuration of the given builder.
+The relative URL for the request
+Explicitly configure 'PUT' as the method of the update request. By default, only the properties that have changed compared to the last known remote state are sent using 'PATCH', while with 'PUT', the whole entity is sent.
+The entity itself, to facilitate method chaining.
+Enumeration of the fields to be required.
+The entity itself, to facilitate method chaining.
+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.
Path to override the default with
+The request builder itself, to facilitate method chaining
+Sets entity fields to ignore by the update request.
+Enumeration of the fields to be ignored.
+The entity itself, to facilitate method chaining.
+Sets required entity keys for the update request.
+Enumeration of the fields to be required.
+The entity itself, to facilitate method chaining.
+Sets ETag version identifier of the entity to update.
+Custom ETag version identifier to be sent in the header of the request.
+The request itself to ease chaining while executing the request.
+Skip fetching csrf token for this request, which is typically useful when the csrf token is not required.
+The request builder itself, to facilitate method chaining.
+Create the URL based on configuration of the given builder.
+Destination to execute the request against.
+Options to employ when fetching destinations.
+Promise resolving to the URL for the request
+Key-value pairs denoting additional custom headers.
+The request builder itself, to facilitate method chaining.
+Key-value pairs denoting additional custom query parameters to be set in the request.
+The request builder itself, to facilitate method chaining.
+Path to override the default with.
+The request builder itself, to facilitate method chaining.
+Custom ETag version identifier to be sent in the header of the request.
+The request itself to ease chaining while executing the request.
+Represents an error that was caused by another error.
+Create an instance of ErrorWithCause.
+Error message.
+Original error, causing this error.
+Optional override for formatting stack traces
+Root cause of the error. + If there are multiple errors caused one by another, the root cause is the first error that occurred. + In case there is no root cause.
+Create .stack property on a target object
+Holds state on already used names and provides new names if there are naming conflicts.
+Creates an instance of UniqueNameGenerator.
+The separator to be used when adding an index.
+Sets the already used names considered in the finding process.
+Adds the name(s) to the already used names.
+Names to be added
+Generate a unique name by appending an index separated by the indexSeparator
if necessary, e. g. if MyName
is already taken MyName_1
will be found by default.
+ The generated name is added to the used names.
+ If the name is already unique nothing is appended.
The name to get a unique name from.
+Whether to check the already used names in a case sensitive manner.
+A unique name.
+Generate unique names by appending an index separated by the indexSeparator
if necessary, while respecting the given suffixes.
+ If the name is already unique nothing is appended.
+ The generated names are added to the used names.
+ Each given suffix is appended to the unique name in the result.
+ The resulting names are also checked for uniqueness.
+ All names in the result have the same number suffix.
+ Example: if MyName
and MyName_1MySuffix
is already taken, [MyName_2, MyName_2MySuffix]
will be generated by default.
The name to get a unique name from
+Additional name of suffixes to be considered for the finding process, as well as the output.
+Whether to check the already used names in a case sensitive manner.
+A list of unique names. The length of this array is one plus the number of suffixes provided. The first entry corresponds to the given name.
+Generate a unique name by appending an index separated by the indexSeparator
if necessary, e. g. if MyName
is already taken MyName_1
will be found by default.
+ If the name is already unique nothing is appended.
The name to get a unique name from.
+Whether to check the already used names in a case sensitive manner.
+A unique name.
+Generate unique names by appending an index separated by the indexSeparator
if necessary, while respecting the given suffixes.
+ If the name is already unique nothing is appended.
+ Each given suffix is appended to the unique name in the result.
+ The resulting names are also checked for uniqueness.
+ All names in the result have the same number suffix.
+ Example: if MyName
and MyName_1MySuffix
is already taken, [MyName_2, MyName_2MySuffix]
will be generated by default.
The name to get a unique name from
+Additional name of suffixes to be considered for the finding process, as well as the output.
+Whether to check the already used names in a case sensitive manner.
+A list of unique names. The length of this array is one plus the number of suffixes provided. The first entry corresponds to the given name.
+The destinations endpoint distinguished between destinations maintained on service level (instance) and account level (subaccount). + This enum is used as a switch in the fetchInstanceDestinations, fetchSubaccountDestinations and destinationServiceCache
+Enumerator that selects the isolation type of destination in cache.
+The SAP Cloud SDK for JavaScript and TypeScript consists of multiple libraries to enable you to write side-by-side extensions on SAP Cloud Platform.
+You can find tutorials that showcase some of the typical use cases on developers.sap.com.
+ If you have questions, you can reach out to us on StackOverflow using the tag sap-cloud-sdk
and on answers.sap.com using the tag SAP Cloud SDK
.
+ Also, you can browse our release notes to check out what's new in each version.
The isolation strategy used for caching destinations. For the available options, see IsolationStrategy. + By default, IsolationStrategy.Tenant is set.
+A boolean value that indicates whether to read destinations from cache.
+A resolved destination containing information needed to execute requests, such as the system URL.
+You can create a destination as a local object when supplying all necessary information, or it could be retrieved from the destination service on SAP Cloud Platform (via DestinationNameAndJwt). + When creating a local object representing a destination, you need to supply at least the url and, if required by the target system, valid credentials with username and password.
+Authentication tokens returned from destination service on SAP Cloud Platform.
+Array of certificates used for authentication type ClientCertificateAuthentication.
+Client Id used to retrieve access token for "OAuth2ClientCredentials", "OAuth2UserTokenExchange" and "OAuth2JWTBearer" authentication.
+Client Secret used to retrieve access token for "OAuth2ClientCredentials", "OAuth2UserTokenExchange" and "OAuth2JWTBearer" authentication.
+Location ID of the Cloud Connector to be used for connection to an On-Premise system. Optional. Corresponds to property "CloudConnectorLocationId" in the additional properties of a destination.
+Additional headers to be used for calls against the destination, originally defined by URL.headers.<header-name>
.
+ The keys of this object denote the names of the headers and the values their values.
Flag indicating whether the destination is for test purpose. Should be "undefined" or "false" for non-mocked destinations.
+Flag indicating whether all certificates should be accepted when communicating with the destination. Should not be "true" in production.
+Name of the key store/certificate to be used for ClientCertificateAuthentication.
+Password of the key store/certificate to be used for ClientCertificateAuthentication.
+Name of the destination retrieved from SAP Cloud Platform.
+Further properties of the destination as defined in destination service on SAP Cloud Platform, possibly empty.
+Password to use for basic authentication, optional if other means of authentication shall be used.
+ProxyConfiguration for on-premise connectivity and http(s) web proxies. Is present if proxyType of the destination equals "OnPremise" or environment variables [http_proxy] or [https_proxy] are set See ProxyConfiguration.
+Proxy type to specify whether the target resides on-premise (not used).
+Additional query parameters to be used for calls against the destination, originally defined by URL.queries.<query-parameter-name>
.
+ The keys of this object denote the names of the query parameters and the values their values.
Client to target in an SAP system, will be added as HTTP header sap-client
if set.
System user to be used for OAuth2SAMLBearerAssertion authentication type.
+Password for tokenServiceUser (if required).
+URL to retrieve access token for "OAuth2ClientCredentials", "OAuth2UserTokenExchange" and "OAuth2JWTBearer" authentication.
+User for basic authentication to OAuth server (if required).
+The type of the destination, defaults to 'HTTP'. The SAP Cloud SDK only understands destinations of type 'HTTP'.
+Base URL for calls to this destination.
+ The URL has to define the protocol, like http://
or https://
, and a host.
+ The path for requests against this destination will be appended to the path defined in the URL as a new path segment.
Username to use for basic authentication, optional if other means of authentication shall be used.
+This property is only considered in case no userJwt is provided.
+ It is meant for situations where you do not have a token e.g. background processes.
+ The value for iss is the issuer field of a JWT e.g. https://
ATTENTION: If this property is used, no validation of the provided subdomain value is done. This is differs from how the userJwt
is handled.
+ So be careful that the used value is not manipulated and breaks the tenant isolation of your application.
Method that implements the selection strategy of the retrieved destination. Uses subscriberFirst per default. Use the selector helper DestinationSelectionStrategies to select the appropriate selection strategy.
+The user token of the current request.
+Represents authentication token returned from destination service.
+The isolation strategy used for caching destinations. For the available options, see IsolationStrategy. + By default, IsolationStrategy.Tenant is set.
+A boolean value that indicates whether to read destinations from cache.
+Represents a certificate attached to a destination.
+Content of the certificate as base64 encoded binary.
+Name of the certificate file.
+Type of the certificate.
+Configuration of a destination as it is available through the destination service.
+Options to customize the behavior of destinationForServiceBinding.
+Custom transformation function to control how a Destination is built from the given ServiceBinding.
+Declaration of a destination to be retrieved from an environment variable or from the destination service on SAP Cloud Platform.
+Use an object of this interface to specify which destination shall be used when executing a request. + The destination will be retrieved via its DestinationNameAndJwt.destinationName according to the following algorithm:
+destinations
(if available), it will be converted into a Destination and used for the request.Name of the destination to retrieve, mandatory.
+An access token for the XSUAA service on SAP Cloud Platform, provided as a JSON Web Token, only mandatory when destination shall be retrieved from destination service on SAP Cloud Platform.
+Credentials for the Destination service.
+Interface representing the return type of the builder function entityDeserializer
+Interface representing the return type of the builder function entitySerializer.
+Optional settings for fields.
+Whether the value of the field can be null
.
Whether the field can be reference in a .select
statement.
Interface representing the return of the getFilter creator createGetFilter.
+This interface is compatible with AxiosRequestConfig.
+A boolean value that indicates whether to fetch the csrf token for a non-get request.
+ For a get request, the csrf token is not fetched and this option is ignored.
+ By default, the value is false
.
Union of necessary methods for the OData URI conversion. + In v2/uri-conversion/odata-uri.ts and v4/uri-conversion/odata-uri.ts the instance for v2 and v4 are created.
+Proxy settings for connecting to an on-premise destination via connectivity proxy or web proxies.
+ The ProxyConfiguration is undefined
in most cases. The logic for setting it is as follow:
http_proxy
and https_proxy
are considered.Valid form for the variable is http://user:password@host:port
where everything besides the host is optional.
+ For user and password non alphanumeric characters need to be percent-encoded.
+ Note: The [no_proxy] environment variables contains a list of URLs for which no proxy will be used even if [http_proxy, https_proxy] are set.
+ Wildcards like *.some.domain.com are not supported while checking the no_proxy env.
HTTP headers to be added to a request if tunneled through the proxy. + If the request is going to an OnPremise system via the connectivity proxy, the header contains the 'Proxy-Authorization' and + the 'SAP-Connectivity-Authentication' header if a JWT is present on the current request. + For web proxies only the 'Proxy-Authorization' enter the header fields if provided.
+The host of the proxy.
+The port of the proxy.
+The protocol used by the proxy
+Representation of the scope. A scope is assigned to a user via role-collection in cloud foundry.
+This property denotes that this is a selectable field.
+Represents the JSON object for a given service binding as obtained from the VCAP_SERVICE environment variable.
+ To see service bindings, run cf env <app-name>
in the terminal. This will produce output like this:
{
+...
+ "VCAP_SERVICES": {
+ "s4-hana-cloud": [
+ {
+ "name": "...",
+ "type": "...".
+ ...
+ }
+ ]
+ }
+}
+
+
+ In this example, the key "s4-hana-cloud" refers to an array of service bindings.
+Unspecific representation of a service's credentials as read from VCAP_SERVICES (for Cloud Foundry) or mounted secrets (for K8S).
+Response element returned from the XSUAA service's /token_key endpoint. + Value holds the key that is used for verifying JWTs.
+Encryption algorithm, e.g. RSA256.
+ID of the key.
+Key type, e.g. RSA.
+RSA key exponent.
+RSA key modulus.
+Public key use parameter - identifies intended use of the public key.
+The actual key.
+Interface defining the methods of the URI converter. + The concrete implementations are created in odata/v2/uri-conversion/uri-value-converter.ts and odata/v4/uri-conversion/uri-value-converter.ts
+Representation of the user i.e. authenticated persona. The authentication is done by the XSUAA.
+Credentials for the XSUAA service.
+Options that can be used to configure the generation when using the generator programmatically. + The options match the CLI options.
+Log message context for a logger with additional custom data.
+This package contains the code we use for collecting usage data. + Please note that usage analytics is disabled by default, i.e. you need to explicitly opt-in for data to be collected. + For more information on how to opt-in and which data is collected, please refer to this document.
+ + + +The recommended way to get in touch with us is to create an issue in our github repository.
+ Select the issue category Bug
, Feature
or Question
depending on the nature of your request.
+ We try to provide fixes, features and answers as soon as possible.
We also monitor questions on StackOverflow and ansers.sap.com but prefer issues on github.
+ +If you would like to contribute to the SAP Cloud SDK, please make yourself familiar with our contributing guidelines and follow the given instructions.
+ +The SAP Cloud SDK is released under the Apache License Version 2.0.
+ +This package contains the core functionality of the SAP Cloud SDK as well as the Cloud Platform abstractions.
+ +$ npm install @sap-cloud-sdk/core
+
+
+ The core is the heart of the SAP Cloud SDK and contains the functionality that is essential to every project powered by the SDK. + Any OData client built by the SAP Cloud SDK, be it the VDM or clients built by the generator are using the core. + We recommend to install this in addition to your clients.
+Below is an example showing how you can build and execute your request with multiple filters by using an function called and
.
import { and } from '@sap-cloud-sdk/core';
+import { BusinessPartner } from '@sap/cloud-sdk-vdm-business-partner-service';
+
+// Build your filters
+const firstNameFilter = BusinessPartner.FIRST_NAME.equals('firstName');
+const lastNameFilter = BusinessPartner.LAST_NAME.equals('lastName');
+
+// Execute your request with two filters
+BusinessPartner.requestBuilder()
+ .getAll()
+ .filter(and(firstNameFilter, lastNameFilter))
+ .execute(yourDestination);
+
+ For more detailed overview visit our OData client documentation.
+ + + +The recommended way to get in touch with us is to create an issue in our github repository.
+ Select the issue category Bug
, Feature
or Question
depending on the nature of your request.
+ We try to provide fixes, features and answers as soon as possible.
We also monitor questions on StackOverflow and ansers.sap.com but prefer issues on github.
+ +If you would like to contribute to the SAP Cloud SDK, please make yourself familiar with our contributing guidelines and follow the given instructions.
+ +The SAP Cloud SDK is released under the Apache License Version 2.0.
+ +Convenience type to reflect the type of the instances of a collection field. + The actual type of the elements for complex type collections is ComplexTypeNamespace.
+Type of of elements of the collection. This can either be an EDM type or complex type.
+Union type to represent the parent of a field. This can either be an entity constructor or a complex type field.
+Options to use while fetching destinations. Encompasses both DestinationCachingOptions and ResilienceOptions interfaces.
+Allowed Edm types for OData v2.
+Convenience type to support legacy EdmTypeField
with field type as generic parameter.
+ This will become obsolete in the next major version update.
Allowed Edm types for OData v4.
+Convenient type to reflect all the values of a string based enum as a union type.
+String based enum type
+Represents all expandables, i.e. everything that can be used in an .expand
statement. Only relevant for OData v4 requests.
Type of the entity to be selected on
+Union type to represent all possible types of a field.
+Convenience type that maps the given EDM type to a FieldType. It also considers whether the field is nullable.
+EDM type of the field. Deprecated: Field type of the field.
+Boolean type that represents whether the field is nullable.
+Type of a parameter of a filter function. This can either be a primitive type, a reference to a field or another filter function.
+Primitive type of a parameter of a filter function.
+hidden
+A union of all types that can be used for filtering.
+Type of the entity to be filtered on
+Internal representation of all parameters of a function import as a map
+External representation of all parameters
+Convenience type to determine whether a field should be orderable. If the given EdmT
is of type OrderableEdmTypes
, it is orderable.
EDM type of the field.
+Convenience type to determine whether a field should be selectable. If the given FieldOfT
is the type of an entity, it is selectable.
Type of the entity or complex type field this field belongs to.
+HTTP Methods supported by the http-client.
+A union of all types that can be used for ordering.
+Type of the entity to be ordered
+EDM types that can be compared with greaterThan
, greaterOrEqual
, lessThan
and lessOrEqual
.
A union of all types that can be used as input for ordering.
+Type of the entity to be ordered
+Selector of destination selection strategies. See alwaysProvider, alwaysSubscriber and subscriberFirst for more information available selection strategies.
+A list of request config keys that are not allowed to be customized by default.
+Entity deserializer instance for v2 entities. + See EntityDeserializer for the provided methods.
+Entity deserializer instance for v4 entities. + See EntityDeserializer for the provided methods.
+Entity serializer instance for v2 entities. + See EntitySerializer for the provided methods.
+Entity serializer instance for v4 entities. + See EntitySerializer for the provided methods.
+OData v2 specific filter functions
+OData v4 specific filter functions
+Mapping between key name in the Tenant and key name in decoded JWT.
+Mapping between key name in the User and key name in decoded JWT and the
+Instance of the ODataUri conversion interface for OData v2.
+Instance of the ODataUri conversion interface for OData v4.
+an ODataRequest.
+The headers that should be added to.
+The provided headers with the new authorization headers.
+Builds a DestinationHttpRequestConfig for the given destination + and then merges it into the given request configuration. + Setting of the given request configuration take precedence over any destination related configuration.
+A destination or a destination name and a JWT.
+Any object representing an HTTP request.
+The given request config merged with the config built for the given destination.
+Given a destination and a JWT (required for subscriber destinations), this function will add a proxy configuration to a destination. + See also ProxyConfiguration.
+This function will reject if no connectivity service is bound, no XSUAA service with plan application is bound or the client credentials grant with the XSUAA service fails.
+ +The destination to which the proxy configuration should be added.
+The JWT of the current user.
+A promise resolving to the destination with the added proxy configuration.
+Will return the entity if all elements of the one-to-many link relation fulfill the condition.
+A filter condition like MyEntity.someMultiLink.someProperty.eq('value')
+The lambda filter function to be considered in the query
+Constraints the selection to provider destinations.
+Retrieved destinations.
+Name of the destination to retrieve.
+the destination to retrieve, returns null
, if no matched provider destination is found.
Constraints the selection to subscriber destinations.
+Retrieved destinations.
+Name of the destination to retrieve.
+the destination to retrieve, returns null
, if no matched subscriber destination is found.
Combine Filterables with logical and
to create a FilterList.
Example:
+Entity.requestBuilder()
+ .getAll()
+ .filter(and(filterExp1, filterExp2));
+
+ Note that the GetAllRequestBuilderV2.filter and GetAllRequestBuilderV4.filter method take a rest parameter and thereby an array of filter expressions that are then combined conjunctively. As a consequence following is equivalent to the example above:
+Entity.requestBuilder()
+ .getAll()
+ .filter(filterExp1, filterExp2);
+
+ Type of the entity filter on.
+Filterables to be combined with logical and
.
The newly created FilterList.
+Will return the entity if at least one element of the one-to-many link relation fulfills the condition.
+A filter condition like MyEntity.someMultiLink.someProperty.eq('value')
+The lambda filter function to be considered in the query
+Create new Order by orderBy._fieldName
in ascending order.
Type of the entity to be ordered
+Field or link to be ordered by
+New order
+Retrieve the audiences of a decoded JWT based on the audiences and scopes in the token.
+Token to retrieve the audiences from.
+A set of audiences.
+A destination.
+The provided headers with the new authorization headers.
+The headers that should be added to.
+The provided headers with the new authorization headers.
+A destination or a destination name and a JWT.
+Any object representing an HTTP request.
+Get CSRF token and cookies for a destination and request configuration. The CSRF token and cookies will be retrieved based on the URL of the destination and the custom configuration given by the requestConfig
.
+ If there is a relative url in the requestConfig
it will be appended to the destination's URL, an absolute URL overwrites the destination related URL.
The destination to get the headers from
+An http request configuration containing additional information about the request, like URL or headers
+A promise to an object containing the CSRF related headers
+Builds a DestinationHttpRequestConfig for the given destination. + If a destination name (and a JWT) are provided, it will try to resolve the destination.
+A destination or a destination name and a JWT.
+Custom default headers for the resulting HTTP request.
+Build a filter function to ceil a number. Evaluates to double or decimal, defaults to double.
+The number to ceil. This can either be a number, a reference to a field or another filter function.
+The return type to use.
+The newly created filter function
+Checks if a given key is present in the decoded JWT. If not, an error is thrown.
+The key of the representation in typescript
+The mapping between the typescript keys and the JWT key
+JWT payload to check fo the given key.
+Executes a client credentials grant request. + If the first parameter is an instance of XsuaaServiceCredentials, the response's access_token will be verified. + If the first parameter is a URI, the response will not be verified.
+The URL of the token service or the credentials of a XSUAA service instance.
+Client credentials for which to request a token.
+Options to use by retrieving access token.
+Object containing value required for the body request.
+A promise resolving to the response.
+Build a filter function to concatenate two strings. Evaluates to string.
+The first string to concatenate. This can either be a string, a reference to a field or another filter function.
+The second string to concatenate. This can either be a string, a reference to a field or another filter function.
+The newly created filter function
+Build a filter function to test whether a string is a substring of the other. Evaluates to boolean.
+The substring to test for. This can either be a string, a reference to a field or another filter function.
+The string to test. This can either be a string, a reference to a field or another filter function.
+The newly created filter function
+A raw json object to deserialize a complex type from.
+A list of rules on how to convert json to the respective type in JavaScript or TypeScript.
+A deserialized complex type representation.
+Creates a getFilter function using the OData v2 or OData v4 URI converter. + The concrete filter getters are initiated in odata/v2/uri-conversion/odata-uri.ts and odata/v4/uri-conversion/odata-uri.ts.
+Uri converter for v2 or v4.
+The filter getter. See interface GetFilter
+Creates a getResourcePathForKeys function using the OData v2 or OData v4 URI converter. + The concrete instances for v2 or v4 are initiated in odata/v2/uri-conversion/odata-uri.ts and odata/v4/uri-conversion/odata-uri.ts.
+Uri converter for v2 or v4.
+The filter getter. See GetFilter
+Extracts the custom attributes from the JWT.
+Token payload to read the custom attributes from.
+Custom attributes added by the XSUAA service to the issued JWT.
+Build a filter function to get the day of a date. Evaluates to int.
+The date to get the day for. This can either be a date (Moment) or a reference to a field.
+The newly created filter function
+Decode JWT.
+JWT to be decoded
+Decoded payload.
+Decode JWT and return the complete decoded token.
+JWT to be decoded.
+Decoded token containing payload, header and signature.
+Create new Order by orderBy._fieldName
in descending order.
Type of the entity to be ordered
+Field or link to be ordered by
+New order
+Deserialize the parsed batch response.
+Two dimensional list of parsed batch sub responses.
+A map that holds the entity type to constructor mapping.
+Response data access module.
+Entity deserializer.
+An array of parsed sub responses of the batch response.
+Tries to build a destination from a service binding with the given name. + Throws an error if no services are bound at all, no service with the given name can be found, or the service type is not supported. + The last error can be circumvent by using the second parameter to provide a custom function that transforms a service binding to a destination.
+The name of the service.
+Options to customize the behavior of this function.
+A destination.
+Detects the system dependent line break in a string.
+The string to check for line breaks. Should have at least two lines, otherwise an error will be thrown.
+The system dependent line break
+Build a filter function to test whether a string ends with another. Evaluates to boolean.
+The string to test. This can either be a string, a reference to a field or another filter function.
+The suffix to test for. This can either be a string, a reference to a field or another filter function.
+The newly created filter function
+Constructs an entityDeserializer given the OData v2 or v4 specific methods. + The concrete deserializers are created in odata/v2/entity-deserializer.ts and odata/v4/entity-deserializer.ts
+Converters emd input to ts values.
+Extractor for the ETag.
+Extractor for data related to one to many links.
+a entity deserializer as defined by EntityDeserializer
+Takes as parameter a function that expects an HttpRequest and returns a Promise of HttpResponse. + Returns a function that takes a destination and a request-config (extends HttpRequestConfig), builds an HttpRequest from them, and calls + the provided execute function.
+NOTE: If you simply want to execute a request without passing your own execute function, use executeHttpRequest instead.
+A function that can execute an HttpRequestConfig.
+A function expecting destination and a request.
+Takes as parameter a function that expects an HttpRequest and returns a Promise of HttpResponse. + Returns a function that takes a destination and a request-config (extends HttpRequestConfig), builds an HttpRequest from them, and calls + the provided execute function.
+NOTE: If you simply want to execute a request without passing your own execute function, use executeHttpRequest instead.
+A function expecting destination and a request.
+Builds a DestinationHttpRequestConfig for the given destination, merges it into the given requestConfig + and executes it (using Axios).
+A destination or a destination name and a JWT.
+Any object representing an HTTP request.
+An HttpRequestOptions of the http request for configuring e.g., csrf token delegation. By default, the SDK will not fetch the csrf token.
+A promise resolving to an HttpResponse.
+Extracts the credentials of a service into an instance of ClientCredentials.
+The credentials of a service as read from VCAP_SERVICES.
+A ClientCredentials instance.
+Extracts all custom fields from the JSON payload for a single entity. + In this context, a custom fields is every property that is not known in the corresponding entity class.
+The JSON payload.
+The constructor function of the entity class.
+An object containing the custom fields as key-value pairs.
+Extractor for the ETag for OData v2 responses used in entityDeserializer.
+Response data from which the ETag is extracted.
+The ETag.
+Extractor for the ETag for OData v4 responses used in entityDeserializer.
+Response data from which the ETag is extracted.
+The ETag.
+Fetches a specific destination by name from the given URI, including authorization tokens. + For destinations with authenticationType OAuth2SAMLBearerAssertion, this call will trigger the OAuth2SAMLBearerFlow against the target destination. + In this pass the access token as string. + Fetches a specific destination with authenticationType OAuth2UserTokenExchange by name from the given URI, including authorization tokens.
+The URI of the destination service
+The access token or AuthAndExchangeTokens if you want to include the X-user-token for OAuth2UserTokenExchange.
+The name of the desired destination
+Options to use by retrieving destinations
+A Promise resolving to the destination
+Fetches all instance destinations from the given URI.
+The URI of the destination service
+The access token
+Options to use by retrieving destinations
+A promise resolving to a list of instance destinations
+Fetches all subaccount destinations from the given URI.
+The URI of the destination service
+The access token
+Options to use by retrieving destinations
+A promise resolving to a list of subaccount destinations
+Fetches verification keys from the XSUAA service for the given credentials.
+Credentials of the XSUAA service instance.
+Value of the jku property in the JWT header. If not provided the old legacy URL xsuaaCredentials.url/token_keys is used as a fallback which will not work for subscriber accounts created after 14th of April 2020.
+An array of TokenKeys.
+Fetches verification keys from the XSUAA service for the given URL, with the given pair of credentials.
+Client ID of the XSUAA service instance.
+Client secret of the XSUAA service instance.
+An array of TokenKeys.
+Filter disallowed keys from a given custom request config object.
+a given custom request config object to be filtered
+A list of keys that are not allowed to be customized.
+Filtered custom request config object.
+A header object to be filtered.
+Build a filter function to floor a number. Evaluates to double or decimal, defaults to double.
+The number to floor. This can either be a number, a reference to a field or another filter function.
+The return type to use.
+The newly created filter function
+Build a filter function to get the fractional seconds of a date. Evaluates to decimal.
+The date to get the fractional seconds for. This can either be a date (Moment) or a reference to a field.
+The newly created filter function
+Builds an Axios config with default configuration i.e. no_proxy, default http and https agent and GET as request method.
+AxiosRequestConfig with default parameters
+Extract the collection data from the response. + If the data does not contain a collection an empty array is returned.
+Response of the OData v4 service.
+Collection extracted from the response.
+Builds a destination from one of three sources (in the given order):
+If you want to get a destination only from a specific source, use the corresponding function directly
+ (getDestinationFromEnvByName
, destinationForServiceBinding
, getDestinationFromDestinationService
).
The name of the destination to be retrieved.
+Configuration for how to retrieve destinations from the destination service.
+A promise returning the requested destination on success.
+Basic Credentials Getter from Destination service credentials needed for JWT generator.
+Basic credentials.
+Name of the destination
+The requested destination if existent, otherwise null
Retrieves a destination with the given name from the Cloud Foundry destination service.
+ Returns null
, if no destination can be found.
+ Requires the following service bindings: destination, XSUAA
+ By default, selects subscriber over provider and instance over subaccount destinations.
If the destinations are read from the environment, the jwt will be ignored.
+The name of the destination to be retrieved.
+Configuration for how to retrieve destinations from the destination service.
+A promise returning the requested destination on success.
+Get a destination from the environment variables by name. If there are multiple destinations with the same name the first one will be used. + This is discouraged for productive use! Use destination-accessor/useOrFetchDestination for fetching destinations + from the Cloud Foundry destination service.
+Name of the destination
+The requested destination if existent, otherwise null
The name of the destination to be retrieved.
+The options of the fetching query of the destination that include the JWT of the current request and the strategy for selecting a destination.
+A promise returning the requested destination on success.
+Get destination service if one is present.
+Destination service
+First 'destination' credentials getter.
+The 'destination' credentials object or null
, if it does not exist.
Destination credentials getter.
+A list of 'credentials' objects in 'destination' service.
+Destination URI getter + NOTICE: If there exist more than one destination/uri, the function + returns the first entry.
+The first existing uri in destination or null
, if not found.
A list of destinations
+Get all destinations from the environment variable "destinations". + This is discouraged for productive use! Use useOrFetchDestination for fetching destinations from the Cloud Foundry destination service.
+A list of destinations
+Convenience method to get the EdmTypeShared from the overloaded constructor. + The two scenarios are:
+complexTypeNameOrEdmType
is of type EdmTypeShared
and edmTypeOrUndefined
is undefined
complexTypeNameOrEdmType
is of type string
and edmTypeOrUndefined
is of type EdmTypeShared
Either the name of the complex type or the EDM type.
+Either the EDM type or undefined
.
The EDM type resolved for the two arguments.
+Convenience method to get the entity constructor of the parent of a complex type.
+Either an entity constructor or another complex type field.
+The constructor of the transitive parent entity;
+Helper function that maps an entity to its keys map with their original names.
+Entity to map
+The constructor of the entity
+object that includes all keys that represent given entity
+Environment variables accessor.
+Environment variable name.
+Env variable value if defined. + null: If not defined.
+Get an object containing the given expand as a query parameter, or an empty object if none was given. + In this OData v2 expand, selected properties are automatically added to the expand.
+Type of the entity to expand on
+The selects which are expanded if necessary
+An object containing the query parameter or an empty object
+Get an object containing the given expand as a query parameter, or an empty object if none was given.
+Type of the entity to expand on
+The expands to transform to a query parameter
+Constructor type of the entity to expand on
+An object containing the query parameter or an empty object
+Get field options merged with default values. + The given options take precedence.
+Given options.
+Given options merged with default values.
+Name of the header to be found.
+Header object to be searched for given key.
+headers
or an empty object if not found.Name of the header to be found.
+Header object to be searched for given key.
+The value of the header with the given key or undefined
.
Name of the header to be found.
+Header object to be searched for given key.
+headers
or an empty object if not found.The serialized request as <HTTP method> <URL> <HTTP version>
.
Extract the collection data from the one to many link response. + If the data does not contain a collection an empty array is returned.
+Response of the one to many link.
+Collection extracted from the response.
+A destination having OAuth2ClientCredentials
authentication type
A promise returning the requested access token on success.
+Get an object containing the given order bys as query parameter, or an empty object if none was given.
+Type of the entity to order
+A list of orderables to get the query parameters for
+An object containing the query parameter or an empty object
+Extracts the http protocol from the destination URL. The default value is http if no protocol is given.
+URL of this destination is parsed
+The protocol, either https or http.
+Type of the entity to filter on
+The filter to transform to a query parameter
+Constructor type of the entity to filter on
+An object containing the query parameter or an empty object
+Type of the entity to order
+A list of orderables to get the query parameters for
+An object containing the query parameter or an empty object
+Type of the entity to get the selection for
+The list of selectables to be transformed to query parameters
+An object containing the query parameters or an empty object
+Type of the entity to get the resource path for
+Key-value pairs where the key is the name of a key property of the given entity and the value is the respective value
+Constructor type of the entity to get the resource path for
+The path to the resource
+Get the response body from the string representation of a response.
+String representation of a response.
+The response body as a one line string.
+Get an object containing the given Selectables as query parameter, or an empty object if none were given.
+ This retrieves where in addition to the selection (select
) there is also an expansion (expand
) needed.
Type of the entity to get the selection for
+The list of selectables to be transformed to query parameters
+An object containing the query parameters or an empty object
+Get an object containing the given Selectables as query parameter, or an empty object if none were given. + In OData v4 selected properties are not automatically expanded anymore and a manual expand needs to be performed.
+Type of the entity to get the selection for
+The list of selectables to be transformed to query parameters
+An object containing the query parameters or an empty object
+Returns the first found instance for the given service type.
+The service type.
+The first found service.
+Credentials list getter for a given service.
+Service name
+Fetched credentials objects of existing service in 'VCAP_SERVICES'.
+Services getter for a given service.
+Service name.
+List of service bindings of the given type. Returns an empty array if no service binding exists for the given type.
+Extract the single entry data from the response. + If the data does not contain a single object an empty object is returned.
+Response of the OData v4 service.
+A single object extracted from the response.
+'VCAP_SERVICES' Getter from environment variables.
+ This function returns the VCAP_SERVICES as object or null
, if it is not defined (i.e. no services are bound to the application).
'VCAP_SERVICES' found in environment variables or null
, if not defined. The key denotes the name ov the service and the value is the definition.
Takes a decoded JWT and uses the client_id and audience claims to determine the XSUAA service instance + that issued the JWT. Returns the credentials if a match is found, otherwise throws an error. + If no decoded JWT is specified, then returns the first existing XSUAA credential service plan "application".
+Either an encoded or decoded JWT.
+The credentials for a match, otherwise null
.
Build a filter function to test whether a set is a subsequence of the other, i. e. whether the second parameter can be transformed into the first by removing items. Evaluates to boolean.
+The subsequence to test for. This can either be an array, a reference to a field or another filter function.
+The sequence to test. This can either be an array, a reference to a field or another filter function.
+The newly created filter function
+Build a filter function to test whether a set is a subset of the other, i. e. whether the second parameter can be transformed into the first by reordering and / or removing items. Evaluates to boolean.
+The subset to test for. This can either be an array, a reference to a field or another filter function.
+The set to test. This can either be an array, a reference to a field or another filter function.
+The newly created filter function
+Build a filter function to get the hour of a date. Evaluates to int.
+The date to get the hour for. This can either be a date (Moment) or a reference to a field.
+The newly created filter function
+Build a filter function to get the start index of a substring. Evaluates to int.
+The string to get the index from. This can either be a string, a reference to a field or another filter function.
+The substring to get the index for. This can either be a string, a reference to a field or another filter function.
+The newly created filter function
+Checks if the data contains a collection result.
+Response of the OData v4 service
+true
, if the data is a collection result
Check whether a value is an EdmType. This will yield positive results for every string starting with Edm.
.
Value to test.
+Whether the given value is of type EdmTypeShared
+hidden
+Compare two decoded JWTs based on their tenantId
s.
User JWT payload.
+Provider JWT payload.
+Whether the tenant is identical.
+Checks if the property with name key of the entity is a navigation property.
+Name of the property.
+Constructor of the entity.
+A boolean denoting whether an entity is a navigation property or not.
+Build a filter function to test whether a selection is of a given type. Evaluates to boolean.
+The type to test for, e. g. API_BUSINESS_PARTNER.A_BusinessPartner
.
The newly created filter function
+Build a filter function to test whether a field is of a given type. Evaluates to boolean.
+A reference to a field to test for type.
+The type to test for, e. g. API_BUSINESS_PARTNER.A_BusinessPartner
.
The newly created filter function
+Convenience function to check whether a given EDM type is of type OrderableEdmType.
+Literal EDM type string to check.
+Whether the given edmType
is of type OrderableEdmType.
The user JWT can be a full JWT containing user information but also a reduced one setting only the iss value + This method divides the two cases.
+Token to be investigated
+Boolean value with true if the input is a UserJwtPair
+Get the issuer URL of a decoded JWT.
+Token to read the issuer URL from.
+The issuer URL if available.
+Returns a jwt bearer token that can be used to call the given service. + The token is fetched via a JWT bearer token grant using the user token + client credentials.
+Throws an error if there is no instance of the given service type or the XSUAA service, or if the request to the XSUAA service fails.
+The JWT of the user for whom the access token should be fetched
+The type of the service or an instance of Service.
+Options to influence resilience behavior (see ResilienceOptions). By default, usage of a circuit breaker is enabled.
+A jwt bearer token.
+Executes a JWT bearer token grant request against the given URI.
+The URL of the token service or the credentials of a XSUAA service instance.
+The credentials (client_id, client_secret) of the target XSUAA service instance.
+The JWT of the user on whose behalf the request is executed.
+Options to use by retrieving access token.
+A promise resolving to the response of the XSUAA service.
+Build a filter function to get the length of a string. Evaluates to int.
+The string to compute the length for. This can either be a string, a reference to a field or another filter function.
+The newly created filter function
+Build a filter function to test whether a string matches a pattern. Evaluates to boolean.
+The string to get the index from. This can either be a string, a reference to a field or another filter function.
+The pattern to test against. This should be a regular expression as a string.
+The newly created filter function
+Build a filter function to get the latest possible point in time. Evaluates to DateTimeOffset.
+The newly created filter function
+A base header object that contains the headers that will be compared with customHeaders
.
A header object to be compared with headers. Only headers present in headers
will be compared.
customHeaders
are replaced. Note that the case (upper / lower) used by customHeaders
will be used.Build a filter function to get the earliest possible point in time. Evaluates to DateTimeOffset.
+The newly created filter function
+Build a filter function to get the minute of a date. Evaluates to int.
+The date to get the minute for. This can either be a date (Moment) or a reference to a field.
+The newly created filter function
+Build a filter function to get the month of a date. Evaluates to int.
+The date to get the month for. This can either be a date (Moment) or a reference to a field.
+The newly created filter function
+Negate a filter.
+The filter to negate.
+The negated filter.
+Build a filter function to get the current point in time. Evaluates to DateTimeOffset.
+The newly created filter function
+Combine Filterables with logical or
to create a FilterList.
Example:
+Entity.requestBuilder()
+ .getAll()
+ .filter(or(filterExp1, filterExp2));
+
+ Type of the entity filter on.
+Filterables to be combined with logical or
The newly created FilterList
+Parse the complete batch HTTP response.
+HTTP response of a batch request.
+An array of parsed sub responses of the batch response.
+Takes a JSON object returned by any of the calls to the destination service and returns an SDK compatible destination object. + This function only accepts destination configurations of type 'HTTP' and will error if no 'URL' is given.
+A JSON object returned by the destination service.
+An SDK compatible destination object.
+Parse the entity name from the metadata uri. This should be the __metadata
property of a single entity in the response.
The URI to parse the entity name from
+The entity name.
+Parse the HTTP code of response.
+String representation of the response.
+The HTTP code.
+Parse the body and http code of a batch sub response.
+A batch sub response.
+The parsed response.s
+The URL of the token service or the credentials of a XSUAA service instance.
+The credentials (client_id, client_secret) of the target XSUAA service instance.
+The refresh token that should be used to generate a new access token.
+Options to use by retrieving access token.
+A promise resolving to the response of the XSUAA service.
+A base header object that contains the headers that will be compared with customHeaders
.
A header object to be compared with headers. Only headers present in headers
will be compared.
headers
object, where headers present in the customHeaders
are replaced. Note that the case (upper / lower) used by customHeaders
will be used.Takes a string that represents the service type and resolves it by calling getService. + If the parameter is already an instance of Service, it is returned directly.
+Throws an error when no service can be found for the given type.
+A string representing the service type or a Service instance.
+A Service instance.
+Retrieve JWT from a request that is based on the node IncomingMessage
. Fails if no authorization header is given or has the wrong format. Expected format is 'Bearer
Request to retrieve the JWT from
+JWT found in header
+Build a filter function to round a number. Evaluates to double or decimal, defaults to double.
+The number to round. This can either be a number, a reference to a field or another filter function.
+The return type to use.
+The newly created filter function
+Takes an existing or a parsed destination and returns an SDK compatible destination object.
+An object that adheres to the Destination interface.
+An SDK compatible destination object.
+Build a filter function to get the second of a date. Evaluates to int.
+The date to get the second for. This can either be a date (moment.Moment) or a reference to a field.
+The newly created filter function
+Serialize a batch request to string. This is used for the batch request payload when executing the request.
+Batch request to serialize.
+Request serialization options.
+String representation of the batch request.
+Serialize change set to string.
+Change set containing a collection of write operations.
+Request serialization options.
+The serialized string representation of a change set.
+Serialize a multipart request to string.
+Request serialization options.
+The serialized string representation of a multipart request, including the multipart headers.
+Returns an access token that can be used to call the given service. The token is fetched via a client credentials grant with the credentials of the given service. + If multiple instances of the provided service exist, the first instance will be selected. + When a JWT is passed, the tenant of the JWT will be used when performing the grant. + When no JWT is passed, the grant will be performed using the provider tenant.
+Throws an error if there is no instance of the given service type or the XSUAA service, or if the request to the XSUAA service fails.
+The type of the service or an instance of Service.
+Options to influence caching and resilience behavior (see CachingOptions and ResilienceOptions, respectively) and a JWT. By default, caching and usage of a circuit breaker are enabled.
+Access token.
+Split a batch response into an array of sub responses for the retrieve requests and changesets.
+The raw HTTP response.
+A list of sub responses represented as strings.
+Split a changeset (sub) response into an array of sub responses.
+The string representation of a change set response.
+A list of sub responses represented as strings.
+Split a string representation of a response into sub responses given its boundary.
+The string representation of the response to split.
+The boundary to split by.
+A list of sub responses represented as strings.
+Build a filter function to test whether a string starts with another. Evaluates to boolean.
+The string to test. This can either be a string, a reference to a field or another filter function.
+The prefix to test for. This can either be a string, a reference to a field or another filter function.
+The newly created filter function
+Prioritizes the selection of subscriber destinations.
+Retrieved destinations.
+Name of the destination to retrieve.
+the destination to retrieve, returns null
if no matched destination is found.
Build a filter function to get a substring starting from a designated position. Evaluates to string.
+The string to get a substring from. This can either be a string, a reference to a field or another filter function.
+The starting position of the substring. This can be either a number, a reference to a field or another filter function.
+The length of the substring. This can be either a number, a reference to a field or another filter function.
+The newly created filter function
+Build a filter function to test whether a string is a substring of the other. Evaluates to boolean.
+The substring to test for. This can either be a string, a reference to a field or another filter function.
+The string to test. This can either be a string, a reference to a field or another filter function.
+The newly created filter function
+Creates a tenant object from the JWT payload.
+ Throws an error if the property id
is not present in the payload.
Token payload to get the tenant information from.
+Representation of the tenant.
+Converts the given time to seconds in positive numerical format.
+Time to convert.
+number Time in seconds.
+Change set containing a collection of write operations.
+The serialized string representation of a change set.
+Change set containing a collection of write operations.
+The serialized string representation of a change set.
+The request builder of the retrieve request.
+The request body.
+The request builder of the retrieve request.
+The request body.
+Build a filter function to transform a string to lower case. Evaluates to string.
+The string to transform. This can either be a string, a reference to a field or another filter function.
+The newly created filter function
+The string to be transformed.
+The transformed string.
+The string to be transformed.
+The transformed string.
+Name of the header.
+Value of the header.
+The string to be transformed.
+The transformed string.
+The string to be transformed.
+The transformed string.
+The string to be transformed.
+The transformed string.
+Build a filter function to transform a string to upper case. Evaluates to string.
+The string to transform. This can either be a string, a reference to a field or another filter function.
+The newly created filter function
+Build a filter function to get the signed number of minutes in the time zone offset. Evaluates to int.
+The date to get the offset minutes for. This can either be a date (Moment) or a reference to a field.
+The newly created filter function
+Build a filter function to trim whitespace from a string. Evaluates to string.
+The string to trim whitespace from. This can either be a string, a reference to a field or another filter function.
+The newly created filter function
+Returns the parameter if it is a destination, calls getDestination otherwise (which will try to fetch the destination + from the Cloud Foundry destination service).
+Fetching a destination requires:
+If either of the prerequisites is not met or one of the services returns an error, this function will either throw an error or return a promise that rejects.
+A destination or the necessary parameters to fetch one.
+Caching options by fetching destination.
+A promise resolving to the requested destination on success.
+The JWT of the user for whom the access token should be fetched.
+The type of the service or an instance of Service.
+Options to influence resilience behavior (see ResilienceOptions). By default, usage of a circuit breaker is enabled.
+A user approved access token.
+Creates a user object from the decoded JWT.
+ Throws an error if no id
or userName
property is present on the JWT payload.
Token payload to get the user from.
+Representation of the user.
+The URL of the token service or the credentials of a XSUAA service instance.
+The JWT of the user on whose behalf the request is executed.
+The client_id of the target XSUAA service instance.
+Options to use by retrieving access token
+A promise resolving to the response of the XSUAA service.
+Verifies the given JWT and returns the decoded payload.
+JWT to be verified
+Options to control certain aspects of JWT verification behavior.
+A Promise to the decoded and verified JWT.
+Verifies the given JWT with the given key and returns the decoded payload.
+JWT to be verified.
+Key to use for verification.
+A Promise to the decoded and verified JWT.
+Wraps the access token in header's authorization.
+Token to attach in request header
+The request header that holds the access token
+Build a filter function to get the year of a date. Evaluates to int.
+The date to get the year for. This can either be a date (Moment) or a reference to a field.
+The newly created filter function
+This packages contains the generator to create your own service module using a service specification (.edmx
file).
$ npm install @sap-cloud-sdk/generator
+
+
+ The generator is primarily meant to be used on the command line:
+generate-odata-client --inputDir path/to/your/service-specification(s) --outputDir path/where/the/modules/are/stored
+
+ Run generate-odata-client --help
for further options.
You can also use the generator programmatically. You will have to provide the options anyways.
+import { generate } from '@sap-cloud-sdk/generator';
+
+// initialize generator options based on what you want to do
+const options: GeneratorOptions = initializeOptions();
+
+// generate the client using the provided options
+generate(options);
+
+ For more detailed overview visit our generator documentation.
+ + + +The recommended way to get in touch with us is to create an issue in our github repository.
+ Select the issue category Bug
, Feature
or Question
depending on the nature of your request.
+ We try to provide fixes, features and answers as soon as possible.
We also monitor questions on StackOverflow and ansers.sap.com but prefer issues on github.
+ +If you would like to contribute to the SAP Cloud SDK, please make yourself familiar with our contributing guidelines and follow the given instructions.
+ +The SAP Cloud SDK is released under the Apache License Version 2.0.
+ +This package contains the generator to create your own service module using a OpenAPI specification. + This generator is based on the OpenAPI Tools generator for OpenAPI and adds some additional code for convenience to better integrate with the SAP Cloud SDK.
+ +$ npm install @sap-cloud-sdk/openapi-generator
+
+
+ generate-openapi-client --input <input> --outputDir <outputDirectory>
Generate OpenAPI client(s), that use the connectivity features of the SAP Cloud SDK for JavaScript/TypeScript.
+USAGE
+ $ generate-openapi-client --input <input> --outputDir <outputDirectory>
+
+OPTIONS
+ -c, --config=<path/to/config.json>
+ Set the path to a file containing the options for generation instead of setting the options on the command line.
+ When combining the `config` option with other options on the command line, the command line options take precedence.
+ If a directory is passed, a `config.json` file is read from this directory.
+
+ -i, --input=<path/to/input>
+ (required) Specify the path to the directory or file containing the OpenAPI service definition(s) to generate
+ clients for. Accepts Swagger and OpenAPI definitions as YAML and JSON files. Throws an error if the path does not
+ exist.
+
+ -o, --outputDir=<path/to/output>
+ (required) Specify the path to the directory to generate the client(s) in. Each client is generated into a
+ subdirectory within the given output directory. Creates the directory if it does not exist. Customize subdirectory
+ naming through `--optionsPerService`.
+
+ -t, --transpile
+ Transpile the generated TypeScript code. When enabled a default `tsconfig.json` will be generated and used. It emits
+ `.js`, `.js.map`, `.d.ts` and `.d.ts.map` files. To configure transpilation set `--tsconfig`.
+
+ --clearOutputDir
+ Remove all files in the output directory before generation. Be cautious when using this option, as it really removes
+ EVERYTHING in the output directory.
+
+ --include=<glob/to/include>
+ Include files matching the given glob into the root of each generated client directory.
+
+ --optionsPerService=<path/to/options-per-service.json>
+ Set the path to a file containing the options per service. The configuration allows to set a `directoryName` and
+ `packageName` for every service, identified by the path to the original file. It also makes sure that names do not
+ change between generator runs. If a directory is passed, a `options-per-service.json` file is read/created in this
+ directory.
+
+ --overwrite
+ Allow to overwrite files, that already exist. This is useful, when running the generation regularly.
+
+ --packageJson
+ When enabled, a `package.json`, that specifies dependencies and scripts for transpilation and documentation
+ generation is generated.
+
+ --skipValidation
+ By default, the generation fails, when there are duplicate or invalid names for operations and/or path parameters
+ after transforming them to camel case. Set this to true to enable unique and valid name generation. The names will
+ then be generated by appending numbers and prepending prefixes.
+
+ --tsConfig=<path/to/tsconfig.json>
+ Replace the default `tsconfig.json` by passing a path to a custom config. By default, a `tsconfig.json` is only
+ generated, when transpilation is enabled (`--transpile`). If a directory is passed, a `tsconfig.json` file is read
+ from this directory.
+
+ --verbose
+ Turn on verbose logging.
+
+EXAMPLES
+
+ // generate TypeScript clients from OpenAPI definitions in a directory
+ $ openapi-generator --input ./my-specs --outputDir ./clients
+
+ // generate a JavaScript client from a OpenAPI definition file
+ $ openapi-generator --input ./my-spec.yaml --outputDir ./client --transpile
+
+ See code: dist/cli/index.ts
+ + + +import { generate } from '@sap-cloud-sdk/openapi-generator';
+
+// initialize generator options based on what you want to do
+// note that inputDir and outputDir are mandatory
+const options: GeneratorOptions = {
+ inputDir: 'path/to/inputDir',
+ outputDir: 'path/to/outputDir'
+};
+
+// generates the files and writes them to the outputDir
+await generate(options);
+
+ For more detailed overview visit our generator documentation.
+ + + +The recommended way to get in touch with us is to create an issue in our github repository.
+ Select the issue category Bug
, Feature
or Question
depending on the nature of your request.
+ We try to provide fixes, features and answers as soon as possible.
We also monitor questions on StackOverflow and ansers.sap.com but prefer issues on github.
+ +If you would like to contribute to the SAP Cloud SDK, please make yourself familiar with our contributing guidelines and follow the given instructions.
+ +The SAP Cloud SDK is released under the Apache License Version 2.0.
+ +Main entry point for the OpenAPI client generation. + Generates models and API files.
+Options to configure generation.
+This package contains utility functions for testing, like loading credentials or creating test destinations.
+ +$ npm install @sap-cloud-sdk/test-util
+
+
+ The test-util package makes writing tests for your SAP Cloud Platform application more convenient.
+For example, you can create a mock destination for your tests by using the function mockTestDestination
.
import { mockTestDestination } from '@sap-cloud-sdk/util';
+mockTestDestination('mockDestinationName');
+
+ You need to save your system information in local file systems.json
:
{
+ "systems": [
+ {
+ "alias": "mockDestinationName",
+ "uri": "https://www.example.com"
+ }
+ ]
+}
+
+ and credentials.json
:
{
+ "credentials": [
+ {
+ "alias": "SYS_001",
+ "username": "username",
+ "password": "password"
+ }
+ ]
+}
+
+
+
+
+ The recommended way to get in touch with us is to create an issue in our github repository.
+ Select the issue category Bug
, Feature
or Question
depending on the nature of your request.
+ We try to provide fixes, features and answers as soon as possible.
We also monitor questions on StackOverflow and ansers.sap.com but prefer issues on github.
+ +If you would like to contribute to the SAP Cloud SDK, please make yourself familiar with our contributing guidelines and follow the given instructions.
+ +The SAP Cloud SDK is released under the Apache License Version 2.0.
+ +Loads a destination matching the provided alias stored in systems.json
and credentials.json
.
+ By default, this function starts looking in the directory the test process has been started in (i.e. '.')
+ and traverses the file hierarchy upwards until it finds a systems.json and credentials.json file.
+ Alternatively, you can supply paths to the systems and the credentials file directly.
Throws an error when no systems.json can be found, the alias does not match any of the available destinations, + the JSON is malformed or one of the supplied paths is invalid. + Does not throw an error when no credentials.json can be found, but will print a warning.
+The alias identifying the destination
+References to the systems.json
and credentials.json
files
An array of destinations
+Loads all destinations stored in systems.json
and credentials.json
files.
By default, this functions starts looking in the directory the test process has been started in (i.e. '.') + and traverses the file hierarchy upwards until it finds a systems.json and credentials.json file. + Alternatively, you can supply paths to the systems and the credentials file directly.
+Throws an error when no systems.json can be found, the JSON is malformed or one of the supplied paths is invalid. + Does not throw an error when no credentials.json can be found, but will print a warning.
+References to the systems.json
and credentials.json
files
An array of destinations
+Add all destinations from the systems.json
and credentials.json
files to the destinations
environment variable.
Throws an error if a destination with the same name as the given test destinations already exists.
+References to the systems.json
and credentials.json
files
Add a destination with the given name from the systems.json
and credentials.json
files to the destinations
environment variable.
Throws an error if a destination with the same name as the given test destination already exists.
+Name of the test destination to add to the destinations
environment variable
References to the systems.json
and credentials.json
files
Set a given destination in the destinations
environment variable.
Throws an error if a destination with the same name as the given test destination already exists.
+Test destination to add to the destinations
environment variable
Removes all test destinations stored in systems.json
and credentials.json
files or added through setTestDestination() from the destinations
environment variable.
This function should be called to invert the behavior of mockAllTestDestinations() and other add single mocked destination functions.
+Removes a destination with the given name from the destinations environment variable. If the given destination name is not found calling this function has no effect. + This function should be called to invert the behavior of mockTestDestination() and setTestDestination().
+Name of the mocked destination to remove
+This package contains general utility functions that we reuse multiple times in the SDK. + While primarily designed for internal usage, they might also be beneficial for consumers of the SDK.
+ +$ npm install @sap-cloud-sdk/util
+
+
+ The util package collects useful tools that help build your SAP Cloud Platform application. + For example, the following code snippet changes the log level of the destination accessor of the SDK.
+import { setLogLevel } from '@sap-cloud-sdk/util';
+setLogLevel('debug', 'destination-accessor');
+
+
+
+
+ The recommended way to get in touch with us is to create an issue in our github repository.
+ Select the issue category Bug
, Feature
or Question
depending on the nature of your request.
+ We try to provide fixes, features and answers as soon as possible.
We also monitor questions on StackOverflow and ansers.sap.com but prefer issues on github.
+ +If you would like to contribute to the SAP Cloud SDK, please make yourself familiar with our contributing guidelines and follow the given instructions.
+ +The SAP Cloud SDK is released under the Apache License Version 2.0.
+ +Npm log levels used for the SAP Cloud SDK logger.
+Denotes the OData version.
+Default logger for the SAP Cloud SDK for unhandled exceptions.
+Format for logging in Kibana.
+Format for local logging.
+Within all files generated by the SDK we use the unix style end of line delimiter.
+ We do not consider if the generator is executed on windows or unix systems.
+ It will always be \n
to have consistent clients between operating systems.
For request payloads, etc., it is convention to use the \r\n
new line.
Adds a key value pair to the given objects and returns a shallow copy. + If the key is already present it will be overwritten.
+key to be added
+value to be added
+object the key value pair is added to.
+the object with the key value pair added
+The key to associate with the given value.
+The value to associate with the given key.
+A copy of the input object with the new key-value pair if the value is neither null
nor undefined
.
The object on which to create the association.
+Same as pipe but for asynchronous functions:
+ asyncPipe(func1, func2, ...funcN)(start)
executes all functions in sequence awaiting the result and piping the response through in other words await funcN(... await func2(await func1(start))...)
.
A list of asynchronous functions to be executed in sequence.
+The return value of the last function in the list.
+Start value for the first function in the list.
+Convert a string to camelCase. This format used e. g. for properties on entity class instances.
+The string to be transformed.
+The transformed string.
+Returns the OData version in capital letters so V2 or V4.
+OData version in lower case: 'v2' or 'v4'
+'V2' or 'V4'
+Checks whether a URL is existing via a head request.
+URL to be checked
+promise - resolves if the URL exists
+Strings in the tagged template. In the example above that would be ['Code with ', ' and more code;'].
+Arguments in the tagged template. In the example above that would be the resolved value for arguments
;
A string formatted as code block.
+Create a logger for the given message context, if available.
+Usage:
+ To create a logger in your module, it is recommended to pass a module identifier that will be logged as messageContext
for all messages from this logger:
+ const logger = createLogger('my-module');
. Not setting any module identifier will retrieve the default logger.
+ Use this logger throughout your module. If the module is spread over multiple files, you can retrieve the logger instance by calling the createLogger
function with the respective module identifier.
+ There will always be only one instance of a logger per module identifier.
+ You can pass any custom data that you want to be logged in addition by passing an object instead. You can change the default logging level (INFO
) using the level
key in the object.
+ In those cases, provide the messageContext
as a key in the object:
const logger = createLogger({
+ messageContext: 'my-module',
+ myCustomKey: 'my-custom-data',
+ level: 'debug'
+});
+
+ You will find these information under the custom_fields key in your Cloud Foundry logs.
+To retrieve a logger after its creation use getLogger. + If you want to change the log level of a logger use setLogLevel.
+Either a key for the message context of all messages produced by the logger or an object with additional keys to set in the message.
+A newly created or an already existing logger for the given context.
+Disable logging of exceptions. Enabled by default.
+Strings in the tagged template. In the example above that would be ['Docs with ', ' and more content;'].
+Arguments in the tagged template. In the example above that would be the resolved value for arguments
;
A string formatted as documentation block.
+Enable logging of exceptions. Enabled by default.
+Encode a string to a base64 encoded string.
+String to encode.
+Base64 encoded string.
+hidden
+hidden
+hidden
+Error message.
+Original error, causing the new error.
+A new error with the given cause.
+Create a shallow copy of the given object, that does not contain the given keys. + Non existing keys in the source object are ignored.
+properties to be selected
+object from which the values are taken
+an object with the selected keys and corresponding values.
+Filter an array by removing duplicates and keeping the left most occurrence. By default this compares by identity.
+Array to remove duplicates from.
+Optional comparator function, indicating whether two items are equal and therefore handled as duplicates. Defaults to identity.
+A filtered array containing no duplicates.
+Filter an array by removing duplicates and keeping the right most occurrence. By default this compares by identity.
+Array to remove duplicates from.
+Optional comparator function, indicating whether two items are equal and therefore handled as duplicates. Defaults to identity.
+A filtered array containing no duplicates.
+Await all promises and resolve if non of them failed. + Reject if at least one of them was rejected, but only once all of them are finished. + Throws an error consisting of a list of reasons.
+Promises to settle.
+Message to use as introductory text of the error if an error occurs.
+Get the first item from an array. Returns undefined
, if the array is empty.
Array to get the first item of.
+Fist item of the array or undefined
, if the array was empty.
Flatten a two dimensional array into a one dimensional array
+The array to be flattened.
+A one dimensional array.
+Flattens a array: [1,[2,[3,4]],5] will become [1,2,3,4,5]. + Non primitive values are copied by reference.
+Array to be flattened
+The flattened array.
+Convert a JSON object to a string using formatting in line with the prettier with indentation and new line at the end.
+Object to be stringified
+The JSON object as string.
+Get logger for a given message context, if available.
+A key for the message context of all messages produced by the logger
+The logger for the given messageContext if it was created before
+Identity function
+Any object
+the given argument without doing something
+Type guard to check whether an error is of type ErrorWithCause.
+An error.
+Whether the given error is of type ErrorWithCause.
+Checks whether a value is either null
or undefined
.
Value to check.
+true
for null
or undefined
, false
otherwise.
Convert a string to kebab case. This format is used e. g. for file names.
+The string to be transformed.
+The transformed string.
+Get the last item from an array. Returns undefined
, if the array is empty.
Array to get the last item of.
+Last item of the array or undefined
, if the array was empty.
Create an object by merging the right
object into a shallow copy of the left
object ignoring casing, but keeping the right casing. Keys present both objects will be present in the merged object.
Object to merge.
+Object to merge. The casing of the keys of this object takes precedence.
+right
object are replaced. Note that the casing used by right
will be used.Create an object by merging the right
object into a shallow copy of the left
object ignoring casing, but keeping the right
casing. Only keys present in the left
object will be present in the merged object.
Object to merge into. They keys of this object will be present in the returned object.
+Object to merge. Only keys in left
will be considered for merging.
left
object, where entries present in the right
object are replaced. Note that the casing used by right
will be used.The object to merge into.
+The object which to merge into a
.
A copy of the merge(a, b)
or a
if b
is undefined
or null
.
Mute all logger output created by the SAP Cloud SDK Logger. This also applies to future loggers created. Useful for tests.
+Split an array into two based on a condition.
+Array to partition.
+Function to determine to where to put each item.
+A two dimensional array containing two arrays, where the first one includes all items where the given condition was met and the second one includes all items where it was not met.
+Convert a string to pascal case. This format is used e. g. for types.
+The string to be transformed.
+The transformed string.
+Create a shallow copy of the given object, that contains the given keys. + Non existing keys in the source object are ignored.
+properties to be selected
+object from which the values are taken
+an object with the selected keys and corresponding values.
+Create a shallow copy of the given object, that contains the given keys, independent of casing. + Non existing keys in the source object are ignored.
+Object to pick the given key from.
+Keys of the pair to be picked.
+Create a shallow copy of the given object, that contains all entries with non-nullish values.
+An object to pick from.
+Returns the value of an object based on the given key, independent of casing.
+Object to be searched for the given key.
+Key of the value to pick.
+The value of for the given key or undefined
, if not available.
Checks if a chain of properties exists on the given object.
+The object to be checked.
+Chained properties.
+true
if the property chain leads to a truthy value, false
otherwise.
Read a JSON file from the file system.
+The path to the JSON file.
+An object parsed from the JSON file.
+Remove file extension from a string, e.g. remove 'test.jpg' would return 'test'
+File name to remove the file extension from.
+File name without extension.
+Takes an object and returns a new object whose keys are renamed according to the provided key mapping. + Any keys in the input object not present in the key mapping will be present in the output object as-is. + If a key in the key mapping is not present in the input object, the output object will contain the key with value "undefined".
+An object mapping keys of the input object to keys of the output object.
+The input object.
+An object with renamed keys.
+Change the global log level of the container which will set default level for all active loggers.
+ E. g., to set the global log level call setGlobalLogLevel('debug')
.
The log level to set the global log level to.
+Change the log level of a logger based on its message context.
+ E. g., to set the log level for the destination accessor module of the SDK to debug, simply call setLogLevel('debug', 'destination-accessor')
.
level to set the logger to. Use an empty string '' as level to unset context level.
+Message context of the logger to change the log level for or the logger itself
+Split the given array in chunks.
+Array to be split into chunks.
+Size of the chunks.
+Two dimensional array with arrays of length chunkSize. The last subarray could be shorter.
+Convert a string to a human readable format, e.g. it transforms to_BusinessPartner
to To Business Partner
.
The string to be transformed.
+The transformed string.
+Create an object based on the given key and value if neither key nor value are nullish.
+Name of the header.
+Value of the header.
+Remove whitespace from the left side of a string.
+String to trim.
+String without outer whitespace.
+Remove whitespace from the left side of a string.
+String to trim.
+String without whitespace on the left side.
+Remove whitespace from the right side of a string.
+String to trim.
+String without whitespace on the right side.
+Remove all duplicates from an array.
+Array that might contain duplicates.
+Array of unique items.
+Unmute all logger output created by the SAP Cloud SDK Logger. This also applies to future loggers created. Useful for tests.
+Convert a string to the uppercase snake case. This format is used e. g. for static properties on entity classes.
+The string to be transformed.
+The input string in the case used by static methods on entity-classes.
+We want to provide methods which accept a variable single number of elements and arrays. + The overloaded signature to achieve this is:
+function doSomething(array: T[])
+function doSomething(...varArgs: T[])
+function doSomething(first: undefined | T | T[], ...rest: T[]) {
+ //implementation
+}
+
+ This wrapper methods makes it easy build an array from the input.
+Either an array, the first element of the var args or undefined
, if no argument was given.
Second to last element, if var args were used, empty array, if the first argument is an array.
+Array from the input or empty array if no input was given.
+Merge two arrays by alternately adding inserting values from both arrays, starting from the left.
+ For example: zip([1, 2], [3, 4, 5, 6])
results in [1, 3, 2, 4, 5, 6]
Array to start alternately merging from.
+Second array to merge.
+Zipped array.
+
Create OData request to execute a action or function import.
+