Accessing Room Reservation Configuration
Once you are ready to begin configuring your 25Live integration, contact Anthology Support to have this option enabled. This needs to be configured before continuing.
After it has been configured, you can then access the configuration screen:
- Log into Engage.
- From the Switch Views button, select the Admin view.
- In the Admin view, from the Configure menu, choose Room Reservations. The Room Reservations screen will appear.
Adding Connection Settings
The Room Reservations screen allows you to add the items necessary for the configuration to be successful. Each is presented in a specific order, and each must be completed successfully before moving onto the next section. Note that we have provided some examples of what each field might be set to, but you should confirm these details with your vendor.
Once you have entered the pertinent information, click Save for that section. Engage will then execute a series of tests, depending on each section, to verify that the data supplied is accurate. If the tests are successful, you will receive aSuccess message for each. If it is not, you will see a Failed message, and will be able to see details on the test and which error was returned.
You may change these settings at any time.
1. Basic Authentication
This section requires you to supply the information needed to connect to your 25Live instance. These details can be provided by your Room Reservation provider. The following items are required:
- API URL : the Base URL where your API can be accessed
- API Username : the credential that we will use to connect to the API. All reservation requests that originate from Engage will appear as if they were created by this user.
- API Password : the private credential assigned to the above Username
2. Events Functionality
These details are used to decide how Engage will update reservation requests within your Room Reservation instance. Which options to use is largely a matter of deciding how you would like those reservations to appear.
- Time Zone Offset : this should be set to reflect the current Time Zone of your institution
- Default state ID for created reservations : determines which 25Live state to use for new reservations. This is usually set to Tentative (ID: 1). However, if you use Draft (ID: 0), and include a Parent ID (see below), this state value is ignored and the Series25 configured default is used.
- Parent ID for created reservations : this determines what folder the new Reservation will be filed under
- Use Buildings instead of Partitions : if your 25Live instance is configured to separate rooms by Partitions, this should be set to FALSE. If it is instead configured to separate rooms into Buildings, this should be set to TRUE.
- Testing options : the next set of options are used by Engage to verify the connection. When you save this section, Engage will try to create a new test Event one week in the future, then cancel it. If that’s successful, we’ll know our configuration is working. If not, we’ll get feedback on the issue in order to address it. These need to be obtained from your instance but can be of any suitable value.
- Series25 Testing Organization ID
- Series25 Testing Event Type ID
- Series25 Testing Room ID
- Series25 Testing Layout ID
3. Engage Event Information
When an Event is created in Engage, we create and store pertinent information about that Event. We will then send that information to your 25Live instance so that administrators in that application can view those details without having to return to Engage. This section requires you to configure the fields that will accept those details.
You can either create new fields or you can use existing ones but remember that we will be writing Engage data into them. Regardless of whether you create new fields or reuse existing ones, they must be of Long Text (X) type, as the data sent could be quite lengthy. Also, the names of the fields are not relevant, but we recommend that you make sure they are easily recognizable as Engage data.
- Engage User Custom Attribute : Engage user who requested the location
- Engage Organization Custom Attribute : Engage Organization hosting the event
- Engage Event Name Custom Attribute : Engage Name for the Event
- Engage Event Description Custom Attribute : Description of the Engage Event
- Engage Event Status Attribute : current Status of the Engage Event
- Engage Event Link Custom Attribute : URL to the Engage Event Page
- Engage Extra Information Custom Attribute : any other information provided for the Event
- Engage Custom Questions Custom Attribute : Custom Questions and their matching Answers provided for the Event
Once your options are fully configured and confirmed, the new Dashboard will appear. This will show you what data Engage has received from your Room Reservation provider. This is also where you can enable or disable the Room Reservation feature and set per Organization overrides.
To add a new Override:
- Click Create Override.
- Select an Organization.
- Choose whether that Organization will always be able to use Room Reservation or never be able to use Room Reservation.
- Click Save to record your changes.
This is a great way to test out the reservation process without enabling it for the whole institution. You can leave the Room Reservation option disabled but create an Override for a specific test organization allowing that organization to always be able to use Room Reservations. You can then have a member of that Organization try to create Event Submissions to review that process.
This option allows you to match the Engage Organization List to the 25Live Organization List. In some cases, the name of each may be slightly different, or you may group the Organizations differently in these applications, so this allows you to create such relationships.
For each Engage Organization, you would simply click the Edit button, then choose the 25Live Organization that matches that Engage Organization. Any reservation coming from that Organization in Engage would then be sent to the matching 25Live Organization.
Event Type Mapping
Similar to Organization Mapping, this allows you to decide what Type Engage events should be assigned to in 25Live. Since the Engage application doesn’t have a native option for “event type”, we can currently only map these to one 25Live Event Type. You can choose that option here.
If you would prefer your users to reach out to your Engage administration team in case of any issues, this is where you would populate the contract information for those administrators. Otherwise, users will be instructed to contact Anthology Support instead.