This object is used to specify the output destination of a scheduled job. If you do not specify a destination, then when you schedule a report, the report instances will be saved on the File Repository Server (FRS).

Four types of destinations are supported by Crystal Enterprise:

• FTP

  The instance can be copied to a server using FTP.

• SMTP

  The instance can be emailed to a person.

• DiskUnmanaged

  The instance can be copied to the local disk or somewhere on the network.

• Printer

  The instance can be printed to a local or network printer.

FTP, SMTP, and DiskUnmanaged are generic destinations that can be used with other object types. However, Printer is a report specific destination and can be used only with report objects. While FTP, SMTP, and DiskUnmanaged scheduling options are provided through the SchedulingInfo object when you schedule a report, the Printer options are set using the Report object.

The options for each destination, with the exception of the printer, are provided through the appropriate destination plugin. Each plugin must be installed with the PluginManager and enabled through the Job ServerDestination Object or the Crystal Management Console's Job Server properties. Printer options are set with the Report plugin instead of a destination plugin.

As well as providing a way to enable each destination plugin, the Job ServerDestination Object allows you to retrieve the destination plugin and set the global options for that particular Job Server. These are the Job Server's default destination settings. When you set the destination for a particular report, you can keep the Job Server's defaults, or you can specify scheduling options for the plugin. If scheduling options are specified, then these settings will override the Job Server's global options. Once the plugin's properties are specified, they can be set on the object being scheduled using the SetFromPlugin Method.

Properties

Property	Description
Empty Property	Returns True if the destination properties are empty for the report, except for the destination name, and False otherwise.
Name Property	The name of the destination.

Methods

Method	Description
Clear Method	Clears all of the destination's properties, except for the destination name.
CopyToPlugin Method	Copies destination properties to the destination plugin.
SetFromPlugin Method	Sets destination properties from the destination plugin to the Destination object.