Managing Resources
Logi JReport Server provides a resource system for managing a group of archive versions that can be processed or organized. Generally, a resource in the Logi JReport Server reporting system is a conceptual node. It refers to report related material. There are different types of resources, such as catalogs, reports, library components, dashboards and analysis templates.
Logi JReport Server resource tree
Resources on Logi JReport Server are organized into a folder-tree structure called the resource tree. Only the resources that are organized in the resource tree can be accessed and queried by a client. Logi JReport Server defines an XML file called admin.xml, and the resource tree conforms to this file. This file is maintained automatically by Logi JReport Server.
The following diagram shows the structure of the server resource tree.
The resource tree consists of the following three layers:
- Folder layer: Basic resource tree element that builds the main framework for the resource tree. Logi JReport Server has built-in folders in the root of the resource tree - My Components, Public Components, My Reports, Public Reports and My Shared. For organization users, there are two additional built-in folders, Organization Components and Organization Reports. A folder can be mapped to a real file path.
Public Reports, Organization Reports and My Reports are built-in folders in the resource tree root for storing resources such as reports, dashboards and analysis templates. You can create your own folders in any of them. The Public Reports folder contains public resources, and can be accessed by everyone. The Organization Reports folder is a public folder to organization users. The My Reports folder is a personal folder. It contains personal resources that can be accessed by its owner only. Each user has one personal folder, specified by the administrator when the user account is created. A user has full control over his/her personal folder and it is the default output location for resources run by the user.
Public Components, Organization Components and My Components are built-in folders in the resource tree root for storing library components. Their behaviors resemble the Public Reports, Organization Reports and My Reports folders. However within the three folders and their sub folders only one catalog file can be stored.
My Shared is a built-in folder in the resource tree root for managing personal web reports that are shared.
- Resource layer: An abstract layer, based on the folder layer that hosts various types of archive versions and provides user access to the versions. In the Logi JReport Server resource tree, there are the following resource types:
- Catalogs
A catalog stores all of the object definitions that are created while developing reports and library components, which include data source definitions, component customizations, style definitions, and more. Every report and library component must exist within the context of a catalog. - Reports
There are two types of reports in Logi JReport: page reports and web reports. A page report is a collection of report tabs and each report tab can have multiple pages. A web report is always displayed as a web layout report with just one page in a browser but can be printed with multiple pages. Logi JReport Server supports running, advanced running and scheduling of reports. - Results
When advanced running or scheduling a report to publish to the versioning system, you can choose an archive location to generate the report result. You can generate the report result in the built-in version folder, or in the resource tree. The report results generated in the resource tree are standalone results while those generated in the built-in version folder can only be bound with their respective reports. Library components
Library components are used to build dashboards in JDashboard. They are able to present data via intuitive components such as charts, crosstabs, tables, and geographic maps. Library components are created and edited using Logi JReport Designer, and then are published to the component library on Logi JReport Server for use in dashboards.Dashboards
Dashboards created in JDashboard allow you to see the big picture by comparing charts, tables, and other components side-by-side.- Analysis templates
Analysis templates are the data status saved via Visual Analysis.
- Catalogs
- Archive layer: A physical file layer, where the archive versions reside for executable resources, which function as the leaves of the resource tree. By default these archive version files are stored in the
<install_root>\history
folder. The structure of the resource tree is stored in the Logi JReport Server DBMS but only as pointers to the physical files located in the history folder. For more information, see Managing Versions.
This section details the following resource topics:
- Publishing Resources
- Converting Resources of Earlier Versions Into Current Version
- Getting and Using Resources From a Real Path
- Customizing TTF Font Location for Resources
- Working With Custom Fields
- Changing Resource Properties
- Linking Resources and Catalogs
- Sharing Reports
- Managing Dynamic Display Names of Business View Elements
- Deleting Resources
In addition to the above tasks that you can perform when managing resources, you can also secure your resources by granting users different permissions.
Tips:
- In the Resources page of the Logi JReport Server console, you can use the Search box to easily locate any resources including reports, catalogs, library components, dashboards and folders in the server resource tree. To do this, browse to the desired folder in the server resource tree, then in the Search box type in the text you want to search for and the resources containing the matched text will be listed. Logi JReport Server searches in the Name and Description columns of the Resources page. After entering text in the Search box, you can select that appears in the box to specify the following search options: Highlight All, Match Case and Match Whole Word. To cancel the search operation, clear the text or select .
- The order and view mode in which the resources in the Resources page of the Logi JReport Server console can be customized. To do this, put the mouse over the corresponding button on the right of the Search box and select the required order or view mode from the drop-down menu.
By default, catalogs are not displayed in the server resource tree for non-admin users. To make them shown for all users, the property web.page.option.show_catalog in the server.properties file located in
<install_root>\bin
should be set to true.