GeoTree Screen

Last verified with: 10.8.6.0

Overview #

The GeoTree is used to organize geographic or location-based rating destinations into a hierarchical structure. Each node in the tree represents a location or grouping, and patterns can be attached to those nodes so usage can be matched to the correct location during rating.

When a usage class is configured to use the GeoTree as its rater, the rating engine evaluates the destination value on the usage record, such as a phone number, IP address, or other supported identifier, against the patterns stored in the GeoTree. If a pattern match is found, the matched location can then be used to select the correct usage rate.

The GeoTree can be structured as broadly or as granularly as needed. For example, it can represent countries, regions, carriers, zones, service areas, or other location-based groupings that matter for rating.

Prerequisites #

No back-end configuration or custom code is required to create or modify the GeoTree. GeoTree data can also be imported when needed.

The GeoTree Panel #

The GeoTree panel on the left displays the tree structure. Expand nodes to browse the hierarchy and select a node to load its details on the right. The root node is loaded first, and child nodes are loaded as you expand and select locations within the tree.

The Edit Panel #

The panel on the right displays the selected GeoTree node and provides two working areas:

• Patterns
• Nodes

Each tab includes its own filter and list so you can work with patterns or child nodes under the selected location.

Patterns Tab #

The Patterns tab displays the patterns configured directly on the selected node.

Patterns are used by the rating engine to map destination values to a location in the GeoTree. When a usage record matches a pattern on a node, the engine can use that location when determining the appropriate usage rate.

Each pattern entry includes:

• Name: The value or pattern that should be matched.
• Country: The country associated with the pattern.

Patterns can contain alphanumeric values, and IP slash notation is supported for IP-based matching.

Working With Patterns #

Use the Patterns tab to:

• add a new pattern under the selected node
• edit an existing pattern
• mark a pattern for deletion or restore it before saving
• filter the visible list when a node contains many patterns

Nodes Tab #

The Nodes tab displays the child nodes that exist beneath the currently selected node.

Use this tab to build and maintain the GeoTree hierarchy.

Each node entry shows the child node name under the current location.

Working With Nodes #

Use the Nodes tab to:

• add a new child node beneath the selected node
• edit the name of an existing child node
• mark a node for deletion or restore it before saving
• filter the visible list when a location has many child nodes

A node cannot be deleted while it still has child nodes beneath it.

Adding GeoTree Nodes #

To add a new node:

1. Select the parent location in the GeoTree panel.
2. Open the Nodes tab.
3. Click New.
4. Enter the node name.
5. Add the node.
6. Save the screen changes.

Editing GeoTree Nodes #

To edit an existing child node:

1. Select the parent location in the GeoTree panel.
2. Open the Nodes tab.
3. Click Edit beside the child node.
4. Update the node name.
5. Save the screen changes.

Deleting GeoTree Nodes #

To delete a node:

1. Select the parent location in the GeoTree panel.
2. Open the Nodes tab.
3. Click Delete beside the child node.
4. Confirm the removal state if prompted.
5. Save the screen changes.

Nodes that still have children beneath them cannot be deleted until those child nodes are removed or moved.

Adding GeoTree Patterns #

To add a pattern:

1. Select the location in the GeoTree panel.
2. Open the Patterns tab.
3. Click New.
4. Enter the pattern Name and Country.
5. Add the pattern.
6. Save the screen changes.

Editing GeoTree Patterns #

To edit a pattern:

1. Select the location in the GeoTree panel.
2. Open the Patterns tab.
3. Click Edit beside the pattern.
4. Update the Name or Country.
5. Save the screen changes.

Deleting GeoTree Patterns #

To delete a pattern:

1. Select the location in the GeoTree panel.
2. Open the Patterns tab.
3. Click Delete beside the pattern.
4. Confirm the removal state if prompted.
5. Save the screen changes.