Use this page to define the business rules for your zones.
Rules define the circumstances that trigger alerts.
Note: You need to define a zone before you can define a rule for it.
When you define a rule, you can check for future events, but not
for events that have already happened. For example, if a person is
already in Zone A and you then define a rule that items defined in
the Person class cannot enter Zone A, the result is no alert. No alert
occurs because rule checking is triggered by zone entry and exits
events, which did not occur in this situation. The logic is similar
with a rule for duration of stay. If a person has already been in
Zone A for 30 minutes, and you define a rule that the person cannot
stay in Zone A for longer than 10 minutes, no alert occurs.
Click
the type of business rule you want to work with. Business rule types
include:
- Zone Access Restriction - Define rules
indicating persons and items that are not allowed to enter zones during
specified time frames.
- Zone Exit Restriction - Define rules
indicating persons and items that are not allowed to leave zones during
specified time frames.
- Duration of Stay in Zone - Define rules
indicating how long persons or items can remain in a zone before an
alert is triggered.
- Maximum Items per Zone Threshold - Define rules
indicating the maximum number of items or persons that can be in a
zone at one time.
- Visitor Escorting - Define rules
indicating how visitors to the location will be escorted. For example,
you can specify who will escort visitors or how far away from an employee
a visitor can be before an alert is triggered.
- Items Association - Define
rules indicating associations between items.
A list of rules displays that are of the business type you selected.
Click Add to define a new rule. Click Delete to delete
an existing rule or click Edit to edit details for an existing
rule.
The following fields are available for all business rules except
for Visitor Escorting:
- Activity
Specify the time frame when the
rule should be applied. You can specify to
Always apply the
rule, to apply it
From a specific date and time (
yyyy/mm/dd
hh:mm:ss)
To another specific date and time, or to specify
a repetitive time frame for the new rule to be applied, for example
outside of normal work hours on all weekdays and all day on weekends.
You can also choose to
Invert the time frame, meaning that
the rule only applies during times outside the specified time frame.
Note: Times are relative to times on the database server.
The machines that host the database server and WebSphere® Application Server must be
set to the same time zone.
For
example, if you check Monday and specify 08:00 as
the start time and 17:00 as the end time, the
rule is active on Mondays between the hours of 8 am and 5 pm. If you
choose to Invert the rule, then it applies on Mondays except
between the hours of 8 am and 5 pm (instead the rule applies from
midnight to 8 am and from 5 pm to midnight).
- Actors
Specify the class, group, and other
filter criteria for items to which the rule applies. You can specify
all three, if needed. If you specify a Class, then all class-specific Attributes are
selectable. Otherwise, only the tag ID and label attributes are selectable.
If you select criteria for Inclusion, the rule applies for
all items that match the filter criteria specified. If you select Exclusion,
the rule applies to all items except those matching the filter criteria.
If no Class, Group, or Attribute is specified
in both the Inclusion and the Exclusion sections, the
rule applies to every defined item.
For example, if you want
the rule to apply to all items in the Person class, except for those
in the Security group, specify the Class value as Person for
inclusion and the Group value as Security for exclusion.
You can also exclude the rule from applying to specific people or
items by filling in the Zone values in the Exclusion column.
- Zones
Specify the Zone and Zone
Type to which the rule is restricted. Similar to Actors,
you can specify Zones for Inclusion and Exclusion by
filling in the values in the respective columns. In both cases, you
can select a single zone or all zones.
Zone Access Restriction
This rule
type allows you to specify the times when specific classes or groups
of persons or items cannot enter specific zones.
Complete the
following fields to create a new rule:
Zone Exit Restriction
This rule
type allows you to specify the times when specific classes or groups
of persons or items must not leave specific zones.
Complete
the following fields to create a new rule:
Duration of Stay in Zone
This rule
type allows you to specify how long specified persons or items that
can be in a specific zone at one time before an alert is triggered.
Complete
the following fields to create a new rule:
- Identification
Enter a Name and Description for
the new rule.
- Activity
- Actors
- Zones
- Additional Parameters
Specify the Maximum duration
of stay, in seconds that an actor can stay in the zone during
the specified time. For example, if you specify 120,
then if a specified actor stays in the zone for more than 120 seconds,
an alert will be triggered.
- Alert Actions
Specify the alert action to take when the
rule is violated. You can specify a combination of the following actions:
- Display Alert displays the issue in the Spatial Management Client.
- Log Alert sends the alert to CEI with a LasDurationOfStay event
type. You can also define a notification channel to call a program
as a result of this alert. For example, the alert action could be
to send an email.
- Customized Notification calls a notification
program outside of CEI and requires special customization.
Maximum Items per Zone Threshold
This
rule type allows you to specify the maximum number of persons or items
satisfying the specified criteria that can be in a specific zone at
one time.
Complete the following fields to create a new rule:
- Identification
Enter a Name and Description for
the new rule.
- Activity
- Actors
- Zones
- Additional Parameters
Specify the Maximum number of
actors that can be in the zone during the specified time. For
example, if you specify 10 then if more than 10 actors
are in the zone at one time during the specified time frame, an alert
will be triggered.
- Alert Actions
Specify the alert action
to take when the rule is violated. You can specify a combination of
the following actions:
- Display Alert displays the issue in the Spatial Management Client.
- Log Alert sends the alert to CEI. You can also
define a notification channel to call a program as a result of this
alert. For example, the alert action could be to send an email.
- Customized Notification calls a notification
program outside of CEI and requires special customization.
Visitor Escorting
This rule type
allows you to specify rules that enforce the escorting of visitors
and that govern how visitors will be escorted at the location. This
rule type has less configuration options than the others, and its
activity cannot be temporarily restricted.
Complete the following
fields to create a new rule:
- Identification
Enter a Name and Description for
the new rule.
- Visitor
Specify the tag ID, class, or group of persons
or items to be escorted.
You can specify an individual
person or item by specifying the Tag ID or you can specify
a Class or Group of persons or items to which the rule
applies.Note: The visitor must belong to container classes, the
escort must not contain a container class, and the DynamicContainerSupportOn
system property must be selected.
- Escort
Specify the tag ID, class, or group of persons
or items that will escort the visitor.
You can specify an individual
person or item by specifying the Tag ID or you can specify
a Class or Group of persons or items to which the rule
applies. For example, you could specify
that a class of persons could escort the visitor.
Note: The visitor
must belong to container classes, the escort must not contain a container
class, and the DynamicContainerSupportOn system property must be selected.
- Zone Selection
Specify the Zone and Zone Type to which
the rule applies. In other words, specify the zones in which
the visitor must be escorted.
- Additional Parameters
Specify the
Maximum tolerated
distance, in units that the visitor can be away from the escort.
For example, if you specify
10, then if the visitor
is more than 10 feet away from an escort, an alert will be triggered.
Note: Currently,
the edge length of the visitor (who is in the container class) determines
the maximum tolerated distance.
Specify the Maximum
tolerated rule violation time, in seconds that the visitor can
be away from an escort before an alert is triggered. For example,
if you specify 120, then if the visitor is more than
10 feet away from an escort for more than 120 seconds, an alert will
be triggered.
- Alert Actions
Specify the alert action
to take when the rule is violated. You can specify a combination of
the following actions:
- Display Alert displays the issue in the Spatial Management Client.
- Log Alert sends the alert to CEI. You can also
define a notification channel to call a program as a result of this
alert. For example, the alert action could be to send an email.
- Customized Notification calls a notification
program outside of CEI and requires special customization.
Items Association
This
rule type allows creating associations between items. An association
is created when two items fulfilling the specified filtering criteria
are close to each other for a configurable period of time. Even though
the rule can be applied to classes and group of items, associations
are always created between two individuals.
Complete the following
fields to create a new rule:
- Identification
Enter a Name and Description for
the new rule.
- Base Item
Specify the tag ID, class, or group of persons
or items to which other items are to be associated.
You can specify an individual
person or item by specifying the Tag ID or you can specify
a Class or Group of persons or items to which the rule
applies. There can be multiple base
items.
Notes: - The base items must be members of classes that have been specified
as containers, and the system property DynamicContainerSupportOn must
be selected.
- The edge length must be greater than zero.
- Associated Item
Specify the tag ID, class, or group of
persons or items to be associated with others. You can specify an individual
person or item by specifying the Tag ID or you can specify
a Class or Group of persons or items to which the rule
applies. There can be multiple associated
items. The item to be associated must not be a container item.
- Zone Selection
Specify the Zone and Zone Type to which
the rule applies.
- Additional Parameters
Specify the
Maximum distance,
in units that the base item and the associated item may be apart
and still be associated. For example, if you specify
10,
then an association only takes place if the associated item is within
a radius of 10 from the base item.
Note: Currently, the edge length
of the base item (that is in the container class) determines the maximum
distance.
Specify the Minimum time of being together,
in seconds. This means the minimum period of time that both items
must be close to each other before an association is created and an
alert is triggered. For example, if you specify 120,
then two items must be not more than 10 feet away from each other
for at least 120 seconds before an alert will be triggered.
- Alert Actions
Specify the alert action
to take when the rule is violated. You can specify a combination of
the following actions:
- Display Alert displays the issue in the Spatial Management Client.
- Log Alert sends the alert to CEI. You can also
define a notification channel to call a program as a result of this
alert. For example, the alert action could be to send an email.
- Customized Notification calls a notification
program outside of CEI and requires special customization.
Tips for using this rule: - Both the container tag and the associated tag must move into the
target zone after the zone-related rule has been defined.
- The associated tag must be "inside" the edge length of the container
tag longer than the minimum time without interruption.
- The base item must be the last item moving because the association
rule is evaluated when the container items move.
Click Save to save your settings or click Cancel to
exit without saving the changes. Click Delete to delete the
rule.
Note: Fields marked with an asterisk (*) are required.
All other fields are optional.