PaperCut Print Script

PaperCut Print Script of the Month #5 – Low balance alert

PaperCut Print Script of the Month

 

With PGM out of the way, it is time to look at our monthly PaperCut Print Script again. This month it is time to recreate a feature that PaperCut already has, but with the added bonus of being able to change more. So, grab your favourite hot drink (coffee is the best option here) and we can get started.

 

 

How to create a script to email users with a low balance

This feature is a way to email users when their balances get below a certain value. This script does assume you have two things in place already:

1. The mail server for notifications.

2. The email address for the users already synced from your sync source.

Let us get started… First create three variables these will be used for the email subject, email body (yes it supports HTML) and the value we want to check against.

var LOW = 1;
var SUBJECT = "Your balance is low";
var BODY = "Your PaperCut balance is getting low, Don't forget to top up soon or you won't be able to print";

 

Once that is done we can add in the method to send an email which can be used to email one address or multiple by putting them in an array. We are just using the users email address which we can get from inputs.user.email which makes this easier.

actions.Utils.sendEmail(inputs.user.email, SUBJECT, BODY);

 

All that is left to do now is wrap the sendEmail method in an if statement to check if the user’s balance minus the cost of the job is less than or equal to the value you want to use as your minimum.

if (inputs.user.balance - inputs.job.cose <= LOW) {
 // Send Email Here
}

 

If you wanted to you could even do a check on the users group and only have it available for a certain group of users.

 

That is it for this month and as always the complete PaperCut Print Script is below, if you have your own requirements for a print script and you don’t have the time or in house experience to make it you can find out how we can help you by sending an email to our sales team at sales@selectec.com

 

/*
 * Email user when balance is low
 *
 * Read more at http://selectec.com/script-of-the-month-5-low-balance-alert/
 */

function printJobHook(inputs, actions) {

  var LOW = 1;
  var SUBJECT = "Your balance is low";
  var BODY = "Your PaperCut Balance is getting low, Don't forget to top up soon or you won't be able to print";

  if (!inputs.job.isAnalysisComplete) {
    return;
  }

  if ( inputs.user.balance - inputs.job.cost <= LOW ) {
    actions.utils.sendEmail(inputs.user.email, SUBJECT, BODY);
  }
}