This topic describes how to use the Preferences Administration GUI to
define your Spatial Management Client and
build time preferences for Location Awareness Services for WebSphere® Sensor Events.
It is necessary to define your preferences only once per server
installation instance for the installation entries.
Open the Preferences Administration GUI by
opening the following URL: http://fully_qualified_host_name/Tracking
GUI/AtlasPrefsAdmin.html
Important: After
you create a new area
using the Preferences Administration GUI,
you must close all browser windows, wait about 60 seconds, and then
reopen the browser before trying to use the new area in the Spatial Management Client.
Spatial Management Client
The
Spatial Management Client is
a monitoring application that polls every
n seconds
for new data in a defined area, as specified in the
prefsV3.xml file.
The default value is to poll every second.
Note: Some browser functions
are not supported. For example, using the Back, Forward,
and Refresh buttons in the browser can lead to inconsistent
displays of areas, tags, and menu options.
The prefsV3.xml file
automatically updates some the Build time fields. When you
update your product version, ensure that you merge the contents of
the old prefsV3.xml file, rather than simply
replacing the previous contents. The list must be consistent with
the related tables in the Location Awareness Services for WebSphere Sensor Events database.
Define
your preferences in the
Preferences Administration GUI by
entering information in the following
Build time fields:
Note: Make
sure you define your preferences and set your area, icon, and overview
scale values correctly before you create zones.
Build time
Build time preferences are defined
only when a new area or subarea is added. These preferences determine
how the areas, zones, and resources display in the Spatial Management Client.
- Area SVG: Select an area from the menu or create or delete
one.
- Click New to create a new area.
- Click Cancel to
cancel your action without saving.
- Click Delete to
delete an area.
Notes: - Defining
an area with an SVG that is greater than 4 MB is not
recommended.
- Deleting an area also deletes its subareas.
- Area name: Enter a descriptive
name for
the area. The area name for a given area cannot be changed.
- SVG
path: Enter the relative path to the area scalable
vector graphic (SVG) file. For example, ./svg/Matrix.svg.
- SVG overview path: Enter the relative path to the area
SVG overview file, which is the graphic file used for the overview
window in the Spatial Management Client.
For example, ./svg/Matrix.svg.
- SVG width: Enter
the width of the SVG file in pixels.
- SVG height: Enter
the height of the SVG file in pixels.
- Minimum Z: Enter
the minimum Z value, or height, for this
area.
- Maximum Z: Enter the maximum Z value, or height,
for this
area.
- Enter the width the drawing represents: Enter
the value
in units that the drawing represents. For example, if the drawing
represents an area that is 40 feet wide, enter 40.
Note: If
you enter the drawing width, Area Scale is automatically filled
in with a scale determined by the drawing width.
- Area
scale: Enter the scale factor to use to scale the
coordinate display in feet for the SVG file representation. As you
move the cursor over the drawing, X and Y coordinates are visible.
Move it over an area of the graphic that you know the coordinates
for and adjust this value so the values match the scale of the drawing.
Note: If
you enter the area scale value, the drawing width also adjusts. The
current width and height are calculated and displayed at the current
scale.
- Overview scale: Scale the overview window to the size you
want it.
- Parent SVG area name: If this area is to be
used as a subarea,
enter the name of the parent area. Otherwise leave this entry blank.
Note: Area
names must be unique across the Location Awareness Services for WebSphere Sensor Events installation.
- X offset value: Enter the X offset value in units for placement
of the subarea within the parent area. Otherwise enter 0.
- Y offset value: Enter the Y offset value in units for placement
of the subarea within the parent area. Otherwise enter 0.
- Cartesian coordinate system: Check this box to turn on
the Cartesian coordinate system, which flips the area coordinate system
so that the X0 and Y0 coordinates are located in the lower-left corner
of the drawing with X positive going right and Y positive going up.
This system matches the X0 and Y0 coordinate system of many third-party
location event providers.
Installation
The Installation parameters
on the Preferences Administration GUI are
described in more detail in the topic about installing the Spatial Management Client.
The Host value
is taken from the requesting URL for the Preferences Administration GUI and
the Port value is set in the prefsV3.xml file.
Refresh
and clustering options
- Poll interval: Enter a value to indicate
the rate in milliseconds that tag data is requested from the server.
Note: Changing
this value does not affect the frequency at which a tracked item's
position is reported to the system. It only affects the frequency
with which the GUI is updated.
- Number of clustering grid rows
and columns: Define the number of grids to use for clustering
tags. If you have many tags on the screen, overlapping tags can occur.
If clustering is set to a value greater than 0, overlapping
tags are shown as a cluster icon. This cluster icon can be clicked
to open a window showing all tags in the cluster. Ten of those tags
can be individually selected.
The number of grid rows defines how
large the grid will be, which is covered by a cluster. For example,
a value of 20 means a grid of 20 rows and columns, where all tags
in one cell are shown as part of the cluster. A value of 0 turns
off clustering, meaning you cannot influence the order of tags from
back to front or select individual tags.
- Click Save Installation Changes to
save your changes to the preferences.
These preference settings
will apply each time the user logs in to the Spatial Management Client.
Making changes
If you edit
an attribute
related to an area, the
Save Modified Area button appears.
If you press this button after filling in all of the changed attributes,
you have the option to update the SVG file for the area.
Tip: If
you change the size of the SVG, scaling, offsets, or the cartesian
attributes, your old zone definitions, definitions made with the administrative
interface for the event provider, or devices might be affected. Be
sure to plan these values carefully and redefine all other affected
definitions.