Previous Page Next Page

Query Editor

The editor appears when you do one of the following:

• In the Catalog Manager, right-click the Queries node, select New Query from the shortcut menu, input a name for the new query and click OK, then add the resources based on which to create the query in the Add Tables/Views/Queries dialog and click OK.
• In the Catalog Manager, right-click a query and click Edit Query on its shortcut menu.
• In the Catalog Manager, right-click the Business Views node, select Add Business Views from the shortcut menu, input a name in the displayed dialog and click OK, then in the Add Tables/Views/Queries dialog, add more than one resource to use in the business view and click OK.
• Click Menu > Tools > Join or click Join in the Business View Editor.

It helps you to edit a query, or select the table columns and set joins for a business view.

The following are details about options in the editor:

Menu

• Query Menu
  • Apply
    Accepts the changes on the query or business view.
  • Save As
    Saves the query with the name you specify.
  • Add Tables/Views/Queries
    Opens the Add Tables/Views/Queries dialog to add tables, views, synonyms, queries, imported SQLs, stored procedures, and user defined data sources in the current catalog data source to the query or business view. When a query, imported SQL, stored procedure or user defined data source is added, it will be added as a single table with all of its columns.
  • Delete Table/View/Query
    Removes the selected resource.
  • Union
    Creates and modifies a union for the query.
  • Filter
    Opens the Search Condition dialog to specify more criteria to limit the amount of data.
  • Select Distinct
    When selected, in the SQL statement, the SELECT DISTINCT command will be used instead of SELECT. The option is enabled when the query contains only tables/views/synonyms from one JDBC connection, or tables from the same collection of a database in a MongoDB connection.
  • Ignore Predicate If Parameter Value Is Null
    If the query or business view uses a parameter, and the parameter value is null at runtime, then this condition will be removed from the query's or business view's criterion.

    For string type parameters, when the value is left blank, if Ignore Predicate If Parameter Is Null is set to true, the value of this parameter will be considered as NULL, and this predicate will not appear in the WHERE clause; if false, it will be treated as an empty string (¡®¡¯).

  • Customized SQL Mode
    Specifies whether to use the customized SQL mode, in which JReport will disable all the functions in the Query Editor and you can only edit the query by modifying the SQL statement in the SQL window. The option is enabled when the query contains only tables/views/synonyms from one JDBC connection.
  • Arrange Tables/Views/Queries
    Organizes the resources added into the query or business view.
  • Show Mapping Names
    Specifies to show the full names of the columns in the Query Editor. The option does not affect the contents in the definition. It is enabled when the query contains only tables/views from one JDBC connection. When it is disabled, the option is treated as checked or true.
  • Show Table Names
    Specifies to show which table each column belongs to in the criteria panel of the Query Editor.
  • Show Paths
    Specifies to show information of the pre-join paths among tables in the query, when the pre-join feature is enabled.
  • Join Columns
    Specifies to join the highlighted columns in tables together.
  • Auto Join
    Specifies to join tables together based upon the default criteria set in the Options dialog (File > Options > Query Editor > Auto Join). You can also reset the criteria to join tables in the query or business view by checking/unchecking the items on the Auto Join submenu.
    • Join on foreign keys
      Specifies to automatically join tables in a query through a reference from Table A to a primary key in Table B. For example, an order form in Table A shows information on purchases that are made by a customer with a primary key of CustomerID. The customer ID # refers to a record in Table B which lists a specific address, phone number, name, and so on for the customer. The CustomerID in Table A is a foreign key because it links the customer's ordering information in Table A to the customer's information in Table B using the CustomerID field.
    • Join on primary keys with same names
      Specifies to automatically join tables in a query through a field or a combination of fields that uniquely and specifically identifies a record. For example, the OrderID may be the primary key in a table for Orders and also for Payments.
    • Join on same name
      Specifies to automatically join tables in a query through a link between two columns of the same name in two different tables. This often creates many invalid joins such as Amount that appears in both tables.
  • Current Query Options
    Opens the Query Options dialog to change the Auto Join and other options for the current query.
• Column
  • New Computed Column
    Opens the New Computed Column dialog to create functions used for a particular query. It helps you to quickly and easily create columns with the functions available instead of writing a formula. The option is enabled when the query contains only tables/views/synonyms from one JDBC connection.
  • Add Formula Fields
    Opens the Add Formula Fields dialog to add formulas to the query or business view.
  • Delete Column
    Deletes the selected column in the Criteria menu. To undelete, find the field in the table you deleted and place a check mark beside it.
• View menu
  The following two options are enabled when the query contains only tables/views from one JDBC connection.

• Edit SQL
  Shows the SQL statement of the query.
• Preview
  Opens the Preview Option dialog to preview the records.

• Help
  Displays the help document about this feature

Toolbar

The following are commands on the toolbar:

• Add Tables
  Opens the Add Tables/Views/Queries dialog to add tables, views, synonyms, queries, imported SQLs, stored procedures, and user defined data sources in the current catalog data source to the query or business view. When a query, imported SQL, stored procedure or user defined data source is added, it will be added as a single table with all of its columns.
• Delete Table
  Removes the selected resource.
• New Computed Column
  Opens the New Computed Column dialog to create functions used for a particular query. It helps you to quickly and easily create columns with the functions available instead of writing a formula. The option is enabled when the query contains only tables/views/synonyms from one JDBC connection.
• Add Formula Fields
  Opens the Add Formula Fields dialog to add formulas to the query.
• Delete Column
  Removes some unwanted columns from a table.
• Arrange
  Organizes the resources added into the query or business view.
• Preview
  Opens the Preview Option dialog to preview the records. The option is enabled when the query contains only tables/views from one JDBC connection.
• Help
  Displays the help document about this feature.

Criteria panel

Lists all columns added to the query. You can specifically define criteria for the columns in this panel.

SQL

Shows the SQL statement of the query. The option is enabled when the query contains only tables/views/synonyms from one JDBC connection.

Show Paths

Shows information of the pre-join paths among tables in the query, when the pre-join feature is enabled.

OK

Accepts all changes and closes the window.

Cancel

Does not retain any changes and closes the window.

Apply

Accepts all changes in the window.

Help

Displays the help document about this feature.

Related topics:

Creating a Query

Editing a Query

Creating and Modifying a Union Query

Previous Page Next Page