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 6 Next »

Work in progress

The RX and OfficeSpace integration was added in v2022.4 - August

Using the OfficeSpace Integration, bookings created in OfficeSpace can now be displayed throughout the RX system.

Functions such as Book, Check-in and Check-out are synced between the two systems.

https://www.officespacesoftware.com/

Pre-requisites

  • An OfficeSpace Admin Account

  • Resources created in both OfficeSpace and ResourceXpress.

  • OfficeSpace Integration is enabled for your ResourceXpress server.
    For SaaS customers please contact helpdesk@qedas.com and request for this option to be enabled.
    For On-Prem customers please follow the guide below.

 How to enabled OfficeSpace Integration for On-Prem

OfficeSpace Configuration

OfficeSpace API Key

For RX to communicate with OfficeSpace an API Key will be required.

Using an OfficeSpace admin account navigate to the OfficeSpace API settings.

This can be found by accessing https://<officespace-url>/admin

Replace <officespace-url> with the correct URL for your OfficeSpace system.

Select OfficeSpace API.

Under the Legacy API Keys heading click the button GENERATE API KEY (LEGACY).

You will be presented with a popup form.

This API Key will require Full Access, then enter a clear name in the Note section.
Click GENERATE NEW API KEY.

You will now see a new API key available in the list of available keys.

Copy the newly created key.

Store this key, it will be required in the RX Configuration section of this guide.

Service User Account

A user account will need to be created for ResourceXpress to view, create and modify bookings.

Using the menu button, found at the top right of the OfficeSpace admin dashboard select Insights Hub.

From the Insights Hub, select People Reports, then choose People Manager.

From the People Manager create a new user by selecting the Create New User icon.

You will be shown a Create New Record popup.

Fill in this form and click Save.

The only required field is First Name.

Once the account has been created you will need to copy the ID value for this user.

This can be copied from the user's table.

Store this ID, it will be required in the RX Configuration section of this guide.

RX Configuration

Connect RX to OfficeSpace

Navigate to your ResourceXpress Admin Console.

You can connect RX to OfficeSpace in 3 different locations.

  1. System Settings - This is the default global configuration that all profiles can utilise.

  2. Location-based Settings - This will be available only to resources assigned to the chosen location.

  3. Resource Settings - This will apply only to a singular resource profile.

System Settings

 Click here to expand...

Using the menu, select Administration Settings then System Settings, from here select the Resource Server tab.

Using the Booking System dropdown, choose OfficeSpace.

Enter the below URL into the Server Host Name field.

https://<officespace-url>/api/1

Replace <officespace-url> with the correct URL for your OfficeSpace system.

Under the OfficeSpace Integration header, enter the Legacy API Key and Service User ID which were created in the OfficeSpace Configuration section of this guide.

Click Save

Location-based Settings

 Click here to expand...

Using the menu, select Administration Settings then System Settings, from here select the Locations tab.

Find the location with you want to configure and click the “Edit Location Settings” icon ((blue star)).

Select the Resource Server tab.

Using the Booking System dropdown, choose OfficeSpace.

Enter the below URL into the Server Host Name field.

https://<officespace-url>/api/1

Replace <officespace-url> with the correct URL for your OfficeSpace system.

Under the OfficeSpace Integration header, enter the Legacy API Key and Service User ID which were created in the OfficeSpace Configuration section of this guide.

Click Save.

Resource Profile Settings

 Click here to expand...

Continue to the next chapter “Link RX Profiles with OfficeSpace”.

You will also need to complete the additional steps in the dropdown at the end of the chapter.

Link RX Profiles with OfficeSpace

For each OfficeSpace resource that you want to link with RX, a matching Profile will need to exist in ResourceXpress.

For more information on creating resource profiles in RX please check out our guide here.
Create & Edit Resource Profiles

Similar to ResourceXpress, each OfficeSpace resource has a unique ID number.
We will use this ID number to link an RX Profile with the OfficeSpace Resource.

Finding the OfficeSpace ID

To find the OfficeSpace ID number navigate to the OfficeSpace Visual Directory.

This can be found by accessing https://<officespace-url>/visual-directory

Replace <officespace-url> with the correct URL for your OfficeSpace system.

From the Visual Directory, select the Resource that you need.

The ID number will be shown at the end of the URL in your browser.

In this example the OfficeSpace ID is 999.

Add OfficeSpace ID to RX

Once you have the OfficeSpace IDs navigate to your ResourceXpress Admin Console.

Using the top menu, select Administration Settings, then choose Resource List.

Find the correct Profile that you want to connect with this OfficeSpace Resource and click the “Edit Profile” icon ((blue star)).

Enter the OfficeSpace ID number into the Resource Name field.

Scroll to the bottom of the page and click Save.

After the page has been saved, navigate to the Connection Properties tab.

Using the Booking System dropdown select OfficeSpace.

If you are using the Resource Profile Settings you will also need to configure the following settings

 Additional steps for Resource Profile Settings configuration

Select Yes for Specify Credentials.

Enter the below URL into the Host Name field.

https://<officespace-url>/api/1

Replace <officespace-url> with the correct URL for your OfficeSpace system.

Under the OfficeSpace Integration header, enter the Legacy API Key and Service User ID which were created in the OfficeSpace Configuration section of this guide.

Click Save.

  • No labels