• an Organizer control based on a data file: the Organizer control will be linked to a data file or to a query. In this case, the data file contains the characteristics of the appointments.
• an Organizer control based on a variable: the Organizer control will be linked to a variable (a class instance in most cases). In this case, the class lists the appointments with their characteristics.

Creating an Organizer control based on a data file

• use the wizard for creating the Organizer control. To do so, select "Display data from a file or existing query". Answer the questions asked by the wizard and validate.
• modify the description of the Organizer control.

1. Open the control description window (select "Description" in the context menu).
2. In the "Content" tab, select "File" and select the data source used. This data source can be:
   • a data file defined in the analysis,
   • a query of the project,
   • a query included in the window or in the page.
3. Associate the different items of the data source with the characteristics of the appointment. The elements preceded by a star are mandatory.
   Remark: If the associated data file does not directly contain the corresponding item, you can set a multi-file link.
4. Validate the description window of the Organizer control. The Organizer control is now based on a data file.

Creating an Organizer control based on a variable

• use the wizard for creating the Organizer control. To do so, select "Display data from an existing variable". Answer the questions asked by the wizard and validate.
• modify the description of the Organizer control.

1. Open the control description window (select "Description" in the context menu).
2. In the "Content" tab, select "By variable" and select the data source used (class, ...).
3. Associate the different elements (members of the class for example) of the data source with the characteristics of the appointment. The elements preceded by a star are mandatory.
4. Validate the description window of the Organizer control. The Organizer control is now based on a variable.

Organizer control based on a data file

• If the user is using the Organizer control via the context menu of the control, the additions, deletions and modifications made to the appointments will be automatically applied to the data source linked to the control.
• If the user handles the appointments via a specific window, all you have to do is modify the data file linked to the Organizer control. The displayed data will be automatically refreshed. It is also possible to use OrganizerDisplay to refresh the data in the control.
• If the Organizer control allows the direct input of appointments, the appointments added into the Organizer control will be automatically added into the data file linked to the control.
• If the Organizer control allows the modification of the duration and/or the move of appointments, the modifications made to the appointment will be automatically applied to the data file linked to the control.
• The deletion performed in the control is performed at the same time in the linked data source.
• By default, the deletion is not allowed in the Organizer control linked to a data source. To allow the deletion of appointments:
  • Display the description of the Organizer control ("Description" in the context menu).
  • In the "Content" tab, check "Allow the deletion (deletes in the data source as well)".
  • Validate.

Organizer control based on a variable

• If the user is using the Organizer control via the context menu of the control, the additions, deletions and modifications made to the appointments will be automatically applied to the data source linked to the control.
• If the user handles the appointments via a specific window, all you have to do is modify the elements linked to the Organizer control (class members for example). The displayed data will be automatically refreshed. It is also possible to use OrganizerDisplay to refresh the data in the control.
• If the Organizer control allows the direct input of appointments, the appointments added into the Organizer control will be automatically added into the data source linked to the control.
• If the Organizer control allows the modification of the duration and/or the move of appointments, the modifications made to the appointment will be automatically applied to the data source linked to the control.
• The deletion performed in the control is performed at the same time in the linked data source.
• By default, the deletion is not allowed in the Organizer control linked to a data source. To allow the deletion of appointments:
  • Display the description of the Organizer control ("Description" in the context menu).
  • In the "Content" tab, check "Allow the deletion (deletes in the data source as well)".
  • Validate.