New WINDEV 28 feature!
  • In this lesson you will learn the following concepts
  • Overview
  • Creating the project
  • Creating the analysis
  • Generating the analysis
Appendix 2. Using data from an external database
In this lesson you will learn the following concepts
  • Creating a project.
  • Creating an analysis.
Lesson duration

Estimated time: 40 mn
Previous LessonTable of contentsNext Lesson
This lesson allows you to handle SQL databases with WINDEV.


This lesson is intended for users who are familiar with SQL databases. Some operations to perform on the SQL database will not be presented in detail.
To create an application that uses an SQL database, you need to:
  • Create the project linked to the application. This project will group all application elements (windows, codes, queries, reports, etc.).
  • Import the description of SQL data files.


To follow this lesson, you must:
  1. Connect to your SQL server.
  2. Import the SQL script files and the image directory to the SQL server (located in "\Exercises\SQLDatabase\", in the directory that contains the examples of this tutorial) with the available import tools (MySql, Oracle, SQL Server, etc.). The image directory is used to get the images of the Product data file.
  3. Run the SQL script files on the SQL server.
    Remark: The provided SQL scripts run on Oracle only.
Your SQL database is ready for this lesson.
Creating the project
  • To create the project:
    1. Start WINDEV.
    2. Go to the WINDEV home page (Ctrl + <).
    3. In the home page, click "Create a project" and select "Windows or Linux application". The project creation wizard starts. The different steps of the wizard will help you create your project. The information specified in this wizard can be modified later.


      Tip: To create a project, you can also:
      1. Click Create an element in the quick access buttons.
      2. The new element window appears: click "Project".
    4. The first step of the wizard allows you to select the operating system for which the project is intended. Select "Windows platform" and go to the next step of the wizard ("Next").
    5. For this lesson, we are going to create a "blank" project. Select "Create a blank project" and go to the next step of the wizard.
    6. WINDEV then prompts you to enter the platform description. Keep the default options ("64-bit Windows executable" and "Executable with windows"). Go to the next step of the wizard.
    7. The wizard prompts you to enter the project name, location and description. In our case, this project will be named "sqldatabase".
    8. The different steps of the wizard appear in the menu on the left. These steps can be clicked directly. Since the other steps in the "Description" are not strictly necessary, you can click "Guidelines" directly.
    9. This step is used to define the code style. Don't change the suggested options. Go to the next step.
    10. This step is used to define the style book. Select "Elegant". Go to the next step.
    11. Click the "Database" step. This step allows you define a database.
    12. Select "Yes, use an existing database".
      Using an existing database
      Go to the next step.
    13. Select "Import the description from an existing database".
      Selecting the database
    14. The analysis creation wizard starts.
Creating the analysis
  • The steps of the analysis creation wizard are as follows:
    1. Specify the analysis name and directory. By default, the analysis name corresponds to the project name and the analysis directory is a ".ana" directory in the project directory. We will keep these default parameters.
      Analysis creation wizard
      Go to the next step of the wizard.
    2. Next, you can choose the types of databases used by the project. Select OLE DB (or the SQL database used if you own the corresponding Native Connector).
      Remark: Native Connectors are listed first.
      Selecting the type of database
      Go to the next step of the wizard.
    3. Select the OLE DB source that corresponds to the type of your database.
      Go to the next step of the wizard.
    4. In the following steps, specify the parameters of your OLE DB connection (the same steps apply for a Native Connector):
      • the name of the database server.
      • the username and password.
      • the database name if necessary.
      • the connection name (the caption associated with the connection is optional).
      Go to the next step.
    5. Specify the data access mode.
      Data access mode
      You can:
      • access the data in its current format directly. Only the description of the tables is imported into the analysis. No conversion is required.
      • convert the data to HFSQL Classic.
    6. In our case, choose "Access the data in its current format directly". Go to the next step.
    7. Select the tables (files) to import.
      Selecting tables to import
    8. Validate and end the wizard. The tables are imported and displayed in the data model editor.
  • The analysis is as follows:
    Analysis of this tutorial
Generating the analysis
The generation of the analysis consists in validating the changes made to the analysis (create data files, add or delete items, etc.) and applying them to the entire project (pages, bound controls, reports, etc.).
If changes have been made to the analysis, a generation dialog box appears automatically when the data model editor is closed.
You can also generate the analysis manually. That's what we are going to do.
  • To generate the analysis:
    1. In the data model editor, on the "Analysis" tab, in the "Analysis" group, click "Generation".
    2. The analysis generation is automatically started.
When the analysis is generated, the data can be handled like HFSQL data. There is no difference. You can:
  • Create a full application via the RAD (Rapid Application Development).
  • Create a full custom application. For more details, see "Part 4".
Previous LessonTable of contentsNext Lesson
Minimum version required
  • Version 28
Click [Add] to post a comment