Sfairadora

  • Reference Guide

Presentation Document Section

The Presentation section contains user-defined presentations of the document data. Presentation is a particular arrangement of controls on the screen. Whenever you need to display some data on the screen, a respective presentation of the data must exist. Presentations are created automatically for entries in the Data and View sections, without the need of user action. The Presentation section allows you to create your own presentations. Presentations are comparable to “dialogs” or “forms” in other applications. A useful feature of a presentation is the possibility to display it in a separate window by double-clicking the respective item in the presentation list in the left pane.
You can create a completely new presentation using the new presentation item located at the bottom of the presentation list. However, in some situations the creation of a completely new item can become unnecessarily complicated; therefore it is recommended to copy an item from the Data or View section to the Presentation section – a new presentation is thus created for the data, the appearance of which corresponds to the automatically created presentation. Then you modify only the attributes that you need. The process of designing your own presentation is explained in detail in the R-D/C Presentation Model chapter.
Properties of individual items in the Presentation section can be found in the Presentation def section.

Copying items to the Presentation section

Source
Result
Data section
Saves the automatically created presentation of the data to the Presentation section. This automatically created presentation can be further modified by means of the dispel definition editor.
A presentation created this way has a universal dispel at its top level so that changes to data types are reflected also by the structure of this presentation. If such behavior is undesirable, you can remove this root universal dispel in the dispel definition editor using the Remove intermediate dispel context menu command. The dispel definition editor is invoked, for example, by the context menu command of the respective item in the Presentation section.
If you preserve the root universal dispel, you can still modify the instant state of the presentation – the modifications made this way are preserved even if the type of the underlying data (and consequently also the appearance of other parts of the automatically created presentation) is changed.
View section
Saves the automatically created presentation of the view. The above explanation of copying from the Data section applies analogically.
Presentation section
Creates a copy of the presentation.

Copying items from the Presentation section

Target
Result
Data section
(This is useful only in very special applications, such as when you need to create source data of an indirect dispel).
Presentation section
Creates a copy of the presentation.
Outputs section
Creates a text output template and hence also an output corresponding to the presentation.
Creates a text representation of the presentation and inserts it into the edited text.
Moreover, you can use this technique to copy data to an external text editor outside Sfairadora.

Context menu

For the Presentation section items in the left pane:
Menu Item
Description
Presentation
Open in Window
Opens a separate window with the respective presentation, which would otherwise be displayed in the right pane. The same is achieved by double-clicking the item.
Edit Presentation Definition
Opens an editor for the modification of the presentation. The command is equivalent to opening the respective item from the Presentation def section in a separate window.
Create Output Template
Creates a text output template based on the presentation. In case of a table, the instant state of the view (filter, ordering …) as well as the presentation state are reflected. The actual text output is then available in the Outputs section. A window asking you to enter the template name appears before saving. Text output reflects changes of source data. Changes of the source table view or presentation do not affect the text output.
Create Output Text
Creates output text based on the instant state of the presentation. You can either save the resulting text to the Data section or create a new text document. Before the text is created, a window appears, in which you can specify the name of the saved text or its location. The created text is independent of changes of the source table data or view.
The context menu of the right pane contains some of the commands listed above.