# Workplace App

The Workplace App is used for people management. This is where people are added into the Kahu system, and access cards can be issued. Is it also possible to set which of the building's systems the person can access, for example whether they can use the booking kiosk to book a desk.

The app can be found at: app.kahu.work - login to get started. If you do not have a Kahu login, please speak to your administrator.

# Login

Logging in to Kahu can be done with a Microsoft account, a Google account, or a Kahu account. Just select the relevant option from the login page. To login with a Microsoft or a Google account your administrator will have to set this up for your organisation.

# Account

To see your account details click the button in the sidebar. This will show your name, email address, and the option to logout.

# Sites

The Workplace App supports multi-site organisations. Sites are buildings, offices, or locations that your organisation manages. Once you are logged in you will be viewing your default site (your default site is set by your administrator, please contact them if it needs changing). To check which site is selected, hover over the site selection button in the sidebar, as shown below. This shows that the "HQ" site is selected.

To change the site, click the site selection button. You will be presented with a small menu with the available sites; click the site you wish to switch to.

The site you have selected will be referred to in this documentation as the active site.

Note: if you change site while using the app it will reset to your default site next time you load the app.

# People

# Directory

The default view when the app is loaded is the Directory. This is where everyone based at the active site will be listed.

To view more detail about a person, or change their permissions, click anywhere on the row.

To search for people type their name in the box and press enter. By default this will search people based at the active site. To change the search settings click the button. You will be presented with a small menu with the available search options.

It is also possible to find someone by scanning their card. To do this click the button next to the search box. Scan the card, and if someone has that card assigned to them you will be taken to their person view. If no one is found you will see a message that it has not been assigned to anyone.

Note: to be able to search by card you need the Kahu Card Reader software installed, and a Kahu provided USB card reader. For more information please contact us.

# Person View

The person view shows details about the person, including their name and contact information; use the Directory to find people.

# Site Permissions

The person view also shows the permissions editor. This is used for setting which of the building's systems the person can access, for the active site. For example in the following screenshot it can be seen that August cannot use Desk Booking or Room Booking at the active site.

To change someone's permissions click the checkboxes as appropriate, and click update. Note that when some permissions are enabled there may be associated permissions which can then be selected. For example when someone has Desk Booking permission, they can also have the permission to book multiple desks. This will only show when desk booking is selected. The screenshot below shows the "Allow multiple desks" option.

# Access Cards

Access cards are used for multiple applications, including allowing people access to the building. The access cards section allows you see which card is currently assigned, and gives the options for replacing the card or issuing a temporary one. To manage cards in the system, see the Cards section.

Note: to be able to assign you cards you need the Kahu Card Reader software installed, and a Kahu provided USB card reader. For more information please contact us.

# Assigning New Cards

The screenshot below shows the view when the person has no cards assigned:

To assign a new card click the button. You will be presented with a small form to fill in. The first action is to scan a card.

  1. Scan a card
  2. Set the access start date
  3. Optionally set an access end date
  4. Press OK

If you need to scan another card, click the button.

The end date is useful if the person needs access until a certain date (for example, someone on a fixed term contract). If no end date is set then the card will be valid indefinitely. To set an end date press "set an end date", and another date field will be shown. To remove the end date press the button.

If the card is already assigned to someone else a warning will be shown, which can be seen below.

Once assigned the card number will show in the Access Cards section.

# Replacing a Card

If a person needs their card replacing this can be done in the person view. From the Access Cards section click the button. Scan the new card, and confirm the replacement.

# Editing a Card

When editing a card all that can be changed is the validity period. To change the card, see Replacing a Card. Click the button, choose the new validity date, and press OK.

# Disabling a Card

It is possible to disable a card so it cannot be used. This is useful if the card is lost, for example. When issuing someone a temporary card their permanent card is automatically disabled. To manually disable a card click the button.

When a card is disabled it will show greyed out, with options to re-enable or replace.

# Temporary Cards

If someone has lost their card it is possible to issue a temporary card. Temporary cards are also used for visitors. To issue a temporary card click the button. By default temporary cards are set to be valid for the rest of the day. Temporary cards can be replaced or edited in the same way that permanent cards can.

Note: If there is a valid permanent card when a temporary card is issued it will be disabled automatically. If the person finds their permanent card or needs it re-enabling, this must be done manually.

# Deleting a Person

If you are an administrator you are able to delete people from the system; this is permanent. If you are able to delete people you will see the button on the Person View. Click this, and press confirm.

# Inactive

If you need to remove someone from the system you can mark them as inactive. This will stop them showing up in the Directory and search results, and they will be unable to use any of the Kahu systems. To mark someone as inactive, click the button. You will see the inactive tag appear in the person view.

To re-enable a person click the button from the person view.

# Person Edit

To edit a persons details click the button from the Person View. You will be presented with a form. Edit details as needed, and click save.

Field Description
Display Name A person's display name is what they like to be called. This is used across the Kahu apps, for example when booking a desk there is a greeting which includes the person's display name. By default this will be set to the person's first name.
Custom Tags Anything can be added as a custom tag. For example, you may want to tag people who have access to a specific facility such as a gym.
Cost Centre Cost Centre is useful for tracking where a person's expenses should be accounted for. Note: this is currently not used by other systems.

# New Person

To add a new person into the system, click the button from the Directory.

You will be taken to the New Person form, where you can fill in the person's details, and click create. Once they have been created you will be redirected to their person view page, where you can then set their permissions and assign them a card.

# Cards

Cards are used in Kahu for authentication. For example at a Booking Kiosk a user can swipe their card to book their desk. There are a few different ways in which cards are used. Some cards are non-transferable, they may have the person's picture printed on the card along with their name. Some cards are transferable, and may have a more generic name associated with them instead; for example "Contractor 1". Other transferable cards are temporary cards, which may be assigned to someone just for the day if they have forgotten their main card. To assign cards to people, see the Access Cards section.

To manage cards in the system, use the Cards list; to see this list select the Cards option in the sidebar. By default you will be presented with a list of transferable cards.

The list includes the cards name, who it is assigned to, the expiry date (if there is one), the type of card (permanent or temporary), the ID, and whether the card has been returned. If the card expires today, there will be an orange warning. If the card has already expired there will be a red warning.

To view more detail about a card, or to make changes, click anywhere on the row.

# Search

To search for cards use the search box in the top corner. Cards can be searched for by card name and by assignee's name. By default this will search for cards which are in use at the active site. To change the search settings click the button. You will be presented with a small menu with the available search options.

For example, the following screenshot shows a search for all cards whose name includes Contractor. This is useful for checking who has those cards assigned at a glance.

# Card View

The card view shows details about a card, including its name, who it is assigned to, and any tags. It also includes an option to see the history. Use the cards list to find cards.

If the card is assigned to someone and they have returned the card, you can remove their assignment by clicking return.

# Card History

The card view includes a button to show history. When this is clicked it shows a list of the most recent changes, and an option to load more. It shows all changes to a card, including name changes and assignment changes.

# Card Edit

To edit a card, from the card view click the button.

This will show a form to edit the card's details, including the card name and tags. It is also possible to change whether a card is non-transferable. Once you have made any changes, click save.

# New Card

To create a new card, click the button from the card list. You will be taken to the new card form (which is similar to the card edit form), where you can scan the card, fill in the card's details, and click create.

# Users

Users are people who have access to log into the Kahu Workplace App. The actions they can perform in the app are based on their user permissions, including editing the permissions of other Kahu users if allowed. Not all people that can use Kahu systems are users and have an account, but most resident staff are likely to; for example the Kahu Booking Kiosks can be used with an access card without needing an account.

If you are a Workplace App admin you can manage Workplace App users for your organisation. To see the users list, select the Users option in the sidebar. You can search for users with the search box, by either name or email address.

The user list shows the user's name, their email, and whether they are linked to a person in the Directory. To view more detail about a user, or change their security roles, click anywhere on the row.

# User View

The user view shows details about a user, including their email and security roles. Use the users list to find users.

To edit a user's security roles click the role checkboxes as appropriate, then click apply. When changes have been made and not yet applied, the apply button will be highlighted.

Note that some roles imply other roles, these will be shown selected and greyed-out; hovering over the checkboxes will show which role it is implied by. For example the People Reception role is implied by the People Admin role; as shown below.

# User Linking

Users can be linked to a person in the Directory. Users must be linked before they can access certain functionality, such as viewing their bookings from the Workplace App. If a user is linked, it will be shown on the user view, next to the Linked Person label. Otherwise, there will be a link button. To link a person to this user, click the link button.

This will bring up a dialog with a list of people, similar to the Directory. Use the search box to find the correct person, then click link to link them to the user.

The dialog will close and you will be returned to the user view, there will be a confirmation message when the link has been completed.

# Room Booking

The Workplace App is used to manage room bookings. For more information on Kahu Room Booking, see the Room Booking guide. If Room Booking is enabled for the active site, then the Room Booking option will show in the sidebar.

# Calendar View

Expand the Room Booking sidebar menu and click Calendar to see the calendar view.

The calendar view includes an overview of all bookings for the active site; the toolbar shows which day is selected. The calendar shows times along the left-hand side, with the current time highlighted with a purple line across the page. The calendar shows rooms along the top, with a column for each room.

The bookings on the calendar are coloured to indicate different states; click the button located in the top right corner to see the key.

To view bookings for a different day, use the previous and next buttons () or click the date to open the date selector located in the toolbar at the top left of the calendar.

# Create a Booking

To create a new booking from the calendar view, click and drag over the desired time slot, in the column of the desired room.

Upon release of the mouse a popup window will appear, this popup is for adding details to your newly created booking.

See and easily change the title of the booking. Conveniently see the room or space where the booking is being held.
Manage the day and time of the booking. View and assign the owner of a booking.
Adjust the setup time required before a booking begins. Add notes to the booking, such as required equipment, catering or other details.
Easily change the length of required clean down time, once a booking ends. Access the sub-menu to delete a booking.

From this popup menu you are able to add details such as a booking title, owner, and setup times. Once all the required details have been added, select create and the booking will be added into Kahu. For more details on how to edit a booking see Edit a Booking.

# Edit a Booking

You are able to edit a booking at any point up until it has been checked out, e.g. adjusting the title of the booking, adding a note or even moving it to a different time or day.

# Adding an Owner

An owner can be assigned by typing in the owner field; entering the first three letters of the desired persons name will display all entries that match, allowing you to select your desired individual. After an owner is added their name will be displayed in the slot in the calendar view.

# Adding Setup/Clean Down Time

Kahu Room Booking includes the ability to add time either side of a booking for setup and clean down. This is for situations where a booking may require preparation or clean up, such as setting up equipment setup or seating. To do this click Add setup time this will display two selectors one for setup and another for clean down time.

The initial time is always set to 15 minutes for each, should this need to be adjusted you are able to do so by either using the arrows when hovering over the times or typing in the desired length of time.

Adding setup and clean down times will result in two additional bookings being created. These appear before and after the booking currently being created/edited and can be edited separately.

# Adding Notes

The notes section allows extra detail to be added to the booking, such examples include required equipment, catering or other details. To add a note click Add a note and enter the detail you wish to add.

# Discarding Changes

If for any reason during creation or editing of a booking you wish to discard your changes, you can select discard. Alternatively you may click outside the popup twice, on the first click the popup will shake to signify you are about to discard the changes. The second click will confirm the action.

# Moving a Booking

Sometimes bookings may need to be moved around to different a time, room or day because of availability or resource management. The next section will detail how to achieve this through the popup window or calendar view.

# Changing a Booking's Location

To move a booking to a different room, click and hold the block of the booking. Then drag this to the column of the room you wish to move it to.

# Changing a Booking's Time

Booking times can be changed in two different ways, the first option is from the popup menu. Click the date and time section underneath the title and you will be presented with a way to adjust the start and end time of the booking; it is also possible to change the length of the booking, and the date on which it will occur.

The second way to achieve this is from the calendar view. By clicking on the booking and dragging it up or down the column to the new time position. Once at the new time slot release the mouse button, the booking will be assigned a new start and end time.

# Changing the length of a Booking

Changing the length of a booking can be done through the booking's popup menu, in the same way as changing a booking's time, see Changing a Booking's time. This can also be achieved by dragging the top or bottom edges of the bookings block on the calendar view.

NOTE: You are able to change the increments from 15 to 5 minutes by holding the CTRL key while dragging.

# Delete a Booking

Deleting a booking is done through the popout menu. First select the booking you wish to delete, then click the symbol in the top right corner and confirm by selecting delete. The booking will be removed and will disappear from the calendar view.

# Divisible Rooms

Divisible rooms are those that can be combined into larger spaces. Kahu defines the combined space as a room in the calendar view. When booking out this room, the Kahu system will automatically place reserved blocks in the rooms that make up that space.

When selecting the reserved block the title will show details on why this space is reserved.

This also occurs in the opposite manner, booking one of the rooms that make up a divisible space places a reserved block to the divisible room's column to signify the larger space is unavailable at that time.

# Busy Bar

The busy bar can be found on the popup underneath the title and booking time details when selecting a booking from the calendar. This bar is a timeline representation of the room's schedule, much like the columns on the calendar view.

When creating a booking, this makes it easier to see room availability for the day. Darker grey sections of this line represent other bookings while the blue shows the selected booking; by hovering over those sections the start and end times for those bookings are displayed.

This feature also serves as a warning when creating or extending a booking by showing clashes that will occur if the bookings times overlap, this is displayed in red.