Query Subsystem |
The NOMADS Query Subsystem generates panels that display records from datasets and return a value associated with a record selected by the user. The selected value populates the control with which it is associated.
When defining a query, the element and key information can come from the Data Dictionary. The query is usually invoked via a query button, which can be associated with certain Panel Controls and appears next to single line Multi-Line controls at run time. A query can also be invoked by pressing Shift + F2 or through program control.
The Query Subsystem has three modes of display: Query+, Drop Queries and Classic Query (original). The Query+ mode is the default mode. An example of each display is pictured below.
In general, a query presents a panel with a list containing data from one or more linked files that can be filtered based on specified selection criteria. A toolbar and popup menu are available with options to do the following: copy or export columns, records or all the data, add dynamic filters to the data shown, designate certain records as favorites, hide and show selected columns, edit the data, or print the data. You can also match a value to the beginning of a selected column or key to place your focus in the data list, or you can search all the data for a specified value.
A query definition can also be used as the Input Source in Report Writer when determining the source of the data to display on a report.
(The ability to use a query definition as a source for Report Writer reports was added in PxPlus 2020.)
By default, a query has no security assigned to it. This means that all users can view all data that can be displayed by means of a Query Definition. Security can be added to the Query Definition through the NOMADS Security Manager by using security classifications to identify and control user access. For information on how to set up security for a query, see Query Security.
The Query+ display, which is the default mode, sorts by column. Advanced column sorting ignores case and accents, supports sort algorithms and can handle complex date sorting. Query+ includes the ability to resize and reorder the columns and to create new formulas at run time.
Query+ supports visual cues, such as bold and colored text, background highlight colors and images. It also supports the AutoChart feature, which generates charts based on the query data. Query+ makes use of load-on-demand and background loading techniques to enhance performance.
The Query Profile feature makes it convenient for end users to save run-time query settings, such as column order/width, filters and additional formulas, etc., so that the settings can be reloaded at a later time by selecting a named profile.
Three views are available that feature a toolbar (Default), a menu, or both.
(The ability to save Query Profile settings was added in PxPlus 2019.)
|
|
Drop Queries are displayed directly on the current panel adjacent to their associated Multi-Line rather than on a separate panel like the other query types. These queries have no toolbar or Select button; however, many features of the Query+ are available via the right-click popup menu.
Two types of Drop Queries are available, Drop Query and Drop Tree:
Drop Query |
Displays data in a Report View list box and emulates an enhanced Drop Box.
The Drop Query does not support the AutoChart feature in its right-click popup menu. (Drop Query functionality was added in PxPlus 2014 - Feature Pack 1.) |
Displays data using a Tree View display, which is useful when records can be grouped (e.g. like detail lines in an invoice).
The Drop Tree supports only the Find, Refresh, Print, Filters and Profile features in its right-click popup menu. The Drop Tree does not support display options such as colors, images, percent bars, etc. (Drop Tree Query functionality was added in PxPlus 2021.) |
The Classic Query sorts by key value but has an option to switch to column sorting. The Sort by Column option supports column sort algorithms. The Classic Query also supports column sub-queries.
|
Query datasets can be based on an existing Data Dictionary definition, a PxPlus View, an ODBC data source, or a manually defined file with no embedded dictionary. Query panels are built using element and key information from the Data Dictionary, View definition or ODBC data source. Column names, headings, widths, formats and associated sub-queries are derived from this information. If no data dictionary is available for the file being queried, then you must provide the element information.
Query Subsystem Help
The Query Subsystem Help provides detailed information on the following topics:
Topic |
Description | ||||||||
Explains the components for defining a query. | |||||||||
Defines the main file or table for the dataset and the general characteristics of the query. | |||||||||
Defines the contents of the query. This includes cross-reference files, columns and formulas. | |||||||||
Explains how to assign visual attributes, such as bold text, text color or highlight color, to a query column or a row in the query data list based on specified conditions being met. | |||||||||
Explains how security can be set up for a query. | |||||||||
Explains how to customize the look of a query display using color settings and Themes. | |||||||||
Defines selection criteria to filter the data. | |||||||||
Describes the various ways to invoke a query, as well as how to switch modes to Query+ or the Classic Query. | |||||||||
Describes the options available to the user at run time. | |||||||||
Explains the three service programs that are launched via the query interface:
(The Open File Query was added in PxPlus 2020.) | |||||||||
Describes design and interface considerations. | |||||||||
Suppressing Query Persistence |
By default, when NOMADS Panel Persistence is turned On, it affects all dialogue panels and queries. Panel persistence can be suppressed (for Query+ and Classic Query) on a system-wide basis by setting the %NOMADS'Query_Suppress_Persistence property. The settings for this property are:
(Support for suppressing panel and query persistence was added in PxPlus 2019.) |