Item Tracker, optionally part of the Brain Server, provides the user to track certain items through the Intellifi ecosystem using visual tooling. This includes:
- Map mode: Visualize the items moving through a 2D space.
- List mode: Simple table representation of items per location
Furthermore, Item Tracker includes an API that is used to integrate the application into your own software. This application will not change the behavior of the localization algorithm.
Item Tracker lives around the idea of visualizing the whereabouts of items using the Brain Server. This includes; current position, historic events and sensor data from those items.
The relationship between Profiles and Views
Item Tracker uses the concepts Profiles and Views. Views are visual representations of what the user want to show, e.g. a floor plan per department in a building showing where tools are located or a table showing current stock counts at a particular location. The user can manage and organize the what he wants to show for each View. The Sections below explain a Profile, View and the API of the Item Tracker.
What is a Profile?
Item Tracker uses the concept of Profiles to administer related settings and Views into a single object. Switching Profiles can be used to switch between Profiles or create a new one. This process is shown below by the animation.
What is a View?
A View is a collection of things that you, the user, are interested in seeing. This includes locations, items, sets, background images of floor plans. Views can represent a single setup which can be configured for, and displayed in both the Map and List mode available in Item Tracker. The image below shows an example of a View that is being observed.
Application Programming Interface (API)
Item Tracker has an internal API that can be used to directly interact with the application or integrate in your application. For example using the Item Tracker in kiosk mode removes all menu and input context from the screen and allows to embed this View into your (web) application. The API documentation can be found at "item-tracker/#/api-doc".
The landing page is the first page that is seen when browsing to the Item Tracker. This is shown in the image below. This gives an overview of the available modes that are available in the Item Tracker. The Sections below explain the Map and List modes, how to edit Views, Item Filters and other functionality.
The Map mode is a 2D representation of any observable setup, for example, a mapping of a floor plan or the front view of a shelving unit.
The figure below shows an example of a floor plan of a hospital wing to track down various equipment.
The figure below shows an example of a table view of a hospital to track down various equipment.
The List mode is a table or list representation of any observable setup. The Map and List mode use the same details of the view but represents the locations and data in different ways.
Editing a View
A View is a predefined set of the following elements:
- A name (E.g. 'Floor plan Building A')
- Locations at certain positions
- Items and/or Item Sets to observe in the observe state
- Data sources, e.g. Images for the Map background to act as a floor plan
The animation below walks through the process of editing a view and observing this view via the Map mode and List mode. The steps are described in the sections below.
Changing View details
The View details contain the name of the View. To change this press the gear icon next to the "Select a view" drop down. This will open a dialog in which the details can be edited or deleted.
Adding Locations, Items and/or Item Sets
To add Locations, Items, and/or Item Sets to the view, select the search box under the "Add Locations, item sets, and items" and search for the desired object to add to the View. Select the result or press the "Enter" key on the keyboard.
Changing Item or Item Set details
To change details, scroll down to the Item or Item Set and change the color of the object as desired.
Uploading images of floor plans
The supported image formats for the Item Tracker are: .jpg, .jpeg, .png, .svg, webp, .ico and .bmp. There is a maximum upload size of 20MB per file. Under the "Add image(s) from" header press the desired source from which images need to be added. The option Device will open a file dialog in which local files can be selected. The option Web will open a small dialog in which a URL of an image can be added.
Deleting images and Locations
Delete images and locations in map mode by selecting them and then pressing the "Delete" key on the keyboard. To delete locations in the List mode, press the small cross next to the Location label. See the animations below for an example.
The figure below demonstrates how to delete images and locations from a View in Map mode.
The figure below demonstrates how to delete locations from a View in List mode.
Group by Item Sets
Items can be grouped by Items Sets which will display the number of items in each Item Set. To do this, go to a view and click on the filter icon in the right top of the screen. Then click on the "Group items" toggle switch to enable or disable grouping Items.
Observing a View
The observe state lets the user “observe” the system as it was designed in the setup process. In the observe state, Items or Item Sets can be toggled "off" which will hide the objects from the View.