How to exclude Test Users from billing in Atria

How to exclude Test Users from billing in Atria


In this article, we will show you how to create non-billable users for a customer.  The idea to show non-billable users in Atria is to create billing rules in the service billing Configuration page, we will use a query to retrieve Test users from the database. This way the report will prioritize and run the created rule and will mark the Test Users as non-billable.

Database Configuration

Run SQL Server Management Studio on your Atria database server and connect to your database engine, then add the following table function to your OLM database:
  1. USE [OLM]
  2. GO
  4. GO
  6. GO
  7. Create FUNCTION [dbo].[tf_ExcludeTestUsers]
  8. (
  9. @BillPeriodID int
  10. )
  11. RETURNS @Result TABLE
  12. (
  13. ObjectID INT,
  14. MaxAuditID INT
  15. )
  16. AS
  17. Begin
  18. INSERT INTO @Result (
  19. ObjectID
  20. ,MaxAuditID)
  21. SELECT ObjectID
  22. ,max(AuditID) AuditID
  23. FROM PropertyValues_AT
  24. WHERE PropertyID = (
  25. SELECT PropertyID
  26. FROM Properties p
  27. WHERE p.Name = 'employeetype')
  28. AND ActionDate <= (
  29. SELECT EndDate
  30. FROM BillPeriod
  31. WHERE BillPeriodID = @BillPeriodID)
  32. AND (PropertyValues_AT.Value = 'True')
  33. GROUP BY ObjectID
  34. RETURN 

  35. End

User Configuration

  1. Logon to Atria web portal 
  2. Select a customer by navigating to Customers -> Customers and select a customer, then click on Users
  3. Edit an existing user or create a new user
  4. Click on Additional User Properties and select Test User checkbox as shown below

  5. Provision the user

Billing Reports Configuration

  1. In Atria click on Reports -> Service Billing Configuration
  2. In the Service Billing Rule Configuration Click on New Rule to create a new rule so that you can exclude test users.
  3. Enter a Description and Override Reason
  4. It is important to enter 1 in Processing Order.

  5. Select a value for Valid From and Valid To date
  6. Click on Rule Type Drop-Down box and select Custom Where Clause

  7. To exclude test users in a particular Bill period, enter the following text inside the Where Text box:
    1. BillItems.UserID in (select u.UserID from Users u inner join (select * from dbo.tf_ExcludeTestUsers(@BillPeriodID)) as A on u.ObjectID = a.ObjectID)

  8. Alternatively, to exclude Test Users without any time filtration, enter the following script in the Where Text box:
    1. BillItems.UserID  in ( Select UserId from vw_UserUserProperties vw where (vw.Property='employeeType') and (vw.Value='True'));
  9. Click on the Save to add the rule to the Service Billing Rule Configuration
  10. Click on Reprocess Billing Records
  11. Click on Reports -> Service Billing Details to view customer and user services
  12. The test users that were created before will show No under Billable

If you find the Test User previously set is not shown correctly to the report, uncheck Test User, Provision, and again check Test User and Reprovision the user.

    • Related Articles

    • Billing Rules Engine User Guide

      Objective This article describes how to use the Atria billing rules engine to identify specific Atria entities as non-billable.   Applies to Introduced in Atria version 12.0.0 Billing Rule Feature Overview Many entities - customers, services, users, ...
    • Billing Process Overview

      Objective This article outlines, at a high level, the billing features available in Atria. The billing feature provides transparency of Atria billable services that have been consumed, down to the day. Applies To Introduced in Atria version 12.0.0. ...
    • Atria Billing Setup User Guide

      Objective This article describes how to configure Atria to utilize the latest billing features. This document outlines the billing setup attributes that should be configured.    Applies to Introduced in Atria version 12.0.0 Billing Setup Overview To ...
    • Service Billing Summary Report

      Objective This article describes the information contained in the Billing Summary Report.     Applies to Introduced in Atria version 12.0.0 Billing Summary Report Overview The service billing summary report is designed to highlight the billable ...
    • Display Patterns for Billing Line Descriptions

      Purpose: When generating billing data, two descriptions are generated for each billable item - Line description (detailed) and summary descriptions.   The Summary Description serves two purpose: Used as a template for your invoice lines and reporting ...