Configuring the Service Order Management Dashboards

This section describes the process for configuring the Service Order Operational Dashboard and the Service Order Trends Dashboard.

Refer to the Using the Service Order Operational Dashboard and Using the Service Order Trends Dashboard sections of the Business User Guide for more information on this functionality.

Configuring the Service Order Operational Dashboard and Service Order Trends Dashboard includes the following:

Configure Activity Type

Configure the following payload statistics activity type:

  • Activity Statistics Aggregator Creator

Use the following procedure to create this activity type:

  1. Select Admin, then Communication, then Activity Type. The Activity Type portal and Activity Type List zone open.

  2. Click the Add/Edit icon for the "Activity Statistics Aggregator Creator" activity type in the Activity Type List zone.

  3. Specify the following:
    • Create Aggregators for Field Activity Statistics: Yes

    • Create Aggregators for Command Activity Statistics: Yes

    • Activity-Requesting Service Providers: The external system(s) that sends service requests

    • Exception Handling: To Do Type, To Do Role, and other values as appropriate for your implementation.

  4. Click Save.

See  Configuring Activity Types   for more information.

Configure Measuring Component Types

Configure the following measuring component types for each service type in your implementation: 

  • Activity Processing Accumulation Aggregator

  • Activity Aging Snapshot Aggregator

  • Activity Processing Snapshot Aggregator

  • Activity Processing Derived Snapshot Aggregator

The tables below provide details for these measuring component types based on the "Electric" service type from the demonstration database.

Sub-Aggregator Measuring Component Types:

Field

Activity Processing Snapshot Aggregator

Activity Processing Derived Snapshot Aggregator

Measuring Component Type

ACT_​PROC_​SNAP_​AGG

ACT_​PROC_​DER_​SNAP_​AGG

Description

Activity Processing Snapshot Aggregator

Activity Processing Derived Snapshot Aggregator

Measuring Component Type Business Object

Activity Statistics Sub-Aggregator Type

Activity Statistics Sub-Aggregator Type

Measuring Component Business Object

Activity Processing Snapshot Aggregator

Activity Derived Snapshot Aggregator

Measurement Business Object

Measurement

Measurement

Service Type

Electric

Electric

Interval Size

24:00:00

24:00:00

Fallback Time Zone

US Eastern Time

US Eastern Time

Consumptive/Subtractive

Consumptive

Consumptive

Activity Aggregator Type

Activity Processing Snapshot

Activity Processing Derived Snapshot

Aggregation

Aggregation Horizon: 7

Aggregation Lag: 2

Aggregation Cut-Off Time: 12:00:00

Aggregation Horizon: 7

Aggregation Lag: 1

Aggregation Cut-Off Time: 12:00:00

Value Identifiers

Value Identifier Type

Short Hand Description

Unit of Measure

Measurement

Created 

Count

Value 01

Completed

Count

Value 02

Error

Count

Value 03

Discarded

Count

Value Identifier Type

Short Hand Description

Unit of Measure

Measurement

Total

Count

Value 10

Discarded

Count

Value 01

Completed

Count

Value 02

Error Total

Count

Value 03

Error in Field

Count

Value 04

Error in Command

Count

Value 05

Error in Orchestrator

Count

Value 06

In Progress Total

Count

Value 07

In Progress in Field

Count

Value 08

In Progress in Command

Count

Value 09

In Progress in Orchestrator

Count

Sub-Aggregator Types

N/A

N/A

Display Configuration

Hours of Chart Data to Display: 480

Default Measurement Condition: Regular

Hours of Chart Data to Display: 480

Default Measurement Condition: Regular

Master Aggregator Measuring Component Types:

Field

Activity Processing Accumulation Aggregator

Activity Aging Snapshot Aggregator

Measuring Component Type

ACT_​PROC_​ACC_​AGG

ACT_​AGN_​SNAP_​AGG

Description

Activity Processing Accumulation Aggregator

Activity Aging Snapshot Aggregator

Measuring Component Type Business Object

Activity Statistics Master Aggregator Type

Activity Statistics Master Aggregator Type

Measuring Component Business Object

Activity Processing Accumulation Aggregator

Activity Aging Snapshot Aggregator

Measurement Business Object

Measurement

Measurement

Service Type

Electric

Electric

Interval Size

24:00:00

24:00:00

Fallback Time Zone

US Eastern Time

US Eastern Time

Consumptive/Subtractive

Consumptive

Consumptive

Activity Aggregator Type

Activity Processing

Activity Aging Snapshot

Aggregation

Aggregation Horizon: 5

Aggregation Lag: 2

Aggregation Cut-Off Time: 12:00:00

Aggregation Horizon: 5

Aggregation Lag: 2

Aggregation Cut-Off Time: 12:00:00

Value Identifiers

Value Identifier Type

Short Hand Description

Unit of Measure

Measurement

Activity Count

Count

Value 10

Discarded Count

Count

Value 01

Completed Count

Count

Value 02

Error Count

Count

Value 03

Error in Field

Count

Value 04

Error in Command

Count

Value 05

Error in Orchestrator

Count

Value 06

In Progress Count

Count

Value 07

In Progress in Field

Count

Value 08

In Progress in Command

Count

Value 09

In Progress in Orchestrator

Count

Value Identifier Type

Short Hand Description

Unit of Measure

Measurement

Average Completion Time

Count

Value 01

Completed Within Tolerance

Count

Value 02

12-19 Hours Late

Count

Value 03

20-27 Hours Late

Count

Value 04

28+ Hours Late

Count

Sub-Aggregator Types

Activity Aggregator Type

Measuring Component Type

Activity Processing Derived Snapshot

Activity Processing Derived Snapshot Aggregator

Activity Processing Snapshot

Activity Processing Snapshot Aggregator

N/A

Display Configuration

Hours of Chart Data to Display: 720

Default Measurement Condition: Regular

Hours of Chart Data to Display: 480

Default Measurement Condition: Regular

Create Activity Aggregator Measuring Components

Create an activity aggregator measuring component for each activity type you wish to capture for each measuring component type you created above. For example, if you wanted to capture statistics for request orchestration activity types (such as Enable Service, Disable Service, and so on) for the above measuring component types, you would create a total of 24 measuring components, as follows:

Measuring Component Type

Aggregation Dimensions — Activity Type

Aggregation Dimensions — Service Type

Activity Processing Accumulation Aggregator

Back to Back Orchestrator

Electric

Activity Aging Snapshot Aggregator

Back to Back Orchestrator

Electric

Activity Processing Snapshot Aggregator

Back to Back Orchestrator

Electric

Activity Processing Derived Snapshot Aggregator

Back to Back Orchestrator

Electric

Activity Processing Accumulation Aggregator

Cut for Non Payment Orchestrator

Electric

Activity Aging Snapshot Aggregator

Cut for Non Payment Orchestrator

Electric

Activity Processing Snapshot Aggregator

Cut for Non Payment Orchestrator

Electric

Activity Processing Derived Snapshot Aggregator

Cut for Non Payment Orchestrator

Electric

Activity Processing Accumulation Aggregator

Disable Service

Electric

Activity Aging Snapshot Aggregator

Disable Service

Electric

Activity Processing Snapshot Aggregator

Disable Service

Electric

Activity Processing Derived Snapshot Aggregator

Disable Service

Electric

Activity Processing Accumulation Aggregator

Enable Service

Electric

Activity Aging Snapshot Aggregator

Enable Service

Electric

Activity Processing Snapshot Aggregator

Enable Service

Electric

Activity Processing Derived Snapshot Aggregator

Enable Service

Electric

Activity Processing Accumulation Aggregator

Exchange Meter

Electric

Activity Aging Snapshot Aggregator

Exchange Meter

Electric

Activity Processing Snapshot Aggregator

Exchange Meter

Electric

Activity Processing Derived Snapshot Aggregator

Exchange Meter

Electric

Activity Processing Accumulation Aggregator

Reconnect Service for Payment Orchestrator

Electric

Activity Aging Snapshot Aggregator

Reconnect Service for Payment Orchestrator

Electric

Activity Processing Snapshot Aggregator

Reconnect Service for Payment Orchestrator

Electric

Activity Processing Derived Snapshot Aggregator

Reconnect Service for Payment Orchestrator

Electric

If you wanted to also capture statistics for smart meter commands or field task types, you would need to create activity aggregator measuring components for each individual command or field task type for each measuring component type.

If you are creating service order activities from multiple initiating systems (such as a customer information system and a network management system), you would need to create separate sets of activity aggregator measuring components for each initiating system.

Configure the Service Order Management Master Configuration

You can access the Master Configuration portal by selecting Admin, then General, then Master Configuration.

Select the Service Order Management Master Configuration. 

Use the Add button beside the record to configure for the first time. If a record has already been added, then click the Edit button instead. Use the embedded help to guide you through the meaning of each configuration field.

Create an Activity for each Measuring Component Type

Create an activity for each measuring component type created above. Based on the example above (from the demonstration database) you would create an activity for each of the following measuring component types for each service type:
  • Activity Processing Accumulation Aggregator

  • Activity Aging Snapshot Aggregator

  • Activity Processing Snapshot Aggregator

  • Activity Processing Derived Snapshot Aggregator

For example, if you configured measuring component types for both "Electric" and "Water" service types, you would create eight activities (two of each of the types listed above).

Use the following procedure to create these activities:

  1. Select Menu, then Communication, then Activity, then Add. The  Select Type  page opens.

  2. Select "Activity Statistics Aggregator Creator" from the Activity Type drop-down list and click OK. The Activity Statistics Aggregator Creator page opens.

  3. Select the appropriate measuring component type from the Aggregator Measuring Component Type drop-down list. 

  4. Select the appropriate service type ("E, "Water", and so on) from the Service Type drop-down list. 

  5. Click Save.

See Maintaining Activities  in the Business User Guide for more information about creating and maintaining activities.

Aggregation and Batch Processing

The Service Order Management dashboards are based on aggregated data, and are configured to be refreshed daily. To refresh the data used in the dashboard, the following aggregation and batch processes should be processed in sequence each day.

Dimension Scanning

  • D1-ADS (Aggregation Dimension Scanner Monitor): Used to transition "Activity Statistics Aggregator Creator" activities (created above) to the "Scan" state which checks for aggregator measuring components based on each measuring component type for each combination of dimensions. If needed, this process creates additional aggregator measuring components.

Use the following parameters when running this batch process:

  • Measuring Component Maintenance Object (maintenanceObject): D1-ACTIVITY

  • Restrict by Batch Code (isRestrictedByBatchCode): true

  • Restrict to Business Object (restrictToBusinessObject): D1-ActivityStatsAggtorCreator

  • Restrict by Status Code (restrictToBOStatus): ACTIVE

Note: Dimension scanning can also be performed manually by clicking Scan on the individual activities in the Activity portal.

Aggregation

  • D1-ACTAG (Activity Statistics Aggregation Monitor):  Used to aggregate activity data (via aggregator measuring components) to be displayed in the Service Order Management dashboards.

Use the following parameters when running this batch process:

  • Restrict by Batch Code (isRestrictedByBatchCode): true

  • Restrict to Business Object (restrictToBusinessObject): Aggregator Measuring Component business object, based on the measuring component types configured earlier:

    • D1-ActivityAgingSnapAggtor (Activity Aging Snapshot Aggregator)

    • D1-ActivityProcsAggregator (Activity Processing Accumulation Aggregator)

    • D1-ActivityProcDerivedSnapAgg (Activity Derived Snapshot Aggregator)

    • D1-ActivityProcSnapAggtor (Activity Processing Snapshot Aggregator)

  • Restrict by Status Code (restrictToBOStatus): ACTIVE

  • Override Maximum Errors (maxErrors): 1000

Note: Aggregation can also be performed manually by clicking Update Statistics on the Activity Statistics dashboard zone.