Connecting to Qlik Sense apps

You can connect to Qlik Sense apps that are stored on Qlik Sense servers that you have permission to access.

This page shows how to connect specific Qlik Sense apps to Qlik NPrinting. If you are:

Unsupported Qlik Sense documents

You cannot create connections to Qlik Sense apps that use the following:

  • Always one selected value for fields

Qlik NPrinting cannot modify or remove these options. As a result, Qlik NPrinting may not have access to the entire data set of the connected Qlik Sense app during cache and report generation.

If you want to use Qlik Sense app with these unsupported features, do the following:

  1. Create a copy of the Qlik Sense app.
  2. Remove all unsupported features.
  3. Use the copied Qlik Sense app for reporting purposes.

Requirements

  • The Qlik NPrinting Server and at least one Qlik NPrinting Engine must be installed and activated.
  • Qlik Sense certificates must be installed on all Qlik NPrinting Engine computers. See: Installing Qlik Sense certificates.
  • The Qlik NPrinting user creating the connection must have:
    • RootAdmin authorization in the Qlik Management Console (QMC).
    • A domain user account that is a member of the same domain as the Qlik NPrinting server and the Qlik Sense server.

Connection rules for Qlik Sense apps

The following rules apply to connections to Qlik Sense apps:

  • You can create connections from a single Qlik NPrinting app to multiple Qlik Sense apps.
  • Connections are not shared between Qlik NPrinting apps. If you want to connect the same Qlik Sense app to multiple Qlik NPrinting apps you must create a connection for each.
  • You can only create one connection between a Qlik Sense app and a Qlik NPrinting app.

Types of connection status

The Cache status column shows one of the following values for each configured connection:

  • Never generated: the connection has never been opened.
  • Pending: Qlik NPrinting is attempting to connect.
  • Generating: Qlik NPrinting is connected and importing metadata.
  • Generated: connection successful on all Qlik NPrinting engines.
  • Error: the connection is failing on all available engines. The Qlik NPrinting scheduler service will try to connect again two minutes after a failure.

The Connection status column shows one of the following values for each configured connection:

  • Connection successful on all NPrinting engines.
  • Warning: One or more engines are not working.
  • Connection failed on all NPrinting engines.

Testing and troubleshooting

You can use our Qlik Sense sample app, Beginner’s tutorial.qvf, to test your connections. To download this file, visit Sample files.

There are several way to resolve a Warning, Error, or Connection failed status. To start, open the connection you want to troubleshoot, and click the Run verification button. This will give you a list of possible issues. Here is an example where verification failed because Qlik Sense certificates were not installed correctly:

You can also check the following:

  • Connection properties: For example, check if the Qlik Sense certificates are present on the Qlik NPrinting Engine computer. Also, verify the proxy address and app ID.
  • Qlik NPrinting Engine installation and configuration: For example, check that the Qlik NPrinting Engine is running.

After resolving any issues, re-launch cache generation, or run a task.

Here are some common causes of connection errors:

Connecting to Qlik Sense apps on a Qlik Sense server

Do the following:

  1. Log in to Qlik NPrinting as a user with authorization to perform connection tasks.
  2. From the Apps menu, click Connections.The Connections page appears.
  3. Click Create connection.
  4. In the Name box, enter a name for the connection.
  5. In the App drop-down list, select the Qlik NPrinting app that you want to connect to.
  6. Click Qlik Sense as your Source.
  7. Enter the following information:
    • Proxy address: the full computer name of the Qlik Sense server.

      The proxy address must be prefixed with HTTP or HTTPS if it is enabled on the Qlik Sense proxy. HTTPS is the default. You can find this in the Qlik Sense hub, in your browser's address bar, on your app's overview page. The format is: https://sense_proxy_computer_name.domain_name.

      Note: Your proxy address may have a prefix at the end. In this case, the format is: https://sense_proxy_computer_name.domain_name/prefix.

    • Qlik Sense app id:

      This information is available from the Qlik Sense QMC under Apps. If you cannot see the app id column, click on the ( at the top right and check "ID".

    • Identity: the <Windows domain name>\<user name> of the Qlik Sense user who has access to the app.

      This information is available from the Qlik Sense QMC under Users. You will need the information in the User directory and User ID fields.

  8. If you want to apply section access for the selected Identity, click the Apply user section access for reports check box.
  9. Click the Run verification button. This ensures your connection is valid.

    If the connection is valid, you will see a "Verification successful" message. If not, you will see the following message: "Errors detected. Check details below."

    Successful Qlik Sense connection verification results.

  10. Under Notifications, you can select Send email notification when metadata reload finishes. An email will be sent to the addresses specified under Settings > Tasks. See: Task executions.
  11. Once your connection settings have been verified, click Create. You will be automatically moved back to the Connections menu.
  12. Click on your new connection. You will see the status Cache status - Generating. This means that Qlik NPrinting is connecting to Qlik Sense and importing metadata. If you have a large Qlik Sense app, this may take several minutes.

  13. Once the cache status shows Generated, you can create a new report template. If you get an Error status, check your connection information.

You will now be able to see your new connection on the Connections screen.

Modifying or deleting a connection

Warning: If you try to delete a connection that has associated reports or filters, you will see a warning listing the elements that will become invalid upon deletion.

Do the following:

  1. From the Apps menu, click Connections.

  2. Click on the connection that you want to modify or delete.

    1. To modify, make the desired changes and click Save.
    2. To delete, click Delete.

      Warning: This action cannot be undone.

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?