Using Regions

The regions keyword populates the Building Region drop-down and it displays a region hierarchy. After you have created your building and assign it a region (country and city) then the region hierarchy and the building name is used in the Location selector, for example in the Spaces Module Locator selector, and the VBS module's Locator selector, Workplace Locator selector, and other modules with Location selectors.

When you have many buildings in locations, you can set up the region hierarchy to include:

Region, Country, and City - this is a detailed hierarchy the requires the user to navigate through the levels.
City - this is a brief hierarchy that the user can quickly navigate.

Region, Country, and City Example

In this example, the region hierarchy is set up to display from the region, country, and city.

This keyword has a particular setup for the region hierarchy to display in the correct order and the example above is set up as:

Keyword	Parent
blank entry	No Parent The No Parent selection displays as a blank entry as this is the top-level region.
North America	blank entry
United States	North America
California	United States
Colorado	United States
Connecticut	United States
Florida	United States

When you are in the VBS module, for example, you will navigate to the building via the region, country, and city to select the building.

City Example

In this example, the region hierarchy is set up to display from the city.

Keyword	Parent
blank entry	No Parent The No Parent selection displays as a blank entry as this is the top-level region.
Atlanta	blank entry
Boston	blank entry
Melbourne	blank entry
New York	blank entry
Zagreb	blank entry

When you are in the VBS module, for example, you will use less clicks to select the building.

Update Regions Keyword Set

You can modify the Regions keyword set.

Navigate to Admin Settings > System Config > General > Keywords.
In the Keyword Set Search field, enter the keyword set name called Regions.
Select the Regions. The keyword values display in the panel.
Add or edit the keyword values in the panel. For more information, refer to Modify an existing Keyword Set.

Top-Level Region

The top-level displays as a "blank entry" with the description "This is the top level region".

Parent and Child

When you add the new region you must select the parent, either:

select the region with the blank name.
or select a parent.

Parent with Blank Name Example

Sometimes you will need to select just above the entries to select the region with the blank name.

Parent Example