Page Comparison

...

Base buckets define the usage characteristics of buckets, such as the unit type that is being consumed (data, count, time), the class of usage that is applicable to the bucket (e.g. data, APIs, disk space, voice, SMS) and the locations where usage is applicable to the bucket (Everywhere, North America, United States, etc.). Base buckets are selected when configuring usage buckets and share plan buckets. Usage buckets are attached to services and define the bucket size (1GB, 100 minutes, etc.), if the bucket recurs, and other settings which define how usage is included/charged in relation to a service or share plan.

As of version 10.4 multiple base buckets can be configured on usage buckets. This configuration feature was introduced to support money buckets and to reduce the number of usage buckets that need to be configured in the system by permitting multiple base buckets of the same data type to be setup on a usage bucket (e.g. a data usage bucket could have two base buckets configured on it, one for ‘data zone 1’ class usage and the second for ‘data zone 2’ class usage, allowing usage from each region to be deducted from a single usage bucket).

For more information on money buckets and how to configure base buckets on usage buckets, see the usage buckets screen help.

Prerequisites

Usage Classes need Classes need to be configured before base buckets can be setup.

...

The Buckets panel on the left of this screen allows you to select existing base buckets to view and edit on the Edit Bucket panel to the right. Actions are also available in this panel which are shown as icons above the Filter text box. The available actions are described below.

Actions

Icon	Description
Image Modified	Deletes the selected base bucket if not in use (configured on usage buckets or share plans)
Image Modified	Adds a new base bucket

Buckets List

The buckets list on the left of the screen shows base buckets that are currently setup.

When you select a base bucket in the list additional details will be displayed in the Edit Bucket panel to the right. These details are explained below.

Edit Bucket Panel

The information in this panel reflects the currently selected base bucket. From here you can change bucket details (fields will display a red left border if a value is required and purple text if the field is read-only and cannot be modified).

...

• Name: a descriptive name for the base bucket (e.g. 'Data Bucket')

• Unit Type: how usage will be consumed for usage buckets that use this type of base bucket. The options are:

  • CountTime: usage by a specific activity/event (messages, events, records, etc.time (e.g. call time/airtime)

  • Data: usage by data consumptionTime

  • Count: usage by time (e.g. call time/airtimea specific activity/event (messages, events, records, etc.)

• Start Date: when the base bucket is active/available in the system

...

This tab specifies the usage classes and locations that are applicable to the bucket. E.g. if you are setting up a base bucket for sms usage in the United States you would need to add bucket details with the appropriate messaging classes (e.g. SMS-MobileOriginating) and the appropriate locations (United States). Instructions on how to add details to the Bucket Details tab are covered in the guides section below.

References tab

This section displays where the selected base bucket is used in the system. By default the reference data is displayed in a summary format to indicate where the base bucket is in use, however the Entity drop down field can be used to view the exact system objects that the base bucket is configured on.

...

Guides

Adding Base Buckets

1. Adding Base Buckets

   1. Under the Buckets heading on the left click the  icon

   2. Under the Add Bucket heading on the right specify the base bucket details

   3. On the Bucket Details tab click the + New button to add usage class and location details. The details available are explained below:

      • Exclude: allows you to exclude usage from being deducted from the bucket for a particular class of usage or usage related to a specific location. For instance, if you configured a bucket detail for voice class usage in North America and wanted to calls to Hawaii not to deduct allotted usage from the bucket, you would create another bucket detail with a location of Hawaii, a class of 'voice/airtime' and the Exclude option checked. Given this configuration, calls to Hawaii would not deduct airtime minutes from the bucket, instead another airtime bucket would be used (if available) or a rate plan would be searched for in order to charge for the calls to Hawaii that were excluded from using the bucket

      • Class: allows you to specify a class of usage applicable to the bucket. E.g. if this is a data bucket you would select the appropriate data class

      • Location: this option will only appear if the selected class is using the geotree as its rater. The location indicates where the bucket applies, or where the bucket cannot be used if a location is specified and the 'Exclude' option is set. The Location relates to the terminating geotree pattern, not the originating number (i.e. making a call from the location is not relevant, the called number is what is evaluated)

      • Location Group: this option will only appear if the selected class is using the geotree as its rater. Location groups are a collection of locations (e.g. multiple regions, states or countries) which like the location setting above can be selected so that the bucket can be used when calling any one of the locations in the group

   4. repeat Repeat the step above to add additional details Bucket Details if needed

   5. Click Save to create the new base bucket

...

...