1. Creating the "RAD Pattern" project.
2. Creating the different pages of the pattern.
   • Form page.
   • Table page.
   • Relation page.
   • Vision Plus buttons and pages.
   • Menus.
3. Generating the RAD pattern.
4. Using the RAD pattern.

The files to create

• A form for RADFileA.
• A form for RADFileB. A Vision Plus button (or a popup combo box) must allow you to select an element of RADFileA.
• A form for RADFileC. A Vision Plus button (or a popup combo box) must allow you to select an element of RADFileB.
• A table for RADFileA.
• A table for RADFileB.
• A table for RADFileC.
• A RADFileB/RADFileD relation page.

Standard to follow

Overview

• A supercontrol: This supercontrol contains the controls of the form to display. This supercontrol is linked to the file to display.
• Back and Validate buttons.

• A table: This table is a file table.
• Buttons for basic actions: Add, Modify, Delete.

Example: Relationship page in the RAD Simple pattern:

Creating a relation page

1. Click in the quick access buttons.
   • The window for creating a new element is displayed: click "Page" then "Page".
   • The page creation wizard opens.
   • Select "Blank" and validate.
2. In the description window, enter the name of the page. This name must contain the name of the file displayed in the file (examples: PAGE_Relation_RADFichierA, PAGE_Rel_RADFichierA, ...)..
   Note: If you want to specify the name of the current file to the user, use the name of the file (RADFileA for instance) in a caption. The RADFileX term will be automatically replaced with the caption of the file described in the analysis.
3. Save the page.
4. The page must be divided into two sections:
   • a File section: in this section, the characteristics of the file RADFichierB will be displayed.
   • a Table section: the characteristics of the table on RADFileD will be displayed in this section. Buttons are used to manage the records found in the table.

Creating the Form section

1. Create a supercontrol on the page: under the "Creación" pane, in the "Contenedores" group, click on "Supercontrol".. This supercontrol will display the controls found in the form. Position this control in the page and define its size. Scrollbars will be automatically displayed if some of the controls cannot fit in the specified size.
2. In the supercontrol description window, specify the name of the supercontrol. This name must be SC_Fiche_ (SC_ is the prefix of the programming guidelines: it is not necessary if you are not using programming guidelines). For example: SC_Fiche_RADFichierB.
3. In the "Content" tab of the supercontrol description window, specify:
   • the data file browsed: RADFichierB.
   • the item browsed: RADFileBID.
4. Assign the supercontrol to a group ("Groups ..." button in the "Details" tab of the supercontrol description). This group allows you to switch the form controls to display mode in the initialization code of the page. This group can be named "GR_FormSection" for example.

Creating the Table section

1. Create a Table control on the page: under the "Creación" pane, in the "Datos" group, pull down "Tabla" and select "Table".
2. In the table creation wizard, specify the following characteristics:
   • Select the "Display data from a file or query" option.
   • Select the base file of the table: RADFileD.
   • Keep the proposed items. The search key is IDLinkedRADFileB.
   • Validate the name of the table.
3. Position the Table control in the page and define its size. The columns corresponding to the identifiers can be invisible if necessary.

Creating buttons

1. Create and position the buttons used to manage the records displayed in the table. These buttons can have any name.
   We advise you to include:
   • a button for adding a row,
   • a button for deleting a row,
   • a button used to validate and to go back to the previous page.
2. Case of addition button ("Add a row" button for example).
   This button can be used to add a record into the table. The code of the Add button can be:
   

   // Initialize the new record
   HReset(RADFileD)
   
   // Assign the identifier of RADFileB 
   // in the corresponding item of RADFileD file
   RADFileD.IDLinkedRADFileB = RADFileB.RADFileBID
   
   // Add the record
   HAdd(RADFileD)
   
   // Update the table
   TableDisplay(TABLE_RADFileD)
   
   CASE ERROR:
   	Error("An error occurred during the addition.", HErrorInfo())
   	RETURN

   
   In the code of the add button, it is advisable to activate automatic error handling (Option "If error: ", with automatic processing "Execute error handling ("ERROR CASE:" in the code)").
   
3. Case of deletion button ("Delete a row" button for example).
   This button can be used to delete a selected record from the table for example.
   The code of Delete button can be:
   

   // If the deletion is confirmed, delete the table row and
   // the corresponding record from the RADFileD file
   IF YesNo("Do you want to delete the record?") THEN 
   	// Delete the record from the table
   	 TableDelete(TABLE_RADFileD)
   	// Position on the current record
   	 TableDisplay(TABLE_RADFileD, taCurrentFirst)
   END
   
   CASE ERROR:
   	 Error("An error occurred during the deletion.", HErrorInfo())
   	 RETURN

   
   In the code of the deletion button, we advise you to enable the automatic management of errors ("If Error: ", with the automatic process "Run the error process ("CASE ERROR:" in the code)").
4. Case of return button ("Back" button for example).
   

   // Are we coming from a page?
   IF PreviousPage() = "" THEN
   	// Yes, display this page
   	PageDisplay(PreviousPage())
   ELSE
   	// No, go back to the home page
   	PageDisplay(PAGE_Home) 
   END

   
   Remark: This code requires the presence of a page named "PAGE_Home" in the RAD pattern.. This page can be the home page of the site and it can contain the main menu of the site. For more details, see Menu page.
5. Enter the declaration code of the global variables of the page. Example:
   

   // Display the records 
   FileToPage()
   
   // Filter for the table of RADFileD
   HFilter(RADFileD,RADFileBIDRel,RADFileB.RADFileBID)
   
   // The form section is read-only
   GR_PartieFiche..State = DisplayOnly

   
   This code is used to:
   • display the value of the records in the form and in the table
   • switch the controls found in the form to "Read-only" mode.
6. Enter the closing code of the page. This code is used to disable the filter:
   

   // Disables the filter
   HDeactivateFilter(RADFileD)