This commit is contained in:
2022-01-18 20:12:27 +00:00
parent db54ad7bbc
commit ec70df46cf
4 changed files with 27 additions and 7 deletions

View File

@@ -8,7 +8,7 @@ This extension is available to User's with delete rights to the business object:
## How to access
The delete extension is accessed from the [extensions](ay-exentions.md) menu item in business object data tables.
The delete extension is accessed from the [extensions](ay-extensions.md) menu item in business object data tables.
## How the Delete extension works

View File

@@ -8,7 +8,7 @@ This extension is available to User's with full read rights to the business obje
## How to access
The Export extension is accessed from the [extensions](ay-exentions.md) menu item in business object data tables.
The Export extension is accessed from the [extensions](ay-extensions.md) menu item in business object data tables.
## How the Export extension works

View File

@@ -8,7 +8,7 @@ This extension is available to User's with read / write editing rights to the bu
## How to access
The Tags extension is accessed from the [extensions](ay-exentions.md) menu item in business object data tables.
The Tags extension is accessed from the [extensions](ay-extensions.md) menu item in business object data tables.
## How the Tags extension works

View File

@@ -1,14 +1,16 @@
# Report picker
The report picker control displays a list of [report templates](adm-report-templates.md) available for the business object type being displayed.
The report picker control displays a list of reports available for the business object type being displayed.
The picker is also the gateway to editing and creating reports in AyaNova.
The picker is also the gateway to [editing and creating reports](adm-report-templates.md) in AyaNova.
## Authorization Roles required
This form is available to User's on any reportable object form to which they have access.
Report templates [can be restricted](ay-report-edit.md#properties) to certain [roles](ay-biz-admin-roles.md) meaning some reports will not be listed for all users even if they have full rights to the underlying AyaNova business object type. For example a Customer report could be restricted to the Business Administration role only even though the User may have full rights to edit Customers as the report may contain management level only information.
Report templates [can be restricted](ay-report-edit.md#properties) to certain [roles](ay-biz-admin-roles.md) meaning some reports will not be listed for all users even if they have full rights to the underlying AyaNova business object type.
For example a Customer report could be restricted to the Business Administration role only even though the User may have full rights to edit Customers as the report may contain sensitive management level only information.
## How to access reports
@@ -24,8 +26,26 @@ The image above shows a report picker for Work order reports. Because the logged
For Users without the right to edit reports the list will show all available reports for selection without the edit controls.
Clicking on a report name will select it for rendering. AyaNova will submit the report to the server to be rendered and show a "Generating report" control that will monitor the reporting job at the server and report back if it times out or open the report once it's completed. The Generating report control also has a `Cancel` button which will instruct the sever to stop rendering the report. Use this button if the report is [taking too long](#timeouts) to render.
Reports are designed to work with a single object or multiple objects so if you select a report from a [data table](ay-start-form-data-tables.md), the report will display one or more [selected records](ay-start-form-data-tables.md#selecting-records). If you select the same report from a single object's edit form the report will only display that object.
### Rendering
In AyaNova reports are "Rendered" (not "Printed") to a .PDF [Portable document format](https://en.wikipedia.org/wiki/PDF) format document and displayed in the browser for printing, viewing, saving or sending.
Reports are designed to work with a single object or multiple objects so if you select a report from a [data table](ay-start-form-data-tables.md), the report will display one or more [selected records](ay-start-form-data-tables.md#selecting-records). If you render a
When a report is selected the AyaNova server will use the [report template](ay-report-edit.md) in conjunction with the object type and records selected to render the report into a .pdf file at the server and send back a link to the AyaNova web app which will trigger it to open the .pdf file in a new browser window. This means you must enable opening popup's in your web browser for your AyaNova server. Normally this will be a prompt one time only in the browser the first time you attempt to view a report from your AyaNova server.
If the browser was told _not_ to allow the AyaNova server 'site' to open popups then it will need to be re-enabled in the browser by editing the site specific settings to allow popups in order to use the report rendering feature.
How exactly to do this is [browser specific](https://duckduckgo.com/?q=how+to+allow+browser+pop-ups) but typically it's a "Site setting" somewhere in the Settings user interface for that browser.
### Timeouts
Report rendering is the most resource "heavy" operation that the AyaNova server must do and sometimes a report may take too long to render and go over the configurable timeout setting in which case you will receive a timeout message instead of your report.
The number of records selected to report and the amount of memory, disk speed and available CPU% at the server directly relates to how long the reports can take to render. You can speed up rendering lengthy reports with a large number of records by breaking them down into smaller chunks.
For example, reporting on a month at a time rather than a whole year at a time of records by [filtering](ay-start-form-data-tables.md#filtering-columns) the data table being reported.
If report rendering speed / timeouts is a recurring issue, we have [report rendering timeout tips](ops-config-report-rendering-timeout.md##what-to-do-if-running-into-timeout-issues) specifically for the I.T. system operator responsible for AyaNova server maintenance who may need to adjust the timeout configuration setting or provide more resources to the AyaNova server to alleviate the problem.