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

Removing Hierarchy Elements


A user can use this use case to remove users, accounts, and services or to delete groups from a hierarchy. Table 71 lists and describes the use case functions.

Table 71. Removing Hierarchy Elements
Function
Description

Name

Removing Hierarchy Elements

Users

Business administrator user and manager user

Triggers

  • Manage tab: Element subtab
  • Manage tab: Details subtab

Report Content

Results Fields For Element Groups Element Subtab (Organization and Account Hierarchy Only):

  • Name (Display name of element type Groups)
  • Position (The name of the hierarchy node one level above)

Results Fields For Element Accounts Element Subtab (Account Hierarchy Only):

  • Account Number (Display name of element type Accounts)
  • Position (The name of the hierarchy node one level above)

Results Fields For Element Service Agreement Element Subtab (Organization Hierarchy Only):

  • Number (Display name of element type Services).
  • Position (The name of the hierarchy node one level above).

Results Fields For Element Users in Element Subtab (All Hierarchy types):

  • Name (Display name of element type User).
  • Position (The name of the hierarchy node one level above).

Exception Paths

  • 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.

Business Rules

  • The Remove action and the Delete action apply to elements in the current version of the hierarchy specified by the Hierarchy Period only.
  • Users assigned to removed groups are unassigned from group and will still appear elsewhere in the hierarchy.
  • Accounts that are unassigned from a removed group are moved to unassigned status but maintain any user settings.
  • Service Agreements that are unassigned from a removed group are moved to unassigned status but maintain any user settings.
  • Element Display Name links to Details subtab for the view. Position in hierarchy highlights the position in the graphical view of the hierarchy.
  • When elements are unassigned from the hierarchy, the fields Last Modified and Modified By are updated.
  • If user selects the checkbox in the row of the column headers of the search results, then all items of the search results become selected.
  • Results field for the search criteria specified is updated according to action performed.
  • The only option when Groups element is selected in the Hierarchy Search Criteria is Assigned. Groups are never unassigned.
  • If user selects the radio button for Entire Hierarchy, then the scope of the search is all the nodes in the hierarchy.
  • If user selects the radio button for From Current Position, then the scope of the search is relative to and limited by the nodes below the current position.

Main Path for Removing Hierarchy Elements

The following path describes the Removing Hierarchy Elements use case:

1 The user specifies a type of Element and Assigned status in the Hierarchy Search Criteria and clicks Submit.
  1. Oracle Self-Service E-Billing returns Element subtab displaying:
    • Top Pane: Hierarchy Search Criteria form with current search criteria context.
    • Bottom Left Pane: Tree View of the current hierarchy and position.
    • Bottom Right Pane: the Display Name and Position in hierarchy for the specified Element type.
  2. The user selects the checkboxes next to the items to be removed from the hierarchy and selects Remove action.
  3. Oracle Self-Service E-Billing displays the following confirmation message on the right pane:

    For all element types except Group: Performing this operation will remove the item(s) from this location in the hierarchy. The item(s) will become unassigned. Do you want to continue?

    For Group element: Performing this operation will permanently delete the group(s) and cannot be reversed. Items contained within the group will become unassigned. Do you want to continue?

  4. The user clicks Submit.
  5. Oracle Self-Service E-Billing redisplays the page displaying the following:
    • Top Pane: Hierarchy context.
    • Bottom Left Pane: Tree View of the current hierarchy with the elements removed from the hierarchy. After removal, the next element below is highlighted. If the element removed is the last one, then the highlight jumps up to the next element.
    • Bottom Right Pane: Updated list of elements with removed or deleted elements removed from the list in the Element subtab and Results field updated as elements are removed from the list.

Alternate Paths for Removing Hierarchy Elements

None

Exceptions for Removing Hierarchy Elements

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 © 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices.