Use this page to define
classes and individual items for
a class, for example, Asset and Person.
You
can define classes or subclasses depending on your needs and then
define individual items for those classes.
Click
Add Child
Class to define a new class;
or click an existing class to edit the fields or to define new items
for the class.
Note: If items are associated with the class
or any of its subclasses, you can change the
Description,
Icon
Link,
Update Interval,
Stationary,
Container,
Edge
Length, and
Smoothing Algorithm attributes. All other attributes
and properties are read-only and cannot be changed. The Smoothing
Algorithm is not inherited; changing it has no effect on subclasses
or items belonging to those subclasses.
Therefore, to change the
class, complete the following steps:
- Delete the items associated
with the class.
- Change the class.
- Add the items associated
with the class.
When you delete a group, class, or
zone, any rules you
created that refer to those entities are not automatically deleted.
You need to clean up any related rules when you delete a group, class,
or zone. If you create a new group, class, or zone with the same name
as one you deleted, and you have not cleaned up the old related rules,
then the old rules will not apply, even if you intended them to be
applicable.
Rules related to items and its properties are always
triggered when an item with the properties matches the condition.
Class Details View
Click the Class Details
View tab to view the details for a class. This view opens automatically
when you click Add Child Class or click an existing class.
Complete
or edit the following fields:
- Class Name*: Enter
a unique, meaningful name for the class.
- Description: Enter
a description of the class.
- Icon Link: Enter the file
name of the graphic icon to display
for this class of items. All items in the class are displayed in the Spatial Management Client with
the icon.
- Update Interval: Enter the number of seconds Location Awareness Services for WebSphere® Sensor Events waits
before processing location data and updating the location of the icon
on the Spatial Management Client.
Set this field to a higher number for items that move slowly or not
at all to reduce server load. For example, if the tagged item is a
mainframe computer, set the field to a higher number because it does
not make sense to check its position each second.
- Stationary: Check
this field if the class is made up of items that should not be removed
from a specific location, such as hardware assets.
- Container: Check
this field to define items in this class
as containers. This means they can contain other items.
- Edge
Length: Enter the size of the container (assume it
is a cube). This value allows rules checking in later releases, such
as when an item cannot leave a container. You can define an edge length
at class-level or an edge length for each item. The class-level edge
length is inherited by each item, but if an edge length is specified
for an item, it overrides the value set at the class-level
- Smoothing
Algorithm: No default smoothing algorithm is
selected when you create a new provider. Instead, the Implementation
Name field is pre-filled with a value of None,
indicating that no smoothing is applied.
- Implementation
Name: Select the name of the smoothing algorithm
implementation to use. The other fields are pre-populated when you
select an implementation. For example, you can choose between the
following types:
- None - The default value; no smoothing
is applied.
- WeightedUpdate - The new position of a
tag is calculated
based on its previous position maintained by Location Awareness Services for WebSphere Sensor Events, and
the new position is reported by the external event provider. The new
position is calculated as follows: newX = averagingFactor
* currentX + (1.0 - averagingFactor) * oldX, and similarly
for the other coordinates.
- MovingAverage - The new
tag position provides position
estimates computed according to a moving average algorithm. It accepts
as properties the length of the time series on which to operate and
the weights for each element in the series. The sum of the weights
must be equal to one.
- HammingWindow - This is a special
version of the MovingAverage
smooting algorithm, where the length of the time series on which to
operate is specified. The weighting of the positions is done according
to the HammingWindow algorithm.
- Implementation
Class: This value is populated based on
your selection of an implementation name.
- Parameter: This value is pre-populated based
on your selection
of an implementation name; however, you can modify the value. These
are the customization parameters for the smoothing algorithm. Specify
them in the keyword=value;keyword=value format.
- WeightedUpdate: AveragingFactor=0..1,
where 0..1 is replaced with a decimal i between
zero (0) and one (1), for example, 0.5.
- MovingAverage: TimeSeriesLength=n;Weights=0.x,0.x,0.x,
where n is replaced by a number greaters than one
(1), and 0.x,0.x,0.x is replaced by values between
zero (0) and one (1) which sum up to one (1). You can also specify Weights=equal,
where each position in the series is counted as the same length.
- HammingWindow: Hamming=true;TimeSeriesLength=n,
where n is replaced by a number greater than zero
(0).
You can define key properties,
properties, or child classes
for each class you create. From the menu, choose from the following
actions:
- Key
Properties
Key properties are mandatory for a class
item. Define key properties so that all members of the class can be
clearly identified. For example, a person's social security number
is an adequate key property, but a person's first and last names are
not adequate key properties, even when used together, because there
might be two people using the same first and last names.
Important: Make sure to define key properties with unique names.
- Name: Enter a unique name for the property.
- Type: Select
the type of value that should be entered for the property. For example,
you can choose among the following types:
- text - A
text field. For example, select this type for
a name property.
- textarea - A text field with space
for more characters.
For example, select this type for an address property.
- checkbox -
A check box. For example, select this type for
a property where the default is true or false.
- integer -
A field that allows only numeric values.
- date - A calendar.
Select this type for a property
that will always be a date.
Beside
each property that you want to delete, click
Mark for Deletion;
then click
Save to save your changes.
Note: You
cannot delete a key property if there are any items, subclasses, or
items in a subclass defined.
- Properties
Properties
can either be optional or mandatory for a class
item.
Important: Make sure to define properties with
unique names.
- Name: Enter a unique name for the
property.
- Type: Select the type of value that should
be
entered for the property. For example, you can choose between the
following types:
- text - A text field. For example,
select this type for
a name property.
- textarea - A text field with space
for more characters.
For example, select this type for an address property.
- checkbox -
A check box. For example, select this type for
a property where the default is true or false.
- integer -
A field that allows only numeric values.
- date - A calendar.
Select this type for a property
that will always be a date. When entering this property, click PickDate to
select the date from the calendar or ClearDate to clear your
selection.
- Min Occurs: Enter a value indicating
the minimum occurrences
of the property. This value should be less than or equal to the Max
Occurs setting. For example, enter 0 if the property
is optional and 1 if it is required.
- Max
Occurs: This property cannot be modified. The value
is 1, indicating that it can occur only one time.
- Default Value: Enter a default value for the property.
For example, for the Company property, enter the
name of your company. This value can be modified when you create an
item for the class.
Beside
each property that you want to delete, click Mark for Deletion;
then click Save to save your changes.
- Add key property
Enter the values for each key property
as necessary.
- Add property
Enter the values for
each property as necessary.
- Add Child Class
Enter
the values for the class,
including defining key properties, properties, and child classes (also
called subclasses) for each child class, as necessary.
- Save
Click Save to
save the class or child class
you are creating, as well as all key properties and properties defined
for the class.
- Delete
Click Delete to delete the class, its sub classes,
and all items in the class. All subclasses and items in the class
are deleted.
- Reload
Click Reload to refresh
the options available from the menus and to reset the fields to their
original state.
Item View
Click
the Item View tab to view the items that have been defined
for a class. You can add or edit new items for a class, assign items
to groups, or delete selected items. If the item is defined as a container
class, you can assign other items to the container item.
Items
in this view are sorted by tag ID in ascending order. Items that do
not have a tag ID are listed at the end.
Select Add
Item to create a new item. Complete the following fields:
- Registration Unit: (Optional) If a registration
unit has been defined and you are using it to read tag IDs into Location Awareness Services for WebSphere Sensor Events, select
the registration unit. This field is not always available.
- Tag
ID: Enter the tag ID for the item.
Enter
the tag ID manually or use an external device, such as a bar code
reader. Additionally, if you defined a registration unit, you can
select the appropriate tag ID from the tags that are read by the registration
unit.
- Icon Link: Enter the name of the graphic
icon file. By
default, the icon associated with the class displays for the item.
- Icon Label: Enter a label to identify the item.
The label helps you quickly identify tags in Location Awareness Services for WebSphere Sensor Events alerts,
in search results, and on the Spatial Management Client,
which allows you to view an icon label beside the tag. If an item
is created or modified using import, you can specify rules for automatic
label creation, such as building a label consisting of a person's
first name, middle name, and last name. If the item is defined as
a container class, the value for Edge Length is prefilled with
the edge length defined for the class and can be modified for the
single item.
Complete any additional fields, which vary
by class.
Click Save to
save your settings or click Cancel to exit without saving.
After
an item is defined, you can complete the following actions:
- Delete
Items
Under Choose Action, select Delete Items to
delete selected items.
- Edit
Properties
Click Edit Properties to edit an existing
item.
- Edit
Groups
Click
Edit Groups to assign the item to a group
or to remove it from a group.
Note: You can select one or multiple
groups, dependent on the HierarchicalGroups system property.
Click Save to
save your settings or click Cancel to exit without saving.
- Edit
Container (only available if the item is a container)
Click
Edit
Container to assign items to the container. A list of items that
can be assigned to the container are listed, as well as a list of
any items that have already been assigned to the container, if any.
The items are listed by class.
Note: To assign items to the container,
select one or more items under containable items. To remove assigned
items from the container, select one or more items under direct children.
Click Save to
save your settings or click Cancel to exit without saving.
Filtering the Item View
You
can also filter
the item view. Enter a string in the text field and then click Apply
Filter. The items will be filtered according to the string you
enter. If any of the property values or tag IDs for an item contains
the string, the item will be shown. Click Clear Filter to clear
the filter criteria.
Note: Fields marked with an asterisk
(*) are required.
All other fields are optional.