Data Modify Profiles

A data modify (DM) profile specifies a list of data modify actions to perform. You assign DM profiles to decision table rows in rating and policy tables and profile selector tables.

A rating or policy table that has profiles assigned to it, must have a default DM profile set. If the table is run during rating, MATRIXX Engine performs the profile associated with the selected result row in the table, including SKIP rows. If a table row does not have a specific profile assigned to it, MATRIXX Engine performs the default DM profile. For example, if you do not assign a DM profile to SKIP rows, MATRIXX Engine performs the default DM profile for SKIP rows selected during rating.

If the table is not run during rating, MATRIXX Engine does not perform the default profile or any other profile assigned to the table.

You can create an empty profile (one that does not contain any data modify actions and so does nothing) and assign it to result rows in the table, or set it to be the default profile for the table. For example, you could map an empty DM profile to the table rows for not present or not matched normalizer results.

Data Modify Actions

A data modify action in a data modify profile defines how to manipulate an MDC field in a message being processed by rating. The sources you can use for the actions in the profile are:
  • A field from a message or an object (subscriber, group, device, user, or account).
  • A field in an LDAP call out response.
  • A field from a custom workspace MDC descended from one of the following MDCs:
    • MtxChrgMsgWorkspace
    • MtxChrgSegWorkspace
    • MtxChrgCompWorkspace
  • Metadata from a normalizer, a rate table, or a policy table.

    Metadata is temporary data defined in the table or normalizer. It exists only until rating has completed processing the table or normalizer that defined it. During rating, any metadata fields that are referenced in a DM action for a selected DM profile may be copied to a destination MDC.

  • A constant.
  • A DateTime field count offset.
  • A calculated value from a balance difference normalizer or a difference range normalizer.
The destinations you can use are:
  • A field in the message being processed.
  • A field in an LDAP call out request.
  • A field in a custom workspace MDC descended from one of:
    • MtxChrgMsgWorkspace
    • MtxChrgSegWorkspace
    • MtxChrgCompWorkspace
  • A field in a subscription, group, device, user, or an offer object.

Source Action

The data modify action, Source Action field configures the action you want the profile to take if the source field is empty. You can select from the following options:
  • Do Nothing if Source Empty — The profile continues to the next action in the profile without raising a warning.
  • Take Default if Source Empty — The profile uses the Default if Empty value as the source.
  • Fail if Source Empty — (Default) The profile stops execution and raises an error.
Note: If the source is a constant, Source Action does not apply. If the source is Time Unit and Count and the source field is empty, the Do Nothing if Source Empty behavior applies.