0.0 Definitions

0.1 WorkPoint

CoWorkr’s Sensor hardware, called a “WorkPoint”,  reports an occupancy state, using various methods of sensing. WorkPoints report a reading of “Occupied” instantaneously and otherwise, if no change of status is observed, a WorkPoint has a “heartbeat” that reports an update to CoWorkr every minute, letting CoWorkr know it’s online. WorkPoints also contain a notification button that reports to CoWorkr if pressed.

WorkPoint Versions:

    V1 - Version 1 WorkPoint that uses temperature or vibration sensing (no longer available)

    V2 - Version 2 WorkPoint that uses temperature or vibration sensing

    V3 - Version 3 “Motion” WorkPoint that uses passive infrared (PIR) sensing

0.2 WorkHub 

A WorkHub is CoWorkr’s internet-enabled device that reads and pushes WorkPoint data to CoWorkr’s servers. WorkHubs, or “Hubs”, require an internet connection using LAN, WiFi, or Cellular dongle to operate. 

WorkHub Attributes:

WorkHub ID: Unique string given to a WorkPoint when placed onto a Floorplan, for example, “54f45a67ac641604fd9bfa1a”

WorkHub UUID: Unique string associated with a WorkHub’s Bluetooth radio, for example “CE27EB1455F1”

0.3 WorkPlace

A WorkPlace is a physical location from which WorkPoints and Workhubs are streaming. A WorkPlace is generally used to represent a single location that is based on a geographical address - for example, a building. WorkPlaces contain one or more Floorplans to which WorkPoints and WorkHubs are assigned. 

WorkPlace Attributes:

WorkPlace ID: A unique case-sensitive alphanumeric identifier, for example “YvamDKDx6KD4QZh5g”, given to a WorkPlace on creation.

WorkPlace Name: A custom field assigned to the WorkPlace by a user.

Address: The physical location of the WorkPlace. This is also used to pair with geolocation services of WorkHubs.

Timezone: The local timezone of the WorkPlace. 

Group: A grouping of users with specific access permissions. Groups are generally created for each customer to segment access but may also be a group of users that belong to a 3rd party that oversees multiple customers. A group is identified by a given Name and a case-sensitive alphanumeric ID, for example “nzYf5H8RNBYSgrLHJ’

Start & End: “Start Date” is the first day the data is to stream from a corresponding WorkPlace.  “End Date” is the day the data at the corresponding WorkPlace will end its streaming. These dates are generally defined by the customer’s subscription period.

Active Hours: “Active Start Hour“ and “Active End Hour” hours determine a range of time wherein occupancy data will be ignored for a specific WorkPlace. This generally is used to eliminate occupancy data created outside of working hours such as that created by late-night cleaners. This is a custom field that can be set by an admin.

0.4 FloorPlan

A FloorPlan is an image file used as a background for CoWorkr’s “FloorPlan” view on which WorkPoints are placed. This is commonly a cad-based 2D drawing that has been exported as a raster image like jpeg or png.

FloorPlan Attributes:

FloorPlan ID: A unique string assigned to a FloorPlan upon creation.

FloorPlan Name: A custom, required, field given to the FloorPlan image upon upload.

FloorPlan X, Y: A location on the FloorPlan using a X-Y coordinate system, typically used to describe a WorkPoint location 

Location: A X,Y coordinate that locates a WorkPoint icon on a Floorplan image on CoWorkr’s App

0.5 Tags

Tags are values assigned to WorkPoints to describe, but not limited to, the physical location or the use of the space. Tags contain 2 values, a category and a value associated with that category. For example, a tag category/value for a WorkPoint assigned to a workstation may be “furniture/desk”.

0.6 Analytics

Analytics is the method of creating and analyzing metrics that are created by CoWorkr to help describe your data.


Keenan May