Locking Queries

Normally in Logi JReport Designer, queries are free to be shared among reports, which could increase the potential risk of being changed unexpectedly. When a query is shared by more than one report, it can be changed by any of those reports, which means you must be very careful to avoid causing impacts to other reports when you modify the shared query for one report. However, Logi JReport provides you with the flexibility to lock a query to prevent it from being changed unintentionally when someone using the same catalog creates a new report. Once a query is locked, it cannot be used by another report even if you do not want to make any changes to the query.

By using this feature, you can ensure each report has a unique query so when you modify the query you know it cannot affect any other reports.

Below is a list of the sections covered in this topic:

Creating a User for a Query
Locking or Sharing a Query

Creating a User for a Query

Before you can lock or share a query, you need to claim the query by creating a user for it.

To creating a user to a query:

In the Catalog Manager, right-click the query you want to claim and select Create User from the shortcut menu. The Create Query's Username and Password dialog appears.
Type in the user name and password.
Select OK to confirm the information.

When a user has been created for a query, you can modify the user information or remove the user as required.

To modify the user information:

Right-click the query and select Modify User from the shortcut menu. The Modify User Information dialog appears.
Provide the old user name and password and select OK. The Create Query's Username and Password dialog appears.
Type in the new user name and password as required and select OK.

To remove a user, right-click the query and select Delete User on the shortcut menu. In the Remove User dialog, provide the user and password information and select OK. The query is then free to be shared.

Note: A query can be claimed by only one user.

Locking or Sharing a Query

Using the Share property of a query, you can lock or unlock it according to your requirements. By default, the Share property of a query is true, which means that all queries in a catalog can be shared among multiple reports until you lock them.

To lock or unlock a query:

In the Catalog Manager, select the query that you want to lock or unlock.
Select Show Properties on Catalog Manager toolbar to show the Properties sheet.
Locate the Share property and set its property to true or false. If it is true, the query can be shared among reports and can be modified. Otherwise, the query is locked and can be neither used in new reports nor modified by another user using the same catalog.

You can also lock or unlock a query in the following way:

In the Catalog Manager, right-click the query that has already been claimed by a user and select Set Share Property from the shortcut menu.
In the Set Query's Share Property dialog, provide the user information and check or clear the Share option as required.
Select OK to confirm the change.

Notes:

If a query has not yet been claimed by any user, when you set its Share property in the Properties sheet, you will be prompted to claim the query by creating a user to it.
If a query is locked, it is password protected. Unless you provide valid user information, you will neither be able to create a report directly using that query nor make changes to the query, including setting its Share property.

Previous Topic Next Topic