Workflows to Disconnect a Service Item

This group of workflows allows a user to disconnect a service. It consists of the workflow process and nested subprocesses:

SIS OM Disconnect Products & Services Process

SIS OM Active Quote Subprocess

SIS OM Active Order Subprocess

SIS OM Disconnect Asset Subprocess

SIS OM Disconnect Products & Services Process

This workflow identifies an active document (quote or order) for the current account. Then it generates a line item to disconnect the selected asset and displays the document detail view. This workflow is shown in Figure 24.

A user initiates this workflow by clicking the Disconnect button in the following views:

Accounts > Service Items view

Accounts > Billing Items view,

Accounts > Customer Portal view

Networks > Nodes view

Networks > Connections view

Networks > All Elements view

Figure 24. SIS OM Disconnect Products & Services Process Workflow

Workflow Description. This workflow does the following:

Gets the details of the current account.

Retrieves the active document (quote or order) for the session.

If the account is of type 'Residential', the active order is retrieved. Otherwise, the active quote is retrieved. See SIS OM Active Quote Sub-process and SIS OM Active Order Sub-process.

Allows the user to disconnect the asset.

The workflow gets the asset's current state and then creates quote line items to disconnect the asset in that state. See 'SIS OM Disconnect Asset Sub-process'.

NOTE: When deleting a network node, the process will automatically delete all associated network connections. If this is not desirable behavior, change the value of the "Delete Connection" argument to 'N'

Displays active document.

Associated Business Service Methods. The following table shows the steps in this workflow that call business service methods.

Workflow Step

Business Service Method Called

Disconnect Selections

Iterate Process For Selected Rows

Go to Document Details View

GotoView

SIS OM Disconnect Asset Sub-process

This workflow applies the open and pending orders related to the selected asset to get its requested state. Then it creates quote line items to disconnect the selected asset in that state. It adds these line items to the active quote. This workflow is shown in Figure 25.

The workflow includes only components that do not have a status of Inactive. The workflow looks for all the orders with a status of Open or Pending that are related to the selected asset. The workflow applies the changes specified by those orders. This re-creates the state of the service product as the user has requested it.

Removes any components from the asset that do not have the 'Track As Asset' flag set.

Displays an error message if the asset is empty.

If one of the open or pending orders disconnects the root component, or there are no components that have the 'Track As Asset' flag set, the result is an empty asset. In this case, the workflow displays an error message.

Retrieves the active document. The workflow generates the delta of the requested state of the asset and the future empty state of the asset. This creates line items to disconnect the asset. The workflow adds these line items to the active document.

Sets the due date for the line items.

Generates a new asset integration ID for any line item with an action code of Add.

Saves the document to the database.

Associated Business Service Methods. The following table shows the steps in this workflow that call business service methods.