Adding Catalog Item Template Fields

You can add more catalog item template fields to default product offers and bundles by creating new custom MATRIXX Data Containers (MDCs). Some default offer and bundle templates include useful example fields, but you should extend that list. Your new custom MDCs extend a base MDC with the template fields that your MATRIXX implementation requires. Pricing Users then decide on a per-offer or per-bundle basis whether to make the new fields available to Catalog Users to configure for catalog items. Only simple data types are allowed.

Once you create and configure the new custom MDCs, the new fields are accessible from the My MATRIXX Template Fields tab for an offer or bundle (as a Catalog Item Template).

You use the create_config.py script to create new custom MDCs by extending the MtxTemplateAttr or MtxSampleTemplateAttr MDC as a base.

Note: The allowed data types are string, integer, decimal, Boolean, or long.
The MtxTemplateAttr MDC is empty by default. MtxSampleTemplateAttr has the default fields described in MtxSampleTemplateAttr Default Fields.
Table 1. MtxSampleTemplateAttr Default Fields
Field Data Type
DataPurchaseChargeAmount Decimal
DataPurchaseGrantAmount Decimal
DataRecurringChargeAmount Decimal
DataRecurringGrantAmount Decimal
SmsPurchaseChargeAmount Decimal
SmsPurchaseGrantAmount Decimal
SmsRecurringChargeAmount Decimal
SmsRecurringGrantAmount Decimal
VoicePurchaseChargeAmount Decimal
VoicePurchaseGrantAmount Decimal
VoiceRecurringChargeAmount Decimal
VoiceRecurringGrantAmount Decimal
BalanceExpirationSelection UINT32
For information about creating custom MDCs and adding fields to MDCs, see:
  • The discussions about extending MATRIXX Engine functionality and custom MDCs in MATRIXX Integration.
  • The discussion about working with custom MDCs in MATRIXX Subscriber Management API.
  • The discussion about field definitions in My MATRIXX Help.
After you create the new custom MDCs, you must configure My MATRIXX to point to the MATRIXX Engine containing the latest schema changes or have access to a local up-to-date system configuration. In other words, My MATRIXX and the MATRIXX Engine must have access to your new MDC definitions. For information about pointing to a running MATRIXX Engine, see the discussion about configuring My MATRIXX in MATRIXX Web App Administration.