Application Guide for Oracle Self-Service E-Billing (Business Edition) > Using Hierarchies >

Searching a Hierarchy


A user can use this use case to find a particular group, account, service, and attribute for any node or leaf within a hierarchy. Table 72 lists and describes the use case functions.

Table 72. Searching a Hierarchy
Function
Description

Name

Searching a Hierarchy

Users

Business administrator user and manager user

Trigger

Search tab

Report Content - Search Results Fields For Element Groups

  • Name (Display name of Group element type.)
  • Position (The name of the hierarchy node one level above)
  • Display Name
  • Description
  • Attributes 1 through 5

Report Content - Search Results Fields For Element Accounts

The search results display the following fields for the element accounts:

  • Account No. (Display name of the Accounts element type.)
  • Position (The name of the hierarchy node one level above.)
  • Account Name
  • Attributes 1 through 5

Report Content - Search Results Fields For Element Service Agreement

The search results display the following fields for the element service agreement:

  • Service Number (Display name of element type Services).
  • Position (The name of the hierarchy node one level above.)
  • Account Number
  • Subscriber Name
  • Attributes 1 through 5

Report Content - Search Results Fields For Element Users

The search results display the following fields for element users:

  • Name (Display name of element type User)
  • Position (The name of the hierarchy node one level above)
  • Contact Number
  • Email Address
  • Attributes 1 through 5

Business Rules

  • Checkbox selections persist when paging. Selections are aggregated across pages.
  • If user selects the radio button for Entire Hierarchy, the scope of the search is all the nodes in the hierarchy.
  • If user selects the radio button for From Current Position, the scope of the search is relative to and limited by the nodes below the current position.

Main Path for Searching a Hierarchy

The following path describes the Searching a Hierarchy use case:

1 The user selects the Search tab.
  1. Oracle Self-Service E-Billing displays Hierarchy Search Criteria form with current context and defaults.
  2. The user changes the Element search criteria and clicks Submit.
  3. Oracle Self-Service E-Billing verifies that the required fields are specified as a search parameter.
  4. Oracle Self-Service E-Billing validation passes.
  5. Oracle Self-Service E-Billing displays a tabular search results report with the total count for the search result set and all attributes for the selected element type.

Alternate Paths for Searching a Hierarchy

Alternate paths can occur in this use case.

After the search results have been displayed, the user selects one or more checkboxes and selects Submit
  • Oracle Self-Service E-Billing returns the user to the Manage tab displaying:
    • Top pane: Hierarchy context.
    • Bottom Left Pane: Tree view of current hierarchy tree opened to current position context.
    • Bottom Right Pane: Elements tab containing the display name and position of the selected elements only selected in the Search page.
The user selects link of the display name of the specified element type for the search criteria
  • Oracle Self-Service E-Billing returns the user to the Manage tab displaying:
    • Top pane: Hierarchy context.
    • Bottom Left Pane: Tree view of current hierarchy tree opened to where the element selected is located in the tree in the bottom left pane.
    • Bottom Right Pane: Details tab containing the details for the selected element.
The user selects Sorting action

Oracle Self-Service E-Billing invokes Sorting use case.

The user selects Paging action

Oracle Self-Service E-Billing invokes Paging use case.

Exceptions for Searching a Hierarchy

Exceptions can occur in this use case.

The user encounters a validation error

Oracle Self-Service E-Billing invokes the validation error message use case.

The user encounters a server system error

Oracle Self-Service E-Billing invokes the error message use case.

Application Guide for Oracle Self-Service E-Billing (Business Edition) Copyright © 2011, Oracle and/or its affiliates. All rights reserved. Legal Notices.