Moving reports between environments
Many users have several Qlik NPrinting environments, such as a test and a production environment. You can export a report from one environment and import it into another.
Exporting a report creates a .zip file containing your Qlik NPrinting Designer template, applied filters, cycles, and dynamic names. The .zip file does not contain your app or connection information. Apps and connections must be present in the secondary environment before you start importing reports.
Exporting a report
Do the following:
- Select Report in the top menu.
- Click on the report you would like to export.
-
Click the Export button.
You will be asked to password protect the file. This is optional.
- Press Download.
You will have a .zip file in the folder that receives files downloaded from your web browser.
Checking connections in the secondary environment
In order to successfully import a report, connections in the secondary environment must match those from the original report. This includes:
- All objects used in the report template.
- All fields used in cycles.
- All fields used in filters that are associated with the original report, or added as object filters in the template.
- All variables used in dynamic naming.
- All entities used, if you are importing a Qlik entity report.
QlikView and Qlik Sense ids are used when comparing objects between the two environments.
The import will not be performed if there is no connection that contains all required objects. If you receive an error message, you can check your Qlik NPrinting WebEngine log file to get the list of objects that are missing from the target app.
Replacing an existing report
Do the following:
- Select Report in the top menu.
- Click on the report you would like to replace.
-
Click the Replace button.
- Choose the Qlik NPrinting app you want to connect to the report template you are importing.
- Click Browse... and select the .zip file you exported previously.
- Type in the password, if applicable.
- Click Next.
- Choose a Connection. Click Next.
- Choose Filters. Click Next.
- Click Confirm.
You have successfully replaced the report. If there are any errors, see the log file. For more information, see: Logging
Importing a new report
Do the following:
- Select Report in the top menu.
- Click the Import report button.
- Choose the Qlik NPrinting app you want to connect to the report template you are importing. If you would like to create a new app, see: Working with apps.
- Click Browse ... and select the .zip file you exported previously.
- Type in the password, if applicable.
- Click Next.
- Click Confirm.
You will now be able to view this report template under Reports.
Importing user filters from imported reports
When you import reports into Qlik NPrinting, the filters associated with users are not included, for performance reasons. Importing all of the filters associated with thousands of users would take a long time, and could cause Qlik NPrinting to stall.
You can change this behavior by uncommenting the line <!-<add key="include-user-filters" />-> in the webengine.config file. The import filter dialog will then import all filters you have stored in the repository. This could take a very long time, depending on the number of stored filters.
If you do not want to edit the webengine.config file, you can manually import a specific user filter along with your report. There are two ways to do this:
- Remove the filters association from all users.
- Create a new filter, not linked to any user, with the same fields and values.