Parameters
- 07 Jan 2025
- 7 Minutes to read
- Contributors
- Print
- PDF
Parameters
- Updated on 07 Jan 2025
- 7 Minutes to read
- Contributors
- Print
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
In the Parameters FastTab of the Reports page, you can define and further manage the report parameters. In addition, it is possible to define a file name for the report, as well as additional buttons that appear in the printer setup dialog for that particular report.
Field Name | Description |
|---|---|
Title | Allows defining a title name for the Lasernet print dialog or the Menu item. It is normally used for a Lasernet Query report. If it is not specified, the report name is then used. For more details, see the chapter Title on the current page. |
Active | Allows changing a report status: active or not. If the toggle button is set to Yes, the report is active, and end users can see the Lasernet print destination and use it as an output for the report. If the toggle button is set to No, the report is not active and, therefore, the report cannot be generated. |
File name | Allows specifying a name for the output file (xlsx, docx, XML, PDF, etc.). It is recommended to define a unique name with date and time to not get them conflicted when running in a batch job (Reports are Duplicated when Printing Multiple Records). Also, consider the user-friendliness of the naming: if the output file is emailed, this is the file name with which the customer receives it. Clicking the gear sign button available next to this field opens the File name panel for specifying additional parameters. |
Server | Allows specifying a Lasernet server based on the purpose for which you want to use this server: it is only for a print preview or it is also for a distribution of the document. A configuration and extra license are required. For more information, visit the Lasernet Servers page of this guide. |
Preview format | Allows specifying the file format you want to use for previewing a report. PDF will be used if this field is left blank. |
Let SSRS render PDF | When the toggle button is set to Yes, the SSRS passthrough is activated, and it is possible to distribute SSRS PDFs using Lasernet distribution tools. |
OTHER PARAMETERS | Description |
|---|---|
Language | Allows specifying a language for the Lasernet query report. |
Review before sending | Yes: allows activating the review functionality and includes the option of using an expression to define when the review is to be shown. No: the review before sending functionality is not active. |
Menu location | Allows a user to generate a custom Lasernet Query from the Modules menu. Remember to refresh the browser after adding a report to the main menu. |
Formats | Allows defining where regional settings are applied. If No formatting (raw data) is chosen, the report is provided in the fixed format without any regional formatting (ISO8601). Choosing Use regional setting allows applying the culture from AOS. |
Document handling | Allows specifying when to save the report as an attachment in Dynamics 365 Finance and Operations. The following options are available: Last: the last report destination is saved as an attachment. First: the first report destination is saved as an attachment. All: all report destinations are saved as attachments. |
Pro forma | Allows defining a method for using pro forma documents in Lasernet. This setting relates to the Archive/Destinations to archive field. If the Archive / Destinations to archive field is set to default: Archiving takes place if Pro forma returns false. Archiving does not take place if Pro forma returns true. |
Next to some fields, you can find a button denoting custom fields. Clicking the
button opens the value selector.
Cache Control
The option to disable cache is located at Report-level (Lasernet > Common > Reports).
Default: Defined within the Lasernet parameters.
Use cache: Save records in memory both when running reports in batch and through UI.
Disable cache: Never save records in memory.
Disable cache in batch: Save records in memory when running the reports from UI but not when running through a batch task.
The module Test & Performance Suite is useful for identifying the best settings in relation to performance as it contains the option for logging the following information:
Average execution time for report
Average execution time for report - Including time for the batch-task
Memory usage (%) for report
CPU usage (%) for report
Execution time, Memory usage, and consumption of the CPU.
The Idea of using the Test & Performance Suite is to execute 10/100/1000 reports within a batch task and identify the best settings.
Disable cache in the batch is useful in case there’s a need to lower memory usage when running batch tasks, such as when posting and printing invoices.
Batch Testing
Additional information regarding execution time is added to the Batch print review and is useful when tracking bottlenecks in relation to Execution-time, performance, and Memory/CPU usage.
Time per report (without batch overhead) contains the average execution time without any overhead caused by the batch/batch task.
Note
Please bear in mind that the value for Time per report (without batch overhead) could get higher compared to Time per report (ms) in case ”multi-threading” is used (multi-tasks/threads).
Example When Using 4 Tasks/Threads
Multi-threading would cause Time per report (without batch overhead) to get higher compared to Time per report (ms).
Single-threading (single task) would cause almost identical numbers:
Title
It is possible to change the title of the dialog for the Lasernet Query report in question.
Use the Title control to add a Lasernet Language text (it can also be exported and imported into other companies/environments).
You can change the title based on the language of Dynamics 365 Finance and Operations client. It can be also done by adding a Lasernet menu via Reprint in forms.
File Name
Calculated.NewGuidStr() is automatically added to any newly created report as well as to any replacement/query report. A GUID can be used to ensure a file name is unique so it is not accidentally overwritten when another file with the same name is generated. However, GUID can be removed to make it easier for external systems to pick up documents/reports created in Lasernet (it is easier to create a simple and fixed file name). It is possible to manually add the GUID by using the expression Calculated.NewGuidStr() in the file name definition.
The best practice is to define a unique file name, as this avoids potential errors when writing the files and also ensures the correct link to the Lasernet Archive.
Review Before Sending
An option to review a document before delivery is available. It can be defined in the Parameters FastTab of a report (Lasernet > Common > Reports).
Allow choose review before sending is used to enable/disable a review option within the print dialog.
Review before sending activates the review functionality, including the possibility of using an expression to define when the review should be shown.
The Review functionality implies adding a signature before delivery. It is only possible to deliver to a destination type (Print, Email, etc.) defined in the predefined destinations or a destination type selected in the print dialog. It is not currently possible to change the destination type before delivery in the review.
Note
It is preferable to use the Print buttons, especially for the Review before sending since this uses the predefined destinations.
In Lasernet FO Connector, it is possible to use HTML/XHTML when reviewing a document.
Review and Document Handling
Review of documents with Review Before Sending provides a great option to verify and/or approve the documents before they are delivered. It is possible to save the final document (normally a PDF file) as an attachment when making the delivery.
Using document handling in review will only work if archiving is activated and will not work for documents in which archiving is disabled, such as proforma documents. Save XML must be enabled.
Lasernet FO Connector provides a phase/status that identifies the documents that have not been delivered.
The note 'In review on report xxxx’ is added for the attachment in case the document has not been delivered, such as when canceling the review.
The Pending review within the Archive would identify the document that has not been delivered.
Clicking Deliver report through the Review would ensure the document is saved as an attachment (Document handling).
The document is then delivered through the Review.
For more information, watch our FormBytes video Preview and Sign a Document before Sending.
Change Destination in Review
Reviewing a document provides the option to approve the document before it is delivered. This also allows us to hold back a document, such as an attachment that needs to be added before the document is delivered (CRM/Bill of lading, etc.).
Lasernet FO Connector provides the option to change or alter the destination when reviewing a document.
This example shows the option to make a printout of a document before it is distributed. Sometimes a print-out provides a much cleaner and clearer view of the document.
Document review can also be useful for validating the destinations found through the predefined destinations (rules for destination), such as a TEST or UAT environment where the delivery is required.