Custom topic panel

From WandoraWiki
Jump to: navigation, search

Custom topic panel is one of several available topic panels in Wandora. As the name suggests the custom topic panel can be customized. Custom topic panel uses Wandora's Query language scripts to select the information viewed in the panel. Custom topic panel consists of information tables and table groups.

Next screen capture views custom topic panel with the Schema type topic. The custom topic panel views two table groups: Classes and Instances and New group. First group contains two information tables viewing class-instance and subclass-superclass relations of the Schema type topic. Latter group contains one table table views instances of Schema type topic and the number of instances of every instance topic. The user should notice that custom topic panel tables can view numbers and more generally characters addition to topics.

Custom topic panel2.jpg

Using information tables

Custom topic panel looks very much like the traditional topic panel. Basically it views information related to one topic. Top of the panel views topic's base name, subject locator and subject identifiers. Below that are all the query groups. Each group contains one or more queries. Query results are viewed in information tables. Each table can view topics, characters strings and numbers. Number of table rows and columns depends on the query language script that generates the information.

Custom topic panel example.gif

The user can select information tables cells, rows and columns, and perform operations for the selection. Available operations are discussed in the page Working with topic tables.

Configuring the custom topic panel

The number of and type of information tables in the custom topic panel is not limited. The user can edit old information tables and create new information tables. Information tables are created in the configuration panel.

Custom topic panel is configured by selecting menu option View > Custom w ... > Configure panel. The menu option is available only when the user has enabled custom topic panel and is viewing thee custom topic panel. Selecting the configuration option opens up the configuration dialog. Next image views a screen capture of the configuration dialog.

Wandora custom config.jpg

Custom queries are organized in groups. The example above contains two groups, namely Classes and instances and New Group. To create a new group, the user can click the Add group button. To rename the group, the user can double click the group name and the label becomes editable.

To add queries the user can click the Add query button. Queries can also be renamed by double clicking the label. The user can also rearrange groups and queries by dragging. Also, a query can be moved from one group to another. To remove a query or a group, the user can select it and click either Remove group or Remove query button.

To duplicate an existing query the user can press the Copy query button.

To edit a query the user can either double click it or select it and press the Modify query button. Both actions open the query editor dialog. Next image views the query editor. It is very simple text editor with a text field and a language selection box.

Wandora custom script.jpg

The text field on top of the editor window is used to hold script's name. Below that is a select box used to specify the scripting engine that is used to execute the query. Below the select box is a text area for the query script. Read the page Query language for more information about writing query scripts.

The user can use Check script button to parse the script. If parse fails, Wandora provides more information about the error.

The menu at the top of the dialog provides basic text editing functionality.

The OK button also checks the syntax of the script, closes the configuration window and saves the script if no errors are found. The Cancel button closes the configuration window and cancels all changes in query scripts.

See also

Personal tools