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 and
Edge
Length attributes. All other attributes and properties are read-only and
cannot be changed.
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® Premises Server 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 key properties, properties, or child classes for each
class you create. From the menu, choose from the following actions:
- Add
Key Property
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. When entering this property, click PickDate to
select the date from the calendar or ClearDate to clear your selection.
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.
- Add Property
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 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 Premises Server,
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 Premises Server 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.