Locations

Locations Module

The Locations module allows users to view and manage sites and their associated locations within the system. The module provides a map view of available sites and allows users to access site management options.


1. Locations Overview

The Locations page displays the available sites and their locations on a map.

Locations Overview

OptionDescription
SearchAllows users to search for a site by name or address.
EntityFilters the displayed sites based on the selected entity.
StateFilters sites based on the selected state.
CategoryFilters sites based on the selected category.
Manage sitesOpens the site and organizational structure management area.
ImportAllows site information to be imported.
New locationAllows users to create a new location.
Site ListDisplays the available sites on the left side of the page.
Map ViewDisplays the geographical locations of the available sites.

2. Manage Sites

The Manage sites option opens the Org Structure page, where groups, customers, and sites can be managed.

Manage Sites

Steps

  1. Open the Locations module.
  2. Click Manage sites.
  3. The Settings page opens with the Org Structure section selected.
  4. The organizational hierarchy is displayed.

3. Create a New Customer

The New customer option allows users to create a customer within the Org Structure.

Create a New Customer

Steps

  1. Open Manage sites.
  2. Click New customer.
  3. The Create a new customer pop-up is displayed.
  4. Enter the required Customer name*.
  5. Enter the Slug if required.
  6. Enter the Description if required.
  7. Select the required Status.
  8. Click Create customer.
  9. The customer is created and added to the organizational structure.

Create a New Customer

Customer Fields

FieldDescription
Customer name*Enter the name of the customer. This field is mandatory.
Slug (optional)Enter a short identifier used in URLs and exports. The slug should use lowercase characters without spaces.
Description (optional)Enter additional information about the customer.
StatusSelect the customer status. The available status shown is Active.
CancelCloses the pop-up without creating the customer.
Create customerCreates the customer using the entered information.

4. Create a New Group

The New group option allows users to create groups within the Org Structure. Multiple groups can be created as required, and each group is saved and displayed in the organizational structure.

Steps

  1. Open the Locations module.
  2. Click Manage sites.
  3. The Org Structure page is displayed.
  4. Click New group.

Create a New Group

  1. The Create a new group pop-up is displayed.
  2. Enter the required Name* for the group.
  3. Click Save.
  4. The group is created and saved in the Org Structure.
  5. The created group is displayed in the group list.
  6. Click New group again to create additional groups.
  7. Enter the new group name and click Save.
  8. The additional group is also saved in the Org Structure.

Created Group

New Group Fields

FieldDescription
Name*Enter the name of the group. This field is mandatory.
CancelCloses the pop-up without creating the group.
SaveCreates and saves the group in the Org Structure.

5. Create a New Site

After creating a customer, users can create a site under the customer using the + New location option.

The Create a new site pop-up allows users to enter the site information and select its location on the map.

Create a New Site

Steps

  1. Open the Locations module.
  2. Click Manage sites.
  3. Open the Org Structure section.
  4. Select the required customer.
  5. Click + New location.
  6. The Create a new site pop-up is displayed.
  7. Enter the required Site name*.
  8. Select the required Customer*.
  9. Enter the Description if required.
  10. Enter the site Address.
  11. Enter the Entity and State if required.
  12. Enter the Branch area (sq ft) if required.
  13. Select the Category if required.
  14. Enter any required custom field information.
  15. Use the map to select or confirm the site location.
  16. Review the entered site information.
  17. Click Create site.
  18. The site is created and added under the selected customer.

Create a New Site

New Site Fields

FieldDescription
Site name*Enter the name of the site. This field is mandatory.
Customer*Select the customer to which the site belongs. This field is mandatory.
DescriptionEnter additional information about the site.
AddressEnter the address of the site.
EntityEnter the entity associated with the site.
StateEnter or select the state associated with the site.
Branch area (sq ft)Enter the branch or site area in square feet.
CategorySelect the category associated with the site.
Custom field 1Enter additional custom information if required.
Custom field 2Enter additional custom information if required.
Custom field 3Enter additional custom information if required.
Custom field 4Enter additional custom information if required.
Custom field 5Enter additional custom information if required.
MapAllows users to search for an address and select or confirm the site location on the map.
CancelCloses the pop-up without creating the site.
Create siteCreates the site using the entered information.

6. Site Details

After creating a site, the Site Details page is displayed.

Site Details

Section / OptionDescription
Site NameDisplays the name of the site.
AddressDisplays the complete address of the site.
MapDisplays the geographical location of the site.
CoordinatesDisplays the latitude and longitude of the site.
Branch AreaDisplays the site area in square feet.
CreatedDisplays the date on which the site was created.
LocationsOpens the location hierarchy associated with the site.
AssetsOpens the assets associated with the site.
Work OrdersOpens the work orders associated with the site.
Assigned Issue TemplateAllows an issue template to be assigned to the site's public QR reporting form.
Print QRAllows users to print the site's QR sticker for reporting an issue.

6.1 Edit Site

Edit Site

  1. Open the required site.
  2. Click Edit.
  3. Update the required site information.
  4. Review the changes.
  5. Save the updated information.

6.2 Delete Site

Delete Site

  1. Open the required site.
  2. Click Delete.
  3. Confirm the deletion if a confirmation message is displayed.
  4. The site is deleted from the system.

7. Import Groups, Customers, Sites & Locations

The Import CSV option allows users to create or update multiple groups, customers, sites, and locations using a CSV file.

Import Groups, Customers, Sites & Locations

Steps

  1. Open the Locations module.
  2. Click Manage sites.
  3. The Org Structure page is displayed.
  4. Click Import CSV.
  5. The Import Groups, Customers, Sites & Locations pop-up is displayed.
  6. Click Download template to download the sample CSV file.
  7. Open the downloaded CSV file and add or modify the required information.
  8. Save the updated CSV file.
  9. Return to the import pop-up.
  10. Click Choose CSV file.
  11. Select the updated CSV file.
  12. If required, enable Update existing records with values from this file.
  13. Review the selected file.
  14. Continue with the import process.

Import CSV Options

CSV Import Options

OptionDescription
Download templateDownloads the sample CSV template for preparing the import data.
Choose CSV fileAllows users to select the prepared CSV file.
Update existing records with values from this fileUpdates existing records using the values provided in the uploaded CSV file.
CancelCloses the import pop-up without importing the CSV file.

CSV Columns

Required CSV Columns

ColumnDescription
customer_nameSpecifies the customer name. This field is required for every row.
site_nameSpecifies the site name. This field is required for every row.
location_nameSpecifies the location name when a location needs to be created.
location_typeSpecifies the location type, such as building, outdoor, floor, zone, wing, room, area, or other.
location_parent_nameSpecifies the parent location when creating a location hierarchy.

CSV Import Process


8. Open a Created Group

After creating a group, the group is displayed in the Org Structure.

Created Group

Steps

  1. Open the Locations module.
  2. Click Manage sites.
  3. Locate the created group in the Org Structure.
  4. Click the created group.
  5. The selected group opens and displays its details and associated organizational structure.

9. Create a New Location

The New location option allows users to create a location under the selected site.

Steps

  1. Open the Locations module.
  2. Select the required site, such as Tidel.
  3. Click + New location in Tidel.
  4. The New location pop-up is displayed.

New Location

  1. Enter the required Name* for the location.
  2. Click the Location Type dropdown.
  3. Select the required location type.

Location Types

9.1 Location Type Options

Location TypeDescription
BuildingCreates a building-level location.
FloorCreates a floor within a building.
WingCreates a wing within a site or building.
RoomCreates a room location.
AreaCreates an area within the site.
ZoneCreates a defined zone within the site.
OutdoorCreates an outdoor location.
OtherCreates a location that does not fit the available location types.
  1. Enter the Description if required.
  2. Select the required Linked Checklists if applicable.
  3. Review the entered information.
  4. Click Create.
  5. The location is created and displayed under the selected site.

New Location Form

9.2 New Location Fields

Location Type Dropdown

FieldDescription
Name*Enter the name of the location. This field is mandatory.
Location TypeSelect the type of location from Building, Floor, Wing, Room, Area, Zone, Outdoor, or Other.
Description (optional)Enter additional information about the location.
Linked ChecklistsSelect the checklists that should be linked to the location.
CancelCloses the pop-up without creating the location.
CreateCreates the location using the entered information.

10. Location Details

After creating a location, the Location Details page is displayed. It provides information about the selected location and allows users to manage tags, sub-locations, documents, checklists, and related work orders or tasks.

Location Details

10.1 Location Information

Section / OptionDescription
Location NameDisplays the name of the selected location.
Location TypeDisplays the type of location, such as Building.
Parent SiteDisplays the site under which the location was created.
LinkProvides access to the location link or related location information.
QR CodeProvides access to the QR code associated with the location.
EditAllows users to edit the location information.
DeleteAllows users to delete the location.

10.2 Tags

OptionDescription
TagsAllows users to assign tags to the location. Tags can be used to group and organize locations on the detailed overview.

10.3 Sub-locations

The Sub-locations section displays locations created under the current location.

OptionDescription
Sub-locationsDisplays the locations created under the selected location.
Add sub-locationAllows users to create another location under the current location.
Sub-location CountDisplays the number of sub-locations available.

10.4 Photos & Documents

The Photos & Documents section allows users to attach files related to the location.

OptionDescription
Upload AreaAllows users to drag and drop files or click to upload them.
Supported FilesSupports PDF, Word, Excel, and image files.
Maximum File SizeThe displayed maximum file size is 25 MB.
File LimitThe displayed limit is 10 files.

10.5 Linked Checklists

The Linked checklists section displays checklists associated with the selected location.

OptionDescription
Linked ChecklistsDisplays the checklists linked to the location.
AddAllows users to add a checklist to the location.
DeleteAllows users to remove a linked checklist from the location.

10.6 Work Orders & Tasks

The Work orders & tasks section displays work orders and tasks associated with the selected location.

OptionDescription
All timeDisplays work orders and tasks for the entire available period.
Last 7dDisplays work orders and tasks from the last 7 days.
Last 30dDisplays work orders and tasks from the last 30 days.
Last 90dDisplays work orders and tasks from the last 90 days.
Last 1yDisplays work orders and tasks from the last year.
Work Orders & Tasks ListDisplays the available work orders and tasks associated with the location.

If there are no work orders or tasks associated with the location, the page displays that there are no work orders or tasks at the location yet.


11. Use Location in New Task

The Use in new task option allows users to create a new task directly from the selected location.

Use in New Task

Steps

  1. Open the required location.
  2. Click Use in new task.
  3. The New task pop-up is displayed.
  4. Enter the required task information.
  5. Review the location and linked checklist information.
  6. Click Create task.
  7. The task is created and added to the Tasks module.
  8. Open the Tasks module to continue the task process.
  9. Start the task and complete the required work.

New Task Form

New Task Fields

SectionDescription
GeneralEnter the task title, description, priority, and task type.
Estimated EffortEnter the estimated hours and minutes required to complete the task.
Task TypeSelect how and when the task should be performed.
AssignmentAssign the task to one or more people or a team.
Approval ChainSelect users who need to review or approve the completed work.
Location & AssetDisplays the selected site and location from which the task was created.
Linked ItemsDisplays linked checklists and other related information.
Attach FilesAllows files to be attached after creating the task.
Reporter / ReviewerSelects the reporter or reviewer for the task.
Digital Sign-OffAllows signatures to be required when closing or acknowledging the task.
Automations That Will FireDisplays automations that will run based on the created task.
Create taskCreates the task and adds it to the Tasks module.

12. Use in New Work Order

The Use in new work order option allows users to create a work order directly from the selected location.

Use in New Work Order

Steps

  1. Open the required location.
  2. Click Use in new work order.
  3. The New work order pop-up is displayed.
  4. Enter the required work order details.
  5. Review the selected Location and other linked information.
  6. Click Create work order.
  7. The work order is created and saved in the Work Orders module.
  8. Open the Work Orders module.
  9. Start the work and complete the required activities.
  10. Resolve or close the work order after completing the work.

New Work Order Fields

New Work Order Fields

Section / FieldDescription
Title*Enter the name of the work order.
DescriptionEnter details about the required work.
PrioritySelect the required priority.
Work TypeSelect the required work type.
Estimated EffortEnter the estimated hours and minutes required to complete the work.
ScheduleSelect the schedule and enter the start and due dates.
AssignmentAssign the work order to one or more people or a team.
Approval ChainSelect the users who need to approve or review the completed work.
Location & AssetDisplays the selected site and location and allows an asset to be selected if required.
Linked ItemsAllows checklists, vendors, categories, and report templates to be linked.
Attach FilesAllows files to be attached after creating the work order.
Reporter / ReviewerSelects the reporter or reviewer for the work order.
Digital Sign-OffAllows signatures to be required when closing or acknowledging the work order.
Automations That Will FireDisplays automations that will run for the work order.
Create work orderCreates and saves the work order.

13. Complete Locations Module Workflow

The following workflow provides the complete process for managing the Locations module, from creating the organizational structure to creating locations and using them for tasks and work orders.

Locations Module
      ↓
Manage Sites
      ↓
Org Structure
      ↓
Create Customer
      ↓
Enter Customer Details
      ↓
Create Customer
      ↓
Customer Created
      ↓
Create Group
      ↓
Enter Group Name
      ↓
Save Group
      ↓
Group Created
      ↓
Create Additional Groups if Required
      ↓
Select Customer
      ↓
Create Site
      ↓
Enter Site Details
      ↓
Select / Confirm Site Location on Map
      ↓
Create Site
      ↓
Site Created
      ↓
Open Site Details
      ↓
Edit / Delete Site if Required
      ↓
Select Site
      ↓
Create New Location
      ↓
Enter Location Name
      ↓
Select Location Type
      ↓
Building / Floor / Wing / Room
/ Area / Zone / Outdoor / Other
      ↓
Enter Description if Required
      ↓
Select Linked Checklists if Required
      ↓
Create Location
      ↓
Location Created
      ↓
Open Location Details
      ↓
Manage Tags
      ↓
Manage Sub-locations
      ↓
Upload Photos & Documents
      ↓
Manage Linked Checklists
      ↓
View Work Orders & Tasks
      ↓
       ┌──────────────┐
       │                       │
       ↓                       ↓
Use in New Task        Use in New Work Order
       ↓                       ↓
New Task                 New Work Order
       ↓                       ↓
Enter Task Details       Enter Work Order Details
       ↓                       ↓
Review Location /       Review Location /
Linked Items            Asset / Linked Items
       ↓                       ↓
Create Task             Create Work Order
       ↓                       ↓
Tasks Module            Work Orders Module
       ↓                       ↓
Start Work              Start Work
       ↓                       ↓
Complete Work            Complete Work
       ↓                       ↓
Resolve / Close         Resolve / Close
       Task               Work Order