PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Overview
  • Creating a duplicate from the report viewer
  • Print available by default
  • Customizing the created duplicate copy
  • Customizing the report viewer
  • Creating a duplicate copy by programming
  • Signing a duplicate copy
  • Using a duplicate copy
  • Colored bars
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Overview
For legal reasons, it may be useful to keep an identical copy of a report (an invoice for example).
Furthermore, due to the large amount of data to process (statistical reports for example), some reports may take quite a long time to generate.
The Duplicate feature automatically proposes a solution to fix this problem.
The principle is straightforward: When editing a report (report created in the report editor or by programming), its identical copy can be generated and stored in a file in ".dpl" format.
This allows you to re-edit a duplicate copy of the report. The data is not processed again so it is protected against the modifications and this re-edit operation is performed immediately.
The creation of a duplicate copy can be performed:
  • from the report viewer (WINDEV only).
  • by programming.
Versions 16 and later
You can sign a duplicate copy using a certificate:
  • from the report viewer.
  • by programming.
New in version 16
You can sign a duplicate copy using a certificate:
  • from the report viewer.
  • by programming.
You can sign a duplicate copy using a certificate:
  • from the report viewer.
  • by programming.
Remarks:
  • Printing a report with duplicate copies slows the print down. Indeed, the duration for creating the duplicate copy is included in the print duration. We advise you to run performances tests.
  • Printing a page of a report with duplicate copy triggers the creation of the duplicate copy for the entire report.
Creating a duplicate from the report viewer
Reports and Queries

Print available by default

By default, the "Export" pane of the report viewer offers the "Duplicate" option to create a duplicate of the report being displayed.
Export pane
When this option is selected, a file picker allows the user to:
  • enter the name of the duplicate file that will be created.
  • Versions 16 and later
    specify the certificate that will be used to sign the duplicate. The signature of the duplicate is optional.
    New in version 16
    specify the certificate that will be used to sign the duplicate. The signature of the duplicate is optional.
    specify the certificate that will be used to sign the duplicate. The signature of the duplicate is optional.
By default, the duplicate:
  • is saved in the directory of the application.
  • has no password.
  • is named: Dupli_YYYYMMDD_HHMMSS.dpl.
Remarks:
  • To avoid proposing the print of duplicate copies, use iParameterViewer (associated with the iButtonDuplicate constant).
  • To modify the default parameters of the duplicate copy, use iParameterDuplicate before opening the report viewer.
Reports and Queries

Customizing the created duplicate copy

To modify the default parameters for the duplicates created from the report viewer, you can use iParameterDuplicate with the iDplPrintout constant.
Example:
// Configure the duplicate copy of invoice
iParameterDuplicate(iDplPrintout, "C:\Temp", ...
"MyDuplicate_%d_%t", "DDDD DD MMMM YYYY", "HH.MM.SS")
 
// Print the duplicate
iDestination(iViewer)
iPrintReport(RPT_Invoice)

iParameterDuplicate is used to:
  • customize the duplicate options proposed by default by the "Duplicate" option found in the report viewer.
  • automate the print of a duplicate from the report viewer. Indeed:
    • the duplicate will be generated when printing (from the report viewer).
    • if an annotation or an edit control is modified in the report viewer, a new duplicate copy will be generated during the next printout.
    • if the print is performed on several printers, a duplicate copy will be generated for each printer.
Remark: The list of duplicate copies created during the last print is returned by iLastFile.
Reports and Queries

Customizing the report viewer

If you have customized the report viewer with a version that does not support this option, to manage duplicates, simply:
  1. Import the new report viewer window.
  2. Copy the button for creating the duplicate.
See Customizing the report viewer for more details.
Creating a duplicate copy by programming
To create a duplicate copy by programming:
  1. Use iParameterDuplicate (associated with the iDplPrintout constant) to configure the options for creating the duplicate copies.
  2. Use iDestination and specify that the print must be performed on a printer. The duplicate copy will be created while the print is performed.
To stop printing the duplicate copies, use iParameterDuplicate (associated with the iDplNone constant).
Signing a duplicate copy
Versions 16 and later
The duplicate copies can be signed via a certificate. This signature ensures the integrity of the reports stored. The signature is included in the duplicate.
This signature automatically perform a timestamp. If may be required legally for some uses.
The signature standard used is PKCS7.
You can sign a duplicate copy using a certificate:
Versions 21 and later
Remark: If the report includes a Signature control (linked to a certificate) or if iPrintSignature is used, the duplicate will be automatically signed during its creation. See Signature control for more details.
New in version 21
Remark: If the report includes a Signature control (linked to a certificate) or if iPrintSignature is used, the duplicate will be automatically signed during its creation. See Signature control for more details.
Remark: If the report includes a Signature control (linked to a certificate) or if iPrintSignature is used, the duplicate will be automatically signed during its creation. See Signature control for more details.
New in version 16
The duplicate copies can be signed via a certificate. This signature ensures the integrity of the reports stored. The signature is included in the duplicate.
This signature automatically perform a timestamp. If may be required legally for some uses.
The signature standard used is PKCS7.
You can sign a duplicate copy using a certificate:
Versions 21 and later
Remark: If the report includes a Signature control (linked to a certificate) or if iPrintSignature is used, the duplicate will be automatically signed during its creation. See Signature control for more details.
New in version 21
Remark: If the report includes a Signature control (linked to a certificate) or if iPrintSignature is used, the duplicate will be automatically signed during its creation. See Signature control for more details.
Remark: If the report includes a Signature control (linked to a certificate) or if iPrintSignature is used, the duplicate will be automatically signed during its creation. See Signature control for more details.
The duplicate copies can be signed via a certificate. This signature ensures the integrity of the reports stored. The signature is included in the duplicate.
This signature automatically perform a timestamp. If may be required legally for some uses.
The signature standard used is PKCS7.
You can sign a duplicate copy using a certificate:
Versions 21 and later
Remark: If the report includes a Signature control (linked to a certificate) or if iPrintSignature is used, the duplicate will be automatically signed during its creation. See Signature control for more details.
New in version 21
Remark: If the report includes a Signature control (linked to a certificate) or if iPrintSignature is used, the duplicate will be automatically signed during its creation. See Signature control for more details.
Remark: If the report includes a Signature control (linked to a certificate) or if iPrintSignature is used, the duplicate will be automatically signed during its creation. See Signature control for more details.
Using a duplicate copy
To use an existing duplicate copy, you can:
  • drop the ".dpl" file into the editor of WINDEV or WEBDEV: the duplicate copy is automatically opened in the report viewer and it can be printed.
  • use iPrintDuplicate. This function is used to print the specified ".dpl" file. To display the duplicate copy in the report viewer, all you have to do is use iDestination. For example:
    iDestination(iViewer)
    iPrintDuplicate("C:\My Projects\My_Project\Exe\Dupli_20101021_112712.dpl")

Colored bars

When a duplicate is displayed in the report viewer, several bars may appear at the bottom of the viewer to inform the user of the duplicate file used: centeralt=Colored bars
Minimum version required
  • Version 15
This page is also available for…
Comments
Click [Add] to post a comment