ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / Editors / Query editor / Operations on queries
  • Overview
  • How to?
  • Adding a join into the current select query
  • Deleting a join from the current select query
  • Notion of external join in the current select query
  • Editing the conditions of a join in the current select query
  • Adding a condition
  • Limitations and notes
  • Specific joins
  • SQL Server syntax for joins
  • Advanced parameters
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Joins between the data files of a select query
Overview
When several data files are used in a query, the query editor automatically searches for the links between these files described in the analysis. These links are called joins in the query editor.
For example, the following query selects the numbers of the orders placed by the customers who live in Paris. The ORDERS and CUSTOMER data files are joined by the CustomerNum item. The query editor automatically defines the joins between these two data files.
Example of an automatic joint process
Note Data file bindings appear in the graphical representation of the query only if both linked data files are used by the query.
By default, the joins are automatically created by the query editor. However, these joins may not correspond to the desired result.. Therefore, you have the ability to add or delete joins. These operations are described in the following paragraphs.
How to?

Adding a join into the current select query

To add a join to the current select query:
  1. Right click the join and select "Edit join" in the context menu. The description window of the query joins appears.
  2. Click the "Add a join" button. A window used to define a new join is displayed.
  3. Specify the characteristics of the join to be added.
  4. Validate. The join is automatically added to the query.
This gives you the ability to create multiple joins between two data files.

Deleting a join from the current select query

To delete a join from the current select query:
  1. Right click the join and select "Edit join" in the context menu. The description window of the query joins appears.
  2. Select the join to delete.
  3. Click the "Delete join" button. The join is automatically deleted. The joins between data files are automatically optimized in order for the query to operate properly.

Notion of external join in the current select query

When calculating a join between two data files ("Parent" data file and "Son" data file), by default only records with a match in both data files are retained. However, the notion of "External join" allows you define a rule to include:
  • records in the "Parent" data file which have no match in the "Son" data file.
  • records in the "Son" data file which have no match in the "Parent" data file.
To define an external join in the current select query:
  1. Right click the join and select "Edit join" in the context menu.
    Edit join
  2. The description window of the query joins appears.
  3. Select the join to modify.
  4. Two options are available on this join, allowing you to define an external join ("Include also").
  5. Select the option(s) corresponding to the desired result.
    Select options
  6. Validate.

Editing the conditions of a join in the current select query

To edit the conditions of a join in the current select query:
  1. Right click the join and select "Edit join" in the context menu.
    Edit join
  2. The description window of the query joins appears.
    Join description
  3. Select the join to edit.
  4. Click the "Edit join conditions" button. The edit window of conditions is displayed.
  5. You can:
    • Add a new condition.
    • Modify a condition.
    • Delete a condition.
    • Define the logical sequence of conditions via operators (AND, OR) and brackets ( and ). You must use the number representing the condition in the formula. For example, if there are 2 conditions, the formula could be: "1 OR 2".

Adding a condition

To add a condition:
  1. Click . The window for creating a condition is displayed.
  2. Select the item for which the condition will be created (1). Only the "key" items are proposed.
  3. Select the operation to perform in the list (2).
  4. Select the type of element to compare for the operation to perform (3):
    • the value: this option is selected in the case of a static (hard-coded) value in the query.
    • parameter: this option is selected if parameters are passed during query execution.
    • the field: this option is selected in the case of a comparison with a field in another data file in the query. Only the "key" items are proposed.
  5. Validate. The condition is added to the previous condition.
  6. Don't forget to check the logical sequence of created conditions.
Limitations and notes

Specific joins

The joins such as (A Join B on x=y) Join C on y=z are not supported.
To run queries with such joins, you must use HExecuteQuery or HExecuteSQLQuery with the hQueryWithoutCorrection constant.
WINDEVWEBDEV - Server codeReports and QueriesWindowsNative Connectors (Native Accesses)

SQL Server syntax for joins

The SQL syntax for joins is supported (when editing an SQL query and when running it). To run these queries, you have the ability to use HExecuteQuery or HExecuteSQLQuery.

Advanced parameters

By default, the joins use the ISO syntax (INNER JOIN / LEFT OUTER JOIN / RIGHT OUTER JOIN / FULL JOIN). You also have the ability to use the Oracle syntax of joins. However, this syntax compatible with Oracle 7 is not recommended.
To use the Oracle syntax:
  1. Open the query description window.
  2. Click the "Advanced" button.
  3. On the "Joins" tab, select the requested type of syntax.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 01/10/2025

Send a report | Local help