Home
My MATRIXX Help
Charging Configuration
Charging Configuration has the interfaces you use to create and manage balance, pricing, product offer and bundle, general, and application-related components.
General Configuration
General Configuration has interfaces you use to create pricing plan components. Pricing plan components managed through this interface include announcements, product and system attributes and definitions, currency codes for rate tables, denial codes, field definitions for use in normalizers and rate tables, Diameter Final-Unit-Indication (FUI) profiles and generators, General Ledger (GL) transaction types and info generators, grace period profiles, languages, notification profiles, parameter definitions, pre/post-rating profiles and generators, SH Repository data, Subscriber Information Query components, tax classes for offer categorization, usage quota profiles and components, purge profiles, virtual fields, and usage triggers.
SH Repository Data
Sh repository data profiles allow you to send information between the Policy and Charging Rules Function (PCRF) and the Subscriber Profile Repository (SPR), where MATRIXX Engine is the SPR. The PCRF and SPR communicate by sending Subscription Notification Requests (SNR) and Subscription Notification Answers (SNA) back and forth over Sp. The Sh repository data returns to the PCRF in an SNA.
Repository Data Components
A repository data component implements the business logic that decides which data to return from the PCRF for a given set of circumstances. Administrators define the business rules and decisions by creating repository data tables inside the repository data components. You can attach repository data components to product offers to define subsets of Sh data that apply to a product offer.
Create a Repository Data Component
Repository data components use decision tables to select the Sh repository data profile that is applied to a specific product offer. Each repository data component can contain one or more repository data component tables. Each repository data component table specifies the decision table containing the business logic for selecting the appropriate Sh repository data profile (or SKIP) for each row in the decision table.

Welcome
MATRIXX Release Notes
MATRIXX Architecture
MATRIXX Installation and Upgrade
MATRIXX Configuration
MATRIXX Security
MATRIXX Integration
MATRIXX Diameter Integration
MATRIXX Call Control Framework Integration
MATRIXX TM Forum Integration
MATRIXX 5G Integration
MATRIXX 5G Event Streaming
MATRIXX Event Streaming
MATRIXX Administration
MATRIXX Web App Administration
MATRIXX Monitoring and Logging
MATRIXX Policy
MATRIXX Kafka CDR Consumer
MATRIXX Pricing and Rating
MATRIXX Pay Now
MATRIXX Subscriber Management
MATRIXX Subscriber Management API
MATRIXX Business API SDK
My MATRIXX Help
- About My MATRIXX Help
  My MATRIXX Help provides information about My MATRIXX, a web application that offers a central location for creating pricing plans and configuring MATRIXX charging and rating behaviors. My MATRIXX is intended for pricing administrators who are responsible for creating and maintaining pricing plans and for IT administrators or developers who configure the rating and charging behavior of the online charging system.
- Introducing My MATRIXX
  The following information describes the My MATRIXX interface.
- Using My MATRIXX
  You use My MATRIXX to validate and compile the pricing configuration file, compile pricing, and set up and manage user roles and domains; create and manage catalog items and catalogs, manage eligibility features and rules, and manage the Normalizers interface; create and manage balances, pricing, offers and bundles, general components, and application-related components; and policies for charging and rating. Use General Configuration to create components that support pricing items and charging functionality such as announcements pricing components, attribute definitions, denial codes, products, decision tables, Final Unit Indication (FUI) profiles and generators, general ledger transaction types, notification profiles, normalizer templates, and subscriber information query actions, profiles, and generators.
- Home Menu
  The following information describes the tasks that can be performed using the My MATRIXX Home menu.
- Catalog Configuration
  Catalog Configuration contains the Catalog Items interface that you use to create, change, or delete catalog items; the Eligibility interface to manage eligibility features and rules to determine whether a subscriber, group, or device is eligible for a catalog item; and the Normalizers interface you use to edit normalizers.
- Charging Configuration
  Charging Configuration has the interfaces you use to create and manage balance, pricing, product offer and bundle, general, and application-related components.
  - Balance Configuration
    Balance Configuration contains interfaces you use to create and manage price components including aggregation selectors, balances and balance classes, balance state update profiles and components, meters, and rollover profiles and components.
  - Pricing Configuration
    Pricing Configuration contains interfaces you use to create pricing plan components. Pricing plan components managed through this interface include decision tables, finance and service contracts, filters, price components including charges, discounts, grants, refunds, and forfeitures, and rate tags.
  - Offer and Bundle Configuration
    Offer and Bundle Configuration contains interfaces you use to create and manage pricing and rating components including bundles, offer priority generators, product offers, and product service types and attributes.
  - Normalizer Configuration
    Normalizer Configuration contains interfaces you use to create and manage normalizers, normalizer templates, and normalizer value lists.
  - Tax Configuration
    Tax Configuration contains interfaces you use to create and manage tax classes and selectors, and US taxation. You must have the Manage Tax domain user role to enable this menu.
  - General Configuration
    General Configuration has interfaces you use to create pricing plan components. Pricing plan components managed through this interface include announcements, product and system attributes and definitions, currency codes for rate tables, denial codes, field definitions for use in normalizers and rate tables, Diameter Final-Unit-Indication (FUI) profiles and generators, General Ledger (GL) transaction types and info generators, grace period profiles, languages, notification profiles, parameter definitions, pre/post-rating profiles and generators, SH Repository data, Subscriber Information Query components, tax classes for offer categorization, usage quota profiles and components, purge profiles, virtual fields, and usage triggers.
    - Announcements
      MATRIXX Engine uses announcement data for determining the list of announcements to play to a subscriber during a voice call, and the language they must be played in. Configure announcement data to be dynamic, so a different result occurs based on conditions that are valid at the time of rating.
    - Attributes
      System attributes and product attributes are properties you can add to certain pricing objects that can be used to influence rating operations and provide information to downstream systems, such as General Ledger accounting systems.
    - Data Modify
      You use the data modify interface to configure data modify actions, data modify profiles, and data modify profile selectors.
    - Denial Codes
      Denial codes are a way to deny service access to subscribers for a specific reason. You define them in My MATRIXX and add them to rate table rows in place of a rating formula, so the value is returned to the network based on the row selected during rating.
    - Final Unit Indication
      You can configure Diameter Final Unit Indication (FUI) information to be static or dynamic.
    - General Ledger Info
      You can configure MATRIXX Charging Application to generate General Ledger (GL) information for inclusion in an _glossary/edr.html.
    - Grace Period Profiles
      You use grace period profiles to configure the length of purchased item cycle grace period(s) that extends the period of time before a cycle goes into a recovery state.
    - Languages
      A language definition indicates that My MATRIXX supports that language.
    - Notifications
      In Notifications you create notification profiles and notification profile selectors that determine when and to which tenants notifications are sent.
    - Object State Update Profiles
      An object state update profile specifies how to extend, limit, or adjust the date/time value of the custom MATRIXX Data Container (MDC) field of an offer owner (subscriber/group/device). Enable an object state update profile by selecting it when configuring an offer owner state update component. The decision table used in an offer owner state update component selects an object state update profile to use to update a custom field of an offer owner. An object state update profile can only be used in combination with an offer owner state update component. For more information, see the discussion about offer owner state update components.
    - Parameters
      You can configure definitions for parameters that you can use in pricing items such as catalog items, bundles, product offers, and price components.
    - PostRating
      MATRIXX Engine uses post-rating profiles and generators for determining a set of actions to apply to a message after it has been processed by rating. You configure post-rating to be dynamic, so a different result occurs based on conditions that are valid at the time of rating.
    - PreRating
      MATRIXX Engine uses pre-rating query data for determining when to perform a call out request for subscriber information to an external server or database. You configure pre-rating query data to be dynamic, so a different result occurs based on conditions that are valid at the time of rating.
    - Purge Profiles
      Purge profiles allow you to define retention periods for expired product offers per _glossary/catalog_item.html, _glossary/meter.html, or _glossary/balance.html.
    - SH Repository Data
      Sh repository data profiles allow you to send information between the Policy and Charging Rules Function (PCRF) and the Subscriber Profile Repository (SPR), where MATRIXX Engine is the SPR. The PCRF and SPR communicate by sending Subscription Notification Requests (SNR) and Subscription Notification Answers (SNA) back and forth over Sp. The Sh repository data returns to the PCRF in an SNA.
      - Sh Repository Data Profiles
        You create Sh repository data profiles to support the use of the Sh protocol over Sp. An Sh repository data profile includes a well-formed XML document fragment that defines a subset of data to be returned to the PCRF, or a service, and name for this data or service. One Sh repository data profile can include multiple data subsets or services.
      - Repository Data Components
        A repository data component implements the business logic that decides which data to return from the PCRF for a given set of circumstances. Administrators define the business rules and decisions by creating repository data tables inside the repository data components. You can attach repository data components to product offers to define subsets of Sh data that apply to a product offer.
        Create a Repository Data Component
        Repository data components use decision tables to select the Sh repository data profile that is applied to a specific product offer. Each repository data component can contain one or more repository data component tables. Each repository data component table specifies the decision table containing the business logic for selecting the appropriate Sh repository data profile (or SKIP) for each row in the decision table.
        Create a Repository Data Component Table
        A repository data component table maps the rows of a decision table to a set of Sh repository data profiles. A repository data component table determines which Sh repository data component profile is applied to a specific product offer.
        Change a Repository Data Component
        You can change any property of an Sh repository data component.
        Create a New Revision of a Repository Data Component
        You use the Edit Repository Data Component interface to create a new revision of an Sh repository data component. Revisions are generally used to update details for the repository data component that you attach to offers. When a new revision becomes active, the old one becomes inactive, so the new revision must have a start date after the original. After you create a new revision, the ID field for that repository data component item is incremented.
        Delete a Repository Data Component
        You can delete repository data components that are no longer needed. You must remove an Sh repository data component from any pricing items that may contain it before you can delete it.
        Repository Data Components Properties
        my_matrixx/r_data_components_properties.html#reference_22542EFB78A6459FBF7502B904FF752D__table_DC8F93FC8842451CA3F9CF9F1DF9BCDE describes the Sh repository data component object properties. Repository data components are referenced from Sh repository data profiles.
    - Usage Quota
      Usage quota components are pricing items that are used for selecting usage quota profiles based on conditions that are valid during rating. The usage quota profile defines authorization and quota management settings to be applied to online charging sessions (to authorize a request for quota for a given service and context type). The usage quota component defines the criteria for choosing a usage quota profile as a set of normalized values.
    - Usage Triggers
      Usage triggers activate network changes based on product offers and subscriber profile data. You apply usage triggers to product offers, which then apply to ongoing subscriber sessions.
    - Virtual Fields
      Use virtual fields to avoid creating multiple pricing configurations if your MATRIXX environment accepts multiple rating message types, for example, messages from Diameter and 5G networks.
  - Application Configuration
    Application Configuration components are used by My MATRIXX for creating pricing plan items and are used by MATRIXX Charging Application and MATRIXX Policy Application for charging and rating.
- Policy Configuration
  Policy configuration components are used by MATRIXX Charging Application and MATRIXX Policy Application for charging and rating.
MATRIXX Backoffice Customer Tool Help
MATRIXX Third-Party Licenses
Glossary

Create a Repository Data Component

Repository data components use decision tables to select the Sh repository data profile that is applied to a specific product offer. Each repository data component can contain one or more repository data component tables. Each repository data component table specifies the decision table containing the business logic for selecting the appropriate Sh repository data profile (or SKIP) for each row in the decision table.

About this task

You can also create an Sh repository data component by copying an existing component. Open SH Repository Data, click the Repository Data Components, and select the copy icon in the row of an Sh repository data component. Enter a new name for the data component and make changes using the steps 2 and 3 below.

Procedure

In SH Repository Data, click the Repository Data Components tab, then click New Repository Data Component.
1. In Name, enter a unique name.
2. (Optional) In Description, enter descriptive information about its purpose.
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.
4. Click Create.
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.
Click Save.