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 funciton 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
+Execute request
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the requested return type
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+Execute request
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the requested return type
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+The request builder itself, to facilitate method chaining
+Represents a selectable property with with an unknown or currently unsupported edm type like Edm.Geography.
+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
+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. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+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 subrequests. Defaults to an autogenerated 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 excuted 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
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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.
+Represents a selectable property with a big number value.
+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
+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. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+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 selectable property with a binary value.
+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
+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. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+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 property with a binary value.
+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
+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. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+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 selectable property with a boolean value.
+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
+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. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+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 property with a boolean value.
+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
+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. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+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 static field of an entity or complex type.
+Type of the entity the field belongs to
+Type of the entries of the collection in the field
+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.
+Type of the field according to the metadata description.
+Path to the field to be used in filter and order by queries. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+Path to the field to be used in filter and order by queries.
+Represents a complex type property with with an unknown or currently unsupported edm type like Edm.Geography.
+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
+Represents a complex type property with a big number value.
+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
+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
+Represents a complex type property with a binary value.
+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
+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
+Represents a complex type property with a boolean value.
+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
+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
+Represents a complex type property with a date value.
+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
+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
+Represents a complex type property with a duration value.
+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
+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
+Represents a complex type property with a enum value.
+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.
+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
+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.
+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.
+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.
+Represents a complex type property with a number value.
+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
+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
+Represents a complex type property with a string value.
+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
+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
+Represents a complex type property with a time value.
+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
+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
+Execute request.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the number of entities
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+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
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+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
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+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
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+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. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+Path to the field to be used in filter and order by queries.
+Represents a selectable property with a date value.
+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
+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. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+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 with a date value.
+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
+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. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+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
+Execute query.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving once the entity was deleted
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+Execute query.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving once the entity was deleted
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+Execute query.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving once the entity was deleted
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+The request builder itself, to facilitate method chaining
+Represents a selectable property with a duration value.
+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
+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. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+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 with a duration value.
+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
+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. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+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 and are generated from the metadata, i.e. for each property of
+ an OData entity, that has an Edm type, there exists 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
+Type of the field
+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
+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. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+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
+Initializes or sets the remoteState of the entity. + This function is called on all read, create and update requests. + This function should be called after initializeCustomFields, if custom fields are defined.
+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
+Initializes or sets the remoteState of the entity. + This function is called on all read, create and update requests. + This function should be called after initializeCustomFields, if custom fields are defined.
+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
+Initializes or sets the remoteState of the entity. + This function is called on all read, create and update requests. + This function should be called after initializeCustomFields, if custom fields are defined.
+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 selectable property with a enum value.
+Type of the entity the 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. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+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
+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
+Creates an instance of Field.
+Actual name of the field used in the OData request
+Constructor type of the entity the field belongs to
+Path to the field to be used in filter and order by queries. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+Path to the field to be used in filter and order by queries.
+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
+EdmType 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.
+EdmType 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.
+Flattens andFilters
and orFilters
as far as possible while staying logically equivalent.
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
+Execute request
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the requested return type
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+Execute request
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the requested return type
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+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
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+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
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+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
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+Execute request.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the requested entity
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+Execute request.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the requested entity
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+Execute request.
+Destination to execute the request against
+Options to employ when fetching destinations
+A promise resolving to the requested entity
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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 -> Link, 1:0..1 -> OneToOneLink + OData v4 entity: 1:N -> OneToManyLink, 1:0..1 -> 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
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+The request builder itself, to facilitate method chaining
+Represents a selectable property with a number value.
+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
+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. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+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 with a number value.
+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
+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. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+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
+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
+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 excuted 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
+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.
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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 excuted 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
+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.
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+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
+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
+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
+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
+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
+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
+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
+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
+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
+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
+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
+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.
+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
+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
+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 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.
+OrderBy statements to order the response by
+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
+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
+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 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
+Interface of the generated api. All properties of the interface will be treated as functions.
+Literal string type of the function name, must be a key of ApiT
and represent a function.
Create an instance of RestRequestBuilder
.
Constructor of the underlying OpenApi api definition.
+Name of the function represented in thie request builder.
+Arguments to pass to the api function.
+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
+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.
+A promise resolving to the requested return type.
+Execute request and get a raw AxiosResponse, 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.
+A promise resolving to an AxiosResponse.
+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
+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
+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
+Represents a selectable property with a string value.
+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
+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. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+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
+Represents a selectable property with a time value.
+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
+Path to the field to be used in filter and order by queries. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+Path to the field to be used in filter and order by queries.
+Represents a property with a time value.
+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
+Path to the field to be used in filter and order by queries. In most cases this will just be the _fieldName itself. However, for complex types for instance, the path is prefixed with the name of the complextype.
+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
+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
+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.
+this The request itself to ease chaining while executing the request
+Specifies entity fields to ignore by the update 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
+Specifies required entity keys for the update request.
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+The request builder itself, to facilitate method chaining
+Specifies a custom 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
+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
+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.
+this The request itself to ease chaining while executing the request
+Specifies entity fields to ignore by the update 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
+Specifies required entity keys for the update request.
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+The request builder itself, to facilitate method chaining
+Specifies a custom 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
+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
+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
+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.
+this The request itself to ease chaining while executing the request
+Specifies entity fields to ignore by the update 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
+Specifies required entity keys for the update request.
+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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
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
+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
+Add custom headers to the request.
+Key-value pairs denoting additional custom headers
+The request builder itself, to facilitate method chaining
+Add custom query parameters to the request.
+Key-value pairs denoting additional custom query parameters to be set 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 S/4HANA apis the servicePath defaults to '/sap/opu/odata/sap/
Path to override the default with
+The request builder itself, to facilitate method chaining
+Specifies a custom 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
+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 seperated 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 seperated 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 seperated 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 seperated 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.
+Enum representing the different strategies for proxying request. Possible situations are "NO_PROXY", use the connectivity service proxy for On-Premise connection or a usual web proxy. + See also ProxyConfiguration for more details.
+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.
+Interface to represent header and payload of a JWT.
+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, optional.
+Array of certificates used for authentication type ClientCertificateAuthentication.
+Client Id used to retrieve access token for "OAuth2ClientCredentials" authentication.
+Client Secret used to retrieve access token for "OAuth2ClientCredentials" 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.
+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, optional.
+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, optional, not used.
+Client to target in an SAP system, will be added as HTTP header sap-client
if set, optional.
System user to be used for OAuth2SAMLBearerAssertion authentication type.
+Password for tokenServiceUser (if required).
+URL to retrieve access token for "OAuth2ClientCredentials" 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, mandatory.
+The URL needs to define at least scheme (protocol like http://
or https://
) and 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.
+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.
+Destination configuration alongside authtokens and certificates.
+Destination configuration alongside authtokens and certificates.
+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.
+Interface representing the return of the getFilter creator createGetFilter.
+Interface for the http-agent within the Axios request config.
+This interface is compatible with AxiosRequestConfig.
+Interface for the https-agent within the Axios request config.
+Interface to represent the payload of a JWT.
+Interface to represent the payload of a JWT.
+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
+Interface to represent the basic properties like issuer, audience etc.
+Keys in the JWT related to the user
+Representation of the scope. A scope is assigned to a user via role-collection in cloud foundry.
+Interface denoting a selectable EdmTypeField.
+This property denotes that this is a selectable edm type 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.
+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).
+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
+Credentials for the XSUAA service.
+Log message context for a logger with additional custom data.
+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.
+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);
+
+
+ Getting started guide + API documentation
+ +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.
+Allowed Edm types for OData v4.
+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.
+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 represenation of all parameters
+A union of all types that can be used for ordering.
+Type of the entity to be ordered
+A union of all types that can be used as input for ordering.
+Type of the entity to be ordered
+Interface to represent the registered claims of a JWT.
+Represents all selectables, i.e. everything that can be used in a .select
statement.
Type of the entity to be selected on
+Selector of destination selection strategies. See alwaysProvider, alwaysSubscriber and subscriberFirst for more information available selection strategies.
+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 and the
+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 destiation with the added proxy configuration.
+Adds the proxy configuration to a destination based on web proxies defined in environment variables. See ProxyConfiguration and proxyStrategy for details.
+to which the proxy configuration is added.
+Destination containing the configuration for web proxy.
+Will return the entity if all elements of the multilink 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
+Create a FilterList by combining Filterables with logical and
.
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 to be filtered on
+Filterables to be combined with logical and
The newly created FilterList
+Will return the entity if at least one element of the multilink 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.
+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 in the decoded JWT. If not an error is raised
+The key of the representation in typescript
+The mapping between the typescript keys and the JWT key
+Decoded token on which the check is done
+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 an 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 in the JWT
+Token to read the custom attributes
+custom attributes added by the xsuaa 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 paramter 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.
+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 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.
+Reponse 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.
+URL of the XSUAA service instance.
+Client ID of the XSUAA service instance.
+Client secret of the XSUAA service instance.
+An array of TokenKeys.
+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
+Returns the http or https-agent config depending on the destination URL. + If the destination contains a proxy configuration, the agent will be a proxy-agent. + If not it will be the default http-agent coming from node.
+determining which kind of configuration is returned
+The http or http-agent configuration.
+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
+any[] - 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 = EdmTypeShared and edmTypeOrUndefined = undefined or complexTypeNameOrEdmType = string of complextype and edmTypeOrUndefined = EdmTypeShared.
+Either the name of the complex type or the EdmType
+Either the EdmType or undefined.
+The EdmType 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
+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 seralized request as
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
+any[] - Collection extracted from the response
+Retrieves an access token required for "OAuth2ClientCredentials" destination authentication type.
+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
+Record<string, any> - single object extracted from the response
+URL of this destination is parsed
+The protocol either undefined if no :// is found or anything before the delimiter.
+'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. wheter 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. wheter 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
+boolean - 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 tenantIds.
+User JWT
+Provider JWT
+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
+Get the issuer url of a decoded JWT.
+Token to read the issuer url from.
+The issuer url if available.
+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
+Build a filter function to get the current point in time. Evaluates to DateTimeOffset.
+The newly created filter function
+Create a FilterList by combining Filterables with logical or
.
Example:
+Entity.requestBuilder()
+ .getAll()
+ .filter(or(filterExp1, filterExp2));
+
+ Type of the entity to be filtered 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.
+Parses the environment variable for the web proxy and extracts the values considering defaults like http for the protocol and 80 or 443 for the port. + The general pattern to be parsed is protocol://user:password@host:port, where everything besides the host is optional. + Special characters in the user and password need to be percent encoded.
+Environment variable which is parsed
+Configuration with default values or undefined if the parsing failed.
+Parse the body and http code of a batch sub response.
+A batch sub response.
+The parsed response.s
+Builds the http(s)-agent config. Note that the proxy agent type like http or https is determined by the destination RUL protocol. + The protocol from the proxy is unrelated to this and in most cases http.
+Destination containing the proxy configurations
+The http(s)-agent containing the proxy configuration
+Determines the proxy strategy. If noProxy is set the ProxyConfiguration in the destination is omitted. + For onPremProxy or internetProxy the connectivy service or enviroment variables are checked to fill the ProxyConfiguration.
+from which the proxy strategy is derived.
+ProxyStrategy possible values are noProxy, internetProxy or onPremProxy.
+Executes a refresh token grant request against the given URI. + If the first parameter is an instance of XsuaaServiceCredentials, the response's access_token will be verified. + If the first parameter is an URI, the response will not be verified.
+The URL of the token service or the credentials of a XSUAA service instance.
+The credentials (client_id, client_secret) if 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 decoded JWT.
+Decoded JWT token
+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.
+Returns a user approved access token that can be used to call the given service on behalf of the given user. The token is fetched via user token + refresh token grant. + This can be necessary for scenarios in which a token for a service is required, but the service needs + to know about the user on whose behalf the request is performed (for example to let the destination + service perform principal propagation with SAP S/4HANA Cloud).
+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 user approved access token.
+Creates a user object from the decoded JWT.
+Decoded JWT toeken
+Representation of the user
+Executes a user token grant request against the given URI.
+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
+Generate 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 { generateProject } from '@sap-cloud-sdk/generator';
+
+// initialize generator options based on what you want to do
+const options: GeneratorOptions = initializeOptions();
+
+// creates a Project datastructure with all sourcefiles based on your options
+const project = generateProject(options);
+
+// here you can modify you project if you need to
+
+// save the files at the specified location
+project.save();
+
+// alternatively you can generate and save the project in one step with: generate(options)
+
+
+ Getting started guide + API documentation
+ +Generate custom JavaScript/TypeScript clients for services with OpenAPI specifications. + 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.
+ +The official OpenAPI generator is Java based, therefore you need to have a Java runtime installed to use the SAP Cloud SDK OpenAPI generator.
+ +$ npm install @sap-cloud-sdk/openapi-generator
+
+
+ generate-openapi-client autocomplete [SHELL]
display autocomplete installation instructions
+USAGE
+ $ generate-openapi-client autocomplete [SHELL]
+
+ARGUMENTS
+ SHELL shell type
+
+OPTIONS
+ -r, --refresh-cache Refresh cache (ignores displaying instructions)
+
+EXAMPLES
+ $ generate-openapi-client autocomplete
+ $ generate-openapi-client autocomplete bash
+ $ generate-openapi-client autocomplete zsh
+ $ generate-openapi-client autocomplete --refresh-cache
+
+ See code: @oclif/plugin-autocomplete
+ +generate-openapi-client help [COMMAND]
display help for generate-openapi-client
+USAGE
+ $ generate-openapi-client help [COMMAND]
+
+ARGUMENTS
+ COMMAND command to show help for
+
+OPTIONS
+ --all see all commands in CLI
+
+ See code: @oclif/plugin-help
+ + +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);
+
+
+ Getting started guide + API documentation
+ +Options to configure generation.
+Package that 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"
+ }
+ ]
+}
+
+
+ Getting started guide + API documentation
+ +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
+Package that 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');
+
+
+ Getting started guide + API documentation
+ +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.
+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
+Adds the value to the object if it is neither null nor undefined. + Note that this is different to JS idiomatic checks for truthy/falsy values, i.e. an empty string will result in key/value pairs beeing 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: + asynvPipe(finc1,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 reponse 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'
+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.
+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.
+Filter an array by removing duplicates and keeping the left most occurence. 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 occurence. 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.
+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.
+Get logger for a given message context, if avilable.
+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.
+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.Merges the two objects, if second object is neither null nor undefined. + If a key exists on a and b the value from b is taken
+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 containting 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.
+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')
.
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-acessor')
.
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 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[]) + functiondoSomething(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 frist 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])
=> [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.
+