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 |
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.
Parent topic