Rule definition overview
Glossary
Term | Definition |
Rule | Set of associated triggers, conditions, actions and notifications |
Trigger | Defines action that triggers the execution of rule – when the conditions are evaluated. |
Condition | Is reviewed when rule is triggered. Evaluates whether action should be performed. When more conditions are defined for specific rule, all of them must be met in order for rule to do action. |
Action | Action is something the system does, typically with a print job. Happens when rule is triggered and conditions are met. |
Notification | Information to end user, manager, administrator or external system about successful execution of rule – it was triggered and conditions were met. |
Triggers
Trigger | Description |
On reception of job by YSoft SafeQ server | Print Job Reception from user workstation or print server. The YSoft SafeQ Client notifications can only be triggered by this trigger. |
Before job is released to the printer | Before print job is released to a device managed by YSoft SafeQ 6. |
On job's delivery to the printer | Print job delivery to a device managed by YSoft SafeQ 6 |
On user's login at terminal | When user authenticates at a YSoft SafeQ terminal. |
On user's logout at terminal | When user logout at a YSoft SafeQ terminal. Rule containing this trigger cannot have any actions, only notifications. |
On job status change | When status of user print job has changed. Rule containing this trigger cannot have any actions, only notifications. |
Conditions
Job Conditions | Supported triggers | Notes |
Job belongs to <user>
Job owner's username <is / is not / contains / does not contain / matches / does not match / starts with / ends with> <text> | Triggers:
| |
Job belongs to user from <cost center>
Job owner's cost center number <equal to / not equal to / greater than / lesser than / greater or equal to / lesser than or equal to> <number> | Triggers:
| |
Job is printed on <device> Job is printed on device whose name <is / is not / contains / does not contain / matches / does not match / starts with / ends with> <text> | Triggers:
| |
Job is printed on printer with type | Triggers:
| At least one type needs to be specified (Devices > Tools > Printer types), otherwise this condition is disabled. |
Job is printed on device from <group/ORS> | Triggers:
| At least one group must be specified (Devices -> Items -> Add new group), otherwise this condition is disabled. |
Job title <is / is not / contains / does not contain / matches / does not match / starts with / ends with> <text> | Triggers:
| Text can be in the form of a regular expression to detect various patterns. |
Job has been sent to named queue <is / is not / contains / does not contain / matches / does not match / starts with / ends with> <queue_name> | Triggers:
| Text can be in the form of a regular expression to detect various patterns. |
Job has been sent to queue type <direct / secured / shared> | Triggers:
| |
Job <has / has not> set a <system tag> | Triggers:
| Setting a system tag (using the "Mark job with tag" action) in one rule doesn't affect other rules because all conditions are evaluated at the beginning. |
Job <has / has not> set a <user tag> | Triggers:
| Setting a user tag (using the "Mark job with tag" action) in one rule doesn't affect other rules because all conditions are evaluated at the beginning. |
Job file size <equal to / not equal to / greater than / lesser than / greater or equal to / lesser than or equal to> <number> <B / KB / MB / GB / TB> | Triggers:
| |
Job has <status> | Triggers:
| Only notification can be executed on this condition. |
Job page conditions | Supported triggers | Notes |
If Job contains <more than, equal to, less than, between> <x> [<all,b/w,color>] pages [with paper size <large, small>] | The rule requires enabled job parser. | |
User status conditions | Supported triggers | Notes |
Total amount of <all pages per month / BW pages per year / etc.> by job owner is <equal to / not equal to / greater than / less than / greater or equal to / less than or equal to> <number>. | Triggers:
| This rule requires the following property to be enabled: displayPrintedPagesPricesOnTerminal Per year/month in this condition means pages in a current calendar year or current month. E.g. from 1. January until today in case of the year condition or from 1. August until today in case it's August and month condition is selected. The condition works with the statistical data:
The amount of pages is not refreshed instantly, therefore the condition is suitable for a soft notification. But to limit user from printing beyond a specific limit, a Quota system needs to be used. |
Outcome of authentication on terminal <equal to / not equal to> success | Triggers:
| |
User authenticates at device group <group> | Triggers:
| Applicable to device groups and subgroups; if group selected, will be applied to all subgroups as well. |
User authenticates at Spooler Controller group <group> | Triggers:
| Applicable to Spooler Controller groups; will be aplied to all belonging SPOCs. Rules with this condition that were created prior to updating to build 66 or higher need to be recreated, the old ones will not work as expected. |
User is not a member of the role <role> | Triggers:
| Rules with this condition that were created before release 6.0.69 need to be recreated, the old ones will not work as expected. |
User is a member of the role <role> | Triggers:
| |
Time conditions | Supported triggers | Notes |
Current <day of week / day of month> is <equal to / not equal to / greater than / lesser than / greater or equal to / lesser than or equal to> <day in week / day in month> | Triggers:
| |
Current time is <equal to / not equal to / greater than / lesser than / greater or equal to / lesser than or equal to> <time> | Triggers:
|
Actions
Transform Job Operations | Supported Triggers | Notes |
Add watermark <text> to each page. Add it to <position> of the page, rotate it by <number>° and use font with <size> and <color> | Triggers:
| The watermark will be always in a predefined position. Printing in landscape mode will not change the watermark's position or rotation. Watermarking feature is available for PCL and PostScript jobs only. Only ISO Latin-1 and Latin-2 character sets are supported. Variables can be used, see below for their definition. |
Find <text> in PJL header and replace it with <text> (<Append/Do not append> the text when searched text is not found) | Triggers:
| When a match is found, whole line is replaced. Be sure to specify the pattern and the new value in the following format: "@PJL SET <HEADER>=<VALUE>" |
<Convert / Do not convert> job to gray scale | Triggers:
| |
<Convert / Do not convert> job to duplex | Triggers:
| |
<Convert / Do not convert> job to simplex | Triggers:
| |
Print job <number> times | Triggers:
| |
Mark job with <tag> | Triggers:
| This action will not affect the evaluation of tag conditions in subsequent rules because all conditions are evaluated before any rules are executed. |
Change processing workflow | Supported triggers | Notes |
Re-queue the job to <queue> | Triggers:
| A direct queue can be selected from a list of existing direct queues. Alternatively, a direct or shared queue name can be typed manually. In that case, variables can be used in the queue name (see below). |
Redirect the job to the secure queue | Triggers:
| Used for redirecting the job from a direct (or shared) queue to the secure queue, so that it is held by the server and not printed immediately. |
Reject print job | Triggers:
| |
Delete print job | Triggers:
| |
Deny authentication on terminal | Triggers:
| User authentication is denied (after successful authentication). |
Change job title to <text> | Triggers:
| Variables may be used in the text (see below). |
Change job owner to <user> | Triggers:
| |
Change job billing code to <billing code> | Triggers:
| |
Set job as <favorite / not favorite> | Triggers:
|
Notifications
General Notification Information | Supported triggers | Notes |
Send e-mail with <subject> and content of <text> to job owner | Triggers:
| Variables can be used, see below for their definition. |
Send e-mail with <subject> and content of <text> to <user> | Triggers:
| Variables can be used, see below for their definition. |
Run external <script> | Triggers:
| Executes any application, optionally passing some information as parameters. Example of input: C:\script.bat [USER_EMAIL] [JOB_STATUS] (This will execute a script.bat located on a C drive with 2 parameters). Variables can be used, see below for their definition. |
Variables
Some variables are not available for some triggers.
Variable | Description |
[DEVICE_ID] | Internal YSoft SafeQ Management Service unique ID of the involved device (printer, mfp) |
[DEVICE_IP] | IP Address of the device |
[DEVICE_NAME] | Device Name as configured in YSoft SafeQ Management Service |
[DEVICE_DESCRIPTION] | Device Description as configured in YSoft SafeQ Management Service |
[DEVICE_LOCATION] | Device Location as configured in YSoft SafeQ Management Service |
[DEVICE_EQUIPMENT_ID] | Device Equipment ID as configured in YSoft SafeQ Management Service |
[DEVICE_SERVICE_AGREEMENT_ID] | Device Service Agreement ID as configured in YSoft SafeQ Management Service |
[DEVICE_CONTACT_PERSON] | Device Contact Person as configured in YSoft SafeQ Management Service |
[DEVICE_ZIP_CODE] | Device ZIP Code as configured in YSoft SafeQ Management Service |
[DEVICE_BACKEND] | Data Delivery Method as configured in YSoft SafeQ Management Service (e.g., TCP/IP Raw, LPR, IPP) |
[DEVICE_SPOC_GUID] | GUID of the Spooler Controller managing the device |
[DEVICE_SPOC_NAME] | Name of the Spooler Controller managing the device |
[USER] | Owner of the job in the format "Name Surname (login)" |
[USER_NAME] | User's first name from the Identity Database |
[USER_SURNAME] | User's surname from the Identity Database |
[USER_LOGIN] | User's login from the Identity Database |
[USER_EMAIL] | User's email address from the Identity Database |
[USER_HOME_DIR] | User's home directory from the Identity Database |
[USER_NOTE] | User's note from the Identity Database |
[USER_OU_NUM] | User's cost center number from the Identity Database |
[USER_ID] | Internal YSoft SafeQ Management Service unique ID of the user from the Identity Database |
[JOB_ID] | Internal YSoft SafeQ Management Service job unique ID (not available during job reception) |
[JOB_GUID] | Internal YSoft SafeQ Management Service job GUID (part of the filename in the JobStore folder in the spooler) |
[JOB_TITLE] | Job Title |
[JOB_SIZE] | Size of the print job (formatted for readability) |
[JOB_SIZE_RAW] | Size of the print job (plain number in bytes for machine readability) |
[JOB_PROJECT_ID] | Internal ID in YSoft SafeQ Management Service of the billing code selected for the job |
[JOB_QUEUE] | Target print queue name |
[JOB_STATUS] | Current job status |
[JOB_STATUS_NUM] | Current job status as a numeric identifier |
[JOB_NOTE] | Internal note generated by system |
[JOB_ORIGIN] | IP address or hostname from where the job was received |
[JOB_SPOOLER_HOSTNAME] | Hostname of the spooler that received the job |
[JOB_SPOOLER_GUID] | GUID of the spooler that received the job |
[JOB_SPOC_GUID] | GUID of the Spooler Controller that received the metadata of the job |
[JOB_PAGES_BW] | Number of black and white pages in the job |
[JOB_PAGES_COL] | Number of color pages in the job |
[JOB_PAGES_BW_LARGE] | Number of large-format black and white pages in the job |
[JOB_PAGES_COL_LARGE] | Number of large-format color pages in the job |
[JOB_PAGES_LARGE] | Number of large-format pages in the job |
[OP_DATE] | Current date and time |
[DATE] | Current date |
[TIME] | Current time |
The Send e-mail notification sends message in plain text. Microsoft Outlook by default removes line breaks in plain text e-mails. If this issue occurs in your environment, disable the Remove extra line breaks in plain text message options in Microsoft Outlook: