This section describes the ODataContext's configuration properties.
Specifies a function that customizes the request before it is sent to the server.
Function parameters:The request parameters.
Object structure:
Name Type Description asyncIndicates whether the request is asynchronous or synchronous.
headersThe request headers.
methodThe request method ("GET", "POST", "PATCH", or "MERGE").
paramsAdditional parameters.
payloadThe request body; for example, when updating an item, this property holds an object with new values.
Unavailable if the request method is "GET".
The request timeout.
urlThe request URL.
jQueryvar context = new DevExpress.data.ODataContext({ url: "https://js.devexpress.com/Demos/DevAV/odata/", entities: { Employees: { key: "Employee_ID", keyType: "Int32" }, Customers: { key: "Customer_ID", keyType: "Int32" } }, beforeSend: function (e) { e.params = { "param1": "value1", "param2": "value2" }; e.headers = { "Custom Header": "value" }; } });Angular
import ODataContext from "devextreme/data/odata/context"; // ... export class AppComponent { context: ODataContext; constructor() { this.context = new ODataContext({ url: "https://js.devexpress.com/Demos/DevAV/odata/", entities: { Employees: { key: "Employee_ID", keyType: "Int32" }, Customers: { key: "Customer_ID", keyType: "Int32" } }, beforeSend: (e) => { e.params = { "param1": "value1", "param2": "value2" }; e.headers = { "Custom Header": "value" }; } }); } }Vue
<script> import ODataContext from 'devextreme/data/odata/context'; const context = new ODataContext({ url: 'https://js.devexpress.com/Demos/DevAV/odata/', entities: { Employees: { key: 'Employee_ID', keyType: 'Int32' }, Customers: { key: 'Customer_ID', keyType: 'Int32' } }, beforeSend: (e) => { e.params = { 'param1': 'value1', 'param2': 'value2' }; e.headers = { 'Custom Header': 'value' }; } }); export default { // ... } </script>React
// ... import ODataContext from 'devextreme/data/odata/context'; const context = new ODataContext({ url: 'https://js.devexpress.com/Demos/DevAV/odata/', entities: { Employees: { key: 'Employee_ID', keyType: 'Int32' }, Customers: { key: 'Customer_ID', keyType: 'Int32' } }, beforeSend: (e) => { e.params = { 'param1': 'value1', 'param2': 'value2' }; e.headers = { 'Custom Header': 'value' }; } }); class App extends React.Component { // ... } export default App;
Specifies whether stores in the ODataContext serialize/parse date-time values.
Stores can parse date-time values in ISO8601 format (for example, "2016-07-13T16:05:00.000Z"
) or Microsoft format (for instance, "/Date(1198908717056)/"
). In the first case, the store ignores the timezone modifier (usually Z
) when parsing the value. In the second case, the store adds the time-zone offset to the value according to the client's time-zone.
Disabling deserialization may cause filtering issues in UI components bound to the ODataStore. When deserialization is disabled in the store, date-time strings are converted to Date objects at the UI component level. When filtering, the UI component reverts an entered date-time value to a string based on the dateSerializationFormat property's value and passes the string to the ODataStore for further processing. Because OData does not support strings, filtering fails.
To prevent these issues, the store's deserializeDates property should be set to true or set the UI component's dateSerializationFormat property to null.
Specifies entity collections to be accessed.
The ODataContext creates an ODataStore per entity collection, so you need to use ODataStore properties for configuring access to entity collections. In the following code, access to the Employees
and Customers
entity collections is configured, but only Customers
is loaded using the load() method:
var context = new DevExpress.data.ODataContext({ url: "https://js.devexpress.com/Demos/DevAV/odata/", entities: { // Configures access to "https://js.devexpress.com/Demos/DevAV/odata/Employees" Employees: { key: "Employee_ID", keyType: "Int32" }, // Configures access to "https://js.devexpress.com/Demos/DevAV/odata/Customers" Clients: { // The collection alias name: "Customers", // The collection name key: "Customer_ID", keyType: "Int32" } } }); context.Clients.load();Angular
import ODataContext from "devextreme/data/odata/context"; // ... export class AppComponent { context: ODataContext; constructor() { this.context = new ODataContext({ url: "https://js.devexpress.com/Demos/DevAV/odata/", entities: { // Configures access to "https://js.devexpress.com/Demos/DevAV/odata/Employees" Employees: { key: "Employee_ID", keyType: "Int32" }, // Configures access to "https://js.devexpress.com/Demos/DevAV/odata/Customers" Clients: { // The collection alias name: "Customers", // The collection name key: "Customer_ID", keyType: "Int32" } } }); this.context.Clients.load(); } }Vue
<script> import ODataContext from 'devextreme/data/odata/context'; const context = new ODataContext({ url: 'https://js.devexpress.com/Demos/DevAV/odata/', entities: { // Configures access to "https://js.devexpress.com/Demos/DevAV/odata/Employees" Employees: { key: 'Employee_ID', keyType: 'Int32' }, // Configures access to "https://js.devexpress.com/Demos/DevAV/odata/Customers" Clients: { // The collection alias name: 'Customers', // The collection name key: 'Customer_ID', keyType: 'Int32' } } }); export default { mounted: { context.Clients.load(); }, // ... } </script>React
// ... import ODataContext from 'devextreme/data/odata/context'; const context = new ODataContext({ url: 'https://js.devexpress.com/Demos/DevAV/odata/', entities: { // Configures access to "https://js.devexpress.com/Demos/DevAV/odata/Employees" Employees: { key: 'Employee_ID', keyType: 'Int32' }, // Configures access to "https://js.devexpress.com/Demos/DevAV/odata/Customers" Clients: { // The collection alias name: 'Customers', // The collection name key: 'Customer_ID', keyType: 'Int32' } } }); class App extends React.Component { constructor(props) { super(props); context.Clients.load(); } } export default App;
Specifies a function that is executed when the ODataContext throws an error.
Function parameters:A JavaScript Error object extended with the following fields:
Object structure:
Name Type Description errorDetailsError details. It is an OData error response object for OData-specific errors or a jqXHR object for other errors when you use jQuery.
httpStatusThe error code.
requestOptionsRequest details. Contains the following fields:
accepts: Object
The data types that the client accepts mapped to their MIME types.
async: Boolean
Indicates whether the request was asynchronous or synchronous.
contentType: String | Boolean
The content type; false if no content type was specified.
data: Object
Query options.
dataType: String
The expected data type.
headers: Object
The request headers.
jsonp: Boolean
Indicates whether the request was sent using JSONP.
method: String
The request method ("GET", "POST", "PATCH", or "MERGE").
timeout: Number
The request timeout.
url: String
The request URL.
xhrFields: Object
Native XMLHttpRequest object properties that were sent in the request.
var context = new DevExpress.data.ODataContext({ // ... errorHandler: function(error) { console.log(error.message); } });Angular
import ODataContext from "devextreme/data/odata/context"; // ... export class AppComponent { context: ODataContext; constructor() { this.context = new ODataContext({ // ... errorHandler: (error) => { console.log(error.message); } }) } }Vue
<script> import ODataContext from 'devextreme/data/odata/context'; const context = new ODataContext({ // ... errorHandler: (error) => { console.log(error.message); } }); export default { // ... } </script>React
// ... import ODataContext from 'devextreme/data/odata/context'; const context = new ODataContext({ // ... errorHandler: (error) => { console.log(error.message); } }); class App extends React.Component { // ... } export default App;
Specifies whether to convert string values to lowercase in filter and search requests. Applies to the following operations: "startswith", "endswith", "contains", and "notcontains".
Defaults to the global oDataFilterToLower setting.
When this property is true, the filter expression sent to the server contains a tolower()
function call and a lowercase filter value.
var context = new DevExpress.data.ODataContext({ url: "https://js.devexpress.com/Demos/DevAV/odata/", entities: { Employees: { key: "Employee_ID", keyType: "Int32" }, // ... }, filterToLower: true }); var ds = new DevExpress.data.DataSource({ store: context.Employees, filter: ["Employee_Name", "startswith", "Jo"] }); // The filter expression in the request looks like the following: // https://...?filter=startswith(tolower(Employee_Name), 'jo')Angular
import ODataContext from 'devextreme/data/odata/context'; import DataSource from 'devextreme/data/data_source'; // ... export class AppComponent { context: ODataContext; ds: DataSource; constructor() { this.context = new ODataContext({ url: "https://js.devexpress.com/Demos/DevAV/odata/", entities: { Employees: { key: "Employee_ID", keyType: "Int32" }, // ... }, filterToLower: true }); this.ds = new DataSource({ store: this.context.Employees, filter: ["Employee_Name", "startswith", "Jo"] }); // The filter expression in the request looks like the following: // https://...?filter=startswith(tolower(Employee_Name), 'jo') } }Vue
<script> import ODataContext from 'devextreme/data/odata/context'; import DataSource from 'devextreme/data/data_source'; const context = new ODataContext({ url: 'https://js.devexpress.com/Demos/DevAV/odata/', entities: { Employees: { key: 'Employee_ID', keyType: 'Int32' }, // ... }, filterToLower: true }); const ds = new DataSource({ store: context.Employees, filter: ['Employee_Name', 'startswith', 'Jo'] }); // The filter expression in the request looks like the following: // https://...?filter=startswith(tolower(Employee_Name), 'jo') export default { // ... } </script>React
// ... import ODataContext from 'devextreme/data/odata/context'; import DataSource from 'devextreme/data/data_source'; const context = new ODataContext({ url: 'https://js.devexpress.com/Demos/DevAV/odata/', entities: { Employees: { key: 'Employee_ID', keyType: 'Int32' }, // ... }, filterToLower: true }); const ds = new DataSource({ store: context.Employees, filter: ['Employee_Name', 'startswith', 'Jo'] }); // The filter expression in the request looks like the following: // https://...?filter=startswith(tolower(Employee_Name), 'jo') class App extends React.Component { // ... } export default App;
Specifies whether data should be sent using JSONP.
Specifies the URL of an OData service.
jQueryvar context = new DevExpress.data.ODataContext({ // ... url: "https://js.devexpress.com/Demos/DevAV/odata/" });Angular
import ODataContext from "devextreme/data/odata/context"; // ... export class AppComponent { context: ODataContext; constructor() { this.context = new ODataContext({ // ... url: "https://js.devexpress.com/Demos/DevAV/odata/" }); } }Vue
<script> import ODataContext from 'devextreme/data/odata/context'; const context = new ODataContext({ // ... url: 'https://js.devexpress.com/Demos/DevAV/odata/' }); export default { // ... } </script>React
// ... import ODataContext from 'devextreme/data/odata/context'; const context = new ODataContext({ // ... url: 'https://js.devexpress.com/Demos/DevAV/odata/' }); class App extends React.Component { // ... } export default App;See Also
Specifies the OData version.
Default Value: 4
Accepted Values: 2 | 3 | 4
If the version is 2, the ODataContext uses the "MERGE" method to send requests; otherwise, it uses "PATCH". Set the method field of the beforeSend function's parameter to override this behavior.
Specifies whether to send cookies, authorization headers, and client certificates in a cross-origin request.
This property's value is passed to the underlying jqXHR object.
Use the beforeSend function to specify custom authorization headers.
Feel free to share topic-related thoughts here.RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4