Create a Closed User Group Normalizer

This normalizer determines if the subscriber making a call and the subscriber receiving a call are in the same group or on the same network.

Before you begin

My MATRIXX must contain the normalizer template that you want to use for this normalizer that implements the Closed User Group normalization algorithm.

If you are creating a normalizer that checks whether subscribers are in the same group or group tier, there must be a field definition for the subscriber group object that holds the tier value. For information about adding field definitions, see the discussion about field definitions.

Procedure

  1. In Normalizers, click New Normalizer.
  2. In Create New Normalizer:
    1. In Name, enter a unique name.
    2. (Optional) In Description, enter descriptive information about the item.
    3. (Optional) In External ID, enter any alphanumeric character to serve as a unique ID on this pricing object. The external ID can be used for any reason that is meaningful to your implementation of MATRIXX Engine. External IDs are saved to the pricing configuration file and loaded into the Pricing database.
    4. From the Normalizer Template list, select the name of the normalizer template that implements the normalization algorithm you want to use for this normalizer.
    5. Click Create.
  3. In Start Date/Time, use the date picker to select the date on which the object becomes active in the Pricing database and is first available for use, or enter the date in the format YYYY-MM-DD. Optionally, enter a time for when the object becomes active. The default start date/time is 2000–01–01 00:00:00. If applicable, the range in which the start date/time must fall is listed. For example:
    • Select a date on or before 2021–12–01.
    • Select a date on or after 2020–01–27.
    • Select a date between 2000–01–02 and 2021–10–04.
    Note: If you are creating a new revision of this object, the start date/time must be after the start date/time of the preceding revision and before the start date/time of the next revision. If you are making a copy of this object, the start date/time is not copied. The new object is the first revision, so it has the default start date/time of 2000–01–01 00:00:00.
  4. If no default parameter values have been defined for the normalizer, click or hover over the Rows menu icon and select Edit Values to add two values, one to use for a match and one to use for a non-match. These values can either be added as a normalizer value list (step 5) or entered manually (step 6).
  5. To define the values using a normalizer value list, perform the following steps:
    Important: The list must contain two values (No Match and Match). The No Match value must have an ID of 0 and the Match value must have an ID of 1.
    1. If the normalizer already has values defined, click Create a Normalizer Value List to save the list of manually created values as a normalizer value list. Enter a unique name and click Create. The new normalizer value list is added to the Normalizer Value List drop-down menu and can be selected for this and other normalizers.
      Important: Any existing values in the normalizer that are not saved as part of creating a normalizer value list are deleted after you click Save.
    2. Check Use Normalizer Value List to enable the menu. This disables the option to add a value manually by clicking New Value. Any existing values assigned to the normalizer are removed.
    3. Select a normalizer value list from the drop-down menu. Values from the selected list are displayed in the table.
  6. If the normalizer template does not define any normalizer values and you are not using a normalizer value list, then you can define the values within the normalizer instance by clicking Edit Values to open Edit Normalizer Values and performing the following steps:
    Important: You must define the No Match value first to assign an ID of 0 to it, and the Match value second to assign an ID value of 1.
    1. Click New Value.
      A row is added to the list with an ID that is used internally to look up the parameter value during rating. Any metadata defined in the normalizer template is displayed as columns in the Values table.
    2. Click the Name cell in the row and enter a descriptive name for the parameter value.
    3. Click the Description cell in the row and enter information about the purpose of the parameter value.
    4. To assign a color to the parameter that displays as the background color for each row in the Rows table, do one of the following:
      • Hover your mouse over the Color cell in the row and select a color from the color palette.
      • Click the Color cell in the row and assign a color to the value by setting the color's hue, saturation, and lightness. The following methods are available:
        • Use the eyedropper tool to select any color on your screen or select a color on the color strip to pick a main color. Then use the color gradient area to fine tune the color.
        • Enter the RGB/HSL/Hex values of a certain color if they are known.
  7. In Value If Field Not Present, select a parameter value to use when the field value is not set at the time of rating.
  8. To check whether calling and called subscribers are in the same group or subgroup, select the name of the group or subgroup in Tier or the parameter used to specify the group tier in Tier Parameter. When selecting a tier, select global to check whether the calling and called subscribers are on the same network.
  9. (Optional) Click or hover over the Rows menu icon and select Validate to check the normalizer values for errors.
    Validation checks for errors caused by duplicate rows, gaps in ranges, overlapping ranges, and any other missing or invalid configurations. To perform the validation, My MATRIXX sorts the rows in the rate table according to the first parameter value.