Exceptions are conditions or results (such as a threshold being reached) requiring intervention. Exceptions cause corresponding indicators on a subscribing users Exceptions Dashboard to change, or a notification to be sent to users who have subscribed.
The exceptions dashboard is an optional content window used to monitor exceptions, it displays on Personal Pages. Each indicator represents one exception-capable job or items manually flagged as an exception.
Use exceptions with jobs or items:
Using monitored exceptions with jobs:
Programmatically enable monitored exceptions on jobs. The exception is set when certain conditions or thresholds are met. Job exceptions are generated by Production Reporting jobs, Interactive Reporting jobs, or generic jobs. See Configuring Exceptions.
Subscribe to jobs and choose to be notified by email when the exception occurs.
Place jobs on the Exceptions Dashboard and view its exception status. For each job you add to the Exceptions Dashboard, a green traffic light icon is displayed. If the job generates an exception, the traffic light changes to red. Using the Exceptions Dashboard.
Manually set exception status for items. See Configuring Exceptions.
Subscribe to items and choose to be notified by email when the exception occurs.
You can place items on the Exceptions Dashboard and view its exception status. For each item you add to the Exceptions Dashboard, a red traffic light icon is displayed. Items cannot be added to the exception dashboard unless the exception status is set. See Using the Exceptions Dashboard.
You have only one Exceptions Dashboard, even if you put it on multiple Personal Pages. If you modify the Exceptions Dashboard on one Personal Page, it changes on all of your Personal Pages that include it.
Configure exceptions for jobs and items with version properties. There are two ways to configure exceptions:
To programmatically enable a job with monitored exceptions capability:
Design the Production Reporting job (*.sqr) or generic jobs to write exceptions to the output.properties file. See Supporting Exceptions in Production Reporting or Generic Programs.
Design the generic job, to write exceptions to the output.properties file. Supporting Exceptions in Production Reporting or Generic Programs.
Design the Interactive Reporting job to write exceptions. See Supporting Exceptions in Interactive Reporting Programs.
To set exception status for items manually, from Explore, set the property Flag as an Exception for the latest version of the item. See Version Properties.
The exceptions dashboard shows a traffic light indicator for each job or item you place on it. The traffic light indicator changes to indicate if an exception occurred (red) or did not occur (green).
To use the Exceptions Dashboard with jobs:
Select Explore, navigate to the job whose exception you want to monitor, right-click the job, and click Properties.
From Advanced, select If exceptions are generated, allow users to add to their Exceptions Dashboard, and click OK.
Select Explore, navigate to the job, right-click the job, and click Subscribe.
On Personal Pages tab, select Add to Exceptions Dashboard.
If this option is not on the Subscribe Settings page, the file cannot be monitored for exceptions.
A traffic light is added to the exceptions dashboard. The traffic light indicator is green. If the job is run and generates an exception, then the traffic light indicator changes to red.
To use Exceptions Dashboard with items:
Select Explore, and navigate to the item that has an exception you want to monitor.
From Advanced, select If exceptions are generated, allow users to add to their Exceptions Dashboard.
From Versions, set the property Flag as an Exception for the latest version of the item and click OK.
Right-click the item, and from the shortcut menu, select Subscribe.
On Subscribe Settings, select Add to Exceptions Dashboard.
If this option is not on the Subscribe Settings page, this file cannot be monitored for exceptions.
A red traffic light is added to the exceptions dashboard, to indicate that an exception is set for this item.
To customize Exceptions Dashboard:
To not show green lights, and have red lights displayed when an exception occurs, enable the Only display links to artifacts that have exceptions.
When exceptions occur and you want to see its exception text explanatory message next to its red light, select Display exception messages next to graphic indicators.
