Enabling On-Demand reports

To enable On-Demand reports, you must install and configure the Qlik NPrinting On-Demand add-on on your QlikView Web Service.

You must install the Qlik NPrinting On-Demand Add-on on your QlikView Web Service to create On-Demand reports from the QlikView AccessPoint interface. If your QlikView Servers are in a cluster, or you performed a custom installation of QlikView Server components, you must install On-Demand on each QlikView Web Service in the cluster.

To enable On-Demand reports in Qlik Sense, you will need to install a visualization extension. See: On-Demand reporting extension.

Installing Qlik NPrinting On-Demand on a Microsoft IIS hosted QlikView AccessPoint

Requirements

  • QlikView Server:
    • 11.20 SR15 or higher

    • 12.10 SR1 or higher

    • 12.20 or higher
  • QlikView Server is installed and configured to use Microsoft IIS with ASP.NET 4.5 (or higher) as web server.
  • Qlik NPrinting is configured to use JWT authentication. For more information, see: JWT authentication.

    The certificate with private key used to configure JWT authentication must be installed on the Microsoft IIS local machine personal certificate store. Certificates generated using CNG compatible algorithms are not compatible with the On-Demand Add-on.

The following must be configured as specified:

JWT attribute configurations
Attribute Configuration
JWT attribute mapping Match user by Domain\Name
JWT attribute for user ID uid
JWT attribute for user directory dom

Installing On-Demand

Qlik NPrinting On-Demand Add-on.exe can be downloaded from:

Do the following:

  1. Log on with a registered customer or partner account, select ServicesCustomer Downloads, and then select the Qlik NPrinting tab. Select Qlik NPrinting On-Demand Add-on.exe and save it to a folder on the IIS server.

  2. Double-click Qlik NPrinting On-Demand Add-on.exe.
  3. If the QlikView Server requirements are not met, you will see an error message. Check the logs for more information.
  4. Click Install to proceed.
  5. If the User Account Control window appears, click Yes to proceed.
  6. Click Next when the welcome message appears.
  7. Accept the terms and conditions.
  8. Click Next to proceed.
  9. Enter your Qlik NPrinting Server URL in the following format: https://YourServerName:PortNumber.

    Note: Ensure there is no slash (the character “/”) following the port number. The default port number is 4993.

    Note: If your Qlik NPrinting Server and Qlik NPrinting Engine are installed on different computers, you must use the Qlik NPrinting Server URL.

  10. Enter the certificate thumbprint used to configure JWT authentication on the Qlik NPrinting Server. To find the certificate thumbprint:
    1. Navigate to the location where the certificate is installed.
    2. Double click on the certificate and go to the details page.
    3. Copy the value from the certificate thumbprint, and paste it into the field in the Qlik NPrinting On-Demand Add-on setup.

  11. Click Next.
  12. Click Install.
  13. Click Finish to close the setup window.

Installing the On-Demand Add-on on a QlikView Web Server hosted QlikView AccessPoint

Requirements

  • QlikView Server:
    • 11.20 SR15 or higher

    • 12.10 SR1 or higher, if you have Qlik NPrinting 17.2.2 or higher.

    • 12.20 or higher
  • Windows login is enabled, working, and used as the authentication system in Qlik NPrinting.

  • NTFS must be enabled on the QlikView Server or QlikView Server cluster that serves the QlikView Web Server where you are installing On-Demand.
  • QlikView Server is installed and configured to use QlikView Webserver.

  • QlikView Server is connected to Qlik NPrinting. See: Connecting Qlik NPrinting with QlikView.
  • In a multi-server environment, On-Demand needs to be installed on all servers running QlikView Web Server (QVWS) services in the environment.
  • The Qlik NPrinting services Windows domain user must be a member of two groups on the QlikView Server (as well as the AccessPoint server, if installed on a separate computer):
    • QlikView Administrators
    • QlikView Management API

    Note: You must restart QlikView and Qlik NPrinting services after adding the Qlik NPrinting services Windows domain user to the QlikView Administrators and QlikView Management API groups.

Installing On-Demand

Qlik NPrinting On-Demand Add-on.exe is obtained from:

Do the following:

  1. Log on with a registered customer or partner account, select ServicesCustomer Downloads, and then select the Qlik NPrinting tab. Select Qlik NPrinting On-Demand Add-on.exe and save it to a folder on your computer.

  2. Double-click Qlik NPrinting On-Demand Add-on.exe.
  3. If the QlikView Server requirements are not met, you will see an error message. Check the logs for more information.
  4. Click Install to proceed.
  5. If the User Account Control window appears, click Yes to proceed.
  6. Click Next when the welcome message appears.
  7. Accept the terms and conditions.
  8. Click Next to proceed. Setup progress will start.
  9. Enter your Qlik NPrinting Server URL in the following format: https://YourServerName:PortNumber.

    Ensure there is no slash (the character “/”) following the port number.

    The default port number is 4993.

    Properly formatted Qlik NPrinting Server URL

    Note: If your Qlik NPrinting Server and Qlik NPrinting Engine are installed on different computers, you must use the Qlik NPrinting Server URL.

  10. Click Next to proceed.
  11. Click Install to begin the installation.
  12. When complete, click Finish to close the setup window.

Adding the QlikView Server as a trusted origin

The QlikView Server in which you want to create On-Demand reports must be added as a trusted origin in Qlik NPrinting web console if your Qlik NPrintingOn-Demand Add-on is hosted on a QlikView Web Server hosted QlikView AccessPoint. For each server path used to access the Qlik NPrinting web console, you must add a trusted origin. For example, if your QlikView Server can be accessed through a local domain, a shortened host, or fully qualified URLs, a trusted origin must be added for each of those server paths.

How you enter the server paths in the Address field of the trusted origin depends on your security configuration.

Configuration 1: SSL security not setup with Qlik NPrinting web console

A trusted origin is required for each server path used to log onto the Qlik NPrinting web console. For example, if your QlikView Server was qlikserver1 and had an IP address of 192.168.0.101, you would add the following trusted origins:

  • http://qlikserver1
  • http://qlikserver1.domain.local
  • http://192.168.0.101

Configuration 2: SSL security setup with Qlik NPrinting web console and third-party

A trusted origin is required for each server path used to log onto the Qlik NPrinting web console. URLs must use HTTPS. For example, if your QlikView Server was qlikserver1 and had an IP address of 192.168.0.101, you would add the following trusted origins:

  • https://qlikserver1
  • https://qlikserver1.domain.local
  • https://192.168.0.101

Adding a trusted origin

Do the following:

  1. In Qlik NPrinting, click Admin > Settings.
  2. Click On-Demand Settings.
  3. Click Add trusted origin.
  4. After Name, enter a name for the trusted origin.
  5. After Description, enter a description for the trusted origin.
  6. After Address, enter the URL for the QlikView Server.

    The URL must be the base URL (scheme and host) only. For example, http://qlikserver1 rather than http://qlikserver1/qlikview/index.htm.

  7. Click Create.

Configuring On-Demand settings on Qlik NPrinting Server

You must configure these settings on your Qlik NPrinting Server:

  • You must have connections to your QlikView Server.

    QlikView Server and QlikView Cluster connections are supported with On-Demand. Local connections are unsupported for On-Demand. See Creating connections .

  • If you are connecting to a QlikView Server or Cluster with a QV Server Extranet License, the following options must be enabled when configuring the connection:
    • Connection requires authentication
    • Apply user section access for reports
  • You must enable your Qlik NPrinting reports for On-Demand.
  • Optionally, you may limit user access to creating On-Demand reports through security roles. See: Role based security.
Note:

On-Demand is compatible with Chrome, Firefox, and Explorer. It does not run in Microsoft Edge, because the certificates will not download.

Enabling Qlik NPrinting reports for On-Demand creation

Qlik NPrinting reports must be manually enabled for On-Demand creation. Reports must be assigned to the QlikView document with which you want to generate On-Demand reports.

On-Demand creation can be enabled during the creation of a new report.

Do the following:

  1. In Qlik NPrinting web console, click Reports.
  2. Open a report or create a new report.
  3. Select an app from the App drop-down list that has a connection to the QlikView document for which you want to generate a report.

    Note: On-Demand requests only work with reports based on a single connection. MultiDoc reports are not supported.
  4. Select the Enable On-Demand check box.
  5. Click Save.

The report template is now available in the QlikView AccessPoint interface.

Configuring image quality in On-Demand reports

You can update the scheduler.config file to change the image quality of your On-Demand reports.

You can set your On-Demand reports to have higher image quality, the same as from a publish task. As soon as you change this, all On-Demand reports will be affected. This will also affect report previews in Qlik NPrinting Designer. Task reports will not be affected.

The report type and output format combinations that are not supported in tasks are still not supported in this case. For example, you cannot set an image quality level on a report from a task if you are exporting a PixelPerfect report as a .jpeg. If you try to run an On-Demand PixelPerfect report setting this flag to "Veryhigh", it will look the same as a "Normal" report. See: Image quality.

The following combinations are not supported:

  • Excel to .tiff
  • PixelPerfect to .gif, .jpeg, .png, .tiff
  • QlikEntiy to .csv, .skv, .tab, .tiff

Do the following:

  1. Open the scheduler.config configuration file.

    The default path is: C:\Program Files\NPrintingServer\NPrinting\Scheduler\scheduler.config

  2. Uncomment the following string: <!-- <add key="ondemand-image-quality" value="Normal" /> -->

    "Normal" is the default value.

  3. You can set value to: "Normal", "High", or "Veryhigh". These are case sensitive, and have the following DPI values:

    1. Normal: 96 DPI
    2. High: 192 DPI
    3. Veryhigh: 384 DPI
  4. Save the file.

Did this information help you?

Thanks for letting us know. Is there anything you'd like to tell us about this topic?

Can you tell us why it did not help you and how we can improve it?