Enterprise Help Site

Page tree

With the help of this new External Calendar API Endpoint feature, users of CAE LearningSpace will be able to process events (including date, event name and room name)  using their software integration components and work with the event information in any way they desire, like:

  • forwarding them to external calendar applications,
  • or presenting it as a static webpage.

IMPORTANT

This process is not a two-way flow of information: data modified or created in an external calendar cannot be returned/sent back to LearningSpace.

The External Calendar API Endpoint can be enabled by a toggle in the System Manager, General tab.


This API endpoint can be queried and provide data from the CAE LearningSpace calendar to display outside of the system on a public-facing calendar. 

  • The calendar is hourly refreshed.
  • It refers to today's and future events for the next 7 days.

With the feature enabled, when starting a query, events that

  • are approved
  • start within that calendar day (from 00:00 of the day of the query)
  • finish on the seventh day of the query (at 23:59 by the latest), will be displayed.

 API endpoint on the following URL: https://<your.learning.space.edu>/w/api/v2/public-calendar.json

{
  "events": [
    {
      "isRecurringSeries": false,
      "isPartOfRecurringSeries": true,
      "activity": {
        "color": "neonCarrot",
        "title": "ACLS Testing "
      },
      "eventStart": "2022-06-13T07:00:00Z",
      "note": "Weekly Assessment",
      "rooms": [
        {
          "location": null,
          "name": "Sim 1 (Sim Room)"
        },
        {
          "location": null,
          "name": "Sim 2 (Sim Room)"
        },
        {
          "location": null,
          "name": "Sim 3 (Sim Room)"
        },
        {
          "location": null,
          "name": "Sim 4 (Sim Room)"
        },
        {
          "location": null,
          "name": "Sim 5 (Sim Room)"
        },
        {
          "location": null,
          "name": "Sim 6 (Sim Room)"
        }
      ],
      "durationMinutes": 180,
      "title": "ACLS Megacode Testing",
      "eventEnd": "2022-06-13T10:00:00Z"
    },
    {
      "isRecurringSeries": false,
      "isPartOfRecurringSeries": false,
      "activity": {
        "color": "neonCarrot",
        "title": "SON C/O 2019 Assessment"
      },
      "eventStart": "2022-06-09T07:00:00Z",
      "note": null,
      "rooms": [
        {
          "location": null,
          "name": "Exam 1 (Exam Room)"
        }
      ],
      "durationMinutes": 135,
      "title": "Effective Assessment and Communication Skills Event",
      "eventEnd": "2022-06-09T09:15:00Z"
    }
  ],
  "eventsTo": "2022-06-16T21:59:59Z",
  "generatedAt": "2022-06-09T05:57:10Z",
  "eventsFrom": "2022-06-08T22:00:00Z"
}



CAE LearningSpace does not generate an external calendar application: the raw data can be used to generate entries to an external (3rd party) calendar.
See details of how to use the API on the External Calendar API Endpoint page.

See more on How to Utilize External Calendar API Endpoint. See further improvements in the Calendar in the Inventory Module Update 2022 Spring Feature notes.