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 publish resources to the server resource tree or when you advanced run or schedule a report.

When applying an archive policy, you can choose whether to use multiple versions for a resource or always use the new version to replace the old one.

Archive as New Version

Specifies to use multiple versions for the specified resource.

Maximum Number of Versions
Specifies the maximum number of versions that will be listed in the version table of the resource. The default value is 0, which means that the version number is unlimited.

Replace Old Version

Specifies to replace the old version when a new version is generated.

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 when publishing resource	In the publish resource dialog (for how to access the dialog, see Publishing resources): If the resource is to be published to the My Reports or Public Reports folder, set the Apply Archive Policy option as required. If the resource is to be published to the My Components or Public Components folder, set the Maximum Number of Versions option as required.	The archive policy is applied to the resource. Note: A folder by itself does not have versions; the archive policy specified for a folder applies to the folder content.
Apply archive policy to a folder	Access the Properties dialog for the folder (for how to access the dialog, see Changing resource and folder properties). In the dialog, For folder in the My Reports or Public Reports folder (including the root folder itself), set the Apply Archive Policy option as required, then click OK. For folder in the My Components or Public Components folder (including the root folder itself), set the Maximum Number of Versions 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	Access the Properties dialog for the resource (for how to access the dialog, see Changing resource and folder properties). In the dialog, For resource in the My Reports or Public Reports folder, set the Apply Archive Policy option as required, then click OK. For resource in the My Components or Public Components folder, set the Maximum Number of Versions option as required, then click OK.	The archive policy is applied to the resource, overriding its inherited archive policy. Note: If you leave the archive policy unspecified, 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	On the JReport Console > Resources page, browse to the resource you want to run. Put the mouse pointer over the resource row and click the Advanced Run button on the floating toolbar. In the Archive tab, check the Auto Archive Properties option. Finish the other relevant information, making sure that Archive Location is set to the resource tree folder. 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	On the JReport Console > Resources page, browse to the resource you want to schedule. Put the mouse pointer over the resource row and click the Schedule button on the floating toolbar. In the Publish tab, click the To Version sub tab, then check the Publish to Versioning System option. Finish the other relevant information, making sure that Archive Location is set to the resource tree folder. 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	Access the version table for the resource (report type) (for how to access the table, see Browsing versions). 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	On the JReport Console > Resources page, browse to the resource you want to run. Put the mouse pointer over the resource row and click the Advanced Run button on the floating toolbar. In the Archive tab, check the Auto Archive Properties option. Finish the other relevant information, making sure that Archive Location is set to the Built-in Version Folder. Set the Apply Archive Policy option as required, then click Finish.
Apply archive policy when scheduling a task	On the JReport Console > Resources page, browse to the resource you want to schedule. Put the mouse pointer over the resource row and click the Schedule button on the floating toolbar. In the Publish tab, click the To Version sub tab, then check the Publish to Versioning System option. Finish the other relevant information, making sure that Archive Location is set to Built-in Version Folder. Set the Apply Archive Policy option as required, then click Finish.