DayPilot.Scheduler.events.load

DayPilot.Scheduler.events.load(url, success, error);

This method loads events from a given URL using an AJAX call (POST). The URL must return JSON array with events (see DayPilot.Event.data for the event data structure).

The POST request sends the following parameters as a JSON object (since version 8.1):

  • start: visible start
  • end: visible end

Example POST body:

{"start": "2015-06-15T09:00:00", "end": "2015-06-15T13:00:00"}

The Scheduler is updated automatically after a successful AJAX call. You can cancel the client-side refresh by calling args.preventDefault() in the success callback function.

Parameters

  • url (string)
  • success (function) - success callback
  • error (function) - error callback

Success Callback

function success(args) {}

The success callback is only executed if the data is successfully received from the URL and it can be parsed as a JSON array.

Arguments:

  • args.preventDefault()
  • args.data (array) - event data received from the server

Error CallBack

function error(args) {}

The error callback is executed when the HTTP return code is other than 200 or 304 or if there is an exception during parsing the JSON data.

Arguments:

  • args.exception (object) - JSON data parsing exception
  • args.request (XmlHttpRequest) - the request object used for the AJAX call

Examples

Minimal example

dp.events.load("/getEvents");

Example with event handlers

This example will load events from "/getEvents" URL. The current date range is passed in "start" and "end" POST parameters.

dp.events.load(
  "/getEvents",
  function success(args) {
    dp.message("Events loaded");
  },
  function error(args) {
    dp.message("Loading failed.");
  }
);

Sample data returned from /getEvents:

[
{
  id: 1
  start: "2015-01-01T09:00:00",
  end: "2015-01-01T13:00:00",
  text: "Event 1",
  resource: "A",
  cssClass: "my-event",
  resizeDisabled: true
},
{
  id: 2
  start: "2015-01-02T09:00:00",
  end: "2015-01-02T13:00:00",
  resource: "B",
  text: "Event 2"
}
]

DayPilot for JavaScript, ASP.NET WebForms, ASP.NET MVC, Java