Kavi® Members Help
Table of Contents
Kavi's Report Builder provides default reports for different applications and allows custom reports to be designed to suit the organization's needs. Each Report Builder comes with a set of Report Types that run predefined queries against specific tables in the database, and each of these Report Types is accompanied by a default report that includes all available fields in the search and downloadable results.
Custom reports are based on one of these Report Types, but the Super Admin can select some subset of available fields for searches to create a more targeted and efficient report, use fixed-field queries if desired, and select which fields are displayed in the online results versus the downloadable results.
All active reports are available in the Reports Area where they can be run by anyone with Reports Area access, including Report Admins and Organization Admins.
Back to topUnderlying each report is a Report Type that queries a specific set of database tables and is calibrated to return the broadest possible set of data fields related to a specific topic. Click the following links to the Kavi Members Report Types document in the Appendix.
Kavi Members Report Types:
Super Administrators can access the Add a Report tool through the Report Builder, which is available on the Super Admin menu.
Super Admins can click here to visit the Report Builder tool.
Select the Report Type that provides the all fields you need for your report. You may narrow the set of fields available in your report for streamlined use and improved performance, but you cannot add more fields. If you aren't sure which Report Type you need, select the one that seems most likely and check to see whether all the fields you need are available. If not, select a different Report Type.
You may find that there is no Report Type that returns every field you want in your report. Database queries can be resource-intensive to process, and the broader the query, the larger the potential drain on system resources. Each Report Type query is optimized to return the widest possible results without placing undue strain on system resources. That said, even the Report Type queries can affect system performance if the report is run without narrowing search criteria. Tips you can use to further optimize your reports are provided at the end of this section.
Once you have selected the Report Type, all the fields available in that Report Type are displayed so that you can select those you want for your Search Form, which you want displayed online in the Viewable Results and which are included in the Downloadable Results. Before you proceed, be sure to set the name and description and the filename. The checkbox that appends the date to the filename is checked by default. It's a good idea to leave this option enabled to make it easier to identify the date that a report was generated and to create unique filenames so that successive reports don't overwrite earlier reports.
Options:
- Set Any Fixed Fields (Optional)
-
Use a fixed field when you want the query to be restricted to a certain set of results. The selected field is "fixed" to a specific value.
Besides saving the administrator a step when running the report (because there's no need to set the 'Contact Type' field), fixing a field narrows the query, which makes the report more efficient and less of a drain on system resources. On the other hand, reports with a fixed field have limited uses and are less versatile than reports without fixed fields. It is rare to fix more than one field in a report.
The most common use cases are reports that only retrieve information about Primary Contacts or reports that specifically retrieve only active or inactive accounts. For example, a Primary Contact report would be based on the 'User' Report Type. The 'Contact Type' field would be selected as a fixed field. On the next step, the field value would be set to 'Primary Contact'. The query only searches for data on users who are assigned the 'Primary Contact' Contact Type.
- Select Search Form Fields
Fields that are selected in the 'Searchable' column appear on the Search Form when the report is run. You should select every field that administrators will want to search upon. You can build reports with no searchable fields. In this case, the Report Admin simply clicks the Run Report button to generate the report.
- Select Viewable Fields for Online Results
Select the fields you want in the Viewable Results, which are displayed online when your report is run. You should limit the number of viewable fields to 15 or less so the fields are sortable when displayed. If the number of Viewable fields exceeds this limit, they won't be sortable.
- Select Fields for the Downloadable Report
Select the fields you want to include in the Downloadable Results when the report is run. This can include a much larger set of fields than the Viewable fields. You can use the handy Select All button to automatically select all the fields, then click to uncheck any fields that you don't want in the report.
Restricted fields:
If 'N/A' is displayed, the field isn't available in every column, but is available for at least one kind of use. For example, Company Lists and User Lists are searchable only; item key fields are downloadable only.
If 'Disabled' is displayed, options in the Set Organizational Properties that control field configuration are set to disable these fields.
The Report Builder includes custom fields, which are displayed in the context of their data type (company, user or membership). They appear at the bottom of each section, in alphabetical order. You can set the order in which these fields will be displayed in the report's Search Form and Results Form.
Now that you've selected the fields for the report you can set default operators, values and field display order.
Options:
- How to Set Operators
-
Operators are set to determine whether the search returns values that include or exclude a specified value or range of values. Operators are configured at several points in the process of designing the report. If Fixed Fields are set when selecting report fields, the next step is to provide default values and configure operators for these Fixed fields. Default values and default operators can also be set for many Searchable Fields.
The set of available operators depends on what type of data is valid for a field (e.g., textual, numerical, dates, etc.). Operators may include 'is' or 'is not' if valid field values are predefined rather than free-text, or 'contains' or 'does not contain' if the value is free-text. If the specified value is a date, operators may also include 'is before' and 'is after'.
- When to Set Default Values
It isn't necessary to set a default value for a Searchable Field, but you may want to if this field is usually set to a certain value when the report is run. For example, the Status field is often defaulted to 'Active' in reports because organizations are usually most interested in managing active users, companies and memberships. The Report Admin can always set this value to 'Inactive' to generate a report on deactivated users or companies, or set the field value to 'Any Status' to retrieve companies or users irregardless of status. On the other hand, a report created specifically to identify inactive companies or users so they can be contacted or removed from the database would have this field defaulted to 'Inactive' (or the Status field could even be fixed to 'Inactive').
- Set Display Order
The Display Order is prefilled according to the order in which fields are displayed in the field selection steps. Edit the display order as you like.
When you designate a field as searchable and it displays 'Show results for' as an operator, the values are displayed as a set of check boxes on the Search Form. As you'd expect, any check boxes you select while configuring the Search Form are prechecked when displayed to the Reports Admin.
Unless an operator is displayed, these fields are in an 'or' relationship, so when a report is run, the results will include records that contain any of the selected values. If none of the check boxes are preselected by the Super Admin and the Report Admin doesn't check any when running the report, the field is ignored (i.e., the results aren't restricted by the values in this field). The result of running a report with all the field values selected is the same as the result of running a report with none of the field values selected.
Check box fields that allow you to set an operator include the 'Membership Status' and 'User Purpose' fields, so check boxes aren't necessarily set to 'or'.
As soon as a report is added it becomes available at the Reports Area. When the Report Admin clicks a link to the report, the report's Search Form is displayed.
The Search Form presents 'Searchable' fields with the default operators and values configured by the Super Admin who built the report. The Report Admin sets search parameters to generate whatever kind of report is needed, then runs the report.
The online Results Form displays the 'Viewable' fields. If there are less than 15 fields, the column headings can be clicked to sort the results. If there are more than 15 fields, the column headings aren't clickable and the Report Admin has to click a link to view columns that don't fit on the main part of the screen.
The 'Downloadable' fields are all included in the Downloadable Results. The downloadable report results are in the comma-separated value (CSV) file format, which can be viewed and manipulated through any spreadsheet application.
Back to topTips:
- To Optimize Performance
-
The demand on system resources is directly proportional to the size of the query. The more restricted the query, the lower the drain on resources. For optimized queries, the Super Admin should consider creating more targeted reports that make use of fixed fields and a smaller number of search fields. The Report Admin can reduce the load on the system by setting search criteria to return the smallest set of results that meets his or her needs.
Routine reports can also be engineered to run automatically during off-peak periods. For more information, contact support.
- Clone a Report
The fastest way to create new reports is to spin-off a similar report that already exists. So, instead of using the Add a Report tool to create a report from scratch, select the report most like the one you want to create and clone it. You won't be able to change the Report Type, so be sure you select a report that uses the desired Report Type.
- Test Your Report
When you are done building your report, run it a few times using different criteria to see how it performs. Download the results files (be sure to edit the filenames or subsequent downloads will overwrite the results files of previous downloads. You might want to time these tests to see how long it takes to get the results. This will give you some idea of which kinds of reports are relatively quick and efficient, and which are slow and consume more system resources.