Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

Configure ResourceXpress to work with Google G Suite.

Prerequisites

In order to connect your Google G Suite to ResourceXpress, the following will be required:

  • A Google G Suite Account with administrator privileges

  • Access to the Google Developer Console

  • Access to the Google Admin Control Panel


G Suite Resources

ResourceXpress will connect with a resource calendar to create bookings, these will need to exist in G Suite.

If you do not already have resource calendars see below for how to create these.

 Creating Resources

Log in to the Google Apps administrator control panel. The URL is https://admin.google.com

Navigate to Buildings and resource → Resource management

Using the large (+) plus button, choose to Add new resource.

Populate the fields as required, then click ADD RESOURCE.

Select the newly created resource from the list.

Copy the Resource email found on the left side of the screen.
You will need this later for configuring resources in ResourceXpress.


All resources being added to ResourceXpress will require their shared settings to be modified.
To access these settings you will need to access these calendars from an admin account.

 Add Resource Calendar to Admin Calendar

Log into Google Calendar with your Admin credentials https://calendar.google.com

On the left side of the screen, click the (+) plus symbol alongside Other calendars.

Choose Browse resources from the list.

Find the required resources and click the checkbox to subscribe.

Once all the required calendars have been added, use the back arrow found in the top left to return to your calendar.

You will see these calendars now available under My calendars.


Setup Google Developers Console

Open the Google Developer Console

https://console.developers.google.com

Login with Google Apps admin credentials, then click on Select a project

Select the folder icon to Manage resources


 Create a project

Create a new project by clicking on Create Project

Enter the required details and click Create

If you see an error like below then the Google account you are signed in with does not have enough privileges. Be sure to use an administrator account instead.

After creating the project, from the options menu navigate to API Manager > Dashboard and click Enable API as below


 Enable Calendar API

Enable Calendar API. You can disable all other APIs that are enabled by default


 Create a Service Account

Navigate to the IAM & Admin menu and then Service accounts

Click Create service account

Give the service account a name and set the Role as Owner, then click Create

From the Options menu for the service account, select Create key

Choose P12 and click Create

This will generate a P12 key file for the service account; store this locally as it is needed later


 Share the Calendar with the Service Account

You will now need to add the Service account email address into the share settings for the resource calendar in Google

Firstly, copy the full Service account ID

Next head back to your Google Calendar where you added the resource email earlier

Select the down arrow alongside the room name, and then select Share this Calendar

Paste the entire Service account ID into the text field under the Share with specific people header. Next make sure that Make changes to events is selected and click Add Person, then Save.


Configuring the ResourceXpress Server

 Adding the .p12 file

Rename the downloaded key file as RX.p12

Open the ResourceXpress server in a browser window, then navigate to Administration Settings > System Settings

In the Resource Server tab, click the Choose file button next to the P12 Certificate field

Locate and open the P12 key to upload it to the server, then click Save


 Update the Application Pool

Open IIS on the ResourceXpress server, then navigate to Application Pools

Select the application pool that is being used by the ResourceXpress application, then right-click and choose Advanced Settings

In the Process Model section, set the Identity field to LocalService

Once this is done, change the Load User Profile value to True and click OK


Configuring ResourceXpress settings

 ResourceXpress System Settings

Open the ResourceXpress Admin Console in a browser window, then navigate to Administration Settings > System Settings

Under the Resource Server tab, enter the Server Host Name as www.google.com

You can verify that the server can contact the host name by using the Check Server section

In the Resource Login User ID field you will need to enter the User ID for the Google service account that was created earlier. This is the characters before the @ in the service account ID (as highlighted below)

The Resource Login Password is the password that was provided when creating the service account; this is usually “notasecret”

The Resource Login Domain should be the text that is after the @ in the service account ID. It will look similar to the highlighted section shown in the screenshot below


 Create and configure profile settings

From the ResourceXpress Admin Console, navigate to Administration Settings > Resource List

Click on the Create button on the right-hand side, then complete the mandatory fields in the Resource Info tab as below:

Resource Name

Name of the resource

Resource Name - Display

Name of the resource (to be displayed on screen)

License Type

Choose as applicable

Space Type

Choose as applicable

Location

Choose as applicable

Stylesheet

For default choose Astro V4

Once this is done, click Save

Next navigate to the Connection Properties tab and ensure the mandatory fields here are populated as below:

Booking System

Select Google from the drop-down list

Resource Email

Google calendar resource email address

Specify Credentials

To auto-populate settings, set this to No

Click Save. The remainder of the fields in this tab should then be populated with the credentials which were previously entered into the System Settings

Check that the profile is configured correctly by clicking Back to List at the bottom of the page, then selecting the Preview button next to the resource that was just created. Make a booking from the preview screen and check that it appears in the Google calendar. Then create a booking in the Google calendar and check that this also appears on the preview screen.

In the event of any problems, please email helpdesk@qedas.com


 Common Errors and Resolutions

  • No labels