Diagnosing and fixing problems

After opening a catalog, you will then be shown the Catalog Doctor. All the resources in the open catalog will be listed in the left panel of the Catalog Doctor window. Select a resource from the resource tree. In the right panel, you will see the information of the selected resource.

You should diagnose the resources in the following order: connection > tables and fields > formulas and summaries > queries.

Connection

The Catalog Doctor can be used to diagnose connections in the following aspects:

• Finding information of the current connection
  Select a connection from the resource tree. The connection information will be displayed in the left panel.
• Modifying the current connection
  Right-click the connection in the resource tree, and then click Modify on the shortcut menu. The Get JDBC Connection Information dialog will appear. You can now modify the connection.

  For a JDBC driver, fill in the class name of the driver, the URL, user ID and password (if necessary).

• For a JDBC-ODBC bridge, uncheck the Driver checkbox and check Use ODBC Data Source, then give the ODBC data source name, and the user ID and password (if necessary).

  You can also change the properties values in the Properties panel directly. Select a property value, and then choose or type in the value.

Tables and fields

The Catalog Doctor can be used to diagnose tables and fields in the following aspects:

• Finding all the mapping tables, views, synonyms and DBFields in the catalog
  In the resource tree, expand the Relational node, then go to the Tables, Views or Synonyms node and reveal it. All the mapping tables, views, synonyms and DBFields in the catalog will then be listed. The icon in front of each object has a specific meaning, which indicates whether the object is valid or not.
  

  The following are descriptions of the icons in front of each object:

  : Table

  : Table which does not exist in the database

  : Table which has invalid fields

  : View

  : View which does not exist in the database

  : View which has invalid fields

  : Synonym

  : Field

  : Field which does not exist

  : Field with a name which can be found in the database, but has a type mismatch.

• Finding the stored information of a mapping table/view/synonym or a DBField
  Select a table/view/synonym or a DBField in the resource tree to find its stored properties. The information will be listed in the Properties panel.
• Finding all the raw tables/views/synonyms
  Select a table/view/synonym in the Tables and Fields node. All the raw tables/views/synonyms will be shown in the Choose from following to Re-Map panel. Each item there shows the name of a table/view/synonym.
• Getting the raw columns in a raw table/view/synonym
  First select a mapping table/view/synonym, then choose a raw table/view/synonym from the Choose from following to Re-Map panel. The raw columns will be shown in the bottom right panel.

  Note: If you select a mapping table/view/synonym with an existing raw table/view/synonym, the raw table/view/synonym will automatically be selected.

• Deleting a set of mapping tables, views, synonyms or DBFields
  To delete the mapping object, you can use one of the following methods:
  • Select an object from the resources tree, right-click and on the shortcut menu click Delete.
  • Click the Delete button on the toolbar after selecting the object.
  • Select the object and press Delete on your keyboard.

  To delete a set of mapping tables, views, synonyms or DBFields, select the objects you want to delete, and click on the toolbar (or press Delete on your keyboard).

• Re-mapping (Updating) a mapping table/view/synonym
  First select the mapping table/view/synonym that is to be updated from the resource tree. Then, select the raw table/view/synonym which the mapping table/view/synonym refers to from the Choose from following to Re-Map panel, and click the Update button on the toolbar.

  Note: The tree is sorted by the validation status of each object (invalid objects are listed ahead). So, after you have updated a mapping table/view/synonym, the order of the objects will probably change. If the table was invalid and becomes valid after updating, it will be listed after the invalid objects.

• Re-mapping (Updating) a DBField
  Before updating a DBField, you must make sure that the mapping table/view/synonym of the DBField is valid. That is, the raw table/view/synonym that the mapping table/view/synonym refers to exists in the database.

  Select the DBField you want to update from the resource tree, choose the raw column you want the DBField to refer to in the bottom right panel, and then click the Update button on the toolbar.

• Adding tables/views/synonyms
  Click the Add Table button ， the Add View button ，or the Add Synonym button on the toolbar, or right-click the Tables, Views, or Synonyms node, or a table, view or synonym and select Add Table, Add View or Add Synonym from the shortcut menu. In the Add Table/View/synonym dialog, select the tables/views/synonyms you would like to add, and click Add. To finish adding, click Done.
• Adding a DBField
  Select a table or a synonym from the resource tree, right-click and on the shortcut menu click Insert Column to bring out the Add Column dialog. Then select the column you want and click Add. When you have finished adding columns, click Done to close the dialog.

Formulas and summaries

The Catalog Doctor can be used to diagnose formulas and summaries in the following aspects:

• Finding all the formulas and summaries in the catalog
  Expand the Formulas and Summaries node on the resources tree. The formulas and summaries in the catalog will be listed in the tree. They will be sorted by their validity and names. If the icon of a formula/summary is marked by a cross, it means it is invalid (it fails on compiling).
• Finding the compile Error message of a formula/summary
  Select the formula/summary that is to be checked. The compile error messages will then be displayed in the Error panel.
• Replacing a mapping field with another in formulas and summaries
  A frequent error is caused when the mapping fields are not found in a catalog. In which case, you will need to replace the mapped field in formulas/summaries with a valid one.
  1. Select the formula/summary that contains unknown fields on the resource tree.
  2. Click the Replace All button in the Error panel. The Replace dialog appears.
  3. Input the field name that is to be replaced in the Mapping Name text box.
  4. Click the Browse button, the Mapping Fields Browse dialog appears.
  5. In the Tree View tab, you can select an existing field to replace the unknown field.
  6. In the List View tab, you will see the mapping fields in alphabetical order and the type for each mapping field. If the mapping field is a DBField, you will see the tables/views/synonyms it belongs to. Select the field you want to use as a replacement and click OK.
  7. Click the Replace button in the Replace dialog.
• Editing a formula/summaries
  Select the formula/summary to be edited, and click the Edit button in the Error panel.
• Removing formulas/summaries
  Select the formulas/summaries that are to be removed, then, do one of the following:
  • Right-click and on the shortcut menu, click Delete.
  • Click the Delete button on the toolbar.
  • Press the Delete key on your keyboard.

Queries

The Catalog Doctor can be used to diagnose queries in the following aspects:

• Finding all the queries in the catalog
  Expand the Queries node in the Relational node. All the queries will be listed in the resources tree.
• Finding the tables/views selected in a query
  Select a query and expand it. All the tables/views will be listed.
• Finding the DBFields selected from a table/view/synonym in a query
  Select a query and expand it, then click on a table/view/synonym and expand it. All the DBFields in the table, view or synonym will be listed.
• Finding the formulas or computed columns selected in a query
  Formulas and computed columns are listed before mapping tables/views/synonyms.
• Editing a query
  Select the query that is to be edited, and click the Edit button in the Error panel (or right-click the query, and select Edit Query from the shortcut menu).
• Deleting queries, DBFields, formulas, computed columns and a table/view/synonym selected in a query
  To delete the object, you can use one of the following methods:
  • Select an object from the resources tree, right-click and on the shortcut menu click Delete.
  • Click the Delete button on the toolbar after selecting the object.
  • Select the object and press Delete on your keyboard.
• Saving a query as a cached query result
  Select the query that is to be saved as a cached query result, and click Run (or right-click a query, and on the shortcut menu, click Create Cached Query Result).