Jump to: navigation, search

Report Metrics


Report Metrics Overview

New3.png With the correct role-based access control (RBAC) permissions, you can view and edit all Contact Center Advisor, Workforce Advisor, and Frontline Advisor metrics on the Report Metrics page. Only certain attributes are editable.

You can customize the out-of-box metrics that ship with Performance Management Advisors to address your specific Contact Center performance and service quality measurements. You can also use the Report Metrics page to create custom metrics for the dashboard.

You can search by metric name or description in all supported languages, regardless of the language you selected at login.

Any changes that you make using the Report Metrics page are logged in the audit log file, similar to all other logged administrative actions.

Custom Agent Group Metrics and the CCAdv Totals & Averages Row

Genesys does not provide an equivalent agent-level metric for a custom CCAdv agent group metric; therefore, de-duplication on the Totals & Averages line is not supported for custom agent group metrics.

Role Based Access Control and the Metric Manager

Security Settings in Configuration Manager for Metric Manager Users

The Report Metrics manager functionality is controlled by privileges and permissions (Role-Based Access Control). A privilege determines the actions a user can perform. A permission grants or denies viewing of individual metrics for a user. In the Report Metrics Manager, the view, create, copy, edit, and delete actions are individually controlled by privileges. For information about Metric Manager–specific privileges, see CCAdv/WA Access Privileges and FA Access Privileges.

Use the following information if you are granting or denying Metric Manager–related permissions and privileges to users:

  • A user can view all the metrics to which he or she has a "read" object permission.
  • A user who can create a custom metric can also view and delete that metric, unless View permission or the Change permission to the metric was explicitly denied in the Configuration Server after the user created the metric.
  • To create custom metrics, a user must have a Create security permission granted on the Advisors Metrics Business Attributes section in Configuration Manager. Without this permission, the user cannot create custom metrics. Similarly, a Change permission must be granted at the root attribute level or at the individual metric attribute value level to ensure the user can delete an existing custom metric. For an example of this configuration, see the Figure on the right.

Editing Out-Of-Box Metrics

You cannot delete Advisors’ out-of-box metrics, but you can edit some of the properties. The display name, description, and the reporting application–specific formatting properties can be edited. You can also edit the following properties of metrics that have them:

  • Time Range upper bound/lower bound (if applicable to the corresponding source metric)
  • Notification mode and frequency
  • Insensitivity
  • Exclude Base Object filter
  • Enabled

Creating Custom Metrics

You can create custom metrics using the Report Metrics page. Custom report metrics are created from Genesys Stat Server source metrics. The Report Metrics page is based on the Metric Manager of earlier releases, but, starting in release 8.5.0, includes additional functionality.

Important
You can create only custom application and agent group metrics for CCAdv, and custom agent metrics for FA. You cannot create custom metrics for any other types of objects. For example, you cannot create custom metrics for contact groups.

There are two some key selections you must make when you create a custom report metric:

  • Select an Advisors application
  • Select the object type

The Report Metrics page then shows the relevant custom metric configuration properties based on the Advisors application and object type you select.

You must provide an expression for the metric (that is, a formula that produces a metric value). Expressions can contain other metrics and constants (numbers) as operands, as well as the operators, functions, constructs, and symbols described in the following Table. Supported operands are included as buttons in the Expression Editor on the Report Metric Details page.

The elements of expressions are limited to existing standard or custom source metrics provided by the Genesys Adapter, source metrics imported from the CISCO environment, and existing CCAdv application, CCAdv agent group, and FA agent dashboard metrics.

Metric Type Acceptable Operands
Calculated custom report metrics Arithmetic operators:
  • + (addition)
  • – (subtraction)
  • * (multiplication)
  • / (division)

Brackets (to ensure the required operation sequence)

You can also include the >, < , and = operators in expressions.

Example: Expression Field Entries


The following examples demonstrate valid formulas you can enter into the Expression Field. If you have multiple operands in the expression, it is important to use parentheses to group the calculations.

  • Custom metric is a sum: Enter (<Metric1>+<Metric2>). For example, (CallsAnsweredTo5+RouterCallsAbandQTo5).
  • Custom metric is a percentage-based metric: Enter 100*(<Metric1>/<Metric2>). For example, 100*(RouterCallsQNow/STF). For this type of expression, you must start the expression with the 100* component followed by the metric calculation, as shown in the example.
  • Custom metric measures the longest value for an activity or state: Enter (DateTime - <AgentGroupMetric>). For example, (DateTime - RouterLongestCallQ)

Propagating custom metric changes to the Stat Server

If you create a new custom metric, or make changes to an existing metric that must be propagated to the Stat Server, these changes are applied during the overnight refresh. The dashboard shows values for any newly-added custom metrics only after the changes have been applied. This is applicable to both CCAdv/WA and FA metrics.

Enabling a disabled metric or disabling an enabled metric is applied to the Stat Server during the overnight refresh.

Metric Groups

Every raw custom report metric must be assigned to a Metric Group. This is not applicable to calculated report metrics; you do not assign them to metric groups.

A metric grouping indicates applicability of metrics to configured objects, which determines if metric statistic(s) must be requested for a certain object. See the Working with Metric Groups page for an example.

The default selection for a new metric is the Default metric group. When creating a custom metric, you can assign the metric to another available metric group. You also have the option to create a new metric group and assign the report metric to that new group.

After you create a metric group, it is available for selection for subsequent metric grouping. The metric group information for a report metric is not stored in the Genesys Configuration Server.

See the Working with Metric Groups page for more information about the metric groups and how to manage them.

Working With Metrics

The following Table provides descriptions of the metric properties.

Property Advisors Application Object Types Editable For Description
Short Name FA, CCAdv, WA FA: Agent

CCAdv: Agent Group or Application
WA: Contact Group

None The name of the metric that uniquely identifies it for internal purposes. This field is system generated. You can only view this property; you cannot edit it.
Language FA, CCAdv, WA FA: Agent

CCAdv: Agent Group or Application
WA: Contact Group

All A drop-down list that includes supported languages for your release. English is the default value. Your selection for this parameter controls the language property for the metric display name and description.
Display Name FA, CCAdv, WA FA: Agent

CCAdv: Agent Group or Application
WA: Contact Group

All The name used for display in the column chooser and dashboard. The name must be unique for a given channel. The display name property accepts 128 characters or less. The default language of the display name is English, but you can specify the name in another supported language using the Language parameter in the Metric Manager.
Description FA, CCAdv, WA FA: Agent

CCAdv: Agent Group or Application
WA: Contact Group

All The metric description. The default language of the description is English, but you can specify the description in another supported language using the Language parameter in the Metric Manager.
New3.png Advisor Application FA, CCAdv, WA FA: Agent

CCAdv: Agent Group or Application
WA: Contact Group

Custom Metric A drop-down list with values representing each supported reporting application. The default value is Contact Center Advisor. Your choice of reporting application is reflected in the values available for the Object Type parameter.
Object Type FA, CCAdv, WA FA: Agent

CCAdv: Agent Group or Application
WA: Contact Group

Custom Metric A drop-down list containing the options available for the Advisor Application you selected. For example, if you selected Contact Center Advisor as the Advisor Application, Application is one of the options in the Object Type list.
Calculation FA, CCAdv, WA FA: Agent

CCAdv: Agent Group or Application
WA: Contact Group

Custom Metric Formerly Metric Type. Select a radio button to indicate if the custom metric is Raw or Calculated.
Summary Type FA, CCAdv, WA FA: Agent

CCAdv: Agent Group or Application
WA: Contact Group

Custom Metric A drop-down list containing options that determine how aggregation is to be performed when rolling up the metric to the higher level of the hierarchy:
  • When the metric type is Raw, the options are:
    • SUM
    • MIN
    • MAX
  • When the metric type is Calculated, Summary Type is not applicable (None).
New3.png Metric Group FA, CCAdv, WA FA: Agent

CCAdv: Agent Group or Application
WA: Contact Group

Custom Metric For a custom metric, a drop-down list with values for all available metric groups. There is one available value “out-of-box” – Default. To create your own metric group, click Create New Metric Group. On confirmation, the new metric group name is appended to the list of metric groups, and is automatically selected in the drop-down. The new metric group value is saved as part of the custom metric creation process, and is subsequently available for selection for other metrics.

The metric group name is case-sensitive. A metric group labelled MG is a different metric group from one labelled mg.

Enabled FA, CCAdv, WA FA: Agent

CCAdv: Agent Group or Application
WA: Contact Group

All Formerly Display on Column Chooser. Select a radio button to specify whether the metric displays in the Column Chooser (Enable) or not (Disable).

Disabling a raw report metric means that the corresponding source metrics are not collected at the data source for the respective reporting application. In the case of Genesys Stat Server, you can reduce the load on the Stat Server by disabling unused metrics for a reporting application.
However, note that each raw report metric is evaluated in two cases:

  1. when directly enabled
  2. when indirectly enabled by its participation in the calculation of another enabled metric

Therefore, to completely disable a raw report metric so it is not collected at the data source, you must both disable the metric and ensure it is not used in the calculation of another metric that is enabled.
You can re-enable any disabled metric by updating the Enabled checkbox.
Disabling or enabling raw report metrics takes effect on overnight refresh or on restart.
Disabling a metric for Contact Center Advisor means that CCAdv does not calculate the metric or send values for it to the dashboard. The effect of disabling takes place at the start of the next Short processing cycle in CCAdv XML Generator.

Channel FA, CCAdv, WA FA: Agent

CCAdv: Agent Group or Application
WA: Contact Group

Custom Metric A drop-down list containing options to specify the media channel type for which the custom metric is shown in the Column Chooser and on the dashboard.
Decimal FA, CCAdv, WA FA: Agent

CCAdv: Agent Group or Application
WA: Contact Group

All A drop-down list containing options you can use to specify the number of decimal places to display for metric values.
Initial Sequence Number FA, CCAdv, WA FA: Agent

CCAdv: Agent Group or Application
WA: Contact Group

All Formerly Sequence Number. Use this parameter to specify the initial column order sequence in which to place the metrics on the dashboard. Clicking Reset in the dashboard's Column Chooser displays the metrics with a sequence number, in the order specified by the number.
New3.png Reorder Columns FA Agent Custom metric By default, the checkbox is cleared. Select the check box to allow users to re-order the column positions on the dashboard.
Threshold Applicable CCAdv, WA CCAdv: Application

WA: Contact Group

All Formerly Threshold. When creating a custom metric, the checkbox is cleared by default.

If this box is checked, you can define thresholds for the metric on the Application Groups/Thresholds page. If this box is cleared, then you will not be able to define thresholds on that page.

Threshold/Chart CCAdv, WA CCAdv: Application

WA: Contact Group

All Enter values for the threshold range (minimum and maximum). These values also determine the y-axis values in a graph.
Display over 100% CCAdv, WA CCAdv: Application

WA: Contact Group

All A format option. When creating a custom metric, the checkbox is selected by default.

A checkmark in the box indicates that values over 100 display actual values. If the checkbox is cleared, values over 100 display as 100+.

New3.png Format Pattern FA Agent All A drop-down list containing options to specify the general structure of the metric. The default selection is Number.
Time Profile FA, CCAdv, WA FA: Agent

CCAdv: Agent Group or Application
WA: Contact Group

All, but with qualifications:
  • CCAdv/WA: Fully editable for custom metrics. For out-of-box metrics, you can enable or disable charting only.
  • FA: You can enable or disable the time profile only.
Select a radio button to indicate if the time profile is Point in Time or Historical. Point in Time on the Metric Details page is the same as Now elsewhere in the products: it is the Current time profile with a duration of 0.

New3.png Starting in release 8.5.001, you can assign a time profile group (Short, Medium, or Long) to a point-in-time custom report metric for an application or agent group in the Time Profile section. The time profile interval and time profile type are not shown for the point-in-time metric. XML Generator creates alerts only for metrics that are mapped to the Short time profile group.

If you select the Historical time profile, available additional options are dependent on the Advisors component with which the metric is associated:

  • CCAdv:
    When you select the Historical radio button, you can configure up to three time profiles in the Time Profile table. You must specify at least one. Use the Enabled checkbox to enable and disable CCAdv metrics by time profile. The allowed time interval for an enabled profile is from 1 minute to 24 hours. The default time intervals are:
    • 5 minutes for a Short group
    • 30 minutes for a Medium group
    • 24 hours for a Long group
    Metrics that are used in formulas for calculated metrics must have time profiles that are compatible with the calculated metric. For each enabled time profile, you must also indicate the time profile type (Sliding or Growing). The default type for each time profile group is:
    • Sliding for a Short group
    • Growing for a Medium group
    • Growing for a Long group
    The Chart checkbox is available for CCAdv application-type metrics. The checkbox is cleared, by default.
  • WA:
    The Chart checkbox is available for WA contact group–type metrics. The checkbox is cleared, by default.
  • New3.png FA:
    Starting in Advisors 8.5.001, you can enable and disable metrics for FA by time profile in the Time Profile table; you can specify which metrics are enabled for a given time profile and disable metrics that are not required for that time profile.

    The time profile durations displayed in the Time Profile table are those that are configured in the FA administration page. You cannot edit the time profiles in the Report Metrics manager; you continue to configure and edit the FA time profiles in the FA administration page.

    To enable a time profile for a specific metric, both of the following conditions must be true:
    • the time profile is enabled at the application level (that is, on the Settings tab of the FA administration page)
    • the time profile is enabled for that metric in the Report Metrics manager

    To disable a time profile, you need to disable the time profile in only one of the preceding locations.

    The results of enabling a time profile for a particular metric are the following:

    • The metric is available in the column chooser and dashboard for display for its enabled time profiles.
    • The aggregation engine calculates the metric for the enabled time profiles.
      Important
      You can enable or disable time profiles for calculated metrics irrespective of their associated operand-level metrics. The disabled time profile for the operand-level metric impacts only the visibility of that metric on the dashboard.

    FA time profile durations cannot be configured on a per-metric basis, therefore, calculated metrics are limited to the time profiles configured in the FA administration page.

    Default settings are:

    • all of the time profiles for the out-of-box metrics are enabled in the Report Metrics manager
    • only the first time profile in the Settings tab of the FA administration page is enabled (consistent with previous releases).

    Changes to time profile settings in the FA administration page are automatically updated in the Report Metrics manager. However, enabling or disabling time profiles for FA metrics in the Report Metrics manager require you to reload the FA hierarchy before the changes are propagated to the FA application; you can reload the hierarchy manually, or wait for the overnight refresh.

Expression Editor

Use the Expression Editor to build the formula that produces a value for your custom metric.

Property Description
Channel and Metric tables Use the Channel and Metric tables to find existing metric expressions that you can use in the calculation of your new custom metric. The entries from the list of metrics serve as operands for building the expression. When creating a raw report metric, the operands available are source metrics. And when creating a calculated report metric, the operands available are other raw report metrics and other calculated report metrics.
Metric Description When you select a metric in the Metric table, a description of that metric displays in the Metric Description box.
Expression Field You build the expression, or formula, for your custom metric in the Expression Field. Use the buttons above the field to add operands to the expression of a calculated metric.

You might see two expression fields for some agent group metrics. This happens when the calculation for individual agent groups is different from the totals and averages calculation. If you are creating a custom agent group metric, you can specify only one calculation expression to be applied in both individual agent groups and totals and averages calculations.

You might see two expression fields for some agent group metrics. This happens when the calculation for individual agent groups is different from the totals and averages calculation. If you are creating a custom agent group metric, you can specify only one calculation expression to be applied in both individual agent groups and totals and averages calculations.

New3.png Notification Mode Available for raw metrics and only when the selected source metric belongs to a Genesys Stat Server data source. See the Stat Server User Guide for more information.

Select a value from the drop-down list. The default value is Time Based. This means that Stat Server will notify the adapter periodically based on the notification frequency. Changed Based means that the Stat Server will notify the adapter as soon as the values change in Stat Server.

New3.png Notification Frequency Available for raw metrics and only when the selected source metric belongs to a Genesys Stat Server data source. See the Stat Server User Guide for more information.

Specify a non-negative integer. The default value is 0. This field is enabled only when the notification mode is Time Based.

New3.png Insensitivity Available for raw metrics and only when the selected source metric belongs to a Genesys Stat Server data source. See the Stat Server User Guide for more information.

Specify a non-negative integer. The default value is 0, which indicates that insensitivity is not applied.

New3.png Exclude Base Object Filter Available for raw metrics and only when the selected source metric belongs to a Genesys Stat Server data source. Exclude base object filter is a property of the statistic template. See the Stat Server User Guide for more information.

The checkbox is available for Contact Center Advisor application and agent group metrics. Select the checkbox to exclude the base object configuration filter when statistics are requested for the metric. The checkbox is cleared, by default.

[+] Additional information about Exclude Base Object Filter
Time Range Lower Bound and Time Range Upper Bound The Time Range Lower Bound and Time Range Upper Bound fields are enabled for raw metrics, and only when the selected source metric is based on a category that requires a time range. For example, TotalNumberInTimeRange.

Available for CCAdv raw report metrics only.
Specify a non-negative integer. The upper bound must be greater than the lower bound. The default value is 0.

View Information about a Metric


Prerequisites

  • You require the privilege that grants you access to the Administration module and the privilege that grants you access to the Metric Manager to perform this procedure.
  • You require permission to view at least one metric.
    The Report Metrics page displays only the metrics to which you have Read permission in the Configuration Server.


Start Procedure

  1. In the Administration module, click Report Metrics in the navigation pane.
  2. Locate the metric for which you want to view detailed information.
    To assist you when searching for a specific metric, use the filters on the right side of the page to reduce the number of metrics that display. By default, all filters are selected.
    Use the page navigation arrows under the list of metrics to move between pages of metrics. By default, the metrics are displayed in alphabetical order.
  3. Click a metric to select it.
    Details about the metric display at the bottom of the Report Metrics page.
Create a Custom Metric


Prerequisites

  • You require the privilege that grants you access to the Administration module and the privilege that grants you access to the Metric Manager to perform this procedure.
  • You require the Create permission in the Configuration Server for the Advisors Metrics Business Attribute on the default tenant.
  • You require the privilege that grants you access to the Create button.


Start Procedure

  1. In the Administration module, click Report Metrics in the navigation pane.
  2. Click New.
    The Metric Details page opens.
  3. Enter information to define the new metric. Ensure you enter information into all required fields.
    For descriptions of the metric properties, see the Metric Properties Descriptions tab on this page.
  4. If you want to return the Metric Details page to the default settings, click Reset.
  5. Click Save to save the metric.
    If you entered all information correctly, the page returns to the Report Metrics page. The new metric displays in the list of metrics.
Copy a Metric to Create a Custom Metric


Prerequisites

  • You require the privilege that grants you access to the Administration module and the privilege that grants you access to the Metric Manager to perform this procedure.
  • You require the Create permission in the Configuration Server for the Advisors Metrics Business Attribute on the default tenant.
  • You require permission to view the metric that you want to copy.
  • You require the privilege that grants you access to the Save as option.


Start Procedure

  1. In the Administration module, click Report Metrics in the navigation pane.
  2. Select the custom or standard metric that you want to use as a template for a new custom metric.
    You can use application or agent group metrics as templates for new CCAdv custom metrics, and agent-level metrics for new FA custom metrics.
    If you select a standard dashboard metric as a template for a new custom metric, the expression of the original standard metric might not be supported in the new custom metric. You must edit the calculation to limit operands to those supported by the custom dashboard metric creation process.
  3. Click the Save as... option.
    The Metric Details page opens.
  4. Edit information to define the new metric. Ensure you enter a new display name for the new custom metric. Ensure you enter information into all required fields.
    For descriptions of the metric properties, see the Metric Properties Descriptions tab on this page.
  5. Click Save to save the metric.
    If you entered all information correctly, the page returns to the Report Metrics page. The new metric displays in the list of metrics.
Edit a Metric


You cannot edit the short name for a metric (this includes custom metrics).


Prerequisites

  • You require the privilege that grants you access to the Administration module and the privilege that grants you access to the Metric Manager to perform this procedure.
  • You require permission to view the metric that you want to edit.
  • You require the privilege that grants you access to the Edit option.
Important
You require the AdvisorsAdministration.MMW.canEdit privilege to edit metrics, but a Change permission is not required in the Configuration Server for the metric business attribute value because none of the edited information is updated on the Configuration Server after the initial creation of the business attribute value.


Start Procedure

  1. In the Administration Module, click Report Metrics in the navigation pane.
  2. Select an existing metric to edit.
  3. Click Edit.
    The Metric Details page opens.
  4. Edit the metric properties.
    The metric properties you can edit are dependent on the type of metric you selected to edit. Your ability to edit standard (out-of-the-box) metrics is limited. For example, the expression editor is always disabled for standard metrics. If you want to edit a standard metric, you must copy the metric and save it as a new custom metric.
    If you change the display name or description of a metric, the information is updated in Advisors only and is not propagated to the Configuration Server.
  5. Click Save to save the metric.
    If you entered all information correctly, the page returns to the Report Metrics page. The metric displays in the list of metrics.
Delete a Custom Metric


Prerequisites

  • You require the privilege that grants you access to the Administration module and the privilege that grants you access to the Metric Manager to perform this procedure.
  • You require permission to view the metric that you want to delete.
  • You require a Change permission in the Configuration Server for the business attribute that represents the metric that you are deleting.
  • You require the privilege that grants you access to the Delete option.
Important
Deleting a custom metric deletes the record in Advisors and also deletes the business attribute value under the Advisors Metrics Business Attributes section in the Configuration Server.


Start Procedure

  1. In the Administration module, click Report Metrics in the navigation pane.
  2. Select a custom metric to delete.
  3. Click Delete.
    If a raw report metric is used in a calculation for a calculated report metric, you cannot delete that raw report metric. If you attempt to delete a metric that is used in another metric calculation, Advisors displays an error message.

Enable Graphing of Metrics

The Metric Graphing window is accessible from both Contact Center Advisor and Workforce Advisor. You specify which combination of metrics and time profiles to graph using the Chart checkboxes in the Time Profile table.

You can choose to graph Application-type metrics in CCAdv, and Contact Group-type metrics in WA.

Use the Edit option associated with the metric on the Report Metrics page, or the Create button, to open the Metric Details page. On the Metric Details page, navigate to the Time Profile.

To enable a metric and time profile for graphing, choose the time profile and select the Chart checkbox beside it. Each metric that can be graphed can have more than one time profile for graphing. For example, you can enable both AHT 30 Min Growing and 5 Min Sliding for graphing.

The number of metric/time profile combinations that can be graphed is controlled by the configurable property max.metrics.graphing.enabled in the CONFIG_PARAMETER database table in the Contact Center Advisor database. While this property can theoretically be set to any value, Genesys recommends you configure the limit to be 5 or less for performance reasons.

Note this parameter is shared by all Advisors modules, including CCAdv and WA. The parameter governs the total number of graphable combinations in both CCAdv and WA. Each metric/time profile combination is counted as 1. For example, if you select AHT 30 Min Growing and AHT 5 Min Sliding, that is counted as 2 graph-enabled metrics.

If you attempt to enable more metrics for graphing than the limit configured in the database, a warning message displays stating that the maximum number of metrics that can be graphed has been exceeded. You cannot save updates in the Metric Manager until you reduce the number of metrics enabled for graphing.

Enable Metrics for Graphing


Start Procedure

  1. Open the Administration module.
  2. Click Report Metrics in the navigation pane.
  3. Use the filters on the Report Metrics page (on the right) to show as many or as few metrics as required.
  4. Do one of the following:
    • Select an Application-type metric or a Contact Group-type metric and click Edit in the Actions column to open the Metric Details page.
    • Click Create to open the Metric Details page and create a new Application-type custom metric.
  5. On the Metric Details page, select the applicable time profile.
    The Time Profile radio buttons are grayed out (that is, you cannot change the time profile) for out-of-box metrics.
  6. To enable the metric for graphing, select at least one time profile from the Time Profile table, and select the Chart checkbox.
    The Time Profile table offers only one time profile type (Current) if the Point in Time radio button is selected, and three possible time profile options if the Historical radio button is selected.

Propagate Changes to Column Choosers

A change you make in the Report Metrics page does not appear immediately in the Column Choosers in the dashboards. This applies to any kind of change, whether to an out-of-box metric, or to a custom metric, including creation or deletion of the latter.

Propagate Changes to Column Choosers in CCAdv and WA


Start Procedure

  1. Save or apply the change on the Report Metrics page.
  2. Log out of Advisors.
  3. Wait at least five minutes for the changes to be read from the Advisors database into cached data.
  4. Log in to Advisors.
  5. In the appropriate dashboard, open the Column Chooser.
  6. You should see your changes reflected there.


Propagate Changes to Column Choosers in FA


Start Procedure

  1. Save or apply the change on the Report Metrics page.
  2. In the FA Administration page Settings tab, click the Hierarchy Reload button. Alternatively, wait until the nightly reset procedure has executed.
  3. Note that new report metrics will not be displayed in the accessible dashboard until the application server is restarted.

Custom metrics for Advisors have a standard, auto-generated CM__metric id internal name. You might have several Advisors installations that use the same Genesys Configuration Server, and if an administrator creates a custom report metric in each of two different installations, but uses the same metric ID (and, therefore, the same name), one metric overwrites the other in the Configuration Server. Overlapping metrics loaded into the Configuration Server impact permission settings for different installations. These metrics can also be deleted with a negative impact on other installations.

To resolve these types of issues, release 8.5.001 includes a parameter, custom.metric.name.prefix, that governs the custom metric naming space within the installation. The parameter is in the Config_Parameter table of the Advisors Platform database. The following screenshot shows the parameter.

The custom.metric.name.prefix parameter in the Config_Parameter table of the Platform database. A value of "null" means the Metric Manager will use the default prefix (CM) for the internal name of new custom report metrics.

The value you enter for this parameter becomes the prefix for custom report metric names and replaces the standard CM prefix in the internal system name. This lets you differentiate and isolate the metrics created in different installations and therefore avoid any conflicts at the Configuration Server level.

When you change the value for the custom.metric.name.prefix parameter, it immediately triggers the replacement of all custom metric names with a name that uses the specified prefix. The names of custom metrics used as operands in calculation expressions are also replaced.

You must run the Advisors Object Migration Wizard to import the metrics for which you specified a new prefix into the Configuration Server. Users of the Advisors interface who were logged in when you configured the prefix must log out and log in again to gain access to the metrics with the new names. All new custom metrics are created with the new prefix.

The Advisors administrator must ensure the prefixes are unique within the existing set of Advisors installations. There is no restriction on the number of metric prefix changes, but Genesys recommends that you carefully manage the number of obsolete metrics in Configuration Server and that you remove metrics that no longer exist in any Advisors installation.

Feedback

Comment on this article:

blog comments powered by Disqus
This page was last modified on May 19, 2014, at 08:20.