Model the database

A default database meta-schema file, mydatabase.4dbx, is provided. You will edit this file to contain information about the tables, columns, and relations of the relational database that is needed by your app.

  1. In the Project group, expand the src and Database nodes, and open mydatabase.4dbx.

    The Meta-Schema Manager is launched for viewing and modifying the schema.

    Note:

    The meta-schema diagram includes a seqreg table. For this quick start, you do not need to worry about this table. For more information about what this table does, see Managing SERIALs in a generated application.

  2. Right-click and select Add Table. Set the table name to account_record.
  3. Edit the existing column:
    1. Set the Name property to id.
    2. From the Data type dropdown box, select INTEGER.
    3. Select the Not null checkbox.
    4. Right-click the column and select Set as Primary Key.
      Tip:

      The primary key is identified by the key icon.

    Figure: Edit column properties

    Account table with id column selected and Properties view displayed.
  4. Right-click on the table and select Add Column. Set the Name of the new column to firstname, the Data type to CHAR, and the Length to 32.
  5. Add three more columns: lastname, company, and phone. Give all these columns a Data type of CHAR and a Length to 32, as in Figure 2.
    Figure: Create table

    Account table with id, firstname, lastname, company, and phone columns.
  6. Select File > Save All.
  7. In the Projects view, right-click on mydatabase.4dbx and select Generate Database Creation Script.
    1. From the Target database dropdown, select SQLite.
    2. Select Populate database with sample data.
    3. Click Generate.
    Figure: Generate Database Creation Script

    Screenshot of Database Generation Script dialog.

    A .4gl file is generated.

  8. Select File > Save.
    Figure: Save to databaseMaintenance subdirectory

    Screenshot of Save As dialog showing mydatabase_sqt_x.4gl file saved to databaseMaintenance directory.
    1. In the Path field, enter $ProjectDir\databaseMaintenance\mydatabase_sqt_x.4gl.
    2. Deselect the Insert the file in the project option as the file is already in the project; you are just saving the file to disk.
    3. Click OK.
    4. You will be asked if you want to overwrite the default file. Click Yes.
  9. Create and populate the database:
    1. Expand the DatabaseMaintenance group and the CreateDatabase application node.
    2. Select the CreateDatabase configuration (green arrow) and ensure its Binary Name property is set to mydatabase_sqt_x.
    3. Right-click on the CreateDatabase configuration and select Execute.
    Note:

    This sample data comes from the Studio Libraries. If populating the database does not work (for example, you might have changed to an older version of FGL), try recompiling the Studio Libraries.