The EZView widget queries and downloads EQuIS reports and creates EQuIS Information Agents (EIAs) to automatically send reports. EIAs for grid reports can also be used as a data source for the widget. A primary purpose of the widget is to run the selected report and then export the report output to third party programs, such as Excel (.xls) workbooks, ArcGIS shapefiles (.shp), tab delimited (.txt) files, and Google Earth (.kmz) files. Users can also drag and drop reports from the EZView widget to a Map widget by dragging the report name from the EZView widget onto the map.
If EIA(s) are defined for the widget, an envelope icon is displayed in the upper right corner. Hover over the envelop icon to see how many EIAs are defined for the EZView widget. The left side of the widget displays the following:
Report Name – The name of the selected report.
Last Download – The date/time (end-user browser local time) that the report was last downloaded.
Run Time – The run time (i.e., elapsed time) indicates how long it took the report to run the last time it was downloaded (excludes download time).
File Size – The file size of the report output the last time it was downloaded.
Record(s) – If applicable, the number of records in the tabular output of the report the last time it was downloaded.
If the option to enable a link to the Report Parameter Editor is selected in the widget properties, the icon will appear on the EZView widget to the left of the Download button. Clicking this icon opens the Report Parameter Editor in ad hoc mode. Depending on the user's permission for the selected report, the user can view/edit the report parameters, run the report with the selected parameters, and save the report or create a new report.
To export the report output, click on the Download button to open a drop-down menu with download options.
Report data can be sent directly to the user via email or to the Notice widget. Click the Send me this report option to enable this option and then select the report format. The report will then be sent directly to the user.
The following file types are available for export:
•.xlsx – Microsoft Excel workbook containing the tabular data.
•.csv – Comma-separated, double-quote delimited text file containing the tabular data.
•.txt – Tab-separated text file containing the tabular data.
•.kmz – Google Earth kmz file containing Placemarks for each location and a balloon pop-up with the tabular data for that location.
•.shp – A .zip file containing the Esri Shapefile (locations as features) and other related files (*.dbf, *.prj, etc).
•.pdf – A Portable Document Format (PDF) file displaying the tabular data.
Note: The PDF output is produced by generating default Report Definition Language (RDL) to display the table of data and rendering that RDL as .pdf file. See the EQuIS Professional documentation for more information on customizing the default RDL used for displaying IGridReport data.
A published RDL Report will show two download options. See the EQuIS Professional documentation for more information on designing and publishing RDL reports:
•xlsx – The Microsoft Excel workbook produced by the published RDL as rendered by Microsoft's ReportViewer control.
•pdf – The PDF output produced by the published RDL as rendered by Microsoft's ReportViewer control.
A non-tabular report will only display the download option for the file type that it generates. For example, the "Google Earth: Locations" Report only generates *.kmz files, so only the .kmz option will be available.
The editor for this widget allows the user to select a report, configure the report, and create EIAs. To add a report or edit other widget properties, open the Widget Editor by selecting the More Options icon in the upper right corner of the widget to display the drop-down menu and then select the Edit menu option.
Widget Title – By default, the widget title is EZView. The title can be modified.
Widget Color – The color of the widget can be changed using the Change Widget Themeicon to the left of the widget title.
Report Chooser – This control is used to select the report or EIA (as a data source) to be used with this instance of the EZView widget. The name of the currently selected report (if applicable) is displayed by default. To select a different report or EIA, click the Choose a Report button or name of the report. The Report Chooser will open and display available reports. Select the desired report or EIA.
Report Parameters – The report parameters (e.g., analytes, sample date range, etc.) can be edited by clicking on the Edit button to open the Report Parameter Editor for the selected report. A user with editor permission on the selected report may update the report.
Edit/Create EIAs – Select the EIA button to create or edit an EIA. See the EQuIS Information Agents chapter for a detailed discussion of EIAs.
View/edit parameters in the widget to run the report without saving – Checking this option enables a link to the Report Parameter Editor. The icon will appear on the widget. Clicking this icon opens the Report Parameter Editor. Depending on the user's permission for the selected report, the user can view/edit the report parameters, run the report with the selected parameters, and save the report or create a new report.
Widget Object Editor – To set various appearance properties of the widget, select the Object Editor icon in the widget header to open the Widget Object Editor. See the Widget Editor article for more details.
Cancel – Select the Close without Saving button to exit the Widget Editor without saving changes.
Save – Changes will be applied to the widget by clicking on the Save button. The Widget Editor screen will close after the save operation is complete.
Help – The Help button connects to the online documentation related to the specific widget.
Copyright © 2020 EarthSoft, Inc • Modified: 22 Oct 2020