Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Importing events from EMS into CampusGroups using customizable filters

  • Integrating EMS room reservation requests within the Event form in CampusGroups

Integration

...

Steps

1. Set up a new API Client User in EMS

The integration requires you to set up a new API client user with the following settings:

  • do NOT enable the "Everyday User Authentication Required" option

  • enable the "Allow this client to book without Everyday User Templates and ignore Booking Rules" option

  • the role selected should grant access to at least the API routes below; allowing all routes should be preferred where possible to support additional use cases as they are implemented:

    • /clientauthentication [POST]

    • /authentication/token [POST]

    • /webusers/actions/search [POST]

    • /bookings [GET]

    • /bookings/{booking_id} [GET]

    • /bookings/{booking_id} [PATCH]

    • /bookings/{booking_id}/cancel [POST]

    • /bookings/actions/search [POST]

    • /bookings/actions/search/userdefinedfields [POST]

    • /reservations/{reservation_id} [GET]

    • /reservations/{reservation_id} [PATCH]

    • /reservations/actions/create [POST]

    • /reservations/actions/search/userdefinedfields [POST]

    • /reservations/{reservation_id}/bookings [POST]

    • /reservations/{reservation_id}/cancel [POST]

    • /reservations/{reservation_id}/userdefinedfields [GET]

    • /reservations/{reservation_id}/userdefinedfields [PATCH]

    • /rooms [GET]

    • /rooms/actions/availability [POST]

    • /rooms/{room_id}/features [GET]

    • /features [GET]

    • /webtemplates [GET]

    • /webtemplates/{webtemplate_id} [GET]

    • /setuptypes [GET]

    • /buildings [GET]

    • /floors [GET]

    • /roomtypes [GET]

    • /statuses [GET]

    • /eventtypes [GET]

    • /groups [GET]

    • /reservationsources [GET]

    • /timezones [GET]

2. Activating the Integration

The Integration can be activated and configured under Admin > Settings > General Settings > Rooms. To activate the integration, you will need to enter the following information:

...

Once you have activated the integration, you can complete the remainder of the configuration with the platform directly.

Please Note: You may need to contact 25Live for some of this information. While the CampusGroups team has basic proficiency with 3rd party systems, we cannot assist with configuring 25Live to integrate with CampusGroups.

3. Detailed Configuration

Importing events from EMS into CampusGroups

CampusGroups can import events from EMS using the EMS API. You may select which events to import using combinations of filters based off of:

...

Additionally CampusGroups groups and EMS groups can be mapped in the EMS to CampusGroups direction so that imported events end up in the correct group. Events that belong to EMS groups not mapped to specific CampusGroups groups would be imported into a single default group of your choosing.

Book rooms in EMS from events created in CampusGroups

When creating an event in CampusGroups officers can request a room in EMS. This will only suggest rooms which are available at the selected time based on the information provided by the EMS API.

The EMS integration lets club officers request rooms in EMS directly from CampusGroups using the event editing page as per below:

...