Skip to main content

Bylott Onboarding Handbook - Knowledgebase / Blyott Manuals - Blyott Support & Assistance

Bylott Onboarding Handbook

Authors list

 


Table of Contents

I. WELCOME TO BLYOTT ONBOARDING HANDBOOK

II. USER MANAGEMENT

III. LIST VIEWS

IV. CONFIGURATION

VI. ADDITIONAL DETAILS


I. WELCOME TO BLYOTT ONBOARDING HANDBOOK


Within this Handbook we aim to provide you with useful information, documentation, and guidance that will enable you to make the most out of your access to the Blyott Platform.

In this guide you will be able to see, create, search, and edit Users, Assets, Tags, Locators, and Locations. At the bottom of this document, you can download the PDF file.


GETTING FAMILIAR WITH THE BLYOTT DASHBOARD
 

Once logged in, you will land on the Dashboard where you will find Assets (total and tagged), Tags (total and live), Locators (total and live), and Locations (total). The “Dashboard” gives us a clear view of all assets and how many of them are tagged. On the left side, there is a panel with User Management, List Views, and Configuration tabs. Take note that different screen sizes change the layout of the panel, on smaller screens the panel will be on the right side following the responsiveness of the webpage – RWD.


GETTING FAMILIAR WITH THE BLYOTT EXCEL TABLE
 

The Excel table is the database of all information needed for the platform to work properly. Usually, this table is prepopulated with all hardware and imported to the platform by your local IT department before your team starts to use the platform.


Here we populate the list of existing Locators, Locations, Hardware, Users, and Assets with all relevant data.


 

For accelerated onboarding, we created a simple shortened table called “Onboarding Excel Table” with minimal data which is needed to jump-start the setup and creation of client account. Here you can add essential data like Locators, Locations, Users, and Assets and forward the table to the support team to import it for you. Instructions on how to download and populate “Onboarding Excel Table” can be found HERE.


II. USER MANAGEMENT


USERS CREATION   
 

When you click on “Users” tab on the “User Management” panel, you can add the people/users that need to have access to your Blyott Platform. You will start with either “Admin” or “User” permissions. After login, on the Dashboard you need to click on “Users” tab from the left-hand panel and then click on “+” (Add User) button. Here you will need to include the following information:

  • First Name 
  • Last Name
  • Username 
     Must be unique, non-taken username in the system, otherwise you will get error message after you click “Save”. Just change your Username if this happens and make sure that it does not contain any spaces (there is no LDAP support currently).
  • Email 
     Please be sure to add the correct work email, as they will receive an invitation to access which is needed to confirm your email address for successful registration.
  • User Role (you can choose following)
    • Administrator: Can administrate the system, make changes, and add other users.
    • User: Can only access and search for assets on the system.
  • Access levels
     Here you choose the access level in certain department like Dermatology, Radiology, Pediatrics, and others. You can choose multiple departments, or you have the option to select all by clicking on “Total Access”.
    • The access levels allow you to determine which users can see or keep track of what equipment. It is likely that users in a certain division will only want to keep track of their own assets. For example, a nurse in the cardiology department may only require tracking cardiology-based equipment. Whereas a site engineer or technician may need to track equipment from various departments for maintenance. 

Access levels allow you to define/create wards/rooms, types of equipment and add additional more criteria meeting your local situation. More on that in Configuration>Access levels part.


III. LIST VIEWS


ASSETS


Here you can enter all the assets that you want to keep within the platform. Equipment you want to track, find its real-time location, is going to be assigned to the tag. This means that a tag’s MAC ID/Address is going to be attached to a specific asset. At this moment you will have to physically place a tag on that particular asset (equipment or device).

Clicking on the “Assets” tab on the “List Views” panel, depending on your “Access Level”, you will see the equipment list with information like Name, Code, Permissions, Workflows, tag assigned to equipment, Signal Strength, Last Seen Status, Location, Location Code and Fixed Location. 

  Here you can do the following:

To add more assets, click on “+” (Add asset) button and fill in the following data:

  • Asset name
     Specify the name of the equipment you want to add to the platform.
  • Permissions
    • If you want to limit access visibility to users in specific access levels (departments), select one or more relevant departments.
    • If you do not want to limit an asset visibility, choose “All Users” for everyone to find the asset.
  • Code
     Create a unique code for the asset (Example for defibrillator: DF01). To follow organization of assets, where the naming suggests (in prefilled excel table) code name for defibrillators with prefix “DF” then we add defibrillators names accordingly. If there is not prefilled data then we choose our code name as we want, keeping in mind to organize names meaningfully.
  •  Tag Assigned
    • Leave this blank if you have no interest in tracking this asset.
    • Assign the tag if you DO want to track the asset – use the value provided in the MAC ID field.
       
       
  • SEARCH ASSET

On the top of the page, you can use the search function to fast search for an asset on the list.

If you want to see detailed information about the asset, click on the desired asset and there you will see the following:

  • General Info
  • Tag details
     Here you can find Tag info about MAC, Type, NFC, Fixed Location, Hardware Model, Asset assigned, Machine learning location, RSSI-based location.
  • Activity details
     Here you can find Signal Strength, Battery, Temperature, Last seen, Location code and Location.
  • Edit button


You can use the following instructions on how to view or check the signal strength of assets attached to the Blyott platform. 

  • Select the ‘Assets’ tab from the left-hand panel.
  • Click on the asset name.
  • Switch to the 'Activity details' tab.
  • The signal strength will be shown in the last column.


TAGS


Tags are essential for the Blyott platform. They need to be scanned, registered, and placed on the equipment so that the assets (equipment) can be tracked successfully. 

Here you can enter all the tags that you have purchased to track and find the real-time location of your equipment. Each tag has unique information called a MAC Address. You can fetch this information by using an NFC Reader App (this can be downloaded onto any smart mobile device). This means that MAC ID/Address is going to be attached to a specific asset. You will also need to physically place a tag on that piece of equipment. 

Clicking on the “Tags” tab on the “List Views” panel, depending on your “Access Level” you can see tags list with information like MAC, NFC, Type, Fixed Location, Hardware Model, Asset Assigned, Last Seen, Additional note, etc.

 Here you can do the following:

To add more assets, click on the “+” (Add tag) button and fill in the following data:

  • MAC
    • Enter the MAC ID of the tag device. *
  • NFC
    • Enter NFC ID of the tag device. *
  • Type
    • Mobile (if the tag is likely to be attached to a piece of equipment that will be moved often)
    • Fixed (if the tag is going to be attached to a piece of equipment that is not expected to move)
  • Fixed location
    • If “Type” is selected “Fixed”, you will need to create fixed locations in the “Location” tab before you can select that location here. If the “Type” is “Mobile” then this is not available to select as it does not require fixed location.
  • Hardware model
    • Select hardware model of the tag device. You can easily find the hardware model under the device, written on the sticker (ex. Blyott | BT-T1a).
  • Asset assigned
    • Select the Asset to whom this tag is assigned. You will need to create Asset before if you want to connect Tag with Asset here. You can always assign it later.

*  Be sure to enter the correct MAC ID/NFC ID. MAC address is indicated on the bottom of the device. Enter the MAC address in capital letters and without the semicolons (:). If the number is not visible on the tag you can easily scan it using a mobile app downloaded from your relevant app store.

On the top of the page, you can use the search function to fast search for an asset on the list.

If you want to see detailed information about the tag, click on the desired tag and there you will see the following:

  • General Info
  • Activity details
     Here you can find Location, Location Code, Last Seen, Temperature, Battery, Signal Strength.
  • Edit button
  • SEE SIGNAL STRENGTH OF TAG

Use the following instructions on how to view or check the signal strength of tags attached to the Assets. 

  • Select the “Tags” tab from the left-hand panel.
  • Click on the tag name.
  • Switch to the 'Activity details' tab.
  • The signal strength will be shown in the last column.


LOCATORS


Locators are the devices that are required to locate all assets in the designated area.  This page will provide instructions on how to add/setup a new locator to the Blyott platform. For external devices, please see our detailed configuration manuals for ARUBA and MIST.

Here you can enter all locators that you are using to receive signals from Bluetooth tags. Each locator must have an associated location as this is how the system 'knows' where your equipment is located.

As an example, the Bluetooth tag that is linked to a piece of equipment was read by Locator A – when you entered Locator A into the platform, you defined it as being in Storage Room 1.

Clicking on the “Locators” tab on the “List Views” panel, depending on your “Access Level”, you can see the locators list with information like Locator Name, Location, Location Code, MAC, Type, Last Seen, Serial Number, IMSI, IMEI.

Here you can do the following:

To add more Locators, click on the “+” (Add locator) button and fill in the following data:


  • Locator
    • Enter locator name.
  • MAC*
    • Enter the MAC ID of the device.
    • Important note! MAC format is different for external MIST AP devices. Please see this manual if you are using Mist AP devices.
  • Type
    • Mobile (if the locator is likely to be moved often)
    • Fixed (if the locator is not expected to move)
    • WIFI (if you are using a Wi-Fi access point to pick up a Bluetooth tag signal)
  • Location
    • If “Type” is selected “Fixed” or “WIFI”, you will need to create fixed locations in the “Location” tab before you can select that location here. If the “Type” is “Mobile” then this is not available to select as it does not require fixed location.
  • Hardware model
    • Select the hardware model of the locator device.
  • Serial Number
    • Enter a serial number of the device.
  • IMSI
    • Enter IMSI.
  • IMEI
    • Enter the IMEI number of the device.

IMPORTANT NOTES:

*  Be sure to enter the correct MAC ID. MAC address is indicated on the bottom of the device. Enter the MAC address in capital letters and without the semicolons (:)

If the number is not visible on the Locator, you can easily scan it using a mobile app downloaded from your relevant app store. This can be confirmed locally with your IT team and/or occasionally marked on the device.

If you are using our Blyott Demo Kit, please see this manual for additional information.
 If you are using external Aruba AP devices, please see this manual for additional information.
 If you are using external MIST AP devices, please see this manual for additional information.

Once the locator(s) have been configured and activated, they can be searched for within the platform by selecting the ‘filter’ icon from the top right corner of the screen.


On the top of the page, you can use the search function to fast search for a Locator on the list.

If you want to see detailed information about the Locator, click on the desired Locator and you will see the following:


  • General Info
  • Activity details
     Here you can find Location, Location Code and Last Seen.
  • Edit button


LOCATIONS


Here you can add the locations where you expect to install locators and track equipment. In addition to the name and code, you have the option to include up to ten 'custom fields' where you can add more detailed information like floor, wing, ward, or room name.

Clicking on the “Locations” tab on the “List Views” panel, depending on your “Access Level”, you can see the locations list with information like Location, Code, Type, Assets on Location, Department.

Here you can do the following:

To add Location, click on the “+” (Add location) button and fill in the following data:

  • Location
    • Enter desired location name.
  • Code
    • Location Code must be unique, non-taken code in the system, otherwise you will get an error message after you click “Save”. Just change your Code if this happens and make sure that it does not contain any spaces.
  • Type
    • Active (if the location is constantly in use)
    • Passive (we suggest marking locations such as 'storage rooms' as inactive or any location where equipment is stored, but not actively used)

Once the locations have been set up and are active, they can be searched for within the platform by selecting the ‘filter’ icon from the top right corner of the screen.

On the top of the page, you can use the search function to fast search for Locations on the list.

If you want to see detailed information about the Locations, click on the desired location and there you will see the following:

  • General Info
  • See Assets (currently assigned assets to this location)
  • Edit button



IV. CONFIGURATION


ACCESS LEVELS


Here you can see all “Access Levels” mentioned in the “User Creation” part above. You can imagine them like separate departments within the hospital like Dermatology, Neurology, Pediatrics. 

Clicking on the “Access Level” tab on the “Configuration” panel, you can see all Access Levels with Descriptions.

Here you can do the following:

To add Access Level, click on the “+” (Add Access Level) button and fill in the following data:

  • Access Level
    • Enter the desired name.
  • Description

Once the Access Levels have been set up and are active, they can be searched for within the platform by selecting the ‘filter’ icon from the top right corner of the screen.

On the top of the page, you can use the search function to fast search for Access Levels on the list.

If you want to see detailed information about the Access Levels, click on the desired Access Level and there you will see the Name, Description, and Edit button.


LAYOUT BUILDER


Layout Builder is essentially a template editing page where you can add or change Property Columns for Assets, Tags, Locators, and Locations.

Clicking on the “Layout Builder” tab on the “Configuration” panel, you can see the following editing form.

On the tab above (1.), you can select the “Property Columns” which you want to Edit/Add and see existing ones that cannot be changed (2.). By selecting, Edit/Delete custom Property Columns (3.) and Add new ones by clicking on the “Add” button (4.) or see Archived ones (5.).

Selecting one “Property Column” allows you to Edit or Archive it. Selecting more allows you only to Archive them.

To add a custom Property Column, click on the “+Add” button and fill in its name. In the following image, you can see confirm and cancel button.



By selecting the custom column on the ticker box, Edit and Archive button will appear like in the following image.




WORKFLOWS/WEBHOOKS


If enabled by our side (you can request enabling by contacting Support Team), you will see in the “Configuration” panel “Workflows” section.

Before you start to use it, you need to create and configure the "Workflow" and specify a URL on where to forward data to e.g. a "Webhook". Take kindly note that you can find all relevant information under the "Workflow specific operations:" headline in the API documentation

Click “+” to add your Workflow and fill in the following data:


Note: “Secret” is a simple method to protect the webhook endpoint. Every webhook request will have a header ‘Token’ and the value of that header will be the value from the Secret field. This way you can check if the Token header exists and if it corrects for each request you receive.

A lot more functionality regarding Webhooks/Workflows are coming during Q3, e.g., zone alerts, etc. As for now, we are currently sending the following data to Webhooks (Workflows):


  • EventType
  • Tenant
  • WorkflowName
  • AssetName
  • AssetCode
  • TagMAC
  • LocatorMAC
  • CurrentLocationID
  • CurrentLocationCode
  • CurrentLocationName
  • MlLocation
  • RSSI
  • TimeSeen
  • Payload

To be able to receive data you need to edit the desired Asset and select a recently created workflow from the list under "Workflows" to start sending Asset data.

For additional information about Webhooks and API-related questions please see our latest API documentation.



VI. ADDITIONAL DETAILS


BLYOTT SUPPORT & ASSISTANCE


Within this Help Center, we aim to provide you with useful information, documentation, and guidance that will enable you to make the most out of your access to the Blyott Platform.

In the Knowledgebase section you can find a video walkthrough guide for the support page, Release Notes, Documentation, Manuals, and “How To” guides.

Keep up to date with the information & articles you are interested in, by selecting the 'Subscribe' option and you will receive email updates every time we add new information.

For everything else do not hesitate to contact us at support@blyott.com.


Thank you for your attention.
 The Blyott Support Team

Helpful Unhelpful

Share