GeneXus provides a set of built-in Domains and Structured data types to interact with QueryViewer and DashboardViewer controls.
They are read-only and encapsulated in the GeneXusReporting module. You can find them under 'References' in the KB Explorer:
In addition, you can find them in the 'Domains' tool window and in the 'Standard Variables' section.
The encapsulation of these objects in the module provides a set of benefits:
- It is clear to all the developers that these objects are maintained by GeneXus.
- Making them read-only prevents occasional errors and compatibility issues.
- Their implementation is already built and is also shipped built-in with GeneXus. So, GeneXus does not need to build (specify, generate, compile) them on every KB/Version/Environment.
The objects encapsulated in this module maintain the same GUID they had when the module didn't exist, so when installing this module the user will see these objects disappear from their old locations (QueryViewer and DashboardViewer folders under the Root module).
You may install the GeneXusReporting module from the Manage Module References dialog in the Knowledge Manager option (located in the GeneXus IDE toolbar).
Additionally, building a Knowledge Base created with a previous GeneXus version that already contained a QueryViewer or a DashboardViewer control will install the GeneXusReporting module automatically.
Finally, inserting either a QueryViewer or a DashboardViewer control in any form for the first time in a new Knowledge Base will also install this module.
Generators: Java, .NET Framework, .NET.
To restore a Knowledge Base to a prior state (that is, before the installation of the GeneXusReporting module) follow the steps below:
- Open the Knowledge Base with a version of GeneXus prior to GeneXus 17 Upgrade 11.
- Locate all the objects referencing the module, export them (so as not to lose them), and delete them.
- Delete the GeneXusReporting module.
- Using the Knowledge Manager, import the following files:
- UserControls\QueryViewer\QueryViewerResources.xml
- UserControls\DashboardViewer\DashboardViewerGxResources.xml.
- Import the objects exported in step 2.
This feature is available since GeneXus 17 Upgrade 11.