Jump to content
We've recently updated our Privacy Statement, available here ×
  • This documentation is an older version of JasperReports Server Community Project Administrator Guide. View the latest documentation.

    Administrators and users with the proper permissions can create, modify, move, and delete folders and resources in the repository. The specific roles and permissions of the user determine the actions available. For the definition of the permissions on folders and resources, see Repository Permissions.

    One responsibility of an administrator is to set up an environment for users to create and save dashboards, Ad Hoc views, and reports. That usually means creating a folder structure where users have write permission. Users with write permission can also create their own sub-folders to store their reports and dashboards.

    Only administrators can create data sources in the repository. So, although users with write permission can upload JRXML files and define resources, they can't run their reports without data sources. For this reason, we recommend that administrators create data sources and other shared resources in the repository. For example, uploading one shared logo file and keeping it up to date is better than many users uploading and maintaining their own separate logo files.

    Resource IDs

    Each resource, including each folder, has an ID, a name, and an optional description:

    The ID is used internally to reference a resource. The ID must be unique within its folder, but may exist in multiple folders.
    The resource name is displayed in the repository.
    The description, if defined, appears in the repository and in tooltips.

    As in a file system, the IDs of nested folders define the path to a resource. For example, the path to a report might be: /reports/samples/Freight.

    To view the name and resource ID of a resource, Right click the folder's name or the resource in the repository or search results and select Properties... from the context menu.


    Resource Properties Dialog for a Writable Resource

    If you have write or administer permission as shown in the figure, you can also edit the name and description of the resource. For some operations such as export, you need the path, also called repository URI, which you can copy from this dialog.

    Creating Folders

    Any user with write permission on a folder can create new sub-folders.

    To create a folder:

    1. Log on as a user who has write permission to the parent folder.
    2. Select View > Repository and locate the parent folder in the Folders panel.
    3. Right-click the parent folder and select Add Folder from the context menu. The Add Folder dialog appears.

    Add Folder Dialog


    4. Enter the folder name and, optionally, a description, then click Add.

    The folder is created in the repository. The name appears in the hierarchy of folders. The description is visible only when viewing the properties of the folder, as shown in “Resource Properties Dialog for a Writable Resource”.

    New folders and their future contents inherit the permissions of their parent folders. Users with Administrator permissions can change permissions folders, as described in Setting Permissions.

    Adding Resources

    Each resource has different requirements, for example some are created from uploaded files, others are created by defining values in a wizard. The procedures for adding each type are available in the documentation below:

    JasperReports are covered in the JasperReports Server User Guide.
    Mondrian and OLAP resources are covered in the Jaspersoft® OLAP Community Project User Guide.
    Data sources are explained in the chapter Data Sources.
    Queries, data types, lists of values, input controls, and file resources are explained in the chapter Other Resources in the Repository

    Most resources are created through the Add Resource menu item on the context menu for folders in the repository. In the following figure, you can see the full menu and submenu with all the resources administrators can create:


    Add Resource Context Menu Expanded

    For every resource you create, you must specify a name and resource ID for referencing the resource in the repository. Each wizard also has one or more pages for specifying the values and controls specific to the resource.


    New resources inherit the permissions of the folder in which they are created. Administrators can change the permissions on the new resource, as described in section Setting Permissions.

    Renaming Folders and Resources

    Any user with write permission on a folder or resource can change its name and description.

    To rename a folder or resource:

    1. Log on as a user who has write permission for the folder or resource.
    2. In the repository, browse or search for the resource. For renaming folders, select View > Repository and locate the folder.
    3. Right-click the object and select Properties... from the context menu. The Properties dialog appears.


    Properties Dialog for a Report Resource

    You can change the folder or resource's name and description, but not the ID; the ID is permanent once the resource is created.

    4. Click Submit to save your changes.

    Copying and Moving

    The repository interface lets any user with the proper permission copy or move both resources and folders. Copying requires read permission on the source, moving requires delete permission on the source, and both require write permission on the destination folder.

    You can drag-and-drop the objects, or you can copy-paste or cut-and-paste them from their context menus. Folders must be moved one at a time, but multiple resources from the same folder can be copied or moved together.

    Copying and moving actions are not possible on the search interface, only on the repository interface showing the list of folders. Currently, it's not possible to create a copy of a resource in the same folder.


    The moved objects inherit their permissions from the destination folder; they do not keep the permissions they had before the move. If you want the objects to have other permissions, you can set new permissions after the move (see Repository Permissions).

    To copy or moving folders and resources:

    1. Log on as a user who has the required permissions for the folder or resource.
    2. Click View > Repository, and expand the folders to display the object to be copied or moved.
    3. Right-click the resource and select Copy or Cut (delete permission is required to cut a resource).

    You can select multiple resources with Control-click or Shift-click, but only a single folder.

    4. Right-click the destination folder and select Paste in the context menu (write permission is required on the destination folder).

    Alternatively, you can drag to move the selected resource or folder to the destination folder. To copy, press and hold the Ctrl key then click and drag. When dragging resources, the destination folder is highlighted in blue if you have write permission to it.

    Editing Resources

    The procedure for editing a resource depends on the resource type. All of the dialogs are available by right-clicking on the resource in the repository and selecting the proper action from the context menu. In nearly all cases, the dialog for editing is the same one that was used to create the resource.

    Editing Resources

    Resource Type

    How to Edit


    To change the layout of an interactive report, users may Run the report, then change the column filters or sorting. Users may save the report, either by overwriting the original or as a new copy, depending on their permissions.

    To change the definition of a report, right-click the report resource and select Edit. Then you can change the data source, input controls, or file resources referenced in the JasperReport. For more information, see JasperReport Structure.

    Content Resource

    A content resource is report output that is stored as a file stored in the repository. These files cannot be edited, only downloaded or deleted.

    Data Source

    Administrators only: right-click the data source, then select Edit from the context menu. For more information, see Data Sources.


    Right-click the resource, then select Edit from the context menu on these resources. You edit these resources in the same dialog you used to create them. For more information, see Other Resources in the Repository.

    Input Control


    List of Values


    When editing a resource, you have several limitations:

    You can't change a resource's ID. If you need to change an ID, you have to create a new resource and delete the old one.
    You can't change the location of a resource. To change the location of the resource, see Copying and Moving.
    For file resources, you can't see the name of the file that was uploaded, nor in most cases download and view the contents of the file. Your only option is to upload a new file to replace the old one.

    Deleting Folders and Resources

    Users with delete permission on folders or resources can delete those objects from the repository. To delete a folder, you also need delete permissions on all the resources and folders in that folder. Folders must be deleted one at a time, but multiple resources can be deleted together.


    You can't undo a delete.

    The repository won't allow you to delete resources currently referenced by other resources. For example, an input type used by a report cannot be deleted as long as the report still references them.

    To find the resources that reference the one you want to delete, you need to look at each report that you suspect of referencing it. When you edit the definition of a JasperReport, you can see the resources it references. Then you can either remove the reference from the resource or delete the entire resource containing the reference.

    To delete a folder or resource:

    1. Log on as a user who has delete permission for the folder or resource.
    2. In the repository, browse or search for the object to be deleted.
    3. Right-click the object and click Delete in the context menu.

    In the repository view, you can select multiple resources and click Delete in the tool bar or in the context menu. In the list of folders, you can delete only one folder at a time, but all contents of that folder will be deleted. In the search results, you can select multiple resources and right-click to select Delete in the context menu.

    User Feedback

    Recommended Comments

    There are no comments to display.

    This is now closed for further comments

  • Create New...