1. Workplace Experience integration: Reservations module in general
This module activation is used to setup the integration between Workplace Management and Workplace Experience for the reservation module, from a Workplace Management point of view.
Workplace Experience touch points can be used by end-user to create reservations, where Workplace Management will be the in the background, used for creating and managing all the relevant (master) data and setting up the relevant reservation workflow settings and restrictions.
This article only focuses on setting up this integration for the Workplace management side. For the Workplace Experience side, see the relevant articles in Workplace Experience
2. What is this module about
This module activation is about the integration of the Reservation module with Workplace Experience. Since this module activation is considered a solution (a combination of multiple related modules), next to the integration itself, it will also activate the following modules:
Reservation module
Master data: Buildings and areas module
If applicable*: Master data: Asset module
If applicable*: Master data: Catalog items
*Applicable based on the setting in the module activation down below
For more information on the content of these modules, including detailed descriptions of some of the core components, see these articles in the Application Managers part:
3 Choices to be made within the module
Since this module is about the integration of the Reservation module with Workplace Experience, see Reservations module activation and information for the relevant choices to be made in the reservation module.
4. How to activate this module
As for every new module, use the ‘Module activation’ option on the administrator startboard (only available for level 2 and level 3 admins). For more general information about these 'Module activation' options, see Module activation
4.1 Prerequisites before activating this module
Since this module activation is actually a solution activation (a combination of multiple related modules), any prerequisite is also part of this activation and thus no other Prerequisites are relevant.
4.2 Module activation
For this specific module activation, multiple settings and options apply:
Settings to be determined
Default start time & Default end time: These settings will determine the default start and end time if a new reservation is created. The user can always change these dates in a new reservation, but if, for instance, most reservations take place from 09:00 to 17:00, these settings can help users by setting this as the default for each new reservation.
Reserve areas: This will determine if areas can be reserved at all. Related settings (e.g., the option to enable ‘Reserve areas' on a specific reservation type and the option per area to set it reservable) only become available if this is enabled.
Use Seating arrangements: If areas can be reserved, this setting will enable the option to create seating arrangements and add these seating arrangements to specific areas. For more information, see the part on seating arrangements in the Application Managers section of this module: Reservation module
Reserve assets: See ‘Reserve areas.’ but for assets.
Reserve catering: See ‘Reserve areas,’ but for catalog items.
Approval needed: This setting is used in the reservation workflow to determine if every reservation that is submitted must first be approved* by a reservation coordinator
*Reservations that are not yet approved still keep the reserved objects in that reservation blocked for others, and only if the reservation coordinator cancels the reservation during the approval step will these objects become available again for others to reserve at the specified time in the reservation.
Reservation types:
At least one reservation type must be added before starting the module activation. Via the include, these reservation types can be added. Additional reservation types can always be added later on (via the navigation menu or the module settings for reservations). For more information on the reservation types, see the part on Reservation types in the Application Managers section of this module: Reservation module
After starting the module activation, the relevant imports become available to download in the next step. For more details, see further down (Data imports).
Starting the module activation will also enable the relevant user groups and these can be assigned to user profiles via the User profile management dashboard, which can be found on the admin`s startboard. For more details, see further down (User groups and profile suggestions).
Workflow Emails
The emails that are automatically sent via the workflow (E.g., the confirmation email to the requestor or a new reservation when a new reservation is created) are also generated and shown in the include on the module activation after this is started. It is possible to delete some or all of these emails if some or all of these emails should not be used. For more information on workflow emails:
For a detailed description of the emails sent via the workflow, see: Reservation module in the 'Application Managers' section.
4.3 Data imports
When activating this module, some data imports become available, which can be used to quickly import relevant data into the system (as opposed to manually entering this data, which is also possible).
Relevant data imports become available in the module activation after it has been started. Default data imports can also be found on the admins' startboard (only for level 2 and level 3 administrators).
For more information on data imports in general, see: Data imports
Available data imports for reservation as a module
If reservations are activated as a module, the following default import connectors become available:
Reference | Name | Description |
---|
Reference | Name | Description |
---|---|---|
FMB-F-024 | Import catering items | This import can be used to import the catalog items that should be reservable (e.g lunch, coffee, etc). Importing catalog items via this import will automatically put these items in the “Reservable items' category of catalog items and will set every item to ‘reservable’ is true. |
FMB-F-041 | Import reservation-settings area* | This import should be used if the areas are already available in the system and (some of those) area should also be reservable. This import is used to set the reservable specific settings for the relevant areas (e.g. to set the restrictions like reserve in advance until period). |
FMB-F-042 | Import reservation-settings assets* | This import should be used if the assets are already available in the system and (some of those) assets should also be reservable. This import is used to set the reservable specific settings for the relevant assets (e.g. to set the restrictions like reserve in advance until period). |
FMB-F-043 | Import reservations-settings catalogitem | This import should be used after the 'Import catering items' import, to set the reservable specific settings for the catalog items (e.g. to set the restrictions like reserve in advance until period). |
FMB-F-083 | Import costcenters | Only relevant if the customer also want to use cost centers in reservations. Via this import, the cost centers can be imported. |
*Data imports from other modules are most likely also relevant regarding the master data that is used to reserve (E.g., Buildings, Areas and Assets). For more information, see
Master data: Buildings and areas module activation and information
and
Master data: Assets module activation and information
4.4 User groups
When a module is activated, user groups can be assigned to user profiles. These user groups give users access to (a subset of) navigation menu options, startboard tabs, and tasks in the relevant workflow(s).
For more general information on user profiles, user groups, users, and the user profile dashboard, see:
For the Reservation module, the following user groups become available:
Reference | Name | Description | License needed |
---|
Reference | Name | Description | License needed |
---|---|---|---|
GOB-G003 | Create reservations | Gives access to creating creating reservations (object and startboard menu options) | Requestor |
FMB-G005 | Create reservation schedule | Group gives rights to change a regular reservation to a periodic reservation | Requestor |
GOB-G028 | Reservation coordinator | Gives rights to change all reservations. Has the task to approve reservations (if applicable) Group also has the option to create the bookable catalog items and adjust the reservation settings of catalog items, rooms and assets. | Full user |
FMB-G001 | Approve reservation items | If a reservation item needs to be approved before the reservation is approved (a setting on the reservable) users with this group (either overall or in the context of the reserved object) will get the task to approve the reservation | Limited user |
FMB-G003 | Intake/issue areas | If reserved areas are to be handed out and taken in as a task per reservation (a client setting), users with this group will receive that task per reservation | Limited user |
FMB-G002 | Intake/issue assets | If assets are to be handed out and taken in as a task per reservation (a client setting), users with this group will receive that task per reservation | Limited user |
FMB-G004 | Intake/issue catering | If catering is to be handed out and taken in as a task per reservation, users with this group will receive that task per reservation | Limited user |
FMB-G164 | View reservations startboard | This group only provides access to the startboard tab 'Reservations dashboard'. This group can be given to users who do not have the system group for reservation coordinators, but are responsible for tasks related to reservations (based on some of the other system groups above) | Limited user |
FMB-G083 | Management dashboards reservations | Group gives access to the menu option "Management dashboards" for the internal reservations module, as well as access to the relevant objects to view this content of the dashboards | Limited user |
Via the 'User profile management' option on the administrator startboard, these user groups can be assigned to existing user profiles or add them to newly created user profiles.
4.4.1 Relevant user groups from other modules:
For some modules, other (master data) modules might be of importance, in order to be able to fully use this module.
For Reservations, the Master data modules ‘Buildings and areas’, ‘Assets' and 'Catalog items” are often relevant (depending on the exact types of objects that can be reserved); therefore the following user groups could also need to be assigned to users (If not already done in the past)to be able to create and edit the relevant master data objects.
Reference | Name | Description | License needed |
---|
Reference | Name | Description | License needed |
---|---|---|---|
GOB-G007 | Edit buildings and areas | Group gives create and edit rights on buildings and areas | Full user |
GOB-G008 | Edit assets | Group gives create and edit rights on assets | Full user |
FMB-G108 | Edit catalog items | Group gives access to creating and editing catalog items | Full user |
When generating the user profiles, it is advised to include these groups or have dedicated profiles (and users) for these modules.
4.5 Navigation menu and startboard options
When a module is activated, the relevant navigation menu options become available to users with the correct authorizations (based on the user groups). Next, a module-specific key user startboard tab becomes available for that particular module and is visible depending on the user's authorizations. This tab gives users insights and day-to-day work overviews relevant to the specific module.
For more general information on the navigation menu and startboard, see:
Authorizing users | 2.2-Navigation-menu-and-Startboard
For the Reservation module, the following navigation menu options become available:
Navigation menu option | Available to user groups | Description |
---|
Navigation menu option | Available to user groups | Description |
---|---|---|
Reservations |
| The option to search for all existing reservations |
Reservation calendar |
| A calendar that shows the existing reservations and has the option to create a new reservation |
Recurring reservations |
| The option to search for all recurring reservations |
Reservable objects |
| The overview of all of the objects (Areas, assets, catalog items) that are reservable |
Reservation types |
| The overview of reservation types and the option to create new reservation types |
Reservations dashboard |
| A management dashboard with overviews and graphs related to reservations (Quantity analysis, Occupancy overviews, etc) |
For the Reservation module, the 'Reservations dashboard' starboard tab becomes available:
Reservations startboardtab
This tab is available for the following user groups:
Reservation coordinator
View reservations startboard
Management dashboards reservations
This startboard tab has the following buttons:
Reservation + : The option to create a new reservation, same as on the general startboard tab.
Search reservations: Same option as in the navigation menu to search on all reservations.
Search recurring reservation schedules: Same option as in the navigation menu to search on all recurring reservations.
Reservation for today (my location): An overview to see all reservations taking place today. If the user has a fixed location (via the ‘Building’ field on the contact of the user), only reservations for this location are shown, otherwise, all reservations (for all buildings)
Overview catering/services: Via this overview, a list of upcoming reservations can be shown that contain catalog items (catering/services). This overview can be used by the service provider to know which services to prepare and deliver on time and can also be used to export catering/service reservations from the past, including the financial details (prices).
Overview assets/equipment: Via this overview, a list of upcoming reservations can be shown that contain assets (assets/equipment). This overview can be used by the service provider to know which assets to hand out or take in on time.
Next to that, this tab has the following includes (most are only visible if they contain data):
Reservations to be approved: An overview of reservations that require approval by the reservation coordinator. If the reservation coordinator has a specific building set on his or her contact, only reservations to be approved related to that building are shown.
Reservations with reservation items to approve: This overview shows reservations with reservation items that need to be reviewed (approved or rejected) by the user.
Reservations within the upcoming 7 days with remarks (my location): This overview shows reservations within the upcoming 7 days with a remark added by the requestor. If the user has a fixed location (via the ‘Building’ field on the contact of the user), only reservations for this location are shown, otherwise, all reservations (for all buildings) with a remark.
Reservation items within the upcoming 7 days with remarks (my location): This overview shows reservation items within the upcoming 7 days with a remark added by the requestor. If the user has a fixed location (via the ‘Building’ field on the contact of the user), only reservation items linked to reservations for this location are shown, otherwise, all reservations items with a remark are shown.
Today's reservations with a deviating seating arrangement (my location): This overview shows all reservations from today with a different seating arrangement compared to the default seating arrangement of the area.
Today's reservations with setup or tidy-up times: This overview shows all reservations for today with reservation items that have setup or tidy-up times. The start time of the setup period or the end time of the tidy-up period is shown per line.
Reservations with reservation items to approve: This overview shows reservations with reservation items that need to be reviewed.
Areas to issue: This overview shows all reservations where the user must prepare an area for an upcoming reservation based on a dedicated workflow task (based on a general reservation module setting 'Preparation of areas via separate task').
Areas to take in: This overview shows all reservations where the user needs to take in an area (clean it up again after a reservation) based on a dedicated workflow task (based on a general reservation module setting ('Clean up of areas via separate task').
Assets to issue: This overview shows all reservations where the user is required to issue an asset based on a dedicated workflow task (based on a general reservation module setting ('Hand out assets via separate task').
Assets to take in: This overview shows all reservations the user needs to take in an asset based on a dedicated workflow task (based on a general reservation module setting ('Take in assets via separate task').
Catering to issue: This overview shows all reservations where the user is required to hand out catering based on a dedicated workflow task (based on a general reservation module setting ('Hand out catering via separate task').
5. Additional reports
For some modules, additional reports can be available via the ‘Report’ navigation menu option.
For the reservation module, there are reports available via:
Navigation menu reports: A long list of reports related to reservations available to the ‘Reservation coordinator’.
Management dashboard: A management dashboard for reservations is available in the ‘Reservations’ navigation menu to the ‘Management dashboards reservations’ system group, with overviews and graphs related to reservations (Quantity analysis, Occupancy overviews, etc):
6. Additional settings and options after enabling
For some modules, additional settings can be configured after the initial module activation via the 'Module settings' option on the administrator startboard. A module is always activated with the most used settings pre-defined. After the module is activated, the module may have more advanced settings available, which can be managed via the Module settings as well.
To navigate to all Reservation settings, go to Modules settings → tab Reservation. Hover over the available settings on that page to get more information:
7. Additional information
No additional information currently
8. User manual
For the user manual with a more step-by-step explanation of the process itself, see: Reservation module for (end)users
9. Q&A
Waiting for questions to answer
OLD:
Keep in mind: If you’re setting up a Workplace Management-Experience Integration, this module activation is step 4 in the WPM-WPE integration: setup guide. Finish up steps 1 to 3 before starting this activation.
How to navigate to the module activation
To start the module activation for Workplace Experience: Reservations,
Navigate to the startBoard.
Click on the “Module Activations” tile
Select the “Available modules to roll out” tab and select “Workplace Experience: Reservations”.
Click on the “Rollout selected module” button.
This will provide you with a short explanation like the one below.
After your click ‘OK’, a new page (first step of the wizard) will open:
The module activation takes you through all the steps that need to be performed.
As part of this module activation, Properties and Area are also activated. So you don't need to run the SBR ‘Masterdata: Properties and areas’ separately.
Steps to follow
Step 1: Settings to be determined:
Tip: We go over the settings in the table below. However, hovering over the field you are filling in will often provide you with the same help text:
Setting | Description |
---|---|
Reference Workplace Experience tenant | Enter the Workplace Experience tenant reference. The reference can be found in Cobundu Studio as a prefix to the username. For example axxprod1.username. |
Properties to Workplace Experience | Add properties automatically (after create) to the External app or manage the properties in the External app manually. Objects linked to the External app can be used in Workplace Experience. |
Areas to Workplace Experience | Add areas automatically (after create) to the External app or manage the areas in the External app manually. Objects linked to the External app can be used in Workplace Experience. |
Users to Workplace Experience | Add system users automatically (after create) to the External app or manage the system users in the External app manually. Objects linked ot the External app can be used in Workplace Experience |
Pre-defined setting tab
Step 2: Start this module activation
START
What happens when clicking the green Start button in this wizard step?
You move on to the next page of the Wizard.
Relevant imports are created, in the next step we will go over these imports.
Workflow emails are automatically created. Meaning that we create the workflow emails that are send out when submitting/cancelling/closing Reservations. More on these emails in the next step.
Relevant imports are created, in the next step we will go over these imports.
You’re done with this step and can click the green ‘Start’ button to start the actions described above.
Step 3 Check data and close the module activation.
On the next page we can check all items that have been created. This also contains a checklist we can follow.
For importing data we take you through the basics steps on how to import module activation data. More details on imports can be found in this article Imports.
The import file created in this SBR is the import for properties, areas and users. These can be set by opening the instance or via an import. To download the import template:
Navigate to the “Relevant imports” include.
Click Generate import template.
Click the download icon next to the loop to download the template.
Send files to the client.
When importing properties and areas make sure to apply the mandatory hierarchy. If this is not done properly, this will result in issues when mapping areas and workplaces in Workplace Experience.
Import files receives and approved
If relevant, check if Properties/Assets and Catering objects are imported successfully. When the properties and areas are already imported when Initializing the environment these boxed can be checked directly.
Click Upload import file and upload the import file obtained from the customer.
To see what workflow emails have been created we navigate to the Generated workflow emails include. We can take a closer look at the individual emails by clicking on the hyperlinks but for more info on workflow emails check /wiki/spaces/KB/pages/25034763.
Configure Workplace Experiencein Cobundu Studio. Continue the steps from WPM-WPE integration: setup guide
If everything is handled we can close the rollout by clicking the close button, Reservations will now be shown as a NavigationMenu option.
Mandatory hierarchy for properties and areas
Make sure to stick to the mandatory hierarchy to prevent issue when setting up Cobundu Studio.
Don’t change the category of the main area (the main area is automatically created when you create a property)
Main area
For every property that is created in WPM, a main area is created with the category ‘Main area’. Do not make any changed to the main area! All floors and areas that are created for this property will be placed hierarchically below this main area.
Location mapping
Below the requirements in WPM are explained. Instruction on how to set up “location mapping” in Cobundu Studio is explained in this article: Studio location mapping.
When importing or manually creating properties and areas in Axxerion please make sure to stick to the following rules regarding hierarchy. To create this hierarchy we’re using the technical Axxerion objects Property and Area combined with categories.
Axxerion Location Category | Hierarchy | Cobundu Location Category |
---|---|---|
Property of the category “Geographical area” | Highest level | Area |
Property of the category “Site” | A site can be part of a Geographical area | Site |
Property of the category “Property” | A property can be part of a site | Building |
Area of the category ‘Floor’ | A floor is part of a property | Floor |
Area of the category 'Meeting room' | A meeting room is part of a floor | Room |
Area of the category 'Area' | An area is part of a floor | Room |
Area of the category 'Workplace' | A workplace is part of an area | Workplace |
Area of the category 'Custom category’ 1 | A custom category is part of an area | Workplace |
Area of the category ‘Parking’ | A parking is part of a floor | Parking |
1 When a custom Area category is created, 95% of the cases it will be on the same hierarchical level as workplaces. As an example of a custom area you could think of a concentration hubs or prayer room. For details on mapping custom categories, see this article Studio location mapping.
Hierarchy with a site or geographical area: additional rules
In Workplace Management, make sure no areas are added to properties of the category ‘Site’ and ‘Geographical area’. You are only allowed to add areas to properties of the category ‘Property’.
When creating a new property in Workplace Management the option to add areas is hidden, so that is fine.
But, afterwards when you change the category from ‘Property’ to, ‘Site’ or ‘Geographical area’ make sure you first delete all areas (except for the main area of course).
It is possible have a additional hierarchical levels above ‘Property’. This is explained in the table above, but not shown in the screenshot below. These levels are called ‘Site' and ‘Geographical area'.
A site could, for example, be a business park on which five properties are located.
The category Geographical area can for example be used as a parent for sites with in the same city or country.
For additional insight please look at the two screenshots below in which the default Area categories in Workplace Management (Axxerion) are shown (left) and an example of the mapping you’ll be doing later in Cobundu (right).
Where do I find the settings I selected
Settings per area can be found on the area. In the navigationMenu click ‘Properties’ > open the menuoption ‘Areas’ > open an area > click on the ‘Reservations’ tab. If the tab is not available set ‘Reservable = yes’ first on the general tab.
General property setting are found by clicking on the ‘Module settings’ button on your startBoard > ‘Masterdata’ tab.
General Workplace Experience integration setting are found by clicking on the ‘Module settings’ button on your startBoard > ‘Workplace Experience’ tab.
Additional options/settings
Summary
Search