Validating a Domain ensures the consistency of all its components. The Domain Designer checks the syntax of files when they're uploaded, and overall consistency is also checked when saving a new or edited Domain.
During validation, the Domain Designer does the following:
| 1. | Verifies that the tables and columns of the Domain design exist in the data source (validation against data source). |
| In special cases where you need to create a design before the data source is available, this step can be omitted by setting a parameter in the server configuration file. See the JasperReports Server Administrator Guide. |
| 2. | Verifies that all items in each defined set originate in the same join tree. |
| 3. | Verifies that all items reference existing columns. |
| 4. | Verifies that derived tables have valid SQL queries. |
| 5. | If a security file has been uploaded, verifies that all items and sets in the security file exist in the Domain design. |
If validation fails, you will not be able to save the Domain. Make the necessary changes to the settings and save again. If the settings are in the uploaded files, edit the files and upload them again.
Validation occurs at the following times:
| • | When you open a Domain for editing: JasperReports Server validates the Domain syntax and validates the Domain against the data source. |
| • | When you replace the data source: JasperReports Server validates the Domain syntax and validates the Domain against the data source. |
| • | When you upload a schema from an XML file: JasperReports Server validates the Domain syntax and validates the Domain against the data source. |
| • | When you save the Domain: JasperReports Server validates the Domain syntax and verifies permissions. |
When validation fails a message appears to help you correct the error.
Open topic with navigation
Recommended Comments
There are no comments to display.