A program object is an object in Crystal Enterprise that represents an application. Publishing a program object to Crystal Enterprise allows you to use Crystal Enterprise to schedule and run the program object and to manage user rights in relation to the program object. For information about publishing program objects, see Publishing overview.
When you publish a program object or its associated files to Crystal Enterprise, they are stored in the File Repository Server (FRS). Each time a Crystal Enterprise program runs, the program and files are passed to the Program Job Server, and Crystal Enterprise creates a program instance. Unlike report instances, which you can view in their completed format, program instances exist as records in the object history. Crystal Enterprise stores the program's standard out and standard error in a text output file. This file appears when you click a program instance in the object History.
Three types of applications can be published to Crystal Enterprise as program objects:
Executable programs are binary files, batch files, or shell scripts. They generally have file extensions such as: .com, .exe, .bat, .sh. You can publish any executable program that can be run from the command line on the machine that runs the Program Job Server.
You can publish any Java program to Crystal Enterprise as a Java program object. For Java program objects to have access to Java SDK objects, your class must implement the IProgramBase interface from the Crystal Enterprise Java SDK (com.crystaldecisions.sdk.plugin.desktop.program.IProgramBase). For details, see the Crystal Enterprise Java SDK Guide.
Script program objects are JScript and VBScript scripts. They are run on Windows using an embedded COM object and can—once published—reference the Crystal Enterprise SDK objects. For details, see the Crystal Enterprise COM SDK Guide.
Note: As the administrator, you can choose to enable or disable any of the types of program objects. For details, see Authentication and program objects.
Once you have published a program object to Crystal Enterprise, you can configure it in the Objects management area of the CMC. For each type of program object (Executable, Java, or Script) you can choose to specify command
Tip: Program objects allow you to write, publish, and schedule scripts or Java programs that run against Crystal Enterprise, and perform maintenance tasks, such as deleting instances from the history. Furthermore, you can design these scripts and Java programs to access Crystal Enterprise session information. This ensures that the scheduled program objects retain the security rights or restrictions of the user who scheduled the job. (Your scripts or java programs require access to the Crystal Enterprise SDK. For details, see the Crystal Enterprise COM SDK Guide or the Crystal Enterprise Java SDK Guide.)
Click the appropriate link to jump to that section:
| Crystal Decisions http://www.crystaldecisions.com/ Support services http://support.crystaldecisions.com/ |