Skip to main content
Aria Knowledge Central

Building Blocks

  1. Last updated
  2. Save as PDF
  1. Service Types
    1. View service types
    2. Add a service type
    3. Edit a service type
    4. Delete a service type
  2. Billable Services
    1. View billable services
    2. Associate a service type with a billable service
  3. Usage Types
    1. View usage types
    2. Add a usage type
    3. Edit or delete a usage type
  4. Multi-Rate Usage Types
    1. View multi-rate usage types
    2. Add a multi-rate usage type
    3. Edit a multi-rate usage type
    4. Delete a multi-rate usage type
  5. Units of Measure
    1. View units of measure
    2. Add, edit, or delete a unit of measure

Building blocks define the classification and structural elements that link usage records to billing models. Configure all building blocks before defining monetization models.

Service Types

Service types classify billable services and are required for usage type configuration. Each service type must map to an Aria billing service.

View service types

  1. Click the Usage toggle in the navigation pane.
  2. Click Configurations to expand the sub-menu.
  3. Click Building Blocks.
  4. Click the Service Type tab in the activity pane.

The table displays all service types configured for the client.

bb-01.png

You can filter the table by Service Type using a case-insensitive, partial-match filter. You can also sort ascending or descending by Service Type.

Add a service type

  1. Navigate to the service types list.
  2. Click Add Service Type at the top right of the activity pane.
  3. Select a Service Type (required) from the dropdown. This links the Allegro service type to the corresponding Aria billing service.
  4. Enter a Name (required) for the service type.
  5. Click Save.

Edit a service type

  1. Navigate to the service types list.
  2. Click the ID link for the service type you want to modify.
  3. Update the Name as needed. The service type ID is read-only.
  4. Click Save.

Delete a service type

Allegro enforces referential integrity. You can only delete a service type if it is not referenced in any other configuration.

  1. Navigate to the service types list.
  2. Click the trash icon in the row for the service type you want to remove.
  3. Click Save to confirm the deletion.

Billable Services

Billable services link Allegro monetization to invoicing in Aria Billing Cloud. Each billable service corresponds to a service in Aria and must be associated with a service type in Allegro.

View billable services

  1. Click the Usage toggle in the navigation pane.
  2. Click Configurations to expand the sub-menu.
  3. Click Building Blocks.
  4. Click the Billable Service tab in the activity pane.

The table lists all billable services configured for the client.

bb-02.png

You can filter and sort the table using the following attributes:

  • Service Type—filters by associated service type.
  • Usage Type No—sort ascending or descending by usage type number.

Associate a service type with a billable service

Note: Add or modify billable services only through the Aria Admin UI, not through Aria Allegro. To associate an Aria service type with an existing billable service in Allegro, follow the steps below.

  1. Navigate to the billable services list.
  2. Click the ID link for the billable service you want to update.
  3. Select the applicable Service Type from the dropdown.
  4. Click Save.

Usage Types

Usage types classify individual usage records for rating. Each usage type maps to a service type and determines how the Allegro engine processes and prices usage transactions.

View usage types

  1. Click the Usage toggle in the navigation pane.
  2. Click Configurations to expand the sub-menu.
  3. Click Building Blocks.
  4. Click the Usage Type tab in the activity pane.

The table lists all usage types configured for the client. You can filter by Usage Type and sort by Usage Type or Usage Type No.

Add a usage type

  1. Navigate to the usage types list.
  2. Click Add Usage Type at the top right of the activity pane.
  3. Enter a Usage Type name (required).
  4. Select the associated Service Type (required) from the dropdown.
  5. Enter any additional attributes as required for your configuration.
  6. Click Save.

Edit or delete a usage type

  1. Navigate to the usage types list.
  2. Click the ID link to edit, or click the trash icon to delete the usage type.
  3. Click Save to apply your changes.

Multi-Rate Usage Types

Multi-rate usage types support scenarios where a single usage record must pass through multiple sequential rating stages—for example, an access fee followed by a usage fee and then a usage surcharge. Each stage applies a separate monetization model in sequence.

View multi-rate usage types

  1. Click the Usage toggle in the navigation pane.
  2. Click Configurations to expand the sub-menu.
  3. Click Building Blocks.
  4. Click the Multi Rate Usage Type tab in the activity pane.

The table lists all multi-rate usage type configurations for the client.

Add a multi-rate usage type

  1. Navigate to the multi-rate usage types list.
  2. Click Add Multi Rate Usage Type at the top right of the activity pane.
  3. Enter a name and configure the rating passes in sequence. For each rating pass, specify the child usage type and, where applicable, an expression that references the result of a prior pass.
  4. To apply an independent monetization model for each child usage type without referencing prior pass results, clear the Usage Type Dependencies field. If you leave this selected, each subsequent row after the first requires an expression.
  5. Click Save.

Note: In a multi-rate sequence, the first pass requires no expression—pricing comes directly from its associated monetization model. Each subsequent pass can either use an independent model or reference the result of one or more prior passes through an expression.

Edit a multi-rate usage type

  1. Navigate to the multi-rate usage types list.
  2. Click the ID link for the configuration you want to modify.
  3. Update the attributes as needed. The ID field is read-only.
  4. Click Save.

Delete a multi-rate usage type

Note: Deleting a multi-rate usage type configuration stops multi-pass processing for that type. Proceed with caution.

  1. Navigate to the multi-rate usage types list.
  2. Click the trash icon in the row for the configuration you want to remove.
  3. Click Save to confirm the deletion.

Units of Measure

Units of measure define the quantity units used in usage records and rate configurations. Configure all applicable units before referencing them in monetization models.

View units of measure

  1. Click the Usage toggle in the navigation pane.
  2. Click Configurations to expand the sub-menu.
  3. Click Building Blocks.
  4. Click the Unit of Measure tab in the activity pane.

Add, edit, or delete a unit of measure

  1. Navigate to the units of measure list.
  2. Click Add Unit of Measure to add a new unit, or click the ID link of an existing unit to edit it.
  3. Enter or update the required attributes.
  4. Click Save. To delete a unit, click the trash icon and then click Save to confirm.
TOP
  1. Back to top
  • Was this article helpful?

Recommended articles

  1. Page type
    Topic
  2. Tags
    1. allegro
    2. rating
    3. usage