Rules

View Existing Rules Configuration

1. Click the Usage switch (Usage/Account toggle) in the navigation pane.
2. Click the Mediation Setup option in the navigation panel to expand its submenu.
3. Click the Rules menu option.
4. This fetches existing rule configurations and displays each as a line in the table.

This is shown in the following screenshot:

View Details of a Specific Rule Configuration

1. Navigate using “To view existing rules configuration” to see the list of rule configurations.
2. Select and click the ID link. This opens the drawer to view and modify data. 

Filter Attributes For The Rule Configuration

1. Name: A case-insensitive, partial match filter for the source platform name. For example, “nokia” matches all configurations for that platform.
2. Service Type: Filters rule configurations by service-type association. A source platform can support different usage record formats for various service types.

Sort Attributes For The Rule Configuration

1. Name: Sort ascending or descending by the rule configuration name.
2. Service Type: Sort ascending or descending by the service-type associated with the source platform.

Add a New Rule Configuration

1. Navigate using “To view existing rule configuration”.
2. Click the Add Rule configuration button at the top-right corner. This opens a drawer to add the new configuration details:
   1. In the Name field, enter a unique name for the source platform rules. Avoid spaces as the name forms the AWS S3 file path.
   2. Select the Service Type from the drop-down list.
   3. Select the Usage Record Type from the drop-down list.
   4. Enter the Rule Name for the configuration.
   5. The Rule File field displays the AWS S3 mediation folder path, generated from the entered attributes.
   6. Enter a database function name for alternative rule definitions, useful for enrichment rules requiring extra data setup or lookup.
   7. Upload rules file—Upload independently created rule files. Clicking upload file opens a drawer with two options:
      1. Drag and drop a file into the box.
      2. Click the box to open a file browser and select the file to upload.
   8. Click the SAVE button at the drawer's bottom right to save the configuration via the backend API.
   9. Click the CANCEL button at the drawer's bottom right to discard changes and return to the main activity pane. 

Follow these steps to modify an existing configuration:

1. Navigate using “To view existing rule configuration”.
2. Click the Id link highlighted in Aria Blue to open the drawer for editing a source platform's attributes.
3. Modify attributes inline as needed; the ID field is not editable.
4. Alternatively,
   1. Upload a new or modified rules file. The UI allows downloading, editing, and re-uploading files. Aria Allegro archives older files in AWS S3 folders accessible to authorized users.
   2. Delete the rules file by clicking the Trash Bin icon above the file content on the right.
   3. View the rules file content in read-only mode after upload.
5. Click the SAVE button at the drawer's bottom right to save changes via the backend API.
6. Click the CANCEL button at the drawer's bottom right to discard changes and return to the main activity pane.

This sample rule checks the ‘usagetype’ value to determine if the record should be filtered. Refer to the Allegro Usage container fields available in the mapping configuration.

Modify Existing Mediation Rules Configuration

The steps to modify an existing mapping configuration are:

1. Navigate using “To view existing rule configuration”
2. Click the Id link button highlighted in Aria Blue to open the drawer and modify attributes of an existing source platform.
3. Modify attributes inline as needed (the ID field is not editable).
4. Alternatively,
   1. Upload a new or modified rules file. The UI lets you download, edit, and re-upload files. Aria Allegro archives older files in AWS S3 folders accessible to authorized users.
   2. Delete the rules file by pressing the Trash Bin icon above the rules file content on the right.
   3. View the rules file content. After uploading, Allegro UI displays it as read-only by default.
5. Click the SAVE button at the drawer's bottom right to save changes via the backend API.
6. Click the CANCEL button at the drawer's bottom right to discard changes and return to the main currency resources pane.

Sample rule configuration

if (usagetype != "API Call") {
    status = "IGNORED";
    reason = "Invalid record";
    return false;
}
status = "PROCESSED";
reason = "processed";
return true;