You can set scheduling options that automatically send notification when an object instance succeeds or fails. You can send notification using audit or email notification. You can also combine multiple notification methods, and provide different notification settings for successful and failed instances.
For example, you may have a large number of reports that run a new instance every day. You need to check each instance to make sure it ran properly, and then send out emails to the users who need to know that the new report is available. With thousands of reports, it would take too much time to manually check the reports and contact the users who need the information. Using notification settings in Crystal Enterprise, you can set each object to automatically notify you when the report fails to run properly, and you can automatically inform users when new report instances run successfully.
When you schedule an object, the scheduled instance either succeeds or fails. The conditions required for an instance's success or failure depend on the type of object you schedule:
A report instance runs successfully if it doesn't encounter any errors while processing the report or accessing the database. A report instance may fail if the user does not provide the correct parameters or logon information.
For program objects, the program must run in order to succeed. If the program does not run, the instance is considered a failure. If the program runs, but does not perform the tasks it is supposed to, it is still considered a successful instance because the program object ran. Crystal Enterprise does not monitor problems with the program object's code.
An object package may fail if one of its components fails. To change this setting, click the object package's Properties tab and clear the "Scheduled package fails upon individual component failure" option.
You can also set scheduling options for individual objects within an object package.
Note: You cannot set audit or email notification for object packages, but you can set any type of notification for the individual objects in the object package. You can also schedule object packages with events on the Schedule tab. For more information about events, see Schedule
You can set notification at the object level, and you can apply it to all objects that can be scheduled in Crystal Enterprise. You can select unique notification options for each object, sending different types of notification for different conditions. For object packages, you can set only event notification, which will trigger an event based on success or failure of the object package. To monitor object successes and failures from a more general perspective, use the auditing functionality within Crystal Enterprise.
If notification fails, then the object instance fails. For example, if an email notification sends a message to an invalid email address, then the notification fails and the object instance is recorded as a failure in the object's history.
You can choose to notify using:
To use audit notification, you must configure the auditing database and enable auditing for the servers. If you use auditing to monitor your Crystal Enterprise system, you can use audit notification. For more information about configuring the auditing database and enabling auditing, see Managing Auditing.
When you select audit notification, information about the scheduled object is written to the auditing database. You can choose to have a notification sent to the auditing database when the job runs successfully, when it fails to run, or both.
Note: For the Crystal Report Server and the Crystal Program Server, you can also set audit notification on the Auditing tab.
You can send an email as a notification of an object instance's success or failure. You can choose the sender and recipients of the email message. You can send an email when the instance fails and when it succeeds. For example, you could send your administrator an email if the report fails, but when the report succeeds you can automatically send a notification to everyone who needs the report to let them know it is now available.
Note: For information on changing the Crystal Job Server's default email, see Setting the default email (SMTP) destination.
You can choose a Crystal Enterprise event that will be triggered based on the completion of the object instance. For more information about events, see Schedule
Note: Notification of a scheduled object's success or failure is not the same as alert notification. Alert notification must be built into the design of the report. For example, alert notification can send an email to you whenever a specific value in the report exceeds $1000000. In this case, the notification has nothing to do with the contents of the report - it's just about whether or not the report object instance has failed or succeeded.
Note: If the notification type is already being used, it will be labelled "Enabled". If not, it will be labelled "Not in use".
To send a record to the auditing database when the job succeeds, select "A job has been run successfully."
To send a record when the job fails, select "A job has failed to run."
Choose whether you want to send a notification when the job fails or when it succeeds.
To specify the contents and recipients of the email notification, select "Set the vales to be used here" and provide the From and To email addresses, the email subject line, and the message.
Note: By default, the notification is sent to the server's default email destination. For details on how to change the default email settings, see Setting the default email (SMTP) destination.
| Crystal Decisions http://www.crystaldecisions.com/ Support services http://support.crystaldecisions.com/ |