Tables, views and synonyms are mapped objects of the tables, views and synonyms in the raw database that a connection refers to. Mapped objects have mapped names that can be different from their names in the raw database. A catalog stores information about the real tables/views/synonyms mapped, such as the name, qualifier, and owner.
Since tables/views/synonyms are only mapped objects, they can be mapped and then re-mapped. That is, the information of the real tables/views/synonyms stored in a caytalog is changeable. This is useful when you are off-line from your database. You will still be able to see the table/view/synonym structure and generate reports; however, you cannot view the report since the catalog only stores a meta-data layer, not the database data. In addition, when changing the connection, for example, from an MySQL database to an Oracle database, you will only need to re-map all the tables/views/synonyms in the catalog as opposed to creating a new catalog.
Note: Synonyms are supported for Oracle database only.
Below is a list of the sections covered in this topic:
- Adding Tables/Views/Synonyms to a Catalog
- Refreshing Tables/Views/Synonyms
- Organizing Tables/Views/Synonyms into Folders
- Removing and Adding Columns to Tables/Views/Synonyms
- Previewing the Column Data of Tables/Views/Synonyms
- In the Catalog Manager resource tree, do any of the following:
- Right-click the JDBC connection and select Add Tables/Views/Synonyms from the shortcut menu.
- Right-click the Tables/Views/Synonyms node of the JDBC connection and select Add Tables/Views/Synonyms from the shortcut menu.
- Right-click an existing table/view/synonym in the JDBC connection if there is and select Add Tables/Views/Synonyms from the shortcut menu.
- Right-click any folder in the Tables/Views/Synonyms node of the JDBC connection if you have already created some and select Add Tables/Views/Synonyms from the shortcut menu.
- Select the Tables/Views/Synonyms node of the JDBC connection, or any existing table/view/synonym or folder in the connection and select Add Tables/Views/Synonyms on the Catalog Manager toolbar.
The Add Tables/Views/Synonyms dialog appears.
- From the Database Catalogs drop-down list, select the required catalog, then specify a schema in the selected catalog from the Schemas box.
- Check Tables/Views/Synonyms checkbox.
- Select the Refresh button. The tables/views/synonyms contained in the selected schema will then be displayed in the box on the right of the Add Tables/Views/Synonyms dialog.
- Check the Show System Tables/Views/Synonyms option if you want to have the system tables/views/synonyms available in the Tables/Views/Synonyms box.
- Check Show Tables/Views/Synonyms Already Added to make the tables/views/synonyms that have been added to the connection available in the Tables/Views/Synonyms box if you want to add them again.
- Choose the required tables in the Tables/Views/Synonyms box, and then select Add.
To choose consecutive tables/views/synonyms, select the first table/view/synonym, press and hold down Shift, and then select the last table/view/synonym. To choose tables/views/synonyms that are not consecutive, press and hold down Ctrl, and then select each table/view/synonym.
- Repeat steps 2 to 4 to add tables from other catalogs and schemas.
- To add certain tables by name or by patterns in their name, select the Table/View/Synonym Name Pattern checkbox. The wildcard % will then be displayed in the text box.
For example, if you want to add tables/views/synonyms beginning with AL, you can type AL% (case sensitive) in the text box, and select the Refresh button. All the tables/views/synonyms beginning with AL in the selected schema will then be displayed in the Tables/Views/Synonyms box. Choose the tables/views/synonyms that are required by selecting Add. They will then be added to the connection.
- After adding the required tables/views/synonyms, select Done to close the dialog.
- When you have added some tables/views/synonyms to a catalog, you can then set up pre-joins between them. For detailed information, see Editing Pre-joins in a Catalog.
- If you have selected schemas in the Schema tab of the Get JDBC Connection Information dialog when setting up the connection, when you add tables/views/synonyms, by default only the selected schemas will be listed in the Schemas box of the Add Tables/Views/Synonyms dialog, however, you can check the Show All Schemas option to show all the schemas.
- When adding tables/views/synonyms, if the Show Tables/Views/Synonyms Already Added option is checked in the Add Tables/Views/Synonyms dialog, when you select the Add button to add a table/view/synonym that has already been added to the connection once, a dialog will be displayed, prompting you to give the new table/view/synonym a different name.
The tables/views/synonyms in your catalog are a temporary deposit to improve the performance when you design and test your report. Your database keeps changing over the time. However, these will not be reflected automatically in your catalog. To synchronize your tables/views/synonyms in the connection and database, you can choose to refresh the tables/views/synonyms information using the Refresh command on their shortcut menu. Then when the refreshing job is done, a reporting dialog will be shown, summarizing the changes and operations that have been taken.
You can organize the tables/views/synonyms that have been added to a catalog via a JDBC connection, by arranging them in different folders in the Catalog Manager.
To add a folder:
- Do any of the following:
- Right-click the Tables, Views or Synonyms node and select New Folder from the shortcut menu.
- Right-click any existing folder and select New Folder from the shortcut menu.
- Selecting any existing table, view, synonym or existing folder and select New Folder on the Catalog Manager toolbar.
- A new folder is added to the Tables/Views node, or in the selected folder. Type a name for the folder in the editing area, and then select outside to confirm the change.
To move tables/views/synonyms to a folder:
- Right-click the table/view/synonym you want to move and select Move To from the shortcut menu.
- In the Move Table/View/Synonym dialog, select the folder to which the table/view/synonym will be moved, then select OK.
By default, when you add a table/view/synonym, you add all the columns present in the table/view/synonym. However, Logi JReport gives you the flexibility to remove columns in a table/view/synonym, leaving only the columns useful to your reports. Additionally, your database keeps changing over the time. You can add the columns to the table/view/synonym after you delete them or the database has been updated.
To remove a column from a table/view/synonym:
- Select the column you want to remove.
- Right-click the column and select Delete from the shortcut menu. This does not remove the column from the database, only from what is visible in Logi JReport Designer.
To add columns to a table/view/synonym:
- Right-click the table/view/synonym to which you want to insert columns, then select Add Columns from the shortcut menu.
- In the Add Columns dialog, select the required columns from the Columns box and select Add.
There will be no available columns in the Columns box if you do not delete any in the table/view/synonym before, or no updates have been made to the database. That is to say, you cannot add columns that do not belong to the table/view/synonym.
- Select the Done button to add the columns to the table/view/synonym.
Tip: If you want to add all the columns in a table/view/synonym at the same time, you can also choose to refresh the table/view/synonym, which synchronizes the table/view/synonym in the catalog with the one in your database.
In the Catalog Manager, you can preview the data for a database column, which enables you to have a general idea about the field contents, field type, and other useful information related to this field.
To preview the data of a column:
- Right-click the column with the data you want to preview, then on the shortcut menu, select Browse Data.
- The data of this column is shown in a list in a dialog, which also includes other information including the field type, precision, scale and number of records.