Duplicating a Counter

Navigation:  Managing the Account > Business Analytics > Counters >

Duplicating a Counter

Previous pageReturn to chapter overviewNext page

 

Overview

 

A Counter can be copied. Operationally speaking, it is another method to create a new counter with all the settings filled in.

This action can be performed in the "Counter Management" page and in the "Counter Details" page.

When duplicating a counter, the aggregated data is not copied.

 

 

To Duplicate a Counter in the "Counter Management" Page

 

Step-by-step

 

1. Click Business Analytics Button, in the "Control Panel" section, and, in the resulting row, select Counters Sub Module Button to open the "Counter Management" page.

 

Counter Management_Page_List View

 

TIPTo ensure the viewing of all counters, select "<All>" in the "Status" drop-down.

 

 

2. Select the counter to duplicate by checking the corresponding Check box.

 

Counter Duplicate1

 

3. Click Duplicate Header Button. The duplicate's details page opens in edit mode.

 

Counter Duplicate_Properties_Page

 

The name and alias of this copy is the same as the copied counter plus "_copy".

 

4. Edit the fields according to your requirements (fields marked with an asterisk must always contain information):

 

Name *

Edit the counter's name.

 

TIPDefine a name related to the metrics you are aggregating to make it easy to identify the counter.

 

Alias *

Enter the counter's alias. Match this alias to the corresponding counter alias defined in the MCL application during development (in MCL-Designer).

Refer to the MCL-Designer User Guide for more detailed information.

The alias can ONLY contain alphanumeric/underscore characters ( = no spaces).

Description

If required, enter information on the new counter.

Aggregate by Period

Resolution max

The time frame that works as a filter for the metrics you want the counter to aggregate.

Maintain or select another time frame from the drop-down.

Aggregate by Key

The metric data that is collected/sent by the MCL application can be further aggregated according to a counter’s primary and/or a secondary key. These keys can be used by a dashboard’s widgets to filter the displayed counter data. For instance, in a Data Table widget that uses a counter as a data source, if that counter has a defined primary and/or a secondary key, you can assign a specific value to the key so that the information displayed by that Data Table is filtered accordingly.

 

NoteThe counter profile defined for the MCL application during development with MCL-Designer, can contain keys (they are defined with the "Metric/Post Message Background" process as "Key 1" and "Key 2"). If so, you MUST match the name of those keys with the keys you define here. Refer to the MCL-Designer User Guide for more detailed.

Primary Key

If required, enter a primary key for the counter to aggregate the received data in the corresponding box.

Secondary Key

If required, enter a secondary key for the counter to aggregate the received data in the corresponding box.

It is NOT necessary to have a primary key to define a secondary key UNLESS the MCL application has a defined primary key.

 

5. If required, go to the "Metrics" tab. If you are done with the editing, proceed to step 7.

 

Counter Duplicate_Metrics_Page

 

6. Fill in the editable fields (fields marked with an asterisk are mandatory):

 

Selection Box

There is a selection box for each metric entry. If required, check the box to select the corresponding entry.

To select all the metrics, at once, check the box in the title row.

Unchecking it, deselects all the currently checked metrics, at once.

You can bulk copy or delete metric entries by checking the selection box in the title row - this activates the Bulk Copy_Button_Conf Value (Duplicate) or Bulk Delete_Button_Conf Value (Delete) options.

 

Clicking Bulk Copy_Button_Conf Value to duplicate a metric entry creates a new entry with the same name as the original metric plus "copy>incremented number>". It also has the same alias and description.

 

TIPWe recommend renaming the duplicate.

Make sure the metric's alias matches one of the selected counter's metrics defined for the corresponding counter in the MCL application during development (in MCL-Designer). Refer to the MCL-Designer User Guide for more detailed information.

 

If you use Bulk Delete_Button_Conf Value to bulk delete, confirm the operation by clicking the "Delete" option in the resulting message Counters_Delete Metrics Confirmation.

Ref.

NOT editable. The internal reference for each metric is attributed automatically by the system.

Name *

Maintain or edit the name of the metric.

Alias

Maintain or edit the alias for the metric. The system suggests an alias based on the defined metric name.

 

NoteThis alias MUST match one of the selected counter's metric aliases defined for the corresponding counter in the MCL application during development (in MCL-Designer). Refer to the MCL-Designer User Guide for more detailed information.

Description

Maintain or edit the description of the metric you defined.

Actions

These "Actions" buttons are only visible/available if the page is set to "edit" mode.

 

Duplicate Sign This button duplicates the corresponding metric. The duplicate will have the same name plus "_copy<incremented number>".

 

Delete Sign This button deletes the corresponding metric. Click it and confirm the operation by clicking the resulting Pop_up window_Confirmation Delete button .

 

7. Once you have edited the required fields, click Save Header Button to apply the modifications or Cancel Header Button_New to abort.

 

 

To Duplicate a Counter in its "Counter Details" Page

 

Step-by-step

 

1. Click Business Analytics Button, in the "Control Panel" section, and, in the resulting row, select Counters Sub Module Button to open the "Counter Management" page.

 

Counter Management_Page_List View

 

TIPTo ensure the viewing of all the counters, select "<All>" in the "Status" drop-down.

 

 

2. Select the counter you want to duplicate by clicking its name (displayed in light blue). This opens the corresponding "Counter Details" page.

 

Counter Details_Page

 

3. Click Duplicate Header Button. The page is set to edit mode.

 

Counter Duplicate_Properties_Page

 

The name and alias of this copy is the same as the copied counter plus "_copy".

 

4. Edit the fields according to your requirements (fields marked with an asterisk must always contain information):

 

Name *

Edit the counter's name.

 

TIPDefine a name related to the metrics you are aggregating to make it easy to identify the counter.

 

Alias *

Enter the counter's alias. Match this alias to the corresponding counter alias defined in the MCL application during development (in MCL-Designer).

Refer to the MCL-Designer User Guide for more detailed information.

The alias can ONLY contain alphanumeric/underscore characters ( = no spaces).

Description

If required, enter information on the new counter.

Aggregate by Period

If required, you can define a specific time frame to work as a filter for the metrics you want the counter to aggregate.

Resolution max

Maintain or edit the time frames available in the drop-down.

Aggregate by Key

The metric data that is collected/sent by the MCL application can be further aggregated according to a counter’s primary and/or a secondary key. These keys can be used by a dashboard’s widgets to filter the displayed counter data. For instance, in a Data Table widget that uses a counter as a data source, if that counter has a defined primary and/or a secondary key, you can assign a specific value to the key so that the information displayed by that Data Table is filtered accordingly.

 

NoteThe counter profile defined for the MCL application during development with MCL-Designer, can contain keys (they are defined with the "Metric/Post Message Background" process as "Key 1" and "Key 2"). If so, you MUST match the name of those keys with the keys you define here. Refer to the MCL-Designer User Guide for more detailed.

Primary Key

If required, enter a primary key for the counter to aggregate the received data in the corresponding box.

Secondary Key

If required, enter a secondary key for the counter to aggregate the received data in the corresponding box.

It is NOT necessary to have a primary key to define a secondary key UNLESS the MCL application has a defined primary key.

 

5. If required, go to the "Metrics" tab. If you are done with the editing, proceed to step 7.

 

Counter Duplicate_Metrics_Page

 

6. Fill in the editable fields (fields marked with an asterisk are mandatory):

 

Selection Box

There is a selection box for each metric entry. If required, check the box to select the corresponding entry.

To select all the metrics, at once, check the box in the title row.

Unchecking it, deselects all the currently checked metrics, at once.

You can bulk copy or delete metric entries by checking the selection box in the title row - this activates the Bulk Copy_Button_Conf Value (Duplicate) or Bulk Delete_Button_Conf Value (Delete) options.

 

Clicking Bulk Copy_Button_Conf Value to duplicate a metric entry creates a new entry with the same name as the original metric plus "copy>incremented number>". It also has the same alias and description.

 

TIPWe recommend renaming the duplicate.

Make sure the metric's alias matches one of the selected counter's metrics defined for the corresponding counter in the MCL application during development (in MCL-Designer). Refer to the MCL-Designer User Guide for more detailed information.

 

If you use Bulk Delete_Button_Conf Value to bulk delete, confirm the operation by clicking the "Delete" option in the resulting message Counters_Delete Metrics Confirmation.

Ref.

NOT editable. The internal reference for each metric is attributed automatically by the system.

Name *

Maintain or edit the name of the metric.

Alias

Maintain or edit the alias for the metric. The system suggests an alias based on the defined metric name.

 

NoteThis alias MUST match one of the selected counter's metric aliases defined for the corresponding counter in the MCL application during development (in MCL-Designer). Refer to the MCL-Designer User Guide for more detailed information.

Description

Maintain or edit the description of the metric you defined.

Actions

These "Actions" buttons are only visible/available if the page is set to "edit" mode.

 

Duplicate Sign This button duplicates the corresponding metric. The duplicate will have the same name plus "_copy<incremented number>".

 

Delete Sign This button deletes the corresponding metric. Click it and confirm the operation by clicking the resulting Pop_up window_Confirmation Delete button .

 

7. Once you have edited the required fields, click Save Header Button to apply the modifications or Cancel Header Button_New to abort.