The Options tab lists resource files you have attached to the Domain and lets you add or remove resource files. You can attach the following resource files to your Domain:
| • | A single security file. Defines row and column-level access to data selected by the Domain. |
| • | Any number of locale bundles. Provides internationalized labels for the sets and items of the Domain design. |
Options Tab When No Resources Are Attached |
|
The security file and locale bundles must be created separately in the correct text-based format. Files can be uploaded locally and attached to the Domain, or you can add a file directly to the repository and reference it from multiple Domains:
| • | A Domain can have only one security file but any number of locale bundles. |
| • | Locale bundles are uploaded to the repository as type File > Resource Bundle and Domain security files are type File > Access Grant Schema. |
| • | Files in the repository are referenced by the Domain; local files are uploaded directly into the Domain: |
| • | Local files are attached to the current Domain and can't be accessed by other Domains. This ensures that users of other Domains won't modify your file to meet their needs. |
| • | Files in the repository can be accessed by multiple Domains. This allows a security file or locale bundle to be used by multiple Domains. |
| • | A warning is displayed if you attempt to delete a security or locale bundle file that is referenced by a Domain, but not if you replace these files with a different file. |
| • | Replacing a shared security file can affect the security of Domains that use it. If your security file is replaced or modified, your security design may fail without any visible error. |
| • | Care must be taken to ensure that the Label and Descriptions Keys are consistent across all Domains that share a locale bundle. |
| A warning is displayed if you attempt to delete a security or locale bundle file that is referenced by a Domain, but not if you replace these files with a different file. When you store these files in the repository, ensure that any updates to the files are compatible with the Domains that reference them. |
This section only describes how to attach and replace Domain resources. For information about uploading files to the repository, see the JasperReports Server Administrator Guide. For information about the syntax of resource files, see The Domain Security File and Localizing Domains.
Options Tab Showing Resources |
|
Based on the current resources attached to the Domain, some or all of the following actions are available:
| • | Add Security File or Replace Security File – Attaches a new security file. If a security file is already attached, it is removed from the Domain and the new one is attached. Repository resources are not removed from the repository. |
| • | Add Locale Bundle– Attaches a new locale bundle. Existing local bundles are preserved. |
| • | |
| • | |
| • | Download Template or download the template – Downloads a file with bundle keys based on the labels and descriptions created on the Data Presentation tab. |
To attach a security file or locale bundle files to a Domain:
| 1. | If you want to use a shared, non-local file, make sure that the file has been uploaded to the repository. If you want to attach files locally, skip this step. |
| 2. | Create a new Domain or edit an existing one. |
| 3. | Go to the Options tab in the Domain. |
| 4. | Click the action you want: Add Security File or Replace Security File for a security file or Add Locale Bundle for a locale bundle file. The corresponding dialog box appears. |
|
Add Security File and Add Locale Bundle Dialog Boxes |
| 5. | Select the Local File or Repository tab and then browse to select a file or repository object. |
In repository view, your view is restricted to specific file types: XML files for security files and .properties files for locale bundle objects. If you are attaching a security file, make sure to select an XML file created explicitly as a security file (uploaded as Access Grant Schema).
| 6. | Click Select to upload or attach the file and add it to the list of current resources. |
The server validates the file to make sure it matches the format of a security file or locale bundle. If the file type is not recognized or there is a fundamental syntax error, the file is not added to the list of resources and you must select another file or click Cancel.
| 7. | To upload or attach additional files, repeat step 4 through step 6. |
If you modify an existing Domain, you must clear the Ad Hoc cache of all queries based on the Domain. This removes any data that was based on the old instance of the Domain and avoids inconsistencies in new reports. For instructions, see the JasperReports Server Administrator Guide.
Recommended Comments
There are no comments to display.