Applying an archive policy

JReport Server uses an archive policy to control resource versions. The archive policy can be applied to a single resource individually or to many resources in a folder as a whole. It can also be applied when you run (Advanced Mode) or schedule a report.

The archive policy includes settings for controlling the use of multiple versions for a specified resource, and the maximum version amount that will be listed in the version table:

If there is no archive policy specified for a resource, the resource will inherit the archive policy from its parent object. If afterwards you then specify an archive policy for the resource, the new policy will override the one inherited from the parent object.

Applying an archive policy to resources in the resource tree

To apply an archive policy to a resource in the resource tree, refer to the table below:

If you want to Then do Result
Apply archive policy to a folder
  1. Access the Properties dialog for the folder (for how to access the dialog, see Changing resource and folder properties).
  2. In the dialog, set the Apply Archive Policy option as required, then click OK.
 The archive policy will be applied to all of the folder content.

Note: This does not include resources that already have individually applied archive policies.
Apply archive policy to a resource
  1. Access the Properties dialog for the resource.
  2. In the Properties dialog, set the Apply Archive Policy option as required, then click OK.
 The archive policy is applied to the resource, overriding its inherited archive policy.

Note: If you leave the Apply Archive Policy option unchecked, the resource will inherit the archive policy from its parent object, for example, the folder it resides in.
Apply archive policy when running a task in Advanced mode
  1. On the JReport Console > Resources page, browse to the resource you want to run.
  2. Put the mouse pointer over the resource row and click the Advanced Run button on the floating toolbar.
  3. In the Archive tab, check the Auto Archive Properties option.
  4. Finish the other relevant information, making sure that Archive Location is set to the resource tree folder.
  5. Set the Apply Archive Policy option as required, and then click Finish.
 The archive policy will be applied to a result type resource.

Note: If you leave the Apply Archive Policy option unchecked, the resource will use its old archive policy or inherit the archive policy from its parent object, for example, the folder it resides in.
Apply archive policy when scheduling a task
  1. On the JReport Console > Resources page, browse to the resource you want to schedule.
  2. Put the mouse pointer over the resource row and click the Schedule button on the floating toolbar.
  3. In the Publish tab, click the To Version sub tab, then check the Publish to Versioning System option.
  4. Finish the other relevant information, making sure that Archive Location is set to the resource tree folder.
  5. Set the Apply Archive Policy option as required, then click Finish.
 The archive policy is applied to a result type resource.

Note: If you leave the Apply Archive Policy option unchecked, the resource will use its old archive policy or inherit the archive policy from its parent object, for example, the folder it resides in.

Applying an archive policy to the built-in version table

The above table applies to the resource in the resource tree only. The versions in the built-in version folder are controlled by its own archive policy.

To apply an archive policy to the built-in version table, refer to the table below:

If you want to Then do
Apply archive policy to a built-in version table
  1. Access the version table for the resource (report type) (for how to access the table, see Browsing versions).
  2. In the Report Result Versions tab, check the Maximum Number of Versions option, specify the versions to be saved as required, then click OK.
Apply archive policy when running a task in Advanced mode
  1. On the JReport Console > Resources page, browse to the resource you want to run.
  2. Put the mouse pointer over the resource row and click the Advanced Run button on the floating toolbar.
  3. In the Archive tab, check the Auto Archive Properties option.
  4. Finish the other relevant information, making sure that Archive Location is set to the Built-in Version Folder.
  5. Set the Apply Archive Policy option as required, then click Finish.
Apply archive policy when scheduling a task
  1. On the JReport Console > Resources page, browse to the resource you want to schedule.
  2. Put the mouse pointer over the resource row and click the Schedule button on the floating toolbar.
  3. In the Publish tab, click the To Version sub tab, then check the Publish to Versioning System option.
  4. Finish the other relevant information, making sure that Archive Location is set to Built-in Version Folder.
  5. Set the Apply Archive Policy option as required, then click Finish.